Fundor 333

blog hoarding cv now note

Dotfiles, bot and yaml files

Reading time 7 minutes
Word count 1412

If you ever use Unix based system you are familiar with dotfiles for configuration. Any program has some of this file or folders laying arrount in your user root.

And many time it was a booring job to setup all your stuff before starting with all the work because I want the config to be the same every where I work. So, in the end of the 2017 i find an article about dotfiles: Managing your Dotfiles . With this article and some copy-and-paste from other dotfiles repo’s on Github I made mine . This was in November 2017. Github suggest it was the 20 of Novembre the first version of the repo but I remember I was trying multiple idea of it and only later make a repo with clean code so It was sometime in November.

Now some time has pass and I have a BIG FAT PROBLEM. I need to have my dotfiles synced and working on a Linux Machine (Arch), an Apple Machine and a Windows Machine… So not only I have multiple versions of configs but for multiple platform. And I need also some of this config on all my machine like the ssh’s config.

So for some time I use a notebook (a book where i write notes not a pc) where I log the change and this make some problems. A lots of problems.

Give me a big fat break

So I search for a system for launch a command and update all and I find it: dotbot .

The bot

This is a project python where you can write an install script from a template and write one or more _.conf.yaml with the instructions. And there are multiple plugin for some package manager (pip, rust, apt, brew…) which can be usefull.

The best way to use (and the only one) is to make the plugin repo into a submodule so it can be updated and will be always an unicum.

In my case I have a multiple config installer

#!/usr/bin/env bash

set -e


BASEDIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"

cd "${BASEDIR}"
git submodule update --init --recursive "${DOTBOT_DIR}"

for conf in ${DEFAULT_CONFIG_PREFIX} ${@}; do
"${BASEDIR}/${DOTBOT_DIR}/${DOTBOT_BIN}" -d "${BASEDIR}" --plugin-dir .dotbot-brew -c "${conf}${CONFIG_SUFFIX}"

The only thing you need to pay attention is the –plugin-dir which can be use multiple times in the command, one for plugin you have. Also you can install a plugin as a submodule for the same reasons as the bot.

My Idea

I have a install script which can execute one config all the time (the default one) and any number of config as add for the default.

So I make multiple setting.conf.yaml one for every configuration I have and i don’t like it. I have:

  • default.conf.yaml: ssh setting, git setting and some command for one or two folder
  • windows.conf.yaml: cmd aliases for my pleasure
  • mac.conf.yaml: zsh and some mac specific config
  • linux.conf.yaml: zsh and some linux specific config

Every time you run the command ./install the default.conf.yaml run and, if you request multiple config, it run default.cong.yaml plus every config you request. And all the configs files are into a folder, one for each and no way to make something similar to function or there is?

I need something more modular, where i can set the config for program/app/stuff in one file and “import” in a list-config, so I can call a list-config or a single/multiple program’s configs.

In this way I don’t have duplication of code or config long km and make multiple list-config more easy to read because they become easy to read.

New Idea because I don' t like the first

I re-read the wiki and I make the meta files. The make file are the solution of my problem.

There are two plus one type of meta file:

  • meta/configs/: single script of config. You can set into this a single program or a “program” of config. In any case this is the “atomic config” of the bot: you can call it as an all not part of this
  • meta/profiles/: the profile of the machine. I use this for make distinction between mac, linux or windows but you can set for something like work or server
  • meta/base.yaml: the base, allways called one. Here you set some default and the cleaner command

Whith this I need to change the install file and make some difference as show in the Wiki1

#!/usr/bin/env bash

set -e




BASE_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"

cd "${BASE_DIR}"
git -C "${META_DIR}/${DOTBOT_DIR}" submodule sync --quiet --recursive
git submodule update --init --recursive "${META_DIR}/\${DOTBOT_DIR}"

while IFS= read -r config; do
CONFIGS+=" ${config}"
done < "${META_DIR}/${PROFILES_DIR}/$1"


echo \${CONFIGS}

for config in ${CONFIGS} ${@}; do
echo -e "\nConfigure $config"
	configFile="$(mktemp)" ; echo -e "$(<"${BASE_DIR}/${META_DIR}/${BASE_CONFIG}${CONFIG_SUFFIX}")\n$(<"${BASE_DIR}/${META_DIR}/${CONFIG_DIR}/${config}${CONFIG_SUFFIX}")" > "$configFile"
"${BASE_DIR}/${META_DIR}/${DOTBOT_DIR}/${DOTBOT_BIN}" -d "${BASE_DIR}" -c "$configFile" ; rm -f "\$configFile"

Make particolar attention of the begginning of the script because is were you can find the configuration for the script.

This new script can run with or without profile. And you can also add plugins in the command as the first install script.

The config files

Now I need to write the config files and it is an easy task. All I need to do is to use this commands and their options:

  • link: make a symbolically link of the file or directory from one of the file or one of the directory of the dotfiles' repo
  • create: make an empty directory
  • shell: execute command in shell in the base directory (that is specified when running the installer)
  • clean: remove all the dead symbolic links in the path
  • defaults: default option for all the command that follow
  • plugins commands: the command of the installed plugins

Now I need to write a meta/base.yaml file for the default command:

- defaults:
      create: true
      relink: true
      force: true

- link:

- shell:
    - [git submodule update --init --recursive, Installing submodules]
    - [chmod +x ~/script/*]

- clean: ["~"]

I start with the default option for the link command:

  • create for creating the parent directories as needed
  • relink removing the old symlink if present
  • force force the new link

This is default for my configs.

After this there is a link to make my default script directory linked in the home directory of the user.

Then we have the shell command with the command for import/download all the submodules of the project and the command for make executable the script folder.

And we end with the clean command with I clean the home from dead symbolic links and delete them all.

After this I need to make my fist profile, the mac one. So I make a new file make/profiles/mac


Every one of this name is a yaml file in the makefile/configs with the command to make/copy/something for the program/stuff is name of. For example git is:

- link:

In this yaml the bot links in the path ~/.gitconfig to the file gitconfig and make the same with ~/.gitignore_global.2

In this way I can build multiple file for all the case I need. Some example is ssh or zsh or the emacs config in my repo which use the configuration describe in this post. There are some files not used like a requirements.txt or choco.ps1 that I don’t know if it’s a good idea.

In any case if you write a good dotfiles repo with dotbot you need to keep the idempotency3 of the bot execution so you are mathematically certan that the execution don’t make different installation with the same command.

If you want to copy some part of my config you can do it but remember:

Dotfiles are supposed to contain your personal settings — what works for someone else isn’t necessarily optimal for you. If certain configurations worked for everybody, those settings would have been built into programs as defaults. Blindly cloning someone else’s dotfiles, especially without having an understanding of how everything works, is not the optimal approach.

Anish Athalye - Managing Your Dotfiles

  1. As describe in the wiki I rename the file as install-profile ↩︎

  2. Be carefull, if you put a path after the : the bot use the path. If you don’t the bot will search a file in the dotfile folder for the same path without the starting dot (if present) ↩︎

  3. Idempotence: is the property of certain operations in mathematics and computer science whereby they can be applied multiple times without changing the result beyond the initial application (from Wikipedia↩︎

by Fundor 333

If you liked this article,

please share it on

or webmention it

See Also