Metadata-Version: 1.1
Name: quicksave
Version: 1.5.2
Summary: A (very) simple file versioning system
Home-page: https://github.com/agraubert/quicksave
Author: Aaron Graubert
Author-email: captianjroot@live.com
License: MIT
Description: quicksave
        =========
        
        |PyPI| |Build Status| |Coverage Status|
        
        A (very) simple file versioning system
        
        **Version:** 1.5.2
        
        Detailed documentation on the available commands can be found on the
        `quicksave wiki <https://github.com/agraubert/quicksave/wiki>`__
        
        Getting started:
        ^^^^^^^^^^^^^^^^
        
        The first thing you'll need to do is create a new database where
        quicksave can store its data:
        
        ::
        
            $ quicksave init <path>
        
        That will setup the new database so it's ready to use.
        
        After that, you're good to go. You can ``register`` new files so they're
        tracked by quicksave, ``save`` new states of registered files, and
        ``revert`` to previously saved states. There are several other commands
        which modify the database itself, but I'm only covering those three
        listed commands in this guide (and none of their various options). For
        detailed documentation on all of the available commands, check out the
        `wiki page <https://github.com/agraubert/quicksave/wiki>`__.
        
        To track (AKA register) a new file in quicksave use:
        
        ::
        
            $ quicksave register <filepath>
        
        Which will copy the initial state of the file, and provide the names of
        the file and state keys you'll need use this file. For a brief
        description of file and state keys, see `this
        note <https://github.com/agraubert/quicksave/wiki#a-note-on-file-and-state-keys>`__
        on the wiki.
        
        To then save a new state of the file, use the save command:
        
        ::
        
            $ quicksave save <filepath>
        
        Quicksave will use the the absolute path and the base file name derived
        from *filepath* to automatically decide which file key to use.
        
        Lastly, to get the file back into a previously saved state, use the
        revert command:
        
        ::
        
            $ quicksave revert <filepath> <state>
        
        Again, quicksave will attempt to determine which file key to use based
        on the absolute path and the file name. Quicksave will lookup the
        provided *state* key and revert the file.
        
        .. |PyPI| image:: https://img.shields.io/pypi/v/quicksave.svg
           :target: https://pypi.python.org/pypi/quicksave
        .. |Build Status| image:: https://travis-ci.org/agraubert/quicksave.svg?branch=master
           :target: https://travis-ci.org/agraubert/quicksave
        .. |Coverage Status| image:: https://coveralls.io/repos/github/agraubert/quicksave/badge.svg?branch=master
           :target: https://coveralls.io/github/agraubert/quicksave?branch=master
        
Keywords: version control
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: PyPy
