Skip to main content

Stow-like application for keeping your dot-files under version control

Project description


stowage badge

stowage badge

travis badge

travis badge

Stow-like designed for keeping dotfiles under version control, written in python


Assuming Python’s pip is installed (for Debian-based systems, this can be installed with 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.

Quick start

  1. Setup your dotfiles repo (by default stowage assumes its at ~/dotfiles, but it could be anywhere)
mkdir ~/dotfiles
cd ~/dotfiles
git init
  1. 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
  1. Activate stowage
stowage vim

Now, your ~/.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.

Full usage

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
                        stowage destination directory
  -b BACKUP, --backup BACKUP
                        stowage backup directory
  -B, --skip-backup     skip making backups


New features, tests, and bug fixes are welcome!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for stowage, version 0.1.9
Filename, size File type Python version Upload date Hashes
Filename, size stowage-0.1.9-py2.py3-none-any.whl (6.4 kB) File type Wheel Python version 3.5 Upload date Hashes View
Filename, size stowage-0.1.9.tar.gz (19.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page