really-notify

This crate is for when you really, really just want to know that your config changed. K8s configmap symlink shenanigans? No problem. Multi-level symlink directory & file redirections? Sure. Just tell me my damn config changed.

Inspiration

This crate is a derivation of some code I've been recycling for a while to deal with hot reloading K8s ConfigMaps, which relink the parent dir (accessed through a symlink). I've made it a bit more robust. This is primarily intended for use on Linux/Unix systems, however I've added a backup fallback to notify crate. That won't have the great symlink management the native inotify integration has. notify crate is unable to be configured to deal with symlinks properly.

Similarly, no existing inotify crate (I could find at a cursory glance) had proper async support. They all delegated out to a blocking thread at best, similar to how Tokio deals with files. To integrate with the Tokio network stack, I'm treating the inotify FD as a UNIX pipe receiver, which makes the correct file read syscall, but uses epoll through mio, and not some blocking stuff. Confirmed with strace.

Examples

See examples/ subdirectory.