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
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
use clap::{Parser, Subcommand};
use fission_command_core::{DistributionProvider, PlatformCapability, Target};
use fission_command_package as package;
use fission_command_release as release;
use std::path::PathBuf;
#[derive(Parser, Debug)]
#[command(
name = "fission",
version,
about = "Scaffold and manage Fission applications"
)]
pub(crate) struct Cli {
#[command(subcommand)]
pub(crate) command: Command,
}
#[derive(Subcommand, Debug)]
pub(crate) enum Command {
/// Create a new Fission application.
Init {
/// Directory to create.
path: PathBuf,
/// Crate/package name override.
#[arg(long)]
name: Option<String>,
/// Application identifier used by mobile targets.
#[arg(long)]
app_id: Option<String>,
/// Optional local Fission checkout to use as a path dependency.
#[arg(long)]
local_path: Option<PathBuf>,
},
/// Add one or more platform targets to an existing Fission app.
AddTarget {
#[arg(value_enum)]
targets: Vec<Target>,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
},
/// Add one or more host capabilities and update platform config where possible.
AddCapability {
#[arg(value_enum)]
capabilities: Vec<PlatformCapability>,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
},
/// Check local toolchains and SDKs needed by Fission targets.
Doctor {
/// Targets to check; defaults to web, iOS, and Android.
#[arg(value_enum)]
targets: Vec<Target>,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Exit with a non-zero status when required checks fail.
#[arg(long)]
strict: bool,
},
/// List runnable desktop, browser, simulator, emulator, and device targets.
Devices {
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Emit machine-readable JSON.
#[arg(long)]
json: bool,
},
/// Build and run the app on a selected device, attaching logs by default.
Run {
/// Restrict device selection to one target.
#[arg(long, value_enum)]
target: Option<Target>,
/// Device id or exact/prefix device name from `fission devices`.
#[arg(long)]
device: Option<String>,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Start the app and return instead of attaching logs/process output.
#[arg(long)]
detach: bool,
/// Build in release mode.
#[arg(long)]
release: bool,
/// Host for the local web server.
#[arg(long, default_value = "127.0.0.1")]
host: String,
/// Port for the local web server.
#[arg(long, default_value_t = 8123)]
port: u16,
/// Do not open a browser, Simulator, or emulator UI where supported.
#[arg(long)]
no_open: bool,
/// Prefer headless simulator/emulator execution where supported.
#[arg(long)]
headless: bool,
},
/// Build a configured target without launching it.
Build {
/// Target to build; defaults to the host desktop target.
#[arg(long, value_enum)]
target: Option<Target>,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Build in release mode.
#[arg(long)]
release: bool,
},
/// Run the generated smoke test for a configured target.
Test {
/// Target to test; defaults to the host desktop target.
#[arg(long, value_enum)]
target: Option<Target>,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Prefer headless simulator/emulator execution where supported.
#[arg(long)]
headless: bool,
},
/// Build, check, serve, or list routes for a static Fission site.
Site {
#[command(subcommand)]
command: SiteCommand,
},
/// Package a build output into a distributable artifact.
Package {
/// Target to package.
#[arg(long, value_enum)]
target: Target,
/// Package format.
#[arg(long, value_enum)]
format: package::PackageFormat,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Build/package in release mode.
#[arg(long)]
release: bool,
/// Emit machine-readable JSON.
#[arg(long)]
json: bool,
},
/// Publish a packaged artifact to a configured distribution provider.
Distribute {
/// Lifecycle action; defaults to publish.
#[arg(value_enum)]
action: Option<package::DistributeAction>,
/// Distribution provider.
#[arg(long, value_enum)]
provider: DistributionProvider,
/// Artifact manifest emitted by `fission package`.
#[arg(long)]
artifact: Option<PathBuf>,
/// Named distribution site/profile from fission.toml.
#[arg(long, default_value = "production")]
site: String,
/// Deployment id used by promote/rollback/status operations.
#[arg(long)]
deploy: Option<String>,
/// Provider track/channel/group, such as internal, testflight, or production.
#[arg(long)]
track: Option<String>,
/// Show what would happen without mutating provider state.
#[arg(long)]
dry_run: bool,
/// Confirm overwrites or provider-side setup changes.
#[arg(long)]
yes: bool,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Emit machine-readable JSON.
#[arg(long)]
json: bool,
},
/// Run package or distribution readiness checks.
Readiness {
/// Readiness area to check.
#[arg(value_enum)]
kind: package::ReadinessKind,
/// Target to package/check.
#[arg(long, value_enum)]
target: Option<Target>,
/// Package format.
#[arg(long, value_enum)]
format: Option<package::PackageFormat>,
/// Distribution provider.
#[arg(long, value_enum)]
provider: Option<DistributionProvider>,
/// Artifact manifest emitted by `fission package`.
#[arg(long)]
artifact: Option<PathBuf>,
/// Named distribution site/profile from fission.toml.
#[arg(long, default_value = "production")]
site: String,
/// Provider track/channel/group, such as internal, testflight, or production.
#[arg(long)]
track: Option<String>,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Emit machine-readable JSON.
#[arg(long)]
json: bool,
},
/// Edit, validate, import, diff, or push release metadata.
ReleaseConfig {
#[command(subcommand)]
command: release::ReleaseConfigCommand,
},
/// Capture, render, or validate release screenshots and store assets.
ReleaseContent {
#[command(subcommand)]
command: release::ReleaseContentCommand,
},
/// Manage beta groups, testers, and beta distribution.
Beta {
#[command(subcommand)]
command: release::BetaCommand,
},
/// Inspect or import signing assets for release builds.
Signing {
#[command(subcommand)]
command: release::SigningCommand,
},
/// List and reply to provider store reviews.
Reviews {
#[command(subcommand)]
command: release::ReviewsCommand,
},
/// Run project-defined release workflows.
ReleaseWorkflow {
#[command(subcommand)]
command: release::ReleaseWorkflowCommand,
},
/// Manage release provider authentication.
Auth {
#[command(subcommand)]
command: release::AuthCommand,
},
/// Attach to logs for an already-running Fission app.
Logs {
/// Restrict device selection to one target.
#[arg(long, value_enum)]
target: Option<Target>,
/// Device id or exact/prefix device name from `fission devices`.
#[arg(long)]
device: Option<String>,
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Continue following logs instead of printing the current buffer.
#[arg(long)]
follow: bool,
},
/// Open the interactive Fission command terminal UI.
Ui {
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Write a PNG screenshot of the rendered terminal frame.
#[arg(long)]
screenshot: Option<PathBuf>,
/// Render once and exit; useful for screenshots and smoke tests.
#[arg(long)]
exit_after_render: bool,
/// Override terminal width in cells.
#[arg(long)]
width: Option<u16>,
/// Override terminal height in cells.
#[arg(long)]
height: Option<u16>,
},
/// Hidden helper used by `fission run --target web --detach`.
#[command(hide = true)]
ServeWeb {
#[arg(long, default_value = ".")]
project_dir: PathBuf,
#[arg(long, default_value = "127.0.0.1")]
host: String,
#[arg(long, default_value_t = 8123)]
port: u16,
#[arg(long)]
open: bool,
},
}
#[derive(Subcommand, Debug)]
pub(crate) enum SiteCommand {
/// Build the static site into its configured output directory.
Build {
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Build in release mode.
#[arg(long)]
release: bool,
},
/// Check the static site by rendering all routes.
Check {
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Build in release mode.
#[arg(long)]
release: bool,
},
/// Serve the generated static site locally.
Serve {
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
/// Host for the local site server.
#[arg(long, default_value = "127.0.0.1")]
host: String,
/// Port for the local site server.
#[arg(long, default_value_t = 8123)]
port: u16,
/// Build in release mode before serving.
#[arg(long)]
release: bool,
/// Do not open a browser.
#[arg(long)]
no_open: bool,
},
/// List custom and content routes.
Routes {
/// Project directory; defaults to the current working directory.
#[arg(long, default_value = ".")]
project_dir: PathBuf,
},
}