crude 0.1.4

Migration toolkit for databases
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
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
104
105
106
107
108

use anstream::eprintln;
use clap::Parser;
use clap_verbosity_flag::{InfoLevel, Verbosity};
use colorchoice_clap::Color;
use owo_colors::OwoColorize;
use proc_exit::Code;

use crate::{
    commands::Subcommands,
    error::{Result, exit},
};

mod db;
mod migration;

pub mod error;
mod styles;

pub mod commands;

pub use migration::planner::PlanOptions;

/// Migration toolkit for databases
#[derive(Debug, Parser)]
#[clap(name = "crude", version)]
#[command(styles = styles::styles())]
pub struct App {
    #[command(subcommand)]
    pub cmd: Subcommands,

    #[command(flatten)]
    pub color: Color,

    #[command(flatten)]
    pub verbose: Verbosity<InfoLevel>,

    #[command(flatten)]
    pub options: Options,
}

#[derive(Debug, Parser)]
#[clap(next_help_heading = "Global Options")]
pub struct Options {
    /// Database URL
    #[arg(short, long, env = "DATABASE_URL")]
    pub url: Option<String>,

    /// Directory containing migrations
    #[arg(
        short = 'd',
        long,
        default_value = "./db/migrations",
        env = "MIGRATIONS_DIR"
    )]
    pub migrations_dir: Option<String>,

    /// File to dump the schema to
    #[arg(short, long, env = "SCHEMA_FILE")]
    pub schema: Option<String>,
}

impl App {
    pub fn run(self) -> Result {
        self.cmd.run(&self.options)
    }

    pub fn new(cmd: Subcommands, options: Options) -> Self {
        App {
            cmd,
            color: Color::default(),
            verbose: Verbosity::default(),
            options,
        }
    }
}

impl Options {
    /// Get the database URL or error out if not provided
    pub fn get_url(&self) -> Result<&str> {
        if let Some(url) = self.url.as_ref() {
            return Ok(url);
        }

        eprintln!(
            "{} the following required arguments were not provided:\n  {}\n\n{} {}{}\n\nFor more information, try '{}'.",
            "error:".red().bold(),
            "--url <URL>".green(),
            "Usage:".yellow(),
            "crude --url ".green(),
            "<URL> <COMMAND>".cyan(),
            "--help".green(),
        );

        exit(Code::FAILURE);
    }
}

#[cfg(test)]
mod test {
    use super::*;

    use clap::CommandFactory;

    #[test]
    fn verify_app() {
        App::command().debug_assert();
    }
}