Enum zng_ext_fs_watcher::fs_event::EventKind

pub enum EventKind {
    Any,
    Access(AccessKind),
    Create(CreateKind),
    Modify(ModifyKind),
    Remove(RemoveKind),
    Other,
}

Top-level event kind.

This is arguably the most important classification for events. All subkinds below this one represent details that may or may not be available for any particular backend, but most tools and Notify systems will only care about which of these four general kinds an event is about.

Variants

Any

The catch-all event kind, for unsupported/unknown events.

This variant should be used as the “else” case when mapping native kernel bitmasks or bitmaps, such that if the mask is ever extended with new event types the backend will not gain bugs due to not matching new unknown event types.

This variant is also the default variant used when Notify is in “imprecise” mode.

Access(AccessKind)

An event describing non-mutating access operations on files.

This event is about opening and closing file handles, as well as executing files, and any other such event that is about accessing files, folders, or other structures rather than mutating them.

Only some platforms are capable of generating these.

Create(CreateKind)

An event describing creation operations on files.

This event is about the creation of files, folders, or other structures but not about e.g. writing new content into them.

Modify(ModifyKind)

An event describing mutation of content, name, or metadata.

This event is about the mutation of files’, folders’, or other structures’ content, name (path), or associated metadata (attributes).

Remove(RemoveKind)

An event describing removal operations on files.

This event is about the removal of files, folders, or other structures but not e.g. erasing content from them. This may also be triggered for renames/moves that move files out of the watched subpath.

Some editors also trigger Remove events when saving files as they may opt for removing (or renaming) the original then creating a new file in-place.

Other

An event not fitting in any of the above four categories.

This may be used for meta-events about the watch itself.

Implementations

impl EventKind

pub fn is_access(&self) -> bool

Indicates whether an event is an Access variant.

pub fn is_create(&self) -> bool

Indicates whether an event is a Create variant.

pub fn is_modify(&self) -> bool

Indicates whether an event is a Modify variant.

pub fn is_remove(&self) -> bool

Indicates whether an event is a Remove variant.

pub fn is_other(&self) -> bool

Indicates whether an event is an Other variant.

Trait Implementations

impl Clone for EventKind

fn clone(&self) -> EventKind

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EventKind

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for EventKind

fn default() -> EventKind

Returns the “default value” for a type.

impl Hash for EventKind

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for EventKind

fn eq(&self, other: &EventKind) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for EventKind

impl Eq for EventKind

impl StructuralPartialEq for EventKind