diff options
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..8587918 --- /dev/null +++ b/README.rst @@ -0,0 +1,69 @@ +TaskThread +========== + +Python thread module to repeat an predefined task on a thread mulitple times. +A TaskThread is useful when a task needs to be repeated several times on +a separate thread. Normal usage of the threading.Thread class would call for +creation of a new thread each time the same task needs to be run. This module +allows for repetitive tasks to be run multiple times on the same thread by having +the thread wait until the task needs to be executed again. + + +Provided Classes +---------------- +``taskthread.TaskThread``` + A sub-class of ``threading.Thread`` that may execute a single task + multiple times without the overhead of starting a new thread. +``taskthread.TaskInProcessException`` + Exception that is thrown if a task is started on a thread that is + already executing. + + +Installation +------------ + +*taskthread* may be installed by executing ``pip install taskthread``. + + +Links +------------- + +* `documentation <http://taskthread.readthedocs.org/en/latest/>`_ +* `source <http://github.com/hpcs-som/taskthread/>`_ + + +Changes +------- + +v1.4 +~~~~ + +* **ADD** ``TimerTask`` class that runs a repetitive task on a taskthread. + + +v1.3 +~~~~ + +* Change task loop to support python 2.6. + + +v1.2 +~~~~ + +* Refactor the module so classes are defined in __init__.py. + + +v1.1 +~~~~ + +* **ADD** ``TaskThread.join_task`` method that waits for the currently executing. + task to complete. + + +v1.0 +~~~~ + +* First release + + + |