argparse-color-formatter 1.1.0

a ``formatter_class`` for ``argparse`` that deals with ANSI colour escapes. Specifically, this formatter does not count escape characters as displayed characters when wrapping ``argparse``'s help text into the terminal.

.. list-table::
:header-rows: 1

* - Branch
- Build Status
- Coverage Status
* - master
-
.. image:: https://semaphoreci.com/api/v1/emergence/argparse-color-formatter/branches/master/shields_badge.svg
:target: https://semaphoreci.com/emergence/argparse-color-formatter
:alt: Build Status

-
.. image:: https://docs.emergence.com/argparse-color-formatter/htmlcov_master/coverage.svg
:target: https://docs.emergence.com/argparse-color-formatter/htmlcov_master/
:alt: Coverage Status

* - develop
-
.. image:: https://semaphoreci.com/api/v1/emergence/argparse-color-formatter/branches/develop/shields_badge.svg
:target: https://semaphoreci.com/emergence/argparse-color-formatter
:alt: Build Status

-
.. image:: https://docs.emergence.com/argparse-color-formatter/htmlcov_develop/coverage.svg
:target: https://docs.emergence.com/argparse-color-formatter/htmlcov_develop/
:alt: Coverage Status

Install
-------

.. code-block:: shell

$ pip install argparse-color-formatter

Usage
-----

Pass in ``argparse_color_formatter.ColorHelpFormatter`` to a new argument parser as ``formatter_class``

.. code-block:: python

import argparse
from argparse_color_formatter import ColorHelpFormatter

parser = argparse.ArgumentParser(
formatter_class=ColorHelpFormatter
)