Metadata-Version: 1.1
Name: issue2branch
Version: 0.0.1
Summary: A feature branch namer / Issue tracker manager
Home-page: https://github.com/pignacio/issue2branch
Author: Ignacio Rossi
Author-email: rossi.ignacio@gmail.com
License: GPLv3
Description: issue2branch
        ============
        
        A helper for naming feature branches with git
        
        This app fetches issue titles from different issue trackers, and checkouts
        feature branches with nice names.
        
        ```
        pignacio/issue2branch ‹master› % issue2branch 4
        Getting issue title for issue: '4'
        Requesting 'https://api.github.com/repos/pignacio/issue2branch/issues/4'
        Got title: 'Issue 4 Write README'
        Branching 'issue-4-write-readme'
        pignacio/issue2branch ‹issue-4-write-readme› %
        ```
        
        ##Installation
        
        At the time of this writing, `GitPython` fails to install correctly, as only
        beta and RC version are listed in PyPI after 0.3.0, and, for example,
        `GitPython==0.3.1-beta2` installs as `0.3.1`.
        
        The easiest way I found to get away from this is installing `GitPython` by hand
        before `issue2branch`, and ensure a version `>=0.3.1`.
        
        ```
        pip install GitPython==0.3.1-beta2
        pip install issue2branch
        ```
        
        ##Usage
        
        ```
        issue2branch --list          # -l/--list show the current open issues
        issue2branch <issue>         # Fetch the <issue> title and checkout a branch
        issue2branch <issue> --take  # Additionally, set yourself as the assignee, when
                                     # possible
        issue2branch <issue> --noop  # -n/--noop runs dry (without making changes)
        ```
        
        ###Additional redmine usages
        
        Redmine supports additional parameters:
        
        ```
        issue2branch --list --mine       # -m/--mine shows only tickes assigned to you
        issue2branch --list -v <version> # -v/--version filters by target version
        issue2branch --list --all        # List all (including closed) issues
        ```
        
        ##Supported issue trackers
        
        * [Github](http://www.github.com) and [Bitbucket](http://www.bitbucket.org)
          public issue trackers are supported out of the box. For private ones, auth
          tokens must be added.
        * [Redmine](http://www.redmine.org)
        
        ##Configuration
        
        The configuration file default location is `<git repo
        root>/.issue2branch.config`, and can be overriden via the `ISSUE2BRANCH_CONFIG`
        enviroment variable.
        
        The file follows the `ConfigParser` format and has the following sections:
        
        ```
        [main]
        tracker = issue tracker type. one of redmine, github, bitbucket.
                  Github and Bitbucket are detected automatically based on the origin
                  remote hostname
        
        [auth]
        user = HTTP authentication user
        password = HTTP authentication password, if missing when user is present, a
                   prompt will ask for it each time issue2branch is run
        
        [redmine] # Redmine specific config
        url = url where the issue tracker is located
        inprogress_id = Internal redmine ID for the "In progress" status. Needed for
                        --take
        assignee_id = Internal redmine ID for the assignee. Needed for --take
        list_limit = number of issues to retrieve when listing. Defaults to 40
        
        [github] # Github specific config
        repo_user = the owner of the issue tracker. Useful for overriding real owner
                    when working on a fork. Defaults to origin's owner
        repo_name = name of the remote repo. Defaults to origins's name
        
        [bitbucket] # Bitbucket specific config
        repo_user = the owner of the issue tracker. Useful for overriding real owner
                    when working on a fork. Defaults to origin's owner
        repo_name = name of the remote repo. Defaults to origins's name
        ```
        
        
        
Keywords: issue branch name tracker
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
