ansiconverter 2.0.0

Description:

ansiconverter 2.0.0

🌀 ANSI Converter

Convert any colour to the ANSI format to write in colours in your terminal.
⌨️ Installation
Run this command to install ansiconverter:
python -m pip install -U ansiconverter

To install for development:
git clone https://github.com/thomassamoth/ansiconverter.git

cd ansiconverter

pip install -e .[dev]

Tests
To ensure the installation of this package has been successful, you can run the tests.

Make sure you have installed the pytest module. Otherwise, run:

pip install pytest


After you downloaded the code and installed the package, run the tests by executing:

python -m pytest test/

 💻 Usage
Converter module

⚠️ Warning
Some colour combinations between background and foreground are incompatible. The result can be slightly different from what is expected.


Convert from RGB colour to ANSI
# How to print a green text on a white background
from ansiconverter import RGBtoANSI
print(RGBtoANSI(text='Green text on a white background',foregound=[0, 255, 0], background=[255, 255, 255]))

Result:
Result:




Convert from hexadecimal to ANSI

# How to print a yellow text on a navy blue background, with hexadecimal values.
from ansiconverter import HEXtoANSI
print(HEXtoANSI('Some yellow text on blue background','#fdf31f', '000080'))

Result:
Result:



ℹ️ Note
Another little tool has been added to convert RGB to hexadecimal and vice versa. It can't be used to write in color in the terminal but could be useful for other applications.



Convert from hexadecimal to RGB

from ansiconverter import HEXtoRGB
print(HEXtoRGB("#0b38c1"))

Result :
[11, 59, 193]




Convert from RGB to hexadecimal

from ansiconverter import RGBtoHEX
print(RGBtoHEX([11, 59, 193]))

Result :
"#0b3bc1"



🎨 Styles module
Several text styles are available as well. You can even combine them with colours



Style
Method




bold
bold


italic
italic


fainted
faint


underlined
underline


bold & underlined
bold_and_underline


strikethroughed
strikethrough


reversed (colours inverted)
reverse



from ansiconverter import bold

print(bold("Some text in bold"))

Replace .bold in the example with any method above to get the desired style.

Combination of colours and styles
⚗️ It is possible to combine text styles with colours by doing so:
from ansiconverter import HEXtoANSI, bold
print(bold(HEXtoANSI('A yellow text in bold','#f6cf6c')))

Result:

N.B: the order between the style and the text format isn't important and you can switch them.
print(bold(HEXtoANSI('A yellow text in bold','#f6cf6c')))


will work the same as
print(HEXtoANSI(bold('A yellow text in bold'),'#f6cf6c'))

Note
This structure of this repository is based on a talk by Mark Smith, which is available here, and its linked repository
License
This repository is licensed under the MIT license. See the LICENSE file for more information.