knowledge-base-cli 0.3.0

Command-line interface for a file-based knowledge base
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

mod read;
mod register;

use super::CommandError;
use clap::Subcommand;
use knowledge_base_crud::KnowledgeBaseRepository;
use knowledge_base_models::ReferenceId;
use std::process::ExitCode;

#[derive(Debug, Subcommand)]
pub enum Command {
    /// Read a reference by identifier.
    Read { id: ReferenceId },
    /// Register or reuse a reference by its canonical URL.
    Register {
        /// Canonical source URL.
        #[arg(long)]
        url: String,
        /// Human-readable source title.
        #[arg(long)]
        title: String,
        /// Source publisher.
        #[arg(long)]
        publisher: Option<String>,
        /// Publication date in YYYY, YYYY-MM, or YYYY-MM-DD form.
        #[arg(long)]
        publication_date: Option<String>,
        /// Source language as a BCP 47 tag.
        #[arg(long)]
        source_language: Option<String>,
        /// Archived copy URL.
        #[arg(long)]
        archive_url: Option<String>,
        /// Validate and report the registration without writing files.
        #[arg(long)]
        dry_run: bool,
    },
}

pub fn execute(command: Command, knowledge_base: &KnowledgeBaseRepository) -> Result<ExitCode, CommandError> {
    match command {
        Command::Read { id } => read::execute(knowledge_base, &id),
        Command::Register {
            url,
            title,
            publisher,
            publication_date,
            source_language,
            archive_url,
            dry_run,
        } => register::execute(
            knowledge_base,
            register::Args {
                url,
                title,
                publisher,
                publication_date,
                source_language,
                archive_url,
                dry_run,
            },
        ),
    }
}