Metadata-Version: 1.1
Name: hubugs
Version: 0.14.0
Summary: Simple client for GitHub issues
Home-page: https://github.com/JNRowe/hubugs
Author: James Rowe
Author-email: jnrowe@gmail.com
License: GPL-3
Description: hubugs - Simple client for GitHub issues
        ========================================
        
        Introduction
        ------------
        
        ``hubugs`` is a very simple client for working with `GitHub's issue tracker`_.
        
        .. important::
        
           This package is in a *rapid* state of flux right now, as support for version
           3 of the `GitHub API`_ is added.  Be aware there may be some significant
           changes to the user interface coming soon!
        
        Requirements
        ------------
        
        ``hubugs`` requires Python_ v2.6 or above.  ``hubugs``'s mandatory
        dependencies outside of the standard library are argh_, blessings_, html2text_,
        httplib2_, Jinja_, micromodels_ and Pygments_.
        
        Configuration
        -------------
        
        Before ``hubugs`` can operate on issues you must generate an OAuth_ token.
        ``hubugs`` provides functionality to do this::
        
            $ hubugs setup
            GitHub user? [JNRowe]
            GitHub password? <password>
            Support private repositories? (Y/n) y
            Configuration complete!
        
        .. note::
        
           You can revoke the generated token at any time from the `GitHub settings`_
           page.
        
        If you wish to set the authorisation token from the command line you can use the
        ``HUBUGS_TOKEN`` environment variable.  For example::
        
            $ HUBUGS_TOKEN=xxx hubugs open
        
        Contributors
        ------------
        
        I'd like to thank the following people who have contributed to
        ``hubugs``.
        
        Patches
        '''''''
        
        * Ben Griffiths
        * Matt Leighton
        
        Bug reports
        '''''''''''
        
        * Brandon Cady
        * Sorin Ionescu
        
        Ideas
        '''''
        
        * James Gray
        * Jules Marleau
        
        If I've forgotten to include your name I wholeheartedly apologise.  Just
        drop me a mail_ and I'll update the list!
        
        Hacking
        -------
        
        Patches and `pull requests`_ are most welcome, but I'd appreciate it if you
        could follow the guidelines below to make it easier to integrate your changes.
        These are only guidelines however, and as such can be broken if the need arises
        or you just want to convince me that your style is better.
        
        * `PEP 8`_, the style guide, should be followed where possible.
        * While support for Python versions prior to v2.6 if such a need were to arise,
          you are encouraged to use v2.6 features now
        * All new classes, methods and functions should be accompanied by new
          reStructuredText_ formatted descriptions
        * You should add tests for new functionality, and berate me for not writing
          enough tests at the outset
        * Tests *must not* span network boundaries, use of a common mocking framework is
          encouraged
        
        Bugs
        ----
        
        If you find any problems, bugs or just have a question about this package
        either file an issue_ or drop me a mail_.
        
        If you've found a problem please attempt to include a minimal testcase so
        I can reproduce the problem, or even better a patch!
        
        .. _GitHub's issue tracker: http://github.com/blog/411-github-issue-tracker
        .. _GitHub API: http://developer.github.com/v3/
        .. _Python: http://www.python.org/
        .. _argh: http://pypi.python.org/pypi/argh/
        .. _blessings: http://pypi.python.org/pypi/blessings/
        .. _Jinja: http://jinja.pocoo.org/
        .. _html2text: http://pypi.python.org/pypi/html2text/
        .. _httplib2: http://pypi.python.org/pypi/httplib2
        .. _micromodels: http://pypi.python.org/pypi/micromodels/
        .. _Pygments: http://pygments.org/
        .. _OAuth: http://oauth.net/
        .. _GitHub settings: https://github.com/settings/applications/
        .. _pull requests: http://github.com/JNRowe/hubugs/issues
        .. _PEP 8: http://www.python.org/dev/peps/pep-0008/
        .. _reStructuredText: http://docutils.sourceforge.net/rst.html
        .. _mail: jnrowe@gmail.com
        .. _issue: http://github.com/JNRowe/hubugs/issues
        
Keywords: github bugs cli
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Communications
Classifier: Topic :: Internet
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Bug Tracking
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
