Stow-like designed for keeping dotfiles under version control, written in python
pip is installed (for Debian-based systems, this can be
sudo apt-get install python-pip), stowage can be installed
directly from PyPI:
pip install stowage
Python versions 3.3+ (and 2.6+) are supported and tested against.
- Setup your dotfiles repo (by default
stowageassumes its at
~/dotfiles, but it could be anywhere)
mkdir ~/dotfiles cd ~/dotfiles git init
- Create one or more dotfile 'packages'
# An example, making one for your .vimrc # Notice that we can call it _vimrc instead of .vimrc, making it visible / # easier to interact with mkdir ~/dotfiles/vim cp ~/.vimrc ~/dotfiles/vim/_vimrc
~/.vimrc has been replaced by a symlink to the
~/dotfiles/vim/_vimrc file, enabling the
~/dotfiles directory to be more
easily put into version control.
usage: stowage [-h] [-n] [-v] [-s SOURCE] [-d DESTINATION] [-b BACKUP] [-B] [packages [packages ...]] Symlink files recursively, good for dotfiles. positional arguments: packages one or more packages optional arguments: -h, --help show this help message and exit -n, --dryrun dryrun, just simulate -v, --verbose increase output verbosity -s SOURCE, --source SOURCE stowage source directory -d DESTINATION, --destination DESTINATION stowage destination directory -b BACKUP, --backup BACKUP stowage backup directory -B, --skip-backup skip making backups
New features, tests, and bug fixes are welcome!