cratestack-parser 0.3.7

Rust-native schema-first framework for typed HTTP APIs, generated clients, and backend services.
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

use std::collections::BTreeMap;

pub(super) fn split_procedure_docs(
    docs: Vec<String>,
) -> (Vec<String>, BTreeMap<String, Vec<String>>) {
    let mut procedure_docs = Vec::new();
    let mut arg_docs = BTreeMap::<String, Vec<String>>::new();

    for doc in docs {
        if let Some(param) = doc.strip_prefix("@param ") {
            let mut parts = param.trim().splitn(2, char::is_whitespace);
            let Some(name) = parts.next() else {
                continue;
            };
            let description = parts.next().unwrap_or_default().trim();
            if description.is_empty() {
                continue;
            }
            arg_docs
                .entry(name.to_owned())
                .or_default()
                .push(description.to_owned());
        } else {
            procedure_docs.push(doc);
        }
    }

    (procedure_docs, arg_docs)
}