persoconf/persoconf
Lertsenem fbc72c0c12 Adding README 2016-06-02 02:06:16 +02:00
..
commands Take into account missing files when checking 2016-05-27 00:24:00 +02:00
README Adding README 2016-06-02 02:06:16 +02:00
main.py Adding 'check' command 2015-12-11 15:55:10 +01:00
metafile.py Adding 'delete' command 2015-09-16 18:51:44 +02:00
persoconf.py Adding Persoconf class 2015-09-14 13:02:56 +02:00
utils.py Moving utils functions in separate module 2015-12-07 15:00:01 +01:00

README

persoconf
=========

*persoconf* is a python script intended to keep track of all your personal
configuration files (also known as dotfiles).

Usage
-----

If you want to skip this and get to the point: there's a 'help' command
available, and +--help/-h+ options for every other command.


Add an app to your persoconf repo:

----
$> persoconf add myapp
----


Add dotfiles and config directories to this app:

----
$> persoconf add myapp ~/.myapp.config
$> persoconf add myapp ~/.config/myapp/
----


List the files and dirs saved in persoconf for an app:

----
$> persoconf list -f
tmux
        tmux.conf
awesome
        rc.lua
vim
        vimrc
myapp
        myapp.config
        myapp/
----


Check if modifications occured on your config files:

----
$> echo "some change in my conf" >> ~/.myapp.config
$> persoconf check
persoconf:WARNING: File ~/.myapp.config was modified
----


Update persoconf saved files with the latest configuration available:

----
$> persoconf update
----


Package your dotfiles to move them on another machine:

----
$> persoconf package --pkgtype tgz
$> ls
persoconf.20160602.tgz
$> tar tzf persoconf.20160602.tgz
.config/awesome/rc.lua
.config/myapp/somefile
.config/myapp/someotherfile
.myapp.config
.tmux.conf
.vimrc
----


Internals
---------

All persoconf data is by default saved in a '.config/persoconf' directory. You
can override this location with the global +--rootdir+ option. If the rootdir
location does not exist when you first try to use persoconf, persoconf will ask
if you want to create it.

Basically, data is saved as is (which means textfiles and dirs, mostly), and
metadata is saved as json files.



// vim: set ft=asciidoc :