---
id: watchdog-gevent
version: "0.2.1"
license: unclear
license_treatment: unclear
maintenance: dormant
---

# watchdog-gevent — A gevent-based observer for watchdog.

License: unclear · Maintenance: dormant · Downloads: 790.8K/mo

## What it is and what it does

watchdog-gevent bridges the watchdog file-monitoring library with gevent's lightweight concurrency primitives. It provides a GeventObserver that watches the file system for changes (creation, deletion, modification) and dispatches events using gevent greenlets instead of threads, making it suitable for I/O-bound applications that already use gevent for async operations.

The package is a thin adapter layer: you define event handlers using watchdog's standard FileSystemEventHandler interface, then schedule them with GeventObserver instead of the default ThreadedObserver. This is useful when you want file monitoring to cooperate with gevent's event loop rather than spawn OS threads. However, the project is dormant (last release 664 days ago), so compatibility with recent versions of its dependencies is uncertain.

Use it for:

- Monitor configuration files in a gevent-based web service and reload settings when they change without blocking other greenlets.
- Watch a directory for new log files in a gevent application and process them concurrently using greenlets.
- Track file system events in a real-time data pipeline built on gevent, triggering downstream tasks on file arrival.
- Implement file-based triggers in a gevent async framework where thread-based observers would add unnecessary overhead.

## Worth the install?

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

Provides a gevent-based file system event observer that integrates watchdog's file monitoring with gevent's lightweight concurrency model.

Yes, if you are already committed to gevent and need file system monitoring—the low install friction and lack of known vulnerabilities make it safe to try. However, verify the license first and test compatibility with your versions of gevent and watchdog, since the package is dormant and may not work with recent releases of its dependencies. If you need active maintenance or support, consider using watchdog's standard ThreadedObserver or evaluating alternatives.

## Install

pip install watchdog-gevent
uv add watchdog-gevent
poetry add watchdog-gevent

## Installing watchdog-gevent

Before you install: Low install friction with just two runtime dependencies (gevent and watchdog). However, the package is dormant—last release was 664 days ago—so maintenance is not active and any issues are unlikely to receive timely fixes.

License in practice: License status is unclear; no SPDX identifier or raw license text is available in the metadata. Verify the actual license before use in proprietary or copyleft-sensitive projects.

Quickstart:

pip install watchdog-gevent

from watchdog_gevent import GeventObserver
from watchdog.events import FileSystemEventHandler

class Handler(FileSystemEventHandler):
    def on_modified(self, event):
        print(f'File modified: {event.src_path}')

observer = GeventObserver()
observer.schedule(Handler(), path='.', recursive=True)
observer.start()

Requires gevent and watchdog to be installed; gevent may require a C compiler on some platforms.

Verify before relying:

- Exact license under which watchdog-gevent is distributed (critical for compliance decisions).
- Whether the package works with current versions of gevent and watchdog, given the 664-day gap since last release.
- Python version compatibility (requires_python is unspecified in metadata).

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 790.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gevent file system monitoring, watchdog gevent integration, async file watcher gevent, file system events gevent, concurrent file observer, gevent, file-monitoring, dormant

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