traceprintplus 0.3

No project description provided

TracePrint-plus - Advanced Python Debugging & Logging Utility

TracePrint-plus is a flexible, developer-friendly Python utility that makes debugging and logging smarter. It automatically prints variable names alongside their values, supports custom messages, optional timestamps, and file/line tracking. With configurable color output, separators, and debug toggles, it transforms ordinary print statements into informative, visually distinct logs—perfect for tracing code execution efficiently.

Authors

• @ArkiniDEV

Features

• Automatic Variable Display – Prints variable names with their current values for easier debugging.

• Custom Messages – Add optional debug messages or prefixes to your logs.

• Timestamps – Optionally show the current time for each print statement.

• File & Line Tracking – Display the source file and line number where the print occurred.

• ANSI Color Support – Highlight debug output with standard, bright, or custom colors.

• Global and Per-Print Coloring – Apply colors globally or override per statement.

• Configurable Separators – Customize how multiple variables are joined in output.

• Debug Toggle – Enable or disable debug printing via a single configuration option.

• Smart Start Message – Optionally prepend a message at the first log for clarity.

• Minimal Setup – No complex logging setup just import and use.

Installation

Install traceprint-plus with npm

  npm install traceprintplus
  cd traceprintplus

Install traceprint-plus with pip

  pip install traceprintplus

Usage/Examples

import traceprintplus as tp

# Settings that traceprintplus-plus (tp) will follow
tp.config.update({
    "DEBUG": True,
    "COLORSFORDEBUG": True,
    "SEP": True,
    "SEPSTYLE": " | ",
    "MESSAGE": "TRACEPRINT:",
    "COLOR": "cyan",
    "TIMESTAMP": True,
    "FILELINE": True,
    "FILELINEARGS": (2, 7)
})

# Demo variables
x, y, z = 10, 20, 30
my_list = [1, 2, 3]

# Demo prints
tp.tprint(x, y, z)
tp.tprint(my_list, x + y, message="Mixed Demo:")
tp.config["DEBUG"] = False
tp.tprint("Debug off → only values")

Expected terminal output

[test.py:21] [12:13:47] TRACEPRINT: x = 10  |  y = 20  |  z = 30
[test.py:22] [12:13:47] Mixed Demo: my_list = [1, 2, 3]  |  x + y = 30
[test.py:24] [12:13:47] Debug off → only values

Color Name	Sample Text
black
red
green
yellow
blue
magenta
cyan
white

Bright Colors	Sample Text
bright_black
bright_red
bright_green
bright_yellow
bright_blue
bright_magenta
bright_cyan
bright_white

Accent Colors	Sample Text
orange
pink
purple
light_blue
teal
lime
light_gray
dark_gray

Reset	Sample Text
reset

🚀 About Me

I'm a Developer who likes making Games in Unity and Programming in Python / C++