Enum Refusal 

pub enum Refusal {
    OutsideRoot,
    AlreadyCovered(PathBuf),
    RecentlyUsed {
        age: Option<Duration>,
    },
    OtherFileSystem,
    HoldsCheckout,
    WorkTreeInUse,
    WorkTreeDetached,
    Unreadable(String),
}

Why a directory was left where it is.

Variants

OutsideRoot

It did not resolve to somewhere under the scan root. Covers .., a symlinked ancestor, an absolute path from somewhere else, and the scan root itself.

AlreadyCovered(PathBuf)

Another target in the same plan contains it, so removing that one removes this.

RecentlyUsed

Touched more recently than the age floor allows.

Fields

age: Option<Duration>

How long ago it was touched, or None when the clock and the filesystem disagree about which came first.

OtherFileSystem

On a different filesystem from the scan root, and one_file_system is on.

HoldsCheckout

It holds a git checkout, so somewhere under it is work that may exist nowhere else.

WorkTreeInUse

It is a linked work tree, but it has uncommitted changes or untracked files.

Ignored files are not work — a work tree carrying 4 GiB of node_modules is clean, and that content is what this program exists to regenerate rather than keep.

WorkTreeDetached

It is a linked work tree whose HEAD is detached.

The one way removing one of these loses a commit: work committed on a detached HEAD is reachable only through that work tree’s own HEAD, so once the directory goes and the administrative files are pruned, nothing refers to it. On a branch it is an ordinary ref in the repository and survives the directory by design.

Unreadable(String)

It could not be read, so nothing about it could be proved.

Trait Implementations

impl Clone for Refusal

fn clone(&self) -> Refusal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Refusal

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

Formats the value using the given formatter.

impl Display for Refusal

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

Formats the value using the given formatter.

impl Eq for Refusal

impl PartialEq for Refusal

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Refusal