subxt-cli 0.50.1

Command line utilities for working with subxt codegen
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

use clap::Subcommand;

use indoc::writedoc;
use subxt::ArcMetadata;
use subxt_metadata::PalletMetadata;

use crate::utils::{FileOrUrl, Indent, first_paragraph_of_docs};

use self::{
    calls::CallsSubcommand,
    constants::ConstantsSubcommand,
    events::{EventsSubcommand, explore_events},
    storage::StorageSubcommand,
};

use calls::explore_calls;
use constants::explore_constants;
use storage::explore_storage;

mod calls;
mod constants;
mod events;
mod storage;

#[derive(Debug, Clone, Subcommand)]
pub enum PalletSubcommand {
    Calls(CallsSubcommand),
    Constants(ConstantsSubcommand),
    Storage(StorageSubcommand),
    Events(EventsSubcommand),
}

pub async fn run<'a>(
    subcommand: Option<PalletSubcommand>,
    pallet_metadata: PalletMetadata<'a>,
    metadata: ArcMetadata,
    file_or_url: FileOrUrl,
    output: &mut impl std::io::Write,
) -> color_eyre::Result<()> {
    let pallet_name = pallet_metadata.name();
    let Some(subcommand) = subcommand else {
        let docs_string = first_paragraph_of_docs(pallet_metadata.docs()).indent(4);
        if !docs_string.is_empty() {
            writedoc! {output, "
            Description:
            {docs_string}

            "}?;
        }

        writedoc! {output, "
        Usage:
            subxt explore pallet {pallet_name} calls
                explore the calls that can be made into a pallet
            subxt explore pallet {pallet_name} constants
                explore the constants of a pallet
            subxt explore pallet {pallet_name} storage
                explore the storage values of a pallet
            subxt explore pallet {pallet_name} events
                explore the events of a pallet
        "}?;
        return Ok(());
    };

    match subcommand {
        PalletSubcommand::Calls(command) => {
            explore_calls(command, pallet_metadata, metadata, output)
        }
        PalletSubcommand::Constants(command) => {
            explore_constants(command, pallet_metadata, metadata, output)
        }
        PalletSubcommand::Storage(command) => {
            // if the metadata came from some url, we use that same url to make storage calls against.
            explore_storage(command, pallet_metadata, metadata, file_or_url, output).await
        }
        PalletSubcommand::Events(command) => {
            explore_events(command, pallet_metadata, metadata, output)
        }
    }
}