tributaries 0.1.0

Cross-platform filesystem notification: overlapping watch subscriptions are subsumed into disjoint roots, and every event is attributed back to each subscription covering it.
Documentation
#![doc = include_str!("../README.md")]
#![deny(missing_docs)]
#![cfg_attr(docsrs, feature(doc_cfg))]
#![cfg_attr(docsrs, allow(unused_attributes))]

mod coalesce;
mod demux;
mod driver;
mod error;
mod event;
mod filter;
mod interest;
mod options;
mod route;
mod source;
mod subscription;
pub(crate) mod subsume;
mod view;

pub use demux::{Demux, Lane};
pub use driver::Tributaries;
pub use error::{
  BuildError, CloseError, FaultKind, SourceFault, SyncError, UnwatchError, WatchError,
};
pub use event::{Event, EventKind};
pub use filter::{Filter, FilterInput};
pub use interest::Interest;
pub use options::{Debounce, DebounceConfig, TributariesOptions, WatchOptions};
pub use source::{Armed, LocalSource, Source, SourceEvent, SyncOutcome, SyncToken};
pub use subscription::{InstanceId, Subscription};
pub use view::{Snapshot, WatchView};

#[cfg(feature = "fs")]
#[cfg_attr(docsrs, doc(cfg(feature = "fs")))]
pub use source::FsSource;

#[cfg(all(feature = "fs", feature = "tokio"))]
#[cfg_attr(docsrs, doc(cfg(all(feature = "fs", feature = "tokio"))))]
pub use driver::TokioTributaries;

#[cfg(all(feature = "fs", feature = "smol"))]
#[cfg_attr(docsrs, doc(cfg(all(feature = "fs", feature = "smol"))))]
pub use driver::SmolTributaries;

/// The umbrella **owns** the source-neutral event vocabulary ([`EventKind`], with the
/// move endpoint carried in-kind): each source — the fs binding included — maps into it
/// at its binding, so the fs-only event types (`tributary_fs::EventKind`,
/// `tributary_fs::MovedEvent`) stay in [`tributary-fs`](tributary_fs) for fs consumers.
/// Only the two fs-binding types surface here (with the default `fs` feature):
/// [`RootHandle`] is the [`FsSource`] armed-root token ([`Source::Handle`]), and
/// [`WatcherOptions`] configures the underlying filesystem watcher it drives.
#[cfg(feature = "fs")]
#[cfg_attr(docsrs, doc(cfg(feature = "fs")))]
pub use tributary_fs::{RootHandle, WatcherOptions};

/// The identity/coordinate primitives — change id, epoch, location — are owned by
/// `tributary-proto` and re-exported from there directly (`tributary-fs` merely
/// re-exports them itself). The per-watch [`Interest`] is **not** among them: the
/// umbrella owns its own source-neutral mask (aligned to [`EventKind`]), and the
/// proto/fs `Interest` stays a purely fs-internal arm mask for consumers driving a raw
/// fs watcher.
pub use tributary_proto::{ChangeId, Epoch, Location, Segment};