Skip to main content

A Widget implementation of PyFiglet for Textual

Project description

textual-pyfiglet-banner

Textual-Pyfiglet

badge badge badge badge badge

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 the sister library of Rich-Pyfiglet.

Features

  • 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 dead 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.
  • Text can be typed or updated in real time - This can be connected to user input or modified programmatically.
  • 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, or experiment with a blend of these settings.
  • 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.

https://github.com/user-attachments/assets/c80edaa6-022d-4044-a8fc-d131e785baf9

Demo App

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

uvx textual-pyfiglet 
pipx textual-pyfiglet

Documentation

Click here for documentation

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

textual_pyfiglet-0.8.6.tar.gz (162.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

textual_pyfiglet-0.8.6-py3-none-any.whl (23.2 kB view details)

Uploaded Python 3

File details

Details for the file textual_pyfiglet-0.8.6.tar.gz.

File metadata

  • Download URL: textual_pyfiglet-0.8.6.tar.gz
  • Upload date:
  • Size: 162.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.5

File hashes

Hashes for textual_pyfiglet-0.8.6.tar.gz
Algorithm Hash digest
SHA256 91b0a453d26f51db3554cc119a34512126d4d30ee89c260975556d0e65607006
MD5 8ac15776cb1b9f5bb90d779efedc5f6d
BLAKE2b-256 e9d96df2f5142b3a254dbc0daa7f4336be85769e821c0c333b6fcdcc1c9c33a4

See more details on using hashes here.

File details

Details for the file textual_pyfiglet-0.8.6-py3-none-any.whl.

File metadata

File hashes

Hashes for textual_pyfiglet-0.8.6-py3-none-any.whl
Algorithm Hash digest
SHA256 679227787d151562132c63bb596482efbc86dbc5946eeab26c72cb29a0a1b426
MD5 74bc48c758f3d5bf5ba40e9f85af7a2e
BLAKE2b-256 822a95d596b38954ee3ee1904a7d28bcccfec7776558173cf0ad39b768988d28

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page