MultiConf

A command line tool for easily generating multiple versions of a configuration file from a single template.

Why?

I'm a big fan of the i3 window manager, and I use it on several linux desktops and laptops. While I mostly want the same i3 configuration across all of these computers, some require different variations.

I created multiconf to make it easy to generate multiple variations of a config file.

How to install

1. Install cargo (the Rust package manager)): $ curl https://sh.rustup.rs -sSf | sh
2. Install multiconf: $ cargo install multiconf

How to use

Create a file called base.txt:

global config 1 global config 2 dog$>>canine config 1 cat$>>feline config 1 global config 3

Then create the "dog" version of base.txt:

$ multiconf --choice dog --input base.txt --output dog.txt

This will contain:

global config 1 global config 2 canine config 1 global config 3

If you want dog.txt to be automatically updated every time base.txt changes, use:

$ multiconf --choice dog --input base.txt --output dog.txt --watch

Typically you'll want to keep this running in the background, for example here is the line I use in my i3 config so I can have different versions depending on the hostname:

`` exec --no-startup-id multiconf -chostname` -i ~/Dropbox/code/linux-cfg/i3/config -o ~/.config/i3/config -w

```

Command line parameters

``` multiconf 0.1.3 Easily generate different versions of config files

USAGE: multiconf [OPTIONS] --choice

OPTIONS: -c, --choice The selected -h, --help Print help information -i, --input The input file, or stdin if not specified -o, --output

The output file, or stdout if not specified -s, --separator Separates choice from the line chosen [default: $>>] -V, --version Print version information -w, --watch Watch the input file for changes and update the output file when it does ```