This is a python package I created in order to simplify the boiling process for displaying text in a geometrical shape drawn using characters.
The package was originally named disp
but had to be changed to display_tty
because the names disp
and display
were already taken by other packages.
The class will still remain Disp
but bindings named Display
, DispTTY
and DisplayTTY
are available.
The Preloaded version exists under: IDISP
, IDISPLAY
, IDTTY
and IDISPTTY
- Display tty
- Description
- Disclaimer
- Table of Content
- Installation
-
Usage
- Importing
- Initialising
- Calling the tree function
-
Displaying a beautified Hello World
- Hello World as a title
- Hello World as a sub title
- Hello World as a sub sub title
- Hello World as a message with adjustable delay per call
- Hello World as a message
- Hello World as a question message
- Hello World as an error message
- Hello World as a success message
- Hello World as a warning message
- Hello World as an inform message
- Change the initialisation content
- Author
- Version
pip install -U disp
Under Windows:
py -m pip install -U display_tty
Under Linux/Mac OS:
python3 -m pip install -U display_tty
from display_tty import IDTTY
The generic class is: Disp(toml_content: dict, save_to_file: bool = False, file_name: str = "text_output_run.txt", file_descriptor: any = None)
For your convenience, you can use the IDTTY
variable which is an initialised version of the class.
IDTTY.title("Hello World")
Otherwise, if you wish to initialise the class with your own parameters, you can do so like this:
from display_tty import DisplayTTY
TOML_CONF = {
'PRETTIFY_OUTPUT': True,
'PRETTY_OUTPUT_IN_BLOCS': True,
'MESSAGE_CHARACTER': '@',
'MESSAGE_ERROR_CHARACTER': '#',
'MESSAGE_INFORM_CHARACTER': 'i',
'MESSAGE_QUESTION_CHARACTER': '?',
'MESSAGE_SUCCESS_CHARACTER': '/',
'MESSAGE_WARNING_CHARACTER': '!',
'SUB_SUB_TITLE_WALL_CHARACTER': '*',
'SUB_TITLE_WALL_CHARACTER': '@',
'TITLE_WALL_CHARACTER': '#',
'TREE_COLUMN_SEPERATOR_CHAR': '│',
'TREE_LINE_SEPERATOR_CHAR': '─',
'TREE_NODE_CHAR': '├',
'TREE_NODE_END_CHAR': 'â””',
'MESSAGE_ANIMATION_DELAY_BLOCKY': 0.01,
'MESSAGE_ANIMATION_DELAY': 0.01
}
SAVE_TO_FILE = False
FILE_NAME = "run_results.txt"
FILE_DESCRIPTOR = None
IDTTY = DisplayTTY(
TOML_CONF,
SAVE_TO_FILE,
FILE_NAME,
)
The generic function is:
tree(self, title: str, data: list[str], offset: int = 0)
The output is: None
TEST_DATA = {
"test_data1": "test_data1.1",
"test_data2": "test_data2.1",
"test_data3": [
"test_data_list3.1",
"test_data_list3.2",
"test_data_list3.3",
"test_data_list3.4",
"test_data_list3.5"
],
"test_data4": "test_data4.1",
"test_data5": {
"test_data5.1": "test_data5.1.1",
"test_data5.2": "test_data5.2.1",
"test_data5.3": "test_data5.3.1",
"test_data5.4": "test_data5.4.1"
},
"test_data6": [
{
"test_data6.1": "test_data6.1.1",
"test_data6.2": "test_data6.2.1"
},
[
"test_data_list6.3.1",
"test_data_list6.3.1",
"test_data_list6.3.1",
"test_data_list6.3.1"
]
],
"test_data7": {
"test_data7.1": {
"test_data7.1.1": "test_data7.1.1.1",
"test_data7.1.2": "test_data7.1.2.1"
},
"test_data7.2": [
"test_data7.2.1",
"test_data7.2.2",
"test_data7.2.3",
"test_data7.2.4",
"test_data7.2.5"
]
}
}
IDTTY.tree("This is a test tree", TEST_DATA, 0)
The generic function to display Hello World!
as a title is:
title(self, title)
The outputs is: None
IDTTY.title("Hello World !")
The generic function to display Hello World!
as a sub title is:
sub_title(self, sub_title)
The outputs is: None
IDTTY.sub_title("Hello World !")
The generic function to display Hello World!
as a sub sub title is:
sub_sub_title(self, sub_sub_title)
The outputs is: None
IDTTY.sub_sub_title("Hello World !")
The generic function to display Hello World!
as a message is:
animate_message(self, message: str = "Hello World!", delay: float = 0.02)
The outputs is: None
IDTTY.animate_message("Hello World !", 0.01)
The generic function to display Hello World!
as a message is:
message(self, message:str)
The outputs is: None
IDTTY.message("Hello World !")
The generic function to display Hello World!
as a question message is:
question_message(self, message: str)
The outputs is: None
IDTTY.question_message("Hello World !")
The generic function to display Hello World!
as an error message is:
error_message(self, message: str)
The outputs is: None
IDTTY.error_message("Hello World !")
The generic function to display Hello World!
as a success message is:
success_message(self, message: str)
The outputs is: None
IDTTY.success_message("Hello World !")
The generic function to display Hello World!
as a warning message is:
warning_message(self, message: str)
The outputs is: None
IDTTY.warning_message("Hello World !")
The generic function to display Hello World!
as an inform message is:
append_run_date(self)
The outputs is: None
IDTTY.append_run_date()
The generic function to display the current date as a title is:
inform_message(self, message: list)
The outputs is: None
IDTTY.inform_message("Hello World !")
When initialising the class it is possible to change the animation behaviour by editing the TOML_CONF
that you must provide when initialising the class.
During the initialisation it is also possible to redirect the output to a file instead of displaying it on the terminal. For this, please set the save_to_file
to True
and either:
-
provide a file name in
file_name
-
provide a file descriptor in
file_descriptor
If you provided a file_name
, the file will automatically be opened
However, in both cases, you will need to close the file by calling the function close_file
(i.e. at the end of your program)
This is the arguments that are required in the TOML
file:
1 | PRETTIFY_OUTPUT: True,
2 | PRETTY_OUTPUT_IN_BLOCS: True,
3 | MESSAGE_CHARACTER: '@',
4 | MESSAGE_ERROR_CHARACTER: '#',
5 | MESSAGE_INFORM_CHARACTER: '!',
6 | MESSAGE_QUESTION_CHARACTER: '?',
7 | MESSAGE_SUCCESS_CHARACTER: '/',
8 | MESSAGE_WARNING_CHARACTER: '?',
9 | SUB_SUB_TITLE_WALL_CHARACTER: '*',
10 | SUB_TITLE_WALL_CHARACTER: '@',
11 | TITLE_WALL_CHARACTER: '#',
12 | TREE_COLUMN_SEPERATOR_CHAR: '│',
13 | TREE_LINE_SEPERATOR_CHAR: '─',
14 | TREE_NODE_CHAR: '├',
15 | TREE_NODE_END_CHAR: 'â””',
16 | MESSAGE_ANIMATION_DELAY_BLOCKY: 0.01,
17 | MESSAGE_ANIMATION_DELAY: 0.01
PS: I've added line numbers <number> |
to help you track the analysis of the file, these are generally added automatically by your code editor.
Thats a big file, lets break it down together:
PRETTIFY_OUTPUT: True
This option is a crucial pivot for the program.
If:
-
True
: The program will output the content letter by letter while waiting a specified delay -
False
: It will print out all of your messages at once without waiting any delay
PRETTY_OUTPUT_IN_BLOCS: True
This option is an optimisation for the program.
If:
-
True
: The program will:- Extract the words from the input
- output the content word by word while waiting a specified delay and respecting spacing
-
False
: It will print out all of your messages at once without waiting any delay
MESSAGE_CHARACTER: '@'
This is a customisation, it allows you to specify the characther to use when displaying a message.
MESSAGE_ERROR_CHARACTER: '#'
This is a customisation, it allows you to specify the characther to use when displaying an error message.
MESSAGE_INFORM_CHARACTER: '!'
This is a customisation, it allows you to specify the characther to use when displaying an inform message.
MESSAGE_QUESTION_CHARACTER: '?'
This is a customisation, it allows you to specify the characther to use when displaying a question message.
MESSAGE_SUCCESS_CHARACTER: '/'
This is a customisation, it allows you to specify the characther to use when displaying a success message.
MESSAGE_WARNING_CHARACTER: '?'
This is a customisation, it allows you to specify the characther to use when displaying a warning message.
SUB_SUB_TITLE_WALL_CHARACTER: '*'
This is a customisation, it allows you to specify the characther to use when displaying a sub sub title.
SUB_TITLE_WALL_CHARACTER: '@'
This is a customisation, it allows you to specify the characther to use when displaying a sub title.
TITLE_WALL_CHARACTER: '#'
This is a customisation, it allows you to specify the characther to use when displaying a title.
TREE_COLUMN_SEPERATOR_CHAR: '│'
This is the character used by the tree function to indicate the indentation level
i.e:
│ ├─── my_file
TREE_LINE_SEPERATOR_CHAR: '─'
This is the character used by the tree function to indicate the file/folder of the current line
i.e:
├─── my_file
TREE_NODE_CHAR: '├'
This is the character used by the tree function to indicate the directory level to wich the file/directory is linked but that this is not the last file/directory.
i.e:
├─── my_file
TREE_NODE_END_CHAR: 'â””'
This is the character used by the tree function to indicate the directory level to wich the file/directory is linked but that this is the last file/directory.
i.e:
└─── my_file
MESSAGE_ANIMATION_DELAY_BLOCKY: 0.01
Specify the delay between each word placement. (min: 0)
PS: if you enter 0, this is like setting PRETTY_OUTPUT_IN_BLOCS
to False
MESSAGE_ANIMATION_DELAY: 0.01
This variable is a pivot point for the program.
Specify the delay between each word placement. (min: 0)
PS: if you enter 0, this is like setting PRETTY_OUTPUT_IN_BLOCS
to False
If the default initialisation, or the class you previously initialised has some elements you would like to update, you can do so by calling the inner variables.
Here are the variables you might be interested in:
from display_tty import IDTTY
IDTTY.title_wall_chr # string (length 1): i.e.: '#'
IDTTY.sub_title_wall_chr # string (length 1): i.e.: '@'
IDTTY.sub_sub_title_wall_chr # string (length 1): i.e.: '*'
IDTTY.message_char # string (length 1): i.e.: '@'
IDTTY.message_error_char # string (length 1): i.e.: '#'
IDTTY.message_success_char # string (length 1): i.e.: '/'
IDTTY.message_inform_char # string (length 1): i.e.: 'i'
IDTTY.message_warning_char # string (length 1): i.e.: '!'
IDTTY.message_question_char # string (length 1): i.e.: '?'
IDTTY.message_animation_delay # float: i.e.: # 0.01
IDTTY.tree_node_char # string (length 1): i.e.: '├'
IDTTY.tree_node_end_char # string (length 1): i.e.: 'â””'
IDTTY.tree_line_seperator_char # string (length 1): i.e.: '─'
IDTTY.tree_column_seperator_char # string (length 1): i.e.: '│'
IDTTY.save_to_file # True or False
IDTTY.toml_content["PRETTIFY_OUTPUT"] # True of False
IDTTY.toml_content["PRETTY_OUTPUT_IN_BLOCS"] # True of False
To update a variable, simply assing it a new value, like in this example: IDTTY.title_wall_chr = "&"
PS: These changes only apply to the class you loaded, any others will not be touched.
This module was written by (c) Henry Letellier Attributions are appreciated.
Quick way:
print(f"AskQuestion is written by {IDTTY.author}")
The current version is 1.0.0
An easy way to display the version is:
import display_tty as IDTTY
print(f"Version : {IDTTY.__Version__}")