eRCaGuy-PyColors 0.1.2

A Python module to add ANSI color and format codes to strings for terminal output

eRCaGuy_PyColors

For text formatting and colorization in the terminal.

A Python module to add ANSI color and format codes to strings for terminal output.

Installation

Upgrade pip first (optional but recommended):

pip install --upgrade pip
# or (more explicit)
python3 -m pip install --upgrade pip

Install from PyPI:

pip install eRCaGuy_PyColors

Or install from source:

git clone https://github.com/ElectricRCAircraftGuy/eRCaGuy_PyColors.git
cd eRCaGuy_PyColors
pip install .

For development (editable install):

pip install -e .

To install into a virtual environment:

# Create and activate a virtual environment
python3 -m venv ~/venvs/eRCaGuy_PyColors
. ~/venvs/eRCaGuy_PyColors/bin/activate

# To see if you're in a virtual environment, run:
echo "$VIRTUAL_ENV"
# If in a virtual environment, this will print the path to the virtual environment.
# Otherwise, it will print nothing.

# Now install as above. Ex: 
# Option 1: install from PyPI:
pip install eRCaGuy_PyColors
# Option 2: install from source: 
# - Inside of the `eRCaGuy_PyColors` repo: 
pip install .

Example usage in your Python program

# Recommended import style
import eRCaGuy_PyColors as colors
# OR (older style): 
# import eRCaGuy_PyColors.ansi_colors as colors

print(f"{colors.FGR}This text is green.{colors.END}")
print(f"{colors.FBB}This text is bright blue.{colors.END}")
print(f"{colors.FBR}This text is bright red.{colors.END}")

colors.print_green("This text is green.")
colors.print_blue("This text is bright blue.")
colors.print_red("This text is bright red.")
colors.print_yellow("This text is bright yellow.")

Test and run this program

Run the built-in tests:

python3 -m eRCaGuy_PyColors

Example run and output:

eRCaGuy_PyColors$ ./ansi_colors.py 
This text is green.
This text is bright blue.
This text is bright red.
This text is bright red.
This text is bright red.
This text is bright red.
This text is
  bright red.
This text is bright yellow.
This text is not colored.
This text is bright yellow again.
This text is green.

Screenshot:

Publishing to PyPI

See:

1. https://packaging.python.org/en/latest/tutorials/packaging-projects/
2. https://packaging.python.org/en/latest/guides/writing-pyproject-toml/

For maintainers, to publish a new version to PyPI:

Short version

./deploy.sh

Details

1. Install or upgrade twine:

   python3 -m pip install --upgrade twine build
   

2. Update the version number in eRCaGuy_PyColors/__init__.py.

   NB: no new changes will be deployed to PyPI if the version number in eRCaGuy_PyColors/__init__.py has not been changed since the last upload.

3. Clean the old build.

   Updating the version number above, plus cleaning the old build like this, are both required to ensure a successful new upload to PyPI.

   rm -rf dist/ build/ *.egg-info
   

4. Build the distribution packages according to the settings in pyproject.toml:

   time python3 -m build
   

5. Obtain a PyPI API token:

   1. Log into your PyPI account.
   2. Go to https://test.pypi.org/manage/account/#api-tokens, setting the “Scope” to “Entire account”. Don’t close the page until you have copied and saved the token — you won’t see that token again.

6. Test an upload to TestPyPI first (recommended):

   1. Obtain an API token at https://test.pypi.org/manage/account/#api-tokens --> "Add API token" --> (Activate two-factor authentication, if not yet done, to enable token generation.) --> Set "Token name" to Gabriel TestPyPI (using your name); set "Scope" to Entire account (all projects) --> click "Create token". Follow the instructions there. ie: create a ~/.pypirc file with the following contents: ~/.pypirc:

      [testpypi]
      username = __token__
      password = <your TestPyPI API token here, without the angle brackets>
      
      [pypi]
      username = __token__
      password = <your PyPI API token here, without the angle brackets>
      

      Paste your TestPyPI API token into the password field under [testpypi], and save the file.
   2. Upload

      python3 -m twine upload --repository testpypi dist/*
      

7. Test an installation in a virtual environment from TestPyPI:

   python3 -m venv ~/venvs/test_eRCaGuy_PyColors
   . ~/venvs/test_eRCaGuy_PyColors/bin/activate
   pip install --index-url https://test.pypi.org/simple/ --no-deps eRCaGuy_PyColors
   

   Test that it works as expected.

8. Upload to PyPI using twine:

   1. Obtain an API token at https://pypi.org/manage/account/#api-tokens --> "Add API token" --> (Activate two-factor authentication, if not yet done, to enable token generation.) --> Set "Token name" to Gabriel PyPI (using your name); set "Scope" to Entire account (all projects) --> click "Create token". Follow the instructions there. ie: update your ~/.pypirc file by pasting in your token under the [pypi] section as shown above.
   2. Upload

      python3 -m twine upload dist/*
      

9. Test an installation in a virtual environment from PyPI:

   python3 -m venv ~/venvs/eRCaGuy_PyColors
   . ~/venvs/eRCaGuy_PyColors/bin/activate
   pip install eRCaGuy_PyColors
   

   Test that it works as expected.

References

1. Borrowed from my file here: https://github.com/ElectricRCAircraftGuy/eRCaGuy_hello_world/blob/master/python/pandas_dataframe_iteration_vs_vectorization_vs_list_comprehension_speed_tests.py
2. https://github.com/ElectricRCAircraftGuy/eRCaGuy_hello_world/blob/master/python/ansi_colors.py
3. https://github.com/ElectricRCAircraftGuy/eRCaGuy_PathShortener/blob/main/ansi_colors.py <==
4. My Bash ANSI format library here: https://github.com/ElectricRCAircraftGuy/eRCaGuy_hello_world/blob/master/bash/ansi_text_format_lib.sh
5. https://en.wikipedia.org/wiki/ANSI_escape_code#3-bit_and_4-bit