cargo-api 0.1.1

Elegant Rust API which wraps the cargo HTTP API
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

use cargo_api::api::crates::Crate;
use cargo_api::api::{Json, Query};
use cargo_api::client::ReqwestClient;
use clap::{Args, Parser};
use std::borrow::Cow;

fn main() -> anyhow::Result<()> {
    let CargoCli::Api(args) = CargoCli::parse();

    let client = ReqwestClient::new(args.user_agent.as_str());

    match args.subcommand {
        Subcommand::Crate(opts) => {
            let endpoint = Json::new(Crate::new(Cow::Borrowed(opts.name.as_str())));
            let value = endpoint.query(&client)?;
            println!("{}", value);
        }
    }

    Ok(())
}

#[derive(Parser)] // requires `derive` feature
#[command(name = "cargo")]
#[command(bin_name = "cargo")]
#[command(styles = CLAP_STYLING)]
enum CargoCli {
    Api(ApiArgs),
}

pub const CLAP_STYLING: clap::builder::styling::Styles = clap::builder::styling::Styles::styled()
    .header(clap_cargo::style::HEADER)
    .usage(clap_cargo::style::USAGE)
    .literal(clap_cargo::style::LITERAL)
    .placeholder(clap_cargo::style::PLACEHOLDER)
    .error(clap_cargo::style::ERROR)
    .valid(clap_cargo::style::VALID)
    .invalid(clap_cargo::style::INVALID);

#[derive(clap::Args)]
#[command(version, about, long_about = None)]
struct ApiArgs {
    #[command(flatten)]
    manifest: clap_cargo::Manifest,

    #[arg(long)]
    user_agent: String,

    #[command(subcommand)]
    subcommand: Subcommand,
}

#[derive(clap::Subcommand)]
#[command(propagate_version = true)]
pub enum Subcommand {
    /// Print details for a specific crate.
    ///
    /// Endpoint: /api/v1/crates/:name
    Crate(CrateOpts),
}

#[derive(Debug, Args)]
#[command(next_help_heading = "Crate options")]
pub struct CrateOpts {
    #[arg(value_name = "name")]
    name: String,
}