papr-pdf 0.1.0

A fast, keyboard-first CLI tool to compile Markdown, LaTeX, and plain text files into publication-grade PDFs.
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

//! Command-line argument definitions and data structures for `papr`.

use clap::{Parser, ValueEnum};
use std::path::PathBuf;

/// Document format selector.
#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
pub enum DocumentFormat {
    /// Markdown (.md, .markdown) format with KaTeX math & syntax-highlighting.
    #[value(name = "md", alias = "markdown")]
    Markdown,

    /// LaTeX (.tex) document with multi-file and package resolution.
    #[value(name = "tex", alias = "latex")]
    Latex,

    /// Plain text (.txt) file with line-wrapping and clean monospace layout.
    #[value(name = "txt", alias = "text")]
    PlainText,
}

/// Visual styling themes for Markdown and Plain Text conversions.
#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum, Default)]
pub enum Theme {
    /// Classical publication style with serif Latin Modern typography.
    #[default]
    #[value(name = "academic")]
    Academic,

    /// Clean GitHub Flavored Markdown aesthetic.
    #[value(name = "github")]
    Github,

    /// Minimalist modern sans-serif aesthetic with soft accents.
    #[value(name = "modern")]
    Modern,

    /// High-contrast dark theme optimized for OLED / reading screens.
    #[value(name = "dark")]
    Dark,
}

/// Command-line arguments parsed by Clap.
#[derive(Parser, Debug)]
#[command(
    name = "papr",
    author = "Rishal",
    version = "0.1.0",
    about = "Lightning-fast CLI tool to compile Markdown, LaTeX, and Plain Text files into publication-grade PDFs.",
    long_about = "papr compiles Markdown (.md), LaTeX (.tex), and Plain Text (.txt) documents into PDFs.\nRun 'papr' with no arguments to launch the interactive prompt, or pass a file directly."
)]
pub struct Cli {
    /// Path to the input file (.md, .tex, or .txt). If omitted, launches interactive wizard.
    #[arg(value_name = "INPUT")]
    pub input: Option<PathBuf>,

    /// Destination path for the generated PDF. Defaults to '<input_name>.pdf'.
    #[arg(short, long, value_name = "OUTPUT")]
    pub output: Option<PathBuf>,

    /// Explicitly specify document format (md, tex, txt). Auto-detected if omitted.
    #[arg(short, long, value_enum)]
    pub format: Option<DocumentFormat>,

    /// Styling theme for Markdown and Plain Text conversions.
    #[arg(short, long, value_enum, default_value_t = Theme::Academic)]
    pub theme: Theme,

    /// Automatically open the generated PDF in the system default viewer.
    #[arg(long)]
    pub open: bool,
}