craftql 0.2.20

A CLI tool to visualize GraphQL schemas and to output a graph data structure as a graphviz .dot format
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

#![deny(unsafe_code, nonstandard_style)]

use anyhow::Result;
use async_std::path::PathBuf;
use clap::Parser;
use craftql::{
    state::{GraphQL, State},
    utils::{
        find_and_print_neighbors, find_and_print_orphans, find_node, get_files,
        populate_graph_from_ast, print_missing_definitions,
    },
};
use petgraph::{
    dot::{Config, Dot},
    Direction,
};

#[derive(Parser)]
#[clap(about, author, version)]
struct Opts {
    /// Path to get files from
    path: PathBuf,

    /// Finds and displays incoming dependencies of a node
    #[clap(short, long)]
    incoming_dependencies: Option<String>,

    /// Finds and displays missing definition(s)
    #[clap(short, long)]
    missing_definitions: bool,

    /// Finds and displays orphan(s) node(s)
    #[clap(short = 'O', long)]
    orphans: bool,

    /// Finds and displays outgoing dependencies of a node
    #[clap(short, long)]
    outgoing_dependencies: Option<String>,

    /// Finds and displays one node
    #[clap(short, long)]
    node: Option<String>,

    /// Finds and displays multiple nodes
    #[clap(short = 'N', long)]
    nodes: Vec<String>,

    /// Filter nodes by GraphQL type(s)
    ///
    /// - directive
    /// - enum
    /// - enum_extension
    /// - input_object
    /// - input_object_extension
    /// - interface
    /// - interface_extension
    /// - object
    /// - object_extension
    /// - scalar
    /// - scalar_extension
    /// - schema
    /// - union
    /// - union_extension
    #[clap(short, long, verbatim_doc_comment)]
    filter: Vec<GraphQL>,
}

#[async_std::main]
async fn main() -> Result<()> {
    let opts: Opts = Opts::parse();
    let state = State::default();
    let shared_data = state.shared;
    let shared_data_for_populate = shared_data.clone();

    // Walk the GraphQL files and populate the data.
    get_files(opts.path, shared_data.files).await?;

    // Populate the graph.
    populate_graph_from_ast(
        shared_data_for_populate.dependencies,
        shared_data_for_populate.files,
        &opts.filter,
        shared_data_for_populate.graph,
        shared_data_for_populate.missing_definitions,
    )
    .await?;

    if let Some(ref node) = opts.incoming_dependencies {
        find_and_print_neighbors(node, shared_data.graph.clone(), Direction::Incoming).await?;

        return Ok(());
    }

    if let Some(ref node) = opts.outgoing_dependencies {
        find_and_print_neighbors(node, shared_data.graph.clone(), Direction::Outgoing).await?;

        return Ok(());
    }

    if let Some(ref node) = opts.node {
        find_node(node, shared_data.graph.clone()).await?;

        return Ok(());
    }

    if !opts.nodes.is_empty() {
        for ref node in opts.nodes {
            find_node(node, shared_data.graph.clone()).await?;
        }

        return Ok(());
    }

    if opts.missing_definitions {
        print_missing_definitions(
            shared_data.graph.clone(),
            shared_data.missing_definitions.clone(),
        )
        .await?;

        return Ok(());
    }

    if opts.orphans {
        find_and_print_orphans(shared_data.graph.clone()).await?;

        return Ok(());
    }

    // Render the graph without edges.
    let graph = &*shared_data.graph.lock().await;
    println!("\n{:?}", Dot::with_config(&graph, &[Config::EdgeNoLabel]));

    Ok(())
}