quickcfg

Apply a base configuration to a system, quickly!

It reads a configuration and template structure from a [dotfiles] directory and tries to normalize the machine that it is run base on this configuration.

WARNING: This will modify your system and potentially overwrite files! Make sure you have backed everything up before using it!

Features

• Zero dependencies! All you need is the quickcfg binary and your configuration repo.
• Blazingly fast! We will normalize your machine and keep the configuration in sync with the remote repository, no questions asked.
• Dependency graph! Builds a dependency graph internally, making sure everything happens in the right order and as quickly as possible.
• Flexible configuration, but opinionated! There are a couple of powerful primitives available (e.g. copy_dir), which does a lot of work with very little configuration.

Configuration

Create a repository with a quickcfg.yml in its root:

``` hierarchy: - secrets.yaml - db/common.yaml - db/{distro}.yaml

systems: # system to copy an entire directory to another. - type: copydir # directory relative to root of this project. from: home tohome: true # system to ensure that a set of packages are installed. - type: install-packages # data key to use when resolving packages # will look up this key in the specified hierarchy. key: packages ```

Packages

We support installing packages on the following platforms:

• Debian, through dpkg-query and apt (fact: distro=debian).

Templating

Any file being copied is treated as a [handlebars] template.

Any template file can make use of hierarchy data, by specifying their dependencies using a quickcfg: tag at the top of the file, like this:

```

quickcfg: name

Hi, my name is {{name}} ```

quickcfg will scan the first 5 lines of any file being copied for this.