logcatter 0.3.1

Logcat style log library

Logcatter 🐱

See logcatter from PyPI

Brings the familiar convenience and readability of Android's Logcat to your Python projects.

Tired of complex logger configurations? Logcatter lets you use intuitive methods like Log.d() and Log.i() right away. It automatically tags logs with the calling filename, dramatically speeding up your debugging workflow.

✨ Key Features

• ☕ Android Logcat Style: Get beautiful, easy-to-read logs formatted as yyyy-MM-dd HH:mm:ss.SSS [D/tag] message.
• 🏷️ Automatic Tagging: The name of the source file (main.py) that calls the log is automatically used as the tag, so you can instantly identify the origin of a log.
• 🎨 Colored Output: Log levels (Debug, Info, Warning, Error) are color-coded for enhanced visual recognition.
• 🚀 Concise API: Use intuitive methods nearly identical to the Android Log class: Log.d(), Log.i(), Log.w(), and Log.e().
• 🔧 Zero Configuration: Works right out of the box after installation with no extra setup required.

📦 Installation

pip install logcatter

🚀 Quick Start

Just import the Log class into your project and call Log.init() first and Log.dispose() last of your code.

from logcatter import Log

Log.init()

Log.d("This is log!!")
Log.set_level(Log.WARNING)  # Hide DEBUG, INFO level logs
Log.i("This is info!!")  # You cannot see this because you set the minimum level `WARNING`
Log.e("ERROR!!!", e=ValueError())  # You can log the caught exception/error with argument `e`
Log.f("FATAL ERROR", s=True)  # You can log the stacktrace with flag `s`

Log.dispose()

Using with other's code

Some library or codes are using print() or sys.stderr.write. And the format of Log is not applied basically. In this case, you can use Log.redirect as a context manager.

from logcatter import Log
Log.init()

with Log.redirect():
    print("Some message")

Log.dispose()

If internal print codes use CR (carriage return) to rewrite last line such as tqdm, the Log style will not be applied.

Save logs

You can save the log messages using just a single line.

from logcatter import Log
Log.init()

Log.save("path of file")

Log.dispose()

Multiprocessing

You can use Log in the multiprocessing with calling Log.init_worker(). (Don't forget the brackets!)

from logcatter import Log
import multiprocessing

Log.init()

with multiprocessing.Pool(processes=2, initializer=Log.init_worker()) as pool:
    Log.i("Some message")

Log.dispose()

💻 Output Example

Visual Studio Code

PyCharm

PowerShell 7 on Windows Terminal