h3o-cli 0.2.10

A CLI app that exposes most of the h3o API for scripting.
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

//! Expose [`CellIndex::parent`]

use anyhow::Result as AnyResult;
use clap::{Parser, ValueEnum};
use h3o::{CellIndex, Resolution};
use serde::Serialize;

/// Converts an index into its parent.
///
/// This command generates the hierarchical parent of a cell index at the
/// specified resolution. If the specified resolution is greater than or equal to
/// the resolution of the index, only the given cell is returned.
#[derive(Parser, Debug)]
#[command(author, version)]
pub struct Args {
    /// Converts parents from this index.
    #[arg(short, long)]
    child: Option<CellIndex>,

    /// Resolution, if greater than PARENT's resolution only PARENT is printed.
    #[arg(short, long, default_value_t = Resolution::Zero)]
    resolution: Resolution,

    /// Output format.
    #[arg(short, long, value_enum, default_value_t = Format::Text)]
    format: Format,

    /// Prettify the output (JSON only).
    #[arg(short, long, default_value_t = false)]
    pretty: bool,
}

#[derive(Debug, Copy, Clone, PartialEq, Eq, ValueEnum)]
enum Format {
    Text,
    Json,
}

/// Run the `cellToParent` command.
pub fn run(args: &Args) -> AnyResult<()> {
    let indexes = crate::utils::get_cell_indexes(args.child)
        .map(|child| child.map(|child| (child, child.parent(args.resolution))));

    match args.format {
        Format::Text => {
            for result in indexes {
                let (child, parent) = result?;
                println!("{}", parent.unwrap_or(child));
            }
        }
        Format::Json => {
            #[derive(Serialize)]
            struct ChildParent {
                child: crate::json::CellIndex,
                parent: Option<crate::json::CellIndex>,
            }

            let indexes = indexes
                .map(|result| {
                    result.map(|(child, parent)| ChildParent {
                        child: child.into(),
                        parent: parent.map(Into::into),
                    })
                })
                .collect::<AnyResult<Vec<_>>>()?;

            crate::json::print(&indexes, args.pretty)?;
        }
    }

    Ok(())
}