Logging objects for Python apps.
Stutter is my own idea for a simple logging lib. Objects in the package handle timestamps and logging to files automatically. Logging to files can be buffered, and even threaded, according to your application’s needs.
Note that it may be possible to use the BufferedReader object with twisted to eliminate the need for threading. I may create such an object in future.
Use objects from this package if you want to log messages. I intend to use this in a bot, and possibly a client, for the deviantART chat network. Logging can be done as follows:
from stutter import logging logger = logging.BaseLogger() logger.message('Sup homie?') logger.message('Everything is saved to files in `./log` by default') logger.message('You can change this somehow... I'll explain later.') logger.debug('This message won't be printed on-screen, but will be saved.')
File IO can be expensive sometimes, so you can use the BufferedLogger object
to determine when messages should be saved to files. When a BufferedLogger is
used to display log messages on screen, the messages are displayed instantly,
but they not saved to any files until
.push() is used:
import time from stutter import logging logger = logging.BufferedLogger() logger.message('Some boring message...') time.sleep(5) # You can use the time you have to confirm that no logs have been written # yet, if you like. These are really trivial examples... logger.warning('Writing logs!') logger.push()
.push() will only save up to 5 messages at a time. You can change
this by telling
push how many messages to save using the
For example, to save up to 10 messages, you would call
push all stored messages to log files, call
If you want to automate calls to
push without having to really think about it
too much, you can use the
ThreadedLogger object. A brief and naive example:
from stutter import logging logger = logging.ThreadedLogger() # Start pushing in a thread. logger.start() logger.message('Your mother smells of elderberries.') # Stop the threading stuff. logger.stop() # Wait until the thread has actually stopped. logger.join() # Make sure all log messages have been saved. # This is not done by stopping the thread! logger.push(0)
I will write documentation when I can be arsed.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|stutter-1.1.tar.gz (6.4 kB) Copy SHA256 Checksum SHA256||–||Source||Nov 7, 2011|
|stutter-1.1.zip (10.9 kB) Copy SHA256 Checksum SHA256||–||Source||Nov 7, 2011|