Enum ImportSource 

pub enum ImportSource {
    R2modmanDir(PathBuf),
    Archive(PathBuf),
    Code(String),
}

What an import source string names.

A user or a UI hands over one string for “import this”, and which of the three import routes it means is decided by looking at the filesystem. That decision is made here, once, so no caller re-derives it: a caller that wants to word the routes differently, or preview what a pasted string would do, matches on this instead of stating its own is_dir/is_file rules.

Deliberately not #[non_exhaustive], matching BadProfile and NotRemovable: a caller that words each route should stop compiling when a fourth appears.

Variants

R2modmanDir(PathBuf)

An existing directory, treated as an r2modman profile to adopt in place.

Archive(PathBuf)

An existing file, treated as a .r2z export.

Code(String)

Anything else, treated as a shareable Thunderstore profile code.

Implementations

impl ImportSource

pub fn classify(source: &str) -> Self

Classifies one import source string.

A path that exists but is neither a directory nor a regular file (a dangling symlink, a socket) falls through to Self::Code, where the attempt fails naming the code endpoint. is_dir/is_file follow symlinks, so a link to either is classified as its destination.

pub fn preserves_versions(&self) -> bool

Whether this route keeps the versions the source recorded.

True only for Self::R2modmanDir, which copies files as they are. The other two resolve every entry through DependencyGraph and install each mod’s latest version instead. Even an adoption reinstalls an unrecorded loader at latest, which is why ImportOutcome::reinstalled is reported separately.

Exposed because it is the one thing a caller has to tell a user before they wonder why a pinned version changed, and deriving it from the variant is the sort of rule that goes stale in a client.

Trait Implementations

impl Clone for ImportSource

fn clone(&self) -> ImportSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImportSource

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

Formats the value using the given formatter.

impl Eq for ImportSource

impl PartialEq for ImportSource

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ImportSource