rattler_lock 0.26.16

Rust data types for conda lock
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! Provides data types that are used to describe the location of a source
//! package.

use rattler_digest::{Md5Hash, Sha256Hash};
use typed_path::Utf8TypedPathBuf;
use url::Url;

/// Describes the source location of a package.
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub enum SourceLocation {
    /// The source is stored as a downloadable archive
    Url(UrlSourceLocation),

    /// The source is stored in a git repository
    Git(GitSourceLocation),

    /// The source is stored on the local filesystem
    Path(PathSourceLocation),
}

/// A specification of a source archive from a URL.
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub struct UrlSourceLocation {
    /// The URL of the package contents
    pub url: Url,

    /// The md5 hash of the archive
    pub md5: Option<Md5Hash>,

    /// The sha256 hash of the archive
    pub sha256: Option<Sha256Hash>,
}

/// A specification of source from a git repository.
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub struct GitSourceLocation {
    /// The git url of the package which can contain git+ prefixes.
    pub git: Url,

    /// The git revision of the package
    pub rev: Option<GitReference>,

    /// The git subdirectory of the package
    pub subdirectory: Option<String>,
}

/// A reference to a specific commit in a git repository.
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub enum GitReference {
    /// The HEAD commit of a branch.
    Branch(String),

    /// A specific tag.
    Tag(String),

    /// A specific commit.
    Rev(String),
}

/// Source located somewhere on the filesystem.
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub struct PathSourceLocation {
    /// The path to the package. Either a directory or an archive.
    pub path: Utf8TypedPathBuf,
}