Metadata-Version: 1.1
Name: python-semantic-release
Version: 4.4.0
Summary: Automatic semantic versioning for python projects
Home-page: http://github.com/relekang/python-semantic-release
Author: Rolf Erik Lekang
Author-email: me@rolflekang.com
License: MIT
Description: python-semantic-release
        =======================
        
        Automatic semantic versioning for python projects. This is an python
        implementation of the
        `semantic-release <https://github.com/semantic-release/semantic-release>`__
        for js by Stephan Bönnemann. If you find this topic interesting you
        should check out his `talk from JSConf
        Budapest <https://www.youtube.com/watch?v=tc2UgG5L7WM>`__.
        
        |Build status| |PyPI version|
        
        Install
        -------
        
        ::
        
            pip install python-semantic-release
        
        Usage
        -----
        
        The general idea is to have some sort of tag in commit messages that
        indicates certain types of changes. If a commit message lack a tag it is
        ignored. Running release can be run locally or from a CI service.
        
        ::
        
            Usage: semantic-release [OPTIONS] COMMAND
        
            Options:
              --major  Force major version.
              --minor  Force minor version.
              --patch  Force patch version.
              --noop   No-operations mode, finds the new version number without changing it.
              --post   If used with the changelog command, the changelog will be posted to the release api.
              --retry  Retry the same release, do not bump.
              --help   Show this message and exit.
        
        Commands
        ~~~~~~~~
        
        -  ``version`` - Create a new release. Will change the version, commit
           it and tag it.
        -  ``publish`` - Runs version before pushing to git and uploading to
           pypi.
        -  ``changelog`` - Generates the changelog for the next release.
        
        Running commands from setup.py
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Add the following to your setup.py and you will be able to run
        ``python setup.py <command>`` as you would
        ``semantic-release <command>``.
        
        .. code:: python
        
            try:
                from semantic_release import setup_hook
                setup_hook(sys.argv)
            except ImportError:
                pass
        
        Configuration
        ~~~~~~~~~~~~~
        
        Configuration belongs in ``semantic_release`` section of the setup.cfg
        file in your project. Details about configuration options can be found
        in `the configuration
        documentation <http://python-semantic-release.readthedocs.org/en/latest/configuration.html>`__.
        
        
        Development
        ~~~~~~~~~~~
        
        Install this module and the development dependencies:
        
        ::
        
            python setup.py develop
            pip install -r requirements/dev.txt
        
        Testing
        ~~~~~~~
        
        To test your modifications locally:
        
        ::
        
            tox
        
        
        .. |Build status| image:: https://circleci.com/gh/relekang/python-semantic-release/tree/master.svg?style=svg
            :target: https://circleci.com/gh/relekang/python-semantic-release/tree/master
        .. |PyPI version| image:: https://badge.fury.io/py/python-semantic-release.svg
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
