rsonpath 0.10.0

Blazing fast JSONPath CLI tool powered by SIMD
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

use crate::version;
use clap::{Parser, ValueEnum};

#[derive(Parser, Debug)]
#[clap(name = "rq", author, version, about)]
#[clap(long_version = version::get_long_version())]
/// Blazing fast JSONPath CLI tool powered by SIMD.
///
/// A usage guide is available at <https://v0ldek.github.io/rsonpath/>.
pub(super) struct Args {
    /// JSONPath query to run against the input JSON.
    pub query: String,
    /// Input JSON file to query.
    ///
    /// If neither file nor --json is specified, uses the standard input stream.
    pub file_path: Option<String>,
    /// Inline input JSON to query.
    #[clap(long)]
    #[arg(conflicts_with = "file_path")]
    pub json: Option<String>,
    /// Include verbose debug information.
    #[clap(short, long)]
    pub verbose: bool,
    /// Only compile the query and output the automaton, do not run the engine.
    ///
    /// Cannot be used with FILE_PATH.
    #[clap(short, long)]
    #[arg(conflicts_with = "file_path")]
    pub compile: bool,
    /// Result reporting mode.
    #[clap(short, long, value_enum, default_value_t = ResultArg::Nodes)]
    pub result: ResultArg,
    /// Bypass automatic resolution of the input strategy and force a specific one.
    ///
    /// This is not recommended in general, since the app automatically picks a strategy
    /// that will result in best performance. It might be useful, however, if the automatic
    /// resolution picks a subpar strategy, or if it is known ahead of time that memory maps
    /// are not available and there is no need for the app to try to create one.
    #[clap(long)]
    pub force_input: Option<InputArg>,
}

#[derive(ValueEnum, Debug, Clone, Copy, PartialEq, Eq)]
pub(super) enum ResultArg {
    /// Return only the number of matches.
    Count,
    /// Return a list of all bytes at which a match occurred.
    Indices,
    /// Returns the full text of the matched nodes.
    Nodes,
}

#[derive(ValueEnum, Debug, Clone, Copy, PartialEq, Eq)]
pub(super) enum InputArg {
    /// Use a memory map over a file.
    ///
    /// This is preferred by default, if available on a given platform.
    /// Forcing usage of mmap when it is not available will cause an error and will not try a different input.
    Mmap,
    /// Eagerly load all the input into memory before running the query.
    Eager,
    /// Read the input in chunks with a buffer.
    Buffered,
}