---
id: zthreading
version: "0.1.19"
license: LICENSE
license_treatment: unclear
maintenance: abandoned
---

# zthreading — A collection of wrapper classes for event broadcast and task management for python (Python Threads or Asyncio).

License: unclear · Maintenance: abandoned · Downloads: 695.3K/mo

## What it is and what it does

zthreading wraps Python's threading and asyncio primitives to provide an event-driven interface for inter-thread communication and task scheduling. It centers on an EventHandler class that lets you register listeners for named events and emit them from any thread, plus a Task class that runs functions in separate threads or async loops and also acts as an EventHandler. The package includes decorators for common patterns: running a function as a background task, batching rapid consecutive calls, and catching OS signals.

The library is designed for scenarios where you want event-based coordination between threads without manually managing locks or queues. However, it has been abandoned since mid-2022 with no commits or releases since then, so it carries the risk of incompatibility with newer Python versions and asyncio changes.

Use it for:

- Coordinate work across multiple threads using named events instead of manual queue management.
- Run a long-running function in a background thread and listen for progress events it emits.
- Batch rapid repeated calls (e.g., file saves) into fewer actual executions using the collect_consecutive_calls_async decorator.
- Gracefully handle OS signals (SIGTERM, SIGINT) in a threaded application using the catch_signal decorator.
- Stream events from a task as a Python generator, pausing the consumer until the producer emits the next event.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides event-driven communication and task management for Python threads and asyncio, with decorators for signal handling and call batching.

No. The package is abandoned (last commit 2022-06-21) with no maintenance signal. While it has low install friction and no known vulnerabilities, the lack of updates means it will likely break or behave unexpectedly on modern Python versions. For new projects, use standard library threading and asyncio primitives directly, or choose an actively maintained event library.

## Install

pip install zthreading
uv add zthreading
poetry add zthreading

## Installing zthreading

Before you install: Low install friction with no runtime dependencies. However, the package is abandoned—last release was 2022-06-13 and last commit 2022-06-21—so expect no maintenance, bug fixes, or compatibility updates.

License in practice: License file present but SPDX identifier unclear; the raw LICENSE file exists but its terms are not machine-readable from the metadata. Verify the actual license text in the repository before relying on it for commercial or copyleft-sensitive projects.

Quickstart:

pip install zthreading

from zthreading.events import EventHandler
from zthreading.tasks import Task

handler = EventHandler()
handler.on("test", lambda msg: print(msg))

def work(msg):
    handler.emit("test", msg)

Task(work).start("hello").join()

Requires Python 3.6 or later; package is unmaintained and may have compatibility issues with modern Python versions.

Verify before relying:

- Whether the package works reliably with Python versions released after 2022-06-21 (asyncio API changes, deprecations).
- Actual license terms and SPDX identifier—metadata lists 'unclear' treatment despite LICENSE file presence.
- Whether event piping with weak references behaves correctly under garbage collection in current Python.

## Package facts

- License: LICENSE (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 695.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

event handler python threads, asyncio task management, event broadcast threading, signal handling decorators, thread pool event emitter, event-driven, threading, abandoned

[View on SkillFed](https://skillfed.io/packages/zthreading) · [View on PyPI](https://pypi.org/project/zthreading/)