diff options
author | Anish Athalye <me@anishathalye.com> | 2014-10-27 20:04:00 -0400 |
---|---|---|
committer | Anish Athalye <me@anishathalye.com> | 2014-10-27 20:31:40 -0400 |
commit | 33d602bb9304b2daf54a5754f5fb51cfcad350dc (patch) | |
tree | 98209eed7081309a14612d4be5c244cc2d3257d5 | |
parent | afebc0bb2fe817778f77d0fcfe30e508bf15d441 (diff) |
Add YAML support
Add support for YAML format configuration files. In addition, this
commit adds instructions about YAML config files to the README, and it
also changes the README to encourage use of YAML instead of JSON.
-rw-r--r-- | .gitmodules | 3 | ||||
-rw-r--r-- | README.md | 95 | ||||
-rwxr-xr-x | bin/dotbot | 10 | ||||
-rw-r--r-- | dotbot/config.py | 4 | ||||
m--------- | lib/pyyaml | 0 | ||||
-rwxr-xr-x | tools/git-submodule/install | 2 |
6 files changed, 86 insertions, 28 deletions
diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..84611fc --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "lib/pyyaml"] + path = lib/pyyaml + url = https://github.com/anishathalye/pyyaml @@ -63,8 +63,8 @@ updated once it's placed in the proper location (the Dotbot repository can be updated independently). An bootstrap install shell script for git is given in -[tools/git-submodule/install][git-install]. The script assumes that the -configuration is located in `install.conf.json` and Dotbot is located in +[tools/git-submodule/install][git-install]. By default, the script assumes that +the configuration is located in `install.conf.yaml` and Dotbot is located in `dotbot`. The script automatically makes sure that the correct version of Dotbot is checked out in the submodule. @@ -74,19 +74,20 @@ different VCS) is fairly straightforward. Configuration ------------- -Dotbot uses json-formatted configuration files to let you specify how to set up -your dotfiles. Currently, Dotbot knows how to `link` files and folders, execute -`shell` commands, and `clean` directories of broken symbolic links. +Dotbot uses YAML-formatted (or JSON-formatted) configuration files to let you +specify how to set up your dotfiles. Currently, Dotbot knows how to `link` +files and folders, execute `shell` commands, and `clean` directories of broken +symbolic links. **Ideally, bootstrap configurations should be idempotent. That is, the installer should be able to be run multiple times without causing any problems.** This makes a lot of things easier to do (in particular, syncing updates between machines becomes really easy). -Dotbot configuration files are json arrays of tasks, where each task is a -dictionary that contains a command name mapping to data for that command. Tasks -are run in the order in which they are specified. Commands within a task do not -have a defined ordering. +Dotbot configuration files are YAML (or JSON) arrays of tasks, where each task +is a dictionary that contains a command name mapping to data for that command. +Tasks are run in the order in which they are specified. Commands within a task +do not have a defined ordering. ### Link @@ -108,23 +109,37 @@ the source path, specify "create" as true if the parent directory should be created if necessary, and specify "force" as true if the file or directory should be forcibly linked. -##### Example +##### Example (YAML) + +```yaml +- link: + ~/.config/terminator: + create: true + path: config/terminator/ + ~/.vim: vim/ + ~/.vimrc: vimrc + ~/.zshrc: + force: true + path: zshrc +``` + +##### Example (JSON) ```json -{ +[{ "link": { "~/.config/terminator": { - "path": "config/terminator/", - "create": true + "create": true, + "path": "config/terminator/" }, - "~/.vimrc": "vimrc", "~/.vim": "vim/", + "~/.vimrc": "vimrc", "~/.zshrc": { - "path": "zshrc", - "force": true + "force": true, + "path": "zshrc" } } -} +}] ``` ### Shell @@ -138,14 +153,21 @@ Shell commands are specified as an array of commands, where each command is a two element array containing the actual shell command as the first element and a human-readable description as the second element. -##### Example +##### Example (YAML) + +```yaml +- shell: + - [mkdir -p ~/downloads, Creating downloads directory] +``` + +##### Example (JSON) ```json -{ +[{ "shell": [ ["mkdir -p ~/downloads", "Creating downloads directory"] ] -} +}] ``` ### Clean @@ -158,18 +180,41 @@ to the dotfiles directory are removed. Clean commands are specified as an array of directories to be cleaned. -##### Example +##### Example (YAML) + +```yaml +- clean: ['~'] +``` + +##### Example (JSON) ```json -{ +[{ "clean": ["~"] -} +}] ``` ### Full Example The configuration file format is pretty simple. Here's an example of a complete configuration. The conventional name for the configuration file is +`install.conf.yaml`. + +```yaml +- clean: ['~'] + +- link: + ~/.dotfiles: '' + ~/.tmux.conf: tmux.conf + ~/.vim: vim/ + ~/.vimrc: vimrc + +- shell: + - [git update-submodules, Installing/updating submodules] +``` + +The configuration file can also be written in JSON. Here is the JSON equivalent +of the YAML configuration given above. The conventional name for this file is `install.conf.json`. ```json @@ -181,8 +226,8 @@ configuration. The conventional name for the configuration file is "link": { "~/.dotfiles": "", "~/.tmux.conf": "tmux.conf", - "~/.vimrc": "vimrc", - "~/.vim": "vim/" + "~/.vim": "vim/", + "~/.vimrc": "vimrc" } }, { @@ -5,6 +5,16 @@ import sys, os PROJECT_ROOT_DIRECTORY = os.path.dirname( os.path.dirname(os.path.realpath(__file__))) +def inject(lib_path): + path = os.path.join(PROJECT_ROOT_DIRECTORY, 'lib', lib_path) + sys.path.insert(0, path) + +# version dependent libraries +if sys.version_info.major >= 3: + inject('pyyaml/lib3') +else: + inject('pyyaml/lib') + if os.path.exists(os.path.join(PROJECT_ROOT_DIRECTORY, 'dotbot')): if PROJECT_ROOT_DIRECTORY not in sys.path: sys.path.insert(0, PROJECT_ROOT_DIRECTORY) diff --git a/dotbot/config.py b/dotbot/config.py index 79b735c..49252d8 100644 --- a/dotbot/config.py +++ b/dotbot/config.py @@ -1,4 +1,4 @@ -import json +import yaml class ConfigReader(object): def __init__(self, config_file_path): @@ -7,7 +7,7 @@ class ConfigReader(object): def _read(self, config_file_path): try: with open(config_file_path) as fin: - data = json.load(fin) + data = yaml.load(fin) return data except Exception: raise ReadingError('Could not read config file') diff --git a/lib/pyyaml b/lib/pyyaml new file mode 160000 +Subproject f30c956c11aa6b5e7827fe5840cc9ed40b938d1 diff --git a/tools/git-submodule/install b/tools/git-submodule/install index ba63987..b1baa33 100755 --- a/tools/git-submodule/install +++ b/tools/git-submodule/install @@ -2,7 +2,7 @@ set -e -CONFIG="install.conf.json" +CONFIG="install.conf.yaml" DOTBOT_DIR="dotbot" DOTBOT_BIN="bin/dotbot" |