Skip to main content

Thread-creation helper

Project description

Thread-creation helper

The thread-creation API provided by the Python threading module is annoying. :)

This package provides a very simple thread-creation API that:

  • Makes threads daemonic and allows daemonicity to be passed to the constructor. For example:

    zc.thread.Thread(mythreadfunc)
    

    Starts a daemonic thread named 'mythreadfunc' running mythreadfunc.

  • Allows threads to be defined via decorators, as in:

    import zc.thread
    
    @zc.thread.Thread
    def mythread():
        ...
    

    In the example above, a daemonic thread named mythread is created and started. The thread is also assigned to the variable mythread.

    You can control whether threads are daemonic and wether they are started by default:

    import zc.thread
    
    @zc.thread.Thread(daemon=False, start=False)
    def mythread():
        ...
    
  • After a thread finishes, you can get the return value of the target function from the thread’s value attribute, or, if the function raises an exception, you can get the exception object from the thread’s exception attribute. (This feature was inspired by the same feature in gevent greenlets.)

  • If a thread raises an exception (subclass of Exception), the exception is logged and a traceback is printed to standard error.

  • A restart argument can be used to rerun a thread target function if there’s an uncaught exception. Value passed to the restart argument is passed to time.sleep before restarting the function.

There’s also a Process constructor/decorator that works like Thread, but with multi-processing processes, and without the value and exception attributes.

Changes

1.0.0 (2015-06-17)

  • Python 3 support
  • Thread names now include a function’s module name.
  • Unhandled exceptions in thread and process targets are now logged and printed with tracebacks.
  • A restart argument can be used to automatically restart thread targets after a rest.

0.1.0 (2011-11-27)

Initial release

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
zc.thread-1.0.0.tar.gz (4.7 kB) Copy SHA256 hash SHA256 Source None

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