Skip to main content

A simple but flexible and containerized observer pipeline for filesystem events featured by docker.

Project description


Monokel sits on top of Watchdog and exposes an easy way on how to register filesystem event handlers that will eventually run inside a Docker container.


Install and update using pip:

$ pip install -U monokel

Getting Started

The build step

To run an event loop that observes filesystem events from within the container we have to configure and build the actual docker-compose file first.

Monokel provides a build command that will do most of that for you and creates everything the resulting compose file needs to set up the final service.

$ monokel build --help

There are components you can optionally provide and a mandatory one - the python file we call the config.

The (python) config

The idea of the config is to provide a single entry point as a file for the event loop that will eventually run within the docker container. It defines what Observer to run and which EventHandlers to schedule for given paths.

As your eventhandlers might become very specific and require external packages it is by intention that you can make use of them from within the config as long as they can be found in PYPI and installed via pip. See config requirements.

The config file itself can have any name as you can provide the location to the script path.

The config requirements


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

monokel-0.0.6.tar.gz (10.4 kB view hashes)

Uploaded Source

Built Distribution

monokel-0.0.6-py3-none-any.whl (10.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page