Provides functions for neatly printing debug information to the terminal output, well-suited for multithreaded programs.
Project description
DvG_debug_functions
Provides functions for neatly printing debug information to the terminal output, well-suited for multithreaded programs.
Supports PyQt5, PyQt6, PySide2 and PySide6.
Installation:
pip install dvg-debug-functions
API
Functions
print_fancy_traceback(err=None, back: int = 3, show_full_paths: bool = False)
Print the exception or the current regular call-stack traceback to the terminal, using ANSI color codes that mimic the IPython command shell.
- Args:
- err (Exception | str | None, optional):
When err is of type Exception, then an exception traceback will be printed. When err is of another type, then the current regular call-stack traceback will be printed.
Default: None
- back (int, optional):
Depth of the traceback to print.
Default: 3
- show_full_paths (bool, optional):
Shows the full filepath in the traceback when True, otherwise just the filename.
Default: False
Example output:
dprint(str_msg: str, ANSI_color: str = None)
‘Debug’ print a single line to the terminal with optional ANSI color codes. There is a lot of overhead using this print statement, but it is particularly well-suited for multithreaded PyQt programs where multiple threads are each printing information to the same terminal. The dprint() function ensure that each line sent to the terminal will remain as a continious single line, whereas a regular print() statement will likely result in the lines getting mixed up.
The line will be terminated with a newline character and the terminal output buffer is forced to flush before and after every print. In addition, if PyQt5 is present in the Python environment, then a mutex lock will be obtained and released again for each dprint() execution.
tprint(str_msg: str, ANSI_color: str = None)
Identical to dprint(), but now prepended with a time.perf_counter() timestamp.
Classes
class ANSI: NONE = "" RED = "\033[1;31m" GREEN = "\033[1;32m" YELLOW = "\033[1;33m" BLUE = "\033[1;34m" PURPLE = "\033[1;35m" # aka MAGENTA MAGENTA = "\033[1;35m" CYAN = "\033[1;36m" WHITE = "\033[1;37m"
Changelog
2.2.0 (2022-09-13)
Added support for PyQt5, PyQt6, PySide2 and PySide6
2.1.1 (2020-07-18)
Added flag show_full_paths to print_fancy_traceback()
2.1.0 (2020-07-17)
Improved print_fancy_traceback()
2.0.0 (2020-07-02)
DvG module filenames changed to lowercase
1.1.2 (2020-06-08)
Code style: black
1.1.1 (2020-06-06)
Extended README
1.1.0 (2020-06-04)
Added tprint(…)
0.0.1 (2020-05-13)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dvg-debug-functions-2.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 304b0e2a127e9bcda309871ed34e85c2ab8cb411d228f20a187ed4a05ba0fa24 |
|
MD5 | aa308f35957cfb690acbc3870b802ac8 |
|
BLAKE2b-256 | 6d352f3ba3d90e454852a3081bc9059b863c45dff74b839ef2c56a7d7a03011c |
Hashes for dvg_debug_functions-2.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6ea41af5dc27e6afce063b751ca22fe0963eac488dbb5fec6b8f9f80f4fb45bd |
|
MD5 | 4dabba7bfd8cfd90b3d3d0a4883757a7 |
|
BLAKE2b-256 | 2111da6e40a93ad9edd97fcef6b2902d691c043ccfc672b10a41d6736d8d4017 |