wepub 0.1.0

CLI to publish browser extensions to Chrome Web Store and Firefox AMO
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161

use std::path::PathBuf;

use clap::{Args, Parser, Subcommand, ValueEnum};
use url::Url;

#[derive(Debug, Parser)]
#[command(
    name = "wepub",
    version,
    about = "Publish browser extensions to web stores"
)]
pub struct Cli {
    /// Show debug-level logs.
    #[arg(short = 'v', long = "verbose", global = true)]
    pub verbose: bool,

    /// Suppress non-warning logs.
    #[arg(short = 'q', long = "quiet", global = true, conflicts_with = "verbose")]
    pub quiet: bool,

    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Debug, Subcommand)]
pub enum Commands {
    /// Upload a zip and create a new version on AMO.
    Firefox(FirefoxArgs),
    /// Upload a zip and submit a new version to the Chrome Web Store.
    Chrome(ChromeArgs),
}

#[derive(Debug, Args)]
#[command(group(
    clap::ArgGroup::new("release_notes_input")
        .multiple(false)
        .args(["release_notes", "release_notes_file"]),
))]
#[command(group(
    clap::ArgGroup::new("approval_notes_input")
        .multiple(false)
        .args(["approval_notes", "approval_notes_file"]),
))]
pub struct FirefoxArgs {
    /// Path to the extension archive (zip).
    #[arg(value_name = "ZIP")]
    pub zip: PathBuf,

    /// Add-on ID (e.g. "myaddon@example.com").
    #[arg(long, env = "WEPUB_FIREFOX_ADDON_ID")]
    pub addon_id: String,

    /// Distribution channel.
    #[arg(long, value_enum, default_value_t = ChannelArg::Listed)]
    pub channel: ChannelArg,

    /// AMO API key (JWT issuer).
    #[arg(long, env = "WEPUB_FIREFOX_API_KEY")]
    pub api_key: String,

    /// AMO API secret (JWT secret).
    #[arg(long, env = "WEPUB_FIREFOX_API_SECRET")]
    pub api_secret: String,

    /// Override the AMO API base URL (for local addons-server etc.).
    #[arg(long, env = "WEPUB_FIREFOX_AMO_BASE_URL")]
    pub amo_base_url: Option<Url>,

    /// Compatible applications, comma-separated (e.g. "firefox,android").
    #[arg(long, value_delimiter = ',')]
    pub compatibility: Vec<ApplicationArg>,

    /// Release notes (en-US). Mutually exclusive with --release-notes-file.
    #[arg(long)]
    pub release_notes: Option<String>,

    /// Path to a file containing en-US release notes. Use "-" for stdin.
    #[arg(long, value_name = "PATH")]
    pub release_notes_file: Option<PathBuf>,

    /// Approval notes for AMO reviewers. Mutually exclusive with --approval-notes-file.
    #[arg(long)]
    pub approval_notes: Option<String>,

    /// Path to a file containing approval notes. Use "-" for stdin.
    #[arg(long, value_name = "PATH")]
    pub approval_notes_file: Option<PathBuf>,

    /// Path to a source archive to attach to the version.
    #[arg(long, value_name = "PATH")]
    pub source: Option<PathBuf>,
}

#[derive(Debug, Clone, Copy, ValueEnum)]
pub enum ChannelArg {
    Listed,
    Unlisted,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, ValueEnum)]
pub enum ApplicationArg {
    Firefox,
    Android,
}

#[derive(Debug, Args)]
pub struct ChromeArgs {
    /// Path to the extension archive (zip).
    #[arg(value_name = "ZIP")]
    pub zip: PathBuf,

    /// Publisher ID under which the item is registered.
    #[arg(long, env = "WEPUB_CHROME_PUBLISHER_ID")]
    pub publisher_id: String,

    /// Item ID (the 32-character extension ID).
    #[arg(long, env = "WEPUB_CHROME_ITEM_ID")]
    pub item_id: String,

    /// OAuth client ID. Use together with --client-secret and --refresh-token.
    #[arg(long, env = "WEPUB_CHROME_CLIENT_ID")]
    pub client_id: Option<String>,

    /// OAuth client secret. Use together with --client-id and --refresh-token.
    #[arg(long, env = "WEPUB_CHROME_CLIENT_SECRET")]
    pub client_secret: Option<String>,

    /// OAuth refresh token. Use together with --client-id and --client-secret.
    #[arg(long, env = "WEPUB_CHROME_REFRESH_TOKEN")]
    pub refresh_token: Option<String>,

    /// Pre-fetched OAuth access token (escape hatch for WIF / gcloud).
    #[arg(long, env = "WEPUB_CHROME_ACCESS_TOKEN")]
    pub access_token: Option<String>,

    /// Publish type.
    #[arg(long, value_enum, default_value_t = PublishTypeArg::Default)]
    pub publish_type: PublishTypeArg,

    /// Bypass the standard review queue (only honoured for changes Google deems eligible).
    #[arg(long)]
    pub skip_review: bool,

    /// Initial deploy percentage (0-100). Omit to use the Developer Dashboard default.
    #[arg(long, value_name = "N", value_parser = clap::value_parser!(u8).range(0..=100))]
    pub deploy_percentage: Option<u8>,

    /// Override the CWS API root URL (for testing).
    #[arg(long, env = "WEPUB_CHROME_CWS_ROOT_URL")]
    pub cws_root_url: Option<Url>,

    /// Override the OAuth token endpoint URL (for testing).
    #[arg(long, env = "WEPUB_CHROME_CWS_TOKEN_URL")]
    pub cws_token_url: Option<Url>,
}

#[derive(Debug, Clone, Copy, ValueEnum)]
pub enum PublishTypeArg {
    Default,
    Staged,
}