Project

dotter_dotfiles

0.0
No commit activity in last 3 years
No release in over 3 years
dotter_dotfilessamis/dotterHomepageDocumentationSource CodeBug TrackerWiki
A simple, yet powerful dotfiles manager that wraps around stow and git
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
10,087
Stars
2
Forks
0
Watchers
2
 Releases
Current version
0.4.0
Total releases
4
First release
2015-10-31
Latest release
2015-12-31
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2015-12-09
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 1.10
pry
>= 0
rake
~> 10.0
rdoc
~> 4.0
rubygems-tasks
~> 0.2

Runtime

git
>= 0
inifile
>= 0
thor
>= 0
 Project Readme

Dotter, a dotfiles manager using stow & git

Dependency Status Code Climate Gem Version License Badges

As the title explained, dotter is a tool to manage your dotfiles. It is written in ruby and uses the tools stow and git in order to manage your dotfiles effectively. It wraps around both tools in order to achieve easy and effective management of dotfiles. Stow handles the symlinking of them while Git tracks the history. It is very new, unfinished software that likely has multiple bugs. However, due to the specific tools used there is not too much risk with using it.

Due to the name 'dotter' already being used, the gem is available under the name 'dotter_dotfiles'. Install it with gem install dotter_dotfiles

To see all available commands, use dotter help or look at the list of commands below. All commands are implemented, but the clone command is dumb due to the difficulties involved in reconstructing the entire structure and state ~/dotfiles from a single, flat git repository.

I have been using this tool for a while now, and it has worked really well. However, there were a few issues which bugged me enough to think on them more. This first issue is that stow has an automatic 'ignore list' that ignores certain directories like .git. This is unexpected and I made one of the design choices (stuffing the git metadata into ~/.dotter/gitrepos/<PACKAGE> was it.) based around the fact that this did not happen. The design decision above has caused multiple other issues such as limited git functionality and a really difficult-to-write accurate clone command. There are other ways to manage dotfiles, but in the interests of not fixing stuff that isn't broken, I plan to seperate the stow/git specific code out and add in another method, likely based on this repository.

Commands:

  dotter add PACKAGE FILE                                    # Add a file from a package to the next commit of that package.
  dotter clone REPO_URL                                      # Clones the dotfiles / packages of the specified repository into ~/dotfiles. Will overwrite any existing data.
  dotter commit PACKAGE -m, --commit-message=COMMIT_MESSAGE  # Commit your changes to a Git-tracked package.
  dotter help [COMMAND]                                      # Describe available commands or one specific command
  dotter import PATH PACKAGE                                 # Imports a file or directory into the specified package
  dotter import_repo REPO_URL PACKAGE                        # Clones the specified git repository as the contents of the specified Package.
  dotter init                                                # Initialise the directory structure for ~/dotfiles
  dotter list                                                # List all packages present in ~/dotfiles
  dotter log PACKAGE                                         # View the commit log of a package.
  dotter publish PACKAGE                                     # Make a package available in your public dotfiles repository
  dotter reset PACKAGE                                       # Reset what will be commmitted in the next commit to the given package.
  dotter status PACKAGE                                      # Obtain the repository status of a Git-tracked package.
  dotter stow PACKAGE                                        # Stow the given package name.
  dotter track PACKAGE                                       # Begin tracking the given package with Git
  dotter unpublish PACKAGE                                   # Make a package private after publishing it.
  dotter unstow PACKAGE                                      # Unstow the given package name.
  dotter update PACKAGE                                      # Updates the specified package
  dotter update_all                                          # Updates all stowed packages.
  dotter version                                             # Print the dotter version
  dotter update_public                                       # Updates the contents of the public git repository and then pushes it

This project tries to follow Semantic Versioning but no guarantees are made in this regard.

TODO

  1. Refactor and clean up the code.
  2. Implement all unimplemented commands.
  3. Make the clone command smarter
  4. Implement error handling
  5. Add any useful suggested features.
  6. Port to Crystal so it can be a single executable.