panzi_inotify 1.0.0

No project description provided

panzi-inotify

API Documentation

Simple inotify bindings for Python.

I didn't like all the other available inotify bindings for one reason or anther. This one is different in these ways:

• You can import the module even if your libc doesn't support inotify. It then will have HAS_INOTIFY false and only if you try to create an instance of Inotify you will get an exception (OSError(ENOSYS)).
• It correctly handles paths that are invalid UTF-8 by using the 'surrogateescape' escape Unicode error handling option. This makes the file paths rountrip safe.
• wait() and read_events() is separate. You can do your own wait/poll logic if you want.
• read_events() only reads the available events. If there are none at the moment it returns an empty array.
• You can pass a stopfd to Inotify(). This file descriptor will be added to epoll_wait() call in Inotify.wait(). If POLLIN signals for that wait() will return False. This is meant for implementing a way to stop a process that waits for events without a timeout.
• Translates errors in the approprioate Python exceptions from the given errno (FileNotFoundError etc. and OSError as fallback).

Example

from panzi_inotify import Inotify, get_inotify_event_names

import sys

with Inotify() as inotify:
    for filename in sys.argv[1:]:
        inotify.add_watch(filename)

    for event in inotify:
        print(f'{event.full_path()}: {", ".join(get_inotify_event_names(event.mask))}')

See examples for more.

You can also run a basic command line too to listen for events on a set of paths like this:

python -m panzi_inotify [--mask=MASK] <path>...

For more on this see:

python -m panzi_inotify --help

See Also

inotify(7)

License

Mozilla Public License Version 2.0