Chronology watches and records every change you make to a file in a Git repository. It's perpetual undo – go back to two hours ago or two days ago.
Chronology also records all your work, as you do it, in almost real time. You can go analyze that data to understand how you built a product, why you made changes, and what you can do to become more productive. Tools to help analyze your edit history are the next step after Chronology.
- Python 2.7 – Not tested with anything <2.7
- OS X. Windows and Linux are coming later.
- pyuv, pygit2, psutil
brew tap xyziemba/brew
brew install chronology
NOT SUPPORTED YET
pip install pyuv
pip install pygit2
git clone ...
# TODO...
# add a directory to watch
chronology.py add-dir my_project_directory
# start chronology daemon
chronology.py start
# when you're done...
# shutdown chronology
chronology.py stop
I'm still figuring that out. :)
Chronology adds its own set of references and objects into your Git repository. These take up space, but generally won't impact your repository.
Chronology's references all have the form refs/chronology/<sha1>. You can delete all of them by running the following command in a bash shell:
git show-ref | grep refs/chronology/.*$ -o | xargs git update-ref -d
Extra git objects will automatically get cleaned up the next time your repository is optimized, but you can force that by running:
git gc
Setting up your environment:
# install libgit2
brew install libgit2 # on mac
cat requirements.txt | xargs pip install
If pygit2 fails to build, you probably have a version mismatch between the version of pygit2 and libgit2. Read about installing pygit2 at http://www.pygit2.org/install.html.
Run tests with tox:
pip install tox
tox
Chronology is a rough draft right now. Please log issues to this repository, or send a pull request if you're feeling adventurous.
I can also be reached by email at [email protected].