Metadata-Version: 2.1
Name: git-punchcard
Version: 2.0.3
Summary: punchcard generator for git commit frequencies
Home-page: https://github.com/coldfix/git-punchcard
Author: Thomas Gläßle
Author-email: thomas@coldfix.de
License: Unlicense
Description: git-punchcard
        =============
        
        Simple git punchcard utility, inspired by git-punchcard-plot_ but rewritten
        for python3 with matplotlib.
        
        .. _git-punchcard-plot: https://github.com/guanqun/git-punchcard-plot
        
        |Screenshot|
        
        
        Installation
        ~~~~~~~~~~~~
        
        Install or upgrade from PyPI_ as follows:
        
        .. code-block:: bash
        
            pip install --user --upgrade git-punchcard
        
        Also, make sure that ``$HOME/.local/bin`` is in ``$PATH``.
        
        To avoid conflicts with other packages, I recommend installing into an
        isolated environment, e.g. using pipx_:
        
        .. code-block:: bash
        
            pipx install git-punchcard
        
        .. _PyPI: https://pypi.org/project/git-punchcard
        .. _pipx: https://github.com/pipxproject/pipx
        
        
        Usage
        ~~~~~
        
        Basic usage:
        
        .. code-block:: bash
        
            git punchcard
        
        Additional arguments can be specified as follows:
        
        .. code-block:: bash
        
            git punchcard [<input path>...] [<options>]
                          [--] [<log options>] [<revision range>] [-- <path>...]
        
        For more help on available options, type:
        
        .. code-block:: bash
        
            git punchcard -h            # [options]
            git help log                # [log options]
            git help gitrevisions       # [revision]
        
        
        Options
        ~~~~~~~
        
        The most common builtin options are:
        
        .. code-block:: bash
        
            # use a fixed timezone for all commits:
            git punchcard --timezone CET
            git punchcard --timezone Europe/Berlin
            git punchcard --timezone UTC+02:30
        
            # show punchcard with specified y/x axes:
            git punchcard -p year/month
            git punchcard -p wday/month
        
            # histogram with specified x axis:
            git punchcard -p /wday
        
            # set the directory of the git repository (multiple allowed):
            git punchcard /path/to/repo
        
            # analyze all repositories in ~/dev:
            git punchcard ~/dev/*/.git
        
            # read commit dates from stdin:
            git punchcard -
        
            # show a github-like punchcard plot with grid:
            git punchcard --grid
        
        By default, each commit's local timezone is used for the plot. If setting a
        fixed timezone, it should be specified in terms of the timezone name (e.g.
        ``CET`` or ``Europe/Berlin``), but can also given by `ISO 3166 country code`
        or country name (if the timezone is ambiguous we will pick the first entry).
        
        .. _ISO 3166 country code: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
        
        
        git log options
        ~~~~~~~~~~~~~~~
        
        Additionally, you can pass any options understood by ``git log`` to e.g.
        restrict the range of commits and limit to commits performed by a certain
        author:
        
        .. code-block:: bash
        
            # include only commits by specific author:
            git punchcard --author=myself
        
            # consider only only the 20 commits:
            git punchcard master~20..master
        
            # commits within a certain time frame:
            git punchcard --since="1 year ago" --until=now
        
            # show at which times a certain file/folder is usually edited:
            git punchcard --follow -- README.rst docs
        
            # show at which times, people like to merge:
            git punchcard --merges
        
        
        Advanced example
        ~~~~~~~~~~~~~~~~
        
        Track evolution of commit activity over the years:
        
        .. code-block:: bash
        
            for year in {2016..2019}; do
                git punchcard -o $year.png --title $year \
                    --since 1.1.$year --until 31.12.$year
            done
        
        
        .. resources:
        
        .. |Screenshot| image:: https://raw.githubusercontent.com/coldfix/git-punchcard/master/screenshot.png
           :target:             https://raw.githubusercontent.com/coldfix/git-punchcard/master/screenshot.png
           :alt:                Screenshot
        
        Changes
        =======
        
        2.0.3
        ~~~~~
        Date: 31.10.2019
        
        - include license file in source distribution
        
        
        2.0.2
        ~~~~~
        Date: 31.10.2019
        
        - automatic deployments
        - changes in setup and testing
        
        
        2.0.1
        ~~~~~
        Date: 26.03.2019
        
        - fix: default to current directory if no input pathes were passed by the user
        
        
        2.0.0
        ~~~~~
        Date: 26.03.2019
        
        - turn ``-C`` into positional argument, remove ``-C`` option
        - allow multiple input files
        - allow passing ``-`` and files with ``git log`` output as input files
        - remove obsolete dependency on docopt
        - allow passing country codes and names instead of timezone (using first
          available timezone in case of ambiguity)
        - match timezones case-insensitively
        - show git command and number of commits
        - show error message without traceback for common errors
        
        
        1.4.0
        ~~~~~
        Date: 26.03.2019
        
        - learn ``--period Y/X`` parameter to specify Y/X axes
        - can plot histograms by leaving one of the axes empty
        - understand ``-v`` as alias for ``--version``
        
        
        1.3.0
        ~~~~~
        Date: 21.03.2019
        
        - log options are now passed directly without ``--`` same as the other options
        - drop dependency on docopt
        
        
        1.2.0
        ~~~~~
        Date: 21.03.2019
        
        - fix setup.py exception if called without runtime dependencies
        - import pytz only if needed
        - learn a ``-C DIR`` parameter to pass the path to the git repository
        - learn a ``--version`` parameter to show the script version
        - fix error when passing options and git options at the same time
        - turn into a module and use setuptools entry_points to generate script
        
        
        1.1.0
        ~~~~~
        Date: 11.03.2019
        
        - add ``--title`` parameter
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: License :: Public Domain
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.3
Description-Content-Type: text/x-rst
