wash-lib 0.25.1

wasmCloud Shell (wash) libraries
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use std::path::PathBuf;

use clap::{Parser, Subcommand};

#[derive(Parser, Debug, Clone)]
pub struct AuthOpts {
    /// OCI username, if omitted anonymous authentication will be used
    #[clap(
        short = 'u',
        long = "user",
        env = "WASH_REG_USER",
        hide_env_values = true
    )]
    pub user: Option<String>,

    /// OCI password, if omitted anonymous authentication will be used
    #[clap(
        short = 'p',
        long = "password",
        env = "WASH_REG_PASSWORD",
        hide_env_values = true
    )]
    pub password: Option<String>,

    /// Allow insecure (HTTP) registry connections
    #[clap(long = "insecure")]
    pub insecure: bool,

    /// Skip checking server's certificate for validity
    #[clap(long = "insecure-skip-tls-verify")]
    pub insecure_skip_tls_verify: bool,
}

#[derive(Debug, Clone, Subcommand)]
pub enum RegistryCommand {
    /// Pull an artifact from an OCI compliant registry
    #[clap(name = "pull")]
    Pull(RegistryPullCommand),
    /// Push an artifact to an OCI compliant registry
    #[clap(name = "push")]
    Push(RegistryPushCommand),
}

#[derive(Parser, Debug, Clone)]
pub struct RegistryPullCommand {
    /// URL of artifact
    #[clap(name = "url")]
    pub url: String,

    /// File destination of artifact
    #[clap(long = "destination")]
    pub destination: Option<String>,

    /// Registry of artifact. This is only needed if the URL is not a full (OCI) artifact URL (ie, missing the registry fragment)
    #[clap(short = 'r', long = "registry", env = "WASH_REG_URL")]
    pub registry: Option<String>,

    /// Digest to verify artifact against
    #[clap(short = 'd', long = "digest")]
    pub digest: Option<String>,

    /// Allow latest artifact tags
    #[clap(long = "allow-latest")]
    pub allow_latest: bool,

    #[clap(flatten)]
    pub opts: AuthOpts,
}

#[derive(Parser, Debug, Clone)]
pub struct RegistryPushCommand {
    /// URL to push artifact to
    #[clap(name = "url")]
    pub url: String,

    /// Path to artifact to push
    #[clap(name = "artifact")]
    pub artifact: String,

    /// Registry of artifact. This is only needed if the URL is not a full (OCI) artifact URL (ie, missing the registry fragment)
    #[clap(short = 'r', long = "registry", env = "WASH_REG_URL")]
    pub registry: Option<String>,

    /// Path to config file, if omitted will default to a blank configuration
    #[clap(short = 'c', long = "config")]
    pub config: Option<PathBuf>,

    /// Allow latest artifact tags
    #[clap(long = "allow-latest")]
    pub allow_latest: bool,

    /// Optional set of annotations to apply to the OCI artifact manifest
    #[clap(short = 'a', long = "annotation", name = "annotations")]
    pub annotations: Option<Vec<String>>,

    #[clap(flatten)]
    pub opts: AuthOpts,
}