Metadata-Version: 1.1
Name: proj
Version: 0.1.0
Summary: A command-line folder manager for many projects.
Home-page: https://github.com/larsyencken/proj
Author: Lars Yencken
Author-email: lars@yencken.org
License: BSD
Description: ===============================
        proj
        ===============================
        
        .. image:: https://badge.fury.io/py/proj.png
            :target: http://badge.fury.io/py/proj
        
        .. image:: https://travis-ci.org/larsyencken/proj.png?branch=master
                :target: https://travis-ci.org/larsyencken/proj
        
        .. image:: https://pypip.in/d/proj/badge.png
                :target: https://pypi.python.org/pypi/proj
        
        
        A command-line folder manager for archiving old projects.
        
        * Free software: BSD license
        * Documentation: https://proj.readthedocs.org.
        
        ``proj`` assumes the following working setup:
        
        - You have a directory of active projects that you're working on (e.g. ~/Projects)
        - You have a directory of inactive projects, your archive (e.g. ~/Archive)
        
        Given this setup, ``proj`` helps you add and remove projects from your archive, and keeps your archive organised in ``<year>/<quarter>`` subfolders, based on when each project was last worked on.
        
        Installation
        ------------
        
        Install the package with pip:
        
        .. code:: console
        
            pip install git+git://github.com/larsyencken/proj
        
        Then, tell ``proj`` where your archive directory is, by adding a line to your ``.bashrc`` or ``.zshrc`` file:
        
        .. code:: console
        
            export PROJ_ARCHIVE=~/Archive
        
        Usage
        -----
        
        Use proj to get rid of clutter in your main directory of projects by archiving ones that aren't being worked on. Proj will detect when you last made a change and file it accordingly.
        
        .. code:: console
        
            $ ls
            cocktails-that-are-blue   news-for-llamas   old-crusty-project
            $ proj archive old-crusty-project
            old-crusty-project -> /Users/lars/Archive/2012/q3/old-crusty-project
            $ ls
            cocktails-that-are-blue   news-for-llamas
            $ proj list
            2012/q3/old-crusty-project
        
        Now we've archived this project, but we can restore it at any time.
        
        .. code:: console
        
            $ proj restore old-crusty-project
            /Users/lars/Archive/2012/q3/old-crusty-project -> old-crusty-project
            $ ls
            cocktails-that-are-blue   news-for-llamas   old-crusty-project
        
        Features
        --------
        
        * ``proj archive``: archive a project to an appropriate directory
        * ``proj restore``: restore a project from the archive
        * ``proj list``: search the archive for a project
        
        
        
        
        History
        -------
        
        0.1.0 (2014-01-11)
        ---------------------
        
        * First release on PyPI.
        * Archive, restore and search features.
        
Keywords: proj
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
