Metadata-Version: 2.1
Name: saga-vcs
Version: 0.0.14
Summary: saga is a version control CLI that handles many file formats
Home-page: https://github.com/saga-vcs/saga
Author: saga
Author-email: narush@wharton.upenn.edu.com
License: UNKNOWN
Description: # saga
        
        Saga is a set of tools for version control. Saga is like Git, but it works for file formats other than text files. As a user, you can use saga to manage your creative projects. Currently, Saga supports unstructed binary files, text files, CSV files, and Excel files. Unlike Git, Saga can merge changes from different branches from any of these files (if they don't conflict).
        
        As a developer, you can use the Saga framework to add version control to new file formats. See examples [here](https://github.com/saga-vcs/saga/blob/master/saga/file_types/text_file.py) and [here](https://github.com/saga-vcs/saga/blob/master/saga/file_types/excel_file.py). Documentation coming soon!
        
        ## Installation Instructions
        
        To install the `saga` command line tool, run:
        
        ~~~~
        pip3 install saga-vcs
        ~~~~
        
        Currently, Saga only works on macOS. Support for Linux and Windows is coming soon!
        
        ## Using saga
        
        Currently, the `saga` command line tool has a very similar interface to Git. The following commands are currently supported:
        
        ~~~~
        saga init
        saga add 
        saga commit
        saga log
        saga status
        saga branch
        saga checkout
        saga merge
        ~~~~
        
        Some commands don't perform exactly as Git does, so watch out! 
        
        ## Warning
        
        Saga is pre-alpha software. Do not use saga to manage any files that you don't totally trust (we are sure there are security vulnerabilities hanging about). 
        
        ## Downloading Saga Source
        
        If you want to check out saga's source code (or contribute <3):
        
        ~~~~
        git clone https://github.com/saga-vcs/saga.git;
        cd saga;
        python3 -m venv env;
        source env/bin/activate;
        pip install -r requirements.txt;
        ~~~~
        
        ### Running Tests
        
        When inside of the python virtual enviorment:
        ~~~~
        python3 -m pytest
        ~~~~
        
        ### Profiling a Test
        
        ~~~
        python3 -m cProfile -m pytest tests/test_excel.py
        ~~~
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
