package/
args.rs

1// Copyright 2024 The Fuchsia Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5use argh::FromArgs;
6use fidl_fuchsia_dash as fdash;
7
8#[derive(FromArgs, PartialEq, Debug)]
9#[argh(name = "package", description = "Interact with the packaging system.")]
10pub struct PackageArgs {
11    #[argh(subcommand)]
12    pub subcommand: PackageSubcommand,
13}
14
15#[derive(FromArgs, PartialEq, Debug)]
16#[argh(subcommand)]
17pub enum PackageSubcommand {
18    Explore(ExploreArgs),
19}
20
21#[derive(FromArgs, Debug, PartialEq)]
22#[argh(subcommand, name = "explore", description = "Same as `ffx target package explore`")]
23pub struct ExploreArgs {
24    #[argh(positional)]
25    /// the package URL to resolve. If `subpackages` is empty the resolved package directory will
26    /// be loaded into the shell's namespace at `/pkg`.
27    pub url: String,
28
29    #[argh(option, long = "subpackage")]
30    /// the chain of subpackages, if any, of `url` to resolve, in resolution order.
31    /// If `subpackages` is not empty, the package directory of the final subpackage will be
32    /// loaded into the shell's namespace at `/pkg`.
33    pub subpackages: Vec<String>,
34
35    #[argh(option)]
36    /// list of URLs of tools packages to include in the shell environment.
37    /// the PATH variable will be updated to include binaries from these tools packages.
38    /// repeat `--tools url` for each package to be included.
39    /// The path preference is given by command line order.
40    pub tools: Vec<String>,
41
42    #[argh(option, short = 'c', long = "command")]
43    /// execute a command instead of reading from stdin.
44    /// the exit code of the command will be forwarded to the host.
45    pub command: Option<String>,
46
47    #[argh(option, default = "fdash::FuchsiaPkgResolver::Full", from_str_fn(parse_resolver))]
48    /// the resolver to use when resolving package URLs with scheme "fuchsia-pkg".
49    /// Possible values are "base" and "full". Defaults to "full".
50    pub fuchsia_pkg_resolver: fdash::FuchsiaPkgResolver,
51}
52
53fn parse_resolver(flag: &str) -> Result<fdash::FuchsiaPkgResolver, String> {
54    Ok(match flag {
55        "base" => fdash::FuchsiaPkgResolver::Base,
56        "full" => fdash::FuchsiaPkgResolver::Full,
57        _ => return Err("supported fuchsia-pkg resolvers are: 'base' and 'full'".into()),
58    })
59}
package/args.rs

package/
args.rs
