Skip to main content

logging utility

Project description

balsa (logging utility)

Simple to use package that sets up Python logging. With just a few lines of code get well formatted logging to the console, log file, popup windows and exception services.

Here is a short Presentation on Balsa.


pip install balsa

Major Features

  • Simple to use. Add full-featured Python logging in just a few lines of code.
  • Sane default log levels. Single verbose flag. (All levels can be overridden if desired.)
  • Both console (stdout) and GUI (popup window) support.
  • Log file support. Uses appdirs for log file paths.
  • Sentry support. Just provide your Sentry DSN.
  • Informative log message formatting (or you can change it if you like).
  • Cross platform (Windows, Linux, MacOS). Pure Python.

Simple Example

from balsa import get_logger, Balsa

application_name = 'example'

log = get_logger(application_name)

def main():
    balsa = Balsa(application_name, 'james abel')
    log.error('my error example')

This will yield output of this form:

2018-04-15 11:25:58,507 - example - - 12 - main - ERROR - my error example


  • 0.6 : Add rate control to popup windows. Automated GUI testing.
  • 0.5 : Allow more than one logger.
  • 0.3 : Initial release.

Where did the name come from?

Balsa lumber is very soft and light, with a coarse, open grain. The Balsa package is light weight, malleable, and open source.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
balsa-0.6.7-py3-none-any.whl (8.7 kB) Copy SHA256 hash SHA256 Wheel 3.6

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page