textual-pyfiglet 1.1.0

A Widget implementation of PyFiglet for Textual

Textual-Pyfiglet

Textual-PyFiglet is an implementation of PyFiglet for Textual.

It provides a FigletWidget which makes it easy to add ASCII banners with colors and animating gradients.

This library is related to Rich-Pyfiglet, as well as utilizes Textual-Coloromatic to provide the Color/animation abilities.

Features

• Full integration of Pyfiglet into Textual. Change the text or the font in real time - This can be connected to user input or modified programmatically.
• Color system built on Textual's color system. Thus, it can display any color in the truecolor/16-bit spectrum, and can take common formats such as hex code and RGB, or just a huge variety of named colors.
• Make a gradient automatically between any two colors.
• Animation system that's simple to use. Just make your gradient and toggle it on/off. It can also be started or stopped in real-time.
• The auto-size mode will re-size the widget with the new rendered ASCII output in real-time. It can also wrap to the parent container and be made to resize with your terminal.
• Animation settings can be modified to get different effects. Set a low amount of colors and a low speed for a very old-school retro look, set it to a high amount of colors and a high speed for a very smooth animation.
• The fonts are type-hinted to give you auto-completion in your code editor, eliminating the need to manually check what fonts are available.
• Included demo app to showcase the features.

Demo App

If you have uv or pipx, you can immediately try the demo app:

uvx textual-pyfiglet 

pipx run textual-pyfiglet

Documentation

Click here for documentation

Video

Your browser does not support the video tag.

Questions, Issues, Suggestions?

Use the issues section for bugs or problems, and post ideas or feature requests on the TTY group discussion board.

Thanks and Copyright

Both Textual-Pyfiglet and the original PyFiglet are under MIT License. See LICENSE file.

FIGlet fonts have existed for a long time, and many people have contributed over the years.

Original creators of FIGlet:
https://www.figlet.org

The PyFiglet creators:
https://github.com/pwaller/pyfiglet

Textual:
https://github.com/Textualize/textual

And finally, thanks to the many hundreds of people that contributed to the fonts collection.