oicana_cli 0.1.0

CLI for working with Oicana templates.
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

//! A command line interface for Oicana.
//!
//! Among other things, this CLI can validate and package Oicana templates.

mod compile;
mod new;
mod pack;
mod target;
mod test;
#[cfg(feature = "self-update")]
mod update;
mod validate;
mod watch;

use crate::compile::compile;
use crate::new::{new, NewArgs, NEW_AFTER_HELP};
use crate::pack::{pack, PackArgs};
use crate::validate::{validate, ValidateArgs};
use crate::watch::WATCH_AFTER_HELP;
use anyhow::Error;
use clap::Parser;
use clap_verbosity::{Verbosity, WarnLevel};
use compile::{CompileArgs, COMPILE_AFTER_HELP};
use log::trace;
use pack::PACK_AFTER_HELP;
use test::{test, TestArgs, TEST_AFTER_HELP};
use validate::VALIDATE_AFTER_HELP;
use watch::watch;

fn main() -> Result<(), Error> {
    let cli = Cli::parse();
    env_logger::Builder::new()
        .filter_level(cli.verbosity.log_level_filter())
        .init();
    trace!("{cli:?}");

    match cli.command {
        Oicana::New(args) => new(args)?,
        Oicana::Compile(args) => compile(args)?,
        Oicana::Watch(args) => watch(args)?,
        Oicana::Validate(validate_args) => validate(validate_args)?,
        Oicana::Pack(package_args) => pack(package_args)?,
        Oicana::Test(test_args) => test(test_args)?,
        #[cfg(feature = "self-update")]
        Oicana::Update => update::update()?,
    }

    Ok(())
}

const VERSION: &str = concat!(
    env!("CARGO_PKG_VERSION"),
    " (comes with typst ",
    env!("TYPST_VERSION"),
    ")"
);

#[derive(Parser, Debug)]
#[clap(name = "oicana", version = VERSION, author)]
#[command(name = "oicana")]
#[command(after_help = AFTER_HELP)]
#[command(about = "PDF templating with Typst", long_about = LONG_ABOUT)]
struct Cli {
    #[command(subcommand)]
    command: Oicana,
    #[command(flatten)]
    verbosity: Verbosity<WarnLevel>,
}

#[derive(Parser, Debug)]
enum Oicana {
    #[clap(about = "Scaffold a new Oicana template", after_help = NEW_AFTER_HELP)]
    New(NewArgs),
    #[clap(about = "Compile oicana templates", after_help = COMPILE_AFTER_HELP)]
    Compile(CompileArgs),
    #[clap(about = "Recompile oicana templates on changes", after_help = WATCH_AFTER_HELP)]
    Watch(CompileArgs),
    #[clap(about = "Validate oicana templates", after_help = VALIDATE_AFTER_HELP)]
    Validate(ValidateArgs),
    #[clap(about = "Package oicana templates", after_help = PACK_AFTER_HELP)]
    Pack(PackArgs),
    #[clap(about = "Test oicana templates", after_help = TEST_AFTER_HELP)]
    Test(TestArgs),
    #[cfg(feature = "self-update")]
    #[clap(about = "Update oicana to the latest release")]
    Update,
}

/// Adds a list of useful links after the normal help text.
#[rustfmt::skip]
const AFTER_HELP: &str = color_print::cstr!("\
<s><u>Resources:</></>
  <s>Website:</>  https://oicana.com/
  <s>Code:</>     https://github.com/oicana/oicana/
");

const LONG_ABOUT: &str = r#"
Oicana is a set of tools and libraries to write document templates
using Typst and create PDFs from these templates out of code.
Oicana templates can define inputs and receive values for
these inputs through libraries for different
programming languages and platforms.
"#;