Metadata-Version: 1.1
Name: argparse-color-formatter
Version: 1.2.1
Summary: 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.
Home-page: https://github.com/arrai-innovations/argparse-color-formatter/
Author: Arrai Innovations
Author-email: support@arrai.com
License: LICENSE
Description: # argparse-color-formatter
        A [`formatter_class` for `argparse`](https://docs.python.org/3/library/argparse.html#formatter-class) 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.
        
        > ![That script's help text is so cool...](/acf.png "That script's help text is so cool...")
        
        | Branch | Build Status | Coverage Status |
        | ------ | ------------ | --------------- |
        | master | [![Build Status](https://semaphoreci.com/api/v1/arrai-innovations/argparse-color-formatter/branches/master/shields_badge.svg)](https://semaphoreci.com/arrai-innovations/argparse-color-formatter) | [![Coverage Status](https://docs.arrai-dev.com/argparse-color-formatter/htmlcov_master/coverage.svg)](https://docs.arrai-dev.com/argparse-color-formatter/htmlcov_master/) |
        | develop | [![Build Status](https://semaphoreci.com/api/v1/arrai-innovations/argparse-color-formatter/branches/develop/shields_badge.svg)](https://semaphoreci.com/arrai-innovations/argparse-color-formatter) | [![Coverage Status](https://docs.arrai-dev.com/argparse-color-formatter/htmlcov_develop/coverage.svg)](https://docs.arrai-dev.com/argparse-color-formatter/htmlcov_develop/) |
        
        ## Install
        
        ```shell
        $ pip install argparse-color-formatter
        ```
        
        ## Usage
        
        Pass in `argparse_color_formatter.ColorHelpFormatter` to a new argument parser as `formatter_class`
        
        ```python
        import argparse
        from argparse_color_formatter import ColorHelpFormatter
        
        parser = argparse.ArgumentParser(
            formatter_class=ColorHelpFormatter
        )
        ```
        
        ## Before & After
        ANSI colour escapes using the default `HelpFormatter`:
        ![before screenshot](/before.png)
        
        ANSI colour escapes using this libraries new `ColorHelpFormatter`:
        ![after screenshot](/after.png)
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: License :: OSI Approved :: BSD License
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
