Metadata-Version: 1.1
Name: git-ls-date
Version: 0.1.1
Summary: git-ls-date is git sub command shows first and last commit date.
Home-page: https://github.com/ton1517/git-ls-date
Author: ton1517
Author-email: tonton1517@gmail.com
License: MIT License
Description: git-ls-date
        ===========
        git-ls-date is git sub command shows first and last commit date.
        
        Examples
        ========
        
        Basic
        ------
        default option is
        
        - date = short
        - format = "{fd} {fh}  {ld} {lh}  {f}"
        
        ::
        
            $ git ls-date
            2013-11-05 7ab1b16  2013-11-05 7ab1b16  README.rst
            2013-11-07 342ad26  2013-11-10 2826492  git_ls_date.py
        
        How long ago?
        ------------------
        ::
        
            git ls-date --date relative --format "first commit is {fd: <20} | {f}"
            first commit is 6 days ago           | .gitignore
            first commit is 3 days ago           | .python-version
            first commit is 3 days ago           | LICENSE
            first commit is 77 minutes ago       | MANIFEST.in
            first commit is 6 days ago           | README.rst
            first commit is 3 days ago           | git_ls_date.py
            first commit is 3 days ago           | setup.py
            first commit is 3 days ago           | test_git_ls_date.py
            first commit is 30 hours ago         | testfiles/testdirectory/testfile4
            first commit is 30 hours ago         | testfiles/testfile1
            first commit is 30 hours ago         | testfiles/testfile2
            first commit is 30 hours ago         | testfiles/testfile3
            first commit is 3 days ago           | tox.ini
        
        Only show commit hash
        ----------------------
        ::
        
            $ git ls-date --format="{lh} {f}
            7ab1b16 README.rst
            2826492 git_ls_date.py
        
        Sort files by last commit date
        -------------------------------
        ::
        
            $ git ls-date --date iso --format "{ld} {f}" | sort
            2013-11-05 04:40:11 +0900 .gitignore
            2013-11-05 04:40:11 +0900 README.rst
            2013-11-07 23:22:29 +0900 setup.py
            2013-11-07 23:34:59 +0900 LICENSE
            2013-11-08 15:36:16 +0900 .python-version
            2013-11-09 15:07:06 +0900 testfiles/testdirectory/testfile4
            2013-11-09 19:11:38 +0900 testfiles/testfile2
            2013-11-09 19:11:38 +0900 testfiles/testfile3
            2013-11-09 21:03:55 +0900 testfiles/testfile1
            2013-11-09 22:22:38 +0900 tox.ini
            2013-11-10 15:32:19 +0900 test_git_ls_date.py
            2013-11-10 18:28:24 +0900 git_ls_date.py
            2013-11-10 19:45:40 +0900 MANIFEST.in
        
        Requirements
        ============
        
        - Python 2.6 / 2.7 / 3.2 / 3.3 or higher
        
        I'm testing with 2.6.8, 2.7.5, 3.2.5, 3.3.2.
        
        Installation
        ============
        
        Install from pypi
        -----------------
        ::
        
            easy_install git-ls-date
        
        or
        
        ::
        
            pip install git-ls-date
        
        Install from github
        -------------------
        ::
        
            git clone https://github.com/ton1517/git-ls-date.git
            cd git-ls-date
            python setup.py install
        
        Manual setup
        ------------
        1. Copy git_ls_date.py to a directory that is in your PATH.
        2. Rename it to git-ls-date.
        3. Change it to executable.
        
        ::
        
            cd ~/bin
            wget https://raw.github.com/ton1517/git-ls-date/master/git_ls_date.py -O git-ls-date
            chmod +x git-ls-date
        
        Usage
        =====
        Usage:
            ::
        
              git ls-date [--date=<option>] [--format=<format>] [<path>]...
              git ls-date -h | --help
              git ls-date -v | --version
        
        Options:
            ::
        
              -h --help                                             Show help.
              -v --version                                          Show version.
              -d --date=(relative|local|default|iso|rfc|short|raw)  Date option.(default: short)
              -f --format=<format>                                  Show-format option. See SHOW FORMAT.(default: "{fd} {fh}  {ld} {lh}  {f}")
        
        SHOW FORMAT:
            format option allows you to specify which information you want to show.
        
            placeholders:
                * {ld}: last commit date
                * {fd}: first commit date
                * {lh}: last commit hash
                * {fh}: first commit hash
                * {f}:  filename
        
            for example:
                ::
        
                    $ git ls-date --date=local --format="{fd} {fh}  {ld} {lh}  {f}" ./README.rst
                    Tue Nov 5 04:40:11 2013 7ab1b16  Tue Nov 5 04:40:11 2013 7ab1b16  README.rst
        
            You can see more format spec to http://docs.python.org/3/library/string.html?highlight=string.format#formatspec
        
        Gitconfig
        =========
        You can write option in .gitconfig
        
        for example:
            ::
        
                [git-ls-date]
                    date = relative
                    format = {lh} {ld: <25} {f}
        
            ::
        
                $ git ls-date
                7ab1b16 6 days ago                  README.rst
                2826492 2 hours ago                 git_ls_date.py
        
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Utilities
