Font Awesome Integration#

PyWaffle installs Font Awesome free version automatically as a dependent package. The package it is trying to install is the latest version of fontawesomefree.

If you would like to upgrade or downgrade fontawesomefree, and use the specific version within PyWaffle, you can upgrade fontawesomefree and then reinstall pywaffle. In commands, that is:

# Either upgrade to the latest, or specify a version number
pip install --upgrade fontawesomefree
# OR
pip install fontawesomefree==6.1.1

# Then reinstall pywaffle
pip install --force-reinstall --no-deps pywaffle

Option --force-reinstal ensures icon mapping file in the package would be regenerated, and option --no-deps avoid package fontawesomefree being upgraded to unexpected version.

To validate the upgrade, you may check the version number at the first line of the icon mapping file. The file path is <PYTHON_LIB>/pywaffle/fontawesome_mapping.py. The line should be something like:

# For Font Awesome version: 6.1.1

For how to use Font Awesome with PyWaffle, please visit Plot with Characters or Icons.