lospec-cli 0.2.0

Lospec CLI is a command-line interface tool that allows users to interact with Lospec's color palettes conveniently. With this tool, you can search for color palettes and download them.
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

use std::path::PathBuf;

use clap::{Parser, ValueEnum};

use crate::cmd::download::{Format, PngSize};

#[derive(Clone, Debug)]
pub enum Sorting {
    Default,
    AZ,
    Downloads,
    Newest,
}

impl ValueEnum for Sorting {
    fn value_variants<'a>() -> &'a [Self] {
        &[Self::Default, Self::AZ, Self::Downloads, Self::Newest]
    }

    fn to_possible_value(&self) -> Option<clap::builder::PossibleValue> {
        Some(match self {
            Sorting::Default => clap::builder::PossibleValue::new("default"),
            Sorting::AZ => clap::builder::PossibleValue::new("az"),
            Sorting::Downloads => clap::builder::PossibleValue::new("downloads"),
            Sorting::Newest => clap::builder::PossibleValue::new("newest"),
        })
    }
}

impl ToString for Sorting {
    fn to_string(&self) -> String {
        match self {
            Sorting::Default => "default".to_string(),
            Sorting::AZ => "alphabetical".to_string(),
            Sorting::Downloads => "downloads".to_string(),
            Sorting::Newest => "newest".to_string(),
        }
    }
}

#[derive(Debug, Parser)]
pub enum Cli {
    #[command(about = "Search for color palettes")]
    Search {
        /// Search for palettes with at most N colors
        #[arg(long, conflicts_with_all = ["min", "exact"])]
        max: Option<u16>,

        /// Search for palettes with at least N colors
        #[arg(long, conflicts_with_all = ["max", "exact"])]
        min: Option<u16>,

        /// Search for palettes with exactly N colors
        #[arg(long, conflicts_with_all = ["max", "min"])]
        exact: Option<u16>,

        /// Show page N
        #[arg(short, long)]
        page: Option<u16>, // TODO: expand to support multiple pages

        /// Search results sorting
        #[arg(long, default_value_t = Sorting::Default)]
        sorting: Sorting,

        /// Search for palettes with a tag
        #[arg(long)]
        tag: Option<String>, // TODO: expand this to perform multiple searches
    },
    #[command(about = "Download a color palette")]
    Download {
        /// The palette slug (for example: `fairydust-8`)
        slug: String,

        /// The path to download the file(s) to. Defaults to `<current_directory>/<slug>`
        #[arg(short, long)]
        path: Option<PathBuf>,

        /// The output format
        #[arg(short, long)]
        format: Format,

        /// The output file size, no-op if the format is not "png"
        #[arg(short, long)]
        size: Option<PngSize>,
    },
}