https://github.com/metov/dotstree

Dotfiles manager based on directory trees.
https://github.com/metov/dotstree

cli configuration-management dotfiles dotfiles-manager symlink tools

Last synced: 14 days ago
JSON representation

Dotfiles manager based on directory trees.

• Host: GitHub
• URL: https://github.com/metov/dotstree
• Owner: metov
• Created: 2021-07-13T05:46:49.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2023-07-01T06:40:03.000Z (over 1 year ago)
• Last Synced: 2024-10-04T21:15:55.067Z (about 1 month ago)
• Topics: cli, configuration-management, dotfiles, dotfiles-manager, symlink, tools
• Language: Python
• Homepage:
• Size: 37.1 KB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Dotfiles manager based on directory trees

Dotstree is a dotfiles manager. "Another one??" I know, right. Here's the highlights:

* The dotfiles are replaced with symlinks

* Every program's deployment spec is stored in its own folder

* Install commands can be part of the deployment

* You can cherrypick which programs to deploy based on which directory trees you pass to dotstree (hence the name)

    * This can be used to handle alternate platforms and dependencies

* You can check and sync programs against their spec 

* Written in Python, released to Pypi

## Usage

You can install it with `pip install dotstree`. To see basic usage info, try `dots --help`. I can provide a [`tldr`](https://github.com/tldr-pages/tldr) page if there's interest - just open an issue. Your dotfiles specs are expected to be in some kind of directory tree that you pass to dotstree. Normally this would be a git repo - but dotstree doesn't care. 

## Tests

Run `pytest .` in the repo root.

## Further reading

* [Details](doc/details.md)

* [Program-specific tips](doc/howto.md)

* [Why not GNU Stow?](doc/why-not-gnu-stow.md)