Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

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.

Files for zc.thread, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size zc.thread-1.0.0.tar.gz (4.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page