ietf-rfc 0.1.0

A CLI tool to search, retrieve, and display IETF RFCs and drafts
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

use anyhow::Result;

use crate::api::DataTrackerClient;
use crate::models::SearchFilter;

pub struct Args {
    pub query: String,
    pub filter: SearchFilter,
    pub limit: usize,
}

pub async fn run(args: Args) -> Result<()> {
    let client = DataTrackerClient::new()?;

    eprintln!("Searching for '{}'...", args.query);

    let results = client
        .search(&args.query, args.filter, args.limit as u32)
        .await?;

    if results.is_empty() {
        println!("No results found for '{}'", args.query);
        return Ok(());
    }

    let shown = results.len();

    if let Some(total) = results.total_count {
        if results.has_more {
            println!(
                "\nShowing {} of {} results. Increase --limit <N> to show more.\n",
                shown, total
            );
        } else {
            println!("\nFound {} results:\n", total);
        }
    } else if results.has_more {
        println!(
            "\nShowing {} results. Increase --limit <N> to show more.\n",
            shown
        );
    } else {
        println!("\nFound {} results:\n", shown);
    }

    let max_name_width = results
        .documents
        .iter()
        .map(|doc| doc.doc_type.name().len())
        .max()
        .unwrap_or(10);

    // 80-col target line: name column + 2-space gutter + title.
    let title_width = 80_usize
        .saturating_sub(max_name_width)
        .saturating_sub(4)
        .min(77);

    for doc in &results.documents {
        println!(
            "{:<width$}  {}",
            doc.doc_type.name(),
            doc.short_title(title_width),
            width = max_name_width
        );
    }

    println!("\nUse 'rfc <document>' to read a document");
    Ok(())
}