This module makes printing to the terminal more exciting by animating the text output. It also makes the output richer my providing access to color codes for terminal or console applicatons. You can also save routine console output to a file using the console2file module. Requires python 3.10 or later versions.
You may install it form PyPI.org using the pip command typed in your terminal.
pip install ConsolePrint
To check for terminal compatibility, run the code below.
import ConsolePrint
ConsolePrint.terminal_test()- This permits output of programs to be saved in a file. Run your code between the start and end console save functions to save the output to file. The prompt argument determines if a prompt is displayed to open the file (Windows only).
import ConsolePrint.console2file as file
from calendar import calendar
file.startConsoleSave(name="my_output")
# Saves all output between the start and end functions to filename argument
print(calendar(2023))
file.endConsoleSave(prompt=True)
# To save the output of a single function and all print logs used in the function, use the func2file decorator
@file.func2file(filename='function_output', prompt=False)
def calendar_print():
print("log 1: Printing Calendar...")
print(calendar(2024))
print("log 2: Printing finished...")
return "This output value is also saved to the file."
calendar_print()- This module permits differnt colourful print animations to be output to file. The format argument takes an ANSI escape sequences as a string. You may also modify other arguments as desired.
To view a full list of all the ANSI escape sequences in the 256-color mode and confirm if your terminal can display the output, import the package and run the code below:
import ConsolePrint
# To view available ANSI codes
ConsolePrint.ansi_codes()The following preset string values may be used instead of the ANSI escape sequences
| Format | ANSI Code | Format | ANSI Code |
|---|---|---|---|
| grey | \033[30m | italics | \033[3m |
| red | \033[31m | underscore | \033[4m |
| green | \033[32m | strike | \033[9m |
| yellow | \033[33m | double_under | \033[21m |
| blue | \033[34m | red_bg | \033[41m |
| magenta | \033[35m | green_bg | \033[42m |
| cyan | \033[36m | yellow_bg | \033[43m |
| white | \033[37m | blue_bg | \033[44m |
| bold | \033[1m | magenta_bg | \033[45m |
| italics | \033[3m | cyan_bg | \033[46m |
| default | \033[0m | white_bg | \033[47m |
Code usage:
import ConsolePrint.animate as prt
prt.printing("hello this should print letter by letter", delay=0.05, style="letter", stay=True, rev=False, format='strike')
prt.printing("hello this should print word by word but in reverse", delay=0.3, style="word", stay=True, rev=True, format='red_bg')
prt.flashprint("The entire text should flash", blinks=5, delay=0.2, stay=True, format='green')
prt.flashtext("The text in will flash", "UPPER CASE", blinks=5, index=12, delay=0.2, format='yellow')
prt.animate1("This text is animated with #", symbol="#", format='magenta')
prt.animate2("Prints letter by letter but masked with # first ", symbol="#", delay=0.05, format="\033[48;5;150m")
prt.text_box("boxed in", symbol="#", padding=True, wall=True, align='right', format='\033[48;5;4m')
prt.asteriskify('This has been asteriskified', align='center', underscore=True, format='cyan')- This adds loading animations to terminal output. The load time argument is specified as an integer in seconds.
import ConsolePrint.loading as load
load.countdown(5)
load.loading1(10)
print()
load.loading2(5, text='Scanning...')
print()
load.loading3(5)This project is given free for use and download under the MIT license.
Still undergoing enhancements.
Fork the repository and create your branch from main. Clone the repository and make your changes. Run tests and make sure they pass: python -m unittest Commit your changes and push to your branch. Create a pull request.
If you encounter any issues or have questions about the project, please contact me at [email protected].