Metadata-Version: 2.1
Name: ansiconverter
Version: 0.0.1
Summary: Convert any color in RGB or hexadecimal format to ANSI code
Home-page: https://github.com/thomassamoth/ansiconverter
Author: Thomas Beyet
Author-email: 
License: UNKNOWN
Description: # ansiconverter  
        
        Convert any color to the ANSI format to write in colors in your terminal.
        
        ## Installation
        
        Run this command to install ansiconverter:
        
        ```python
        pip install ansiconverter
        ```
        
        ##  Usage
        
        ### Converter module
        
        #### Convert any RGB color to ANSI
        
        ```python
        # How to print a green text on a white background
        from ansiconverter import converter as cv
        
        print(f"{cv.RGBtoANSI(foregound=[0, 255, 0], background=[255, 255, 255])}Green text on white background{cv.RESET}")
        
        # Alternative
        duo = cv.RGBtoANSI(foregound=[0, 255, 0], background=[255, 255, 255])
        
        print(f"{duo} Another green text on white bg {cv.RESET}")
        
        ```
        
        #### Convert any hexadecimal color to ANSI  
        
        > **Warning**: no background color available for now
        
        ```python
        # How to print a yellow text with its hexadeciaml value
        from ansiconverter import converter as cv
        
        print(f"{cv.HEXtoANSI('#f6cf6c')}Some yellow text{cv.RESET}")
        
        ```
        
        ### Styles module
        
        Write your text in different styles :
        
        * bold
        * italic
        * faint
        * underlined
        * bold & underlined
        * strikethrough
        * reversed
        
        ```python
        
        from ansiconverter import styles
        
        print(styles.bold("Some text in bold"))
        ```
        
        ### Combination of colors and styles
        
        It is possible to combine text styles with colors by doing so:
        ```python
        from ansiconverter import converter, styles
        
        yellow = converter.HEXtoANSI('#f6cf6c')
        
        print(styles.bold(yellow)+"Some yellow text in bold"+RESET)
        ```
        
        You can replace `styles.bold()` by any function mentionned [above](#styles-module) i.e. `styles.italic()`.
        
        ## Additional features
        
        You can also use RGB to HEX converter or HEX to RGB by themselves like this:
        ``` python
        >>>from ansiconverter import converter
        
        >>> print(converter.HEXtoRGB("#0b38c1"))
        [11, 59, 193])
        
        >>> print(converter.RGBtoHEX([11, 59, 193]))
        "#0b3bc1"
        ```
        
        * * *
        
        **Note:** This repository is based on [Mark Smith](https://github.com/judy2k)'s talk available [here](https://youtu.be/GIF3LaRqgXo) and its [linked repository](https://github.com/judy2k/publishing_python_packages_talk)
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Provides-Extra: dev
