qail 0.28.0

Schema-first database toolkit - migrations, diff, lint, and query generation
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

//! Migration creation

use crate::colors::*;
use anyhow::Result;

/// Create a new named migration file pair (up + down) with timestamp prefix.
/// ## Generated Files
/// ```text
/// deltas/
/// ├── 20251231093400123_add_users.up.qail
/// └── 20251231093400123_add_users.down.qail
/// ```
pub fn migrate_create(name: &str, depends: Option<&str>, author: Option<&str>) -> Result<()> {
    println!("{}", "📝 Creating Migration".cyan().bold());
    println!();

    let timestamp = crate::time::timestamp_version();
    let created = crate::time::timestamp_rfc3339();

    // Ensure deltas directory exists
    let migrations_dir = super::resolve_deltas_dir(true)?;

    // Build metadata header
    let mut meta_lines = vec![
        format!("-- @name: {}_{}", timestamp, name),
        format!("-- @created: {}", created),
    ];

    if let Some(auth) = author {
        meta_lines.push(format!("-- @author: {}", auth));
    }

    if let Some(deps) = depends {
        meta_lines.push(format!("-- @depends: {}", deps));
    }

    let meta_header = meta_lines.join("\n");

    // Create UP migration
    let up_filename = format!("{}_{}.up.qail", timestamp, name);
    let up_filepath = migrations_dir.join(&up_filename);
    let up_content = format!(
        "{}\n\n-- Add your UP migration below:\n-- Example: make users (id serial primary, email text unique)\n\n",
        meta_header
    );
    std::fs::write(&up_filepath, &up_content)?;

    // Create DOWN migration
    let down_filename = format!("{}_{}.down.qail", timestamp, name);
    let down_filepath = migrations_dir.join(&down_filename);
    let down_content = format!(
        "{}\n\n-- Add your DOWN (rollback) migration below:\n-- Example: drop users\n\n",
        meta_header
    );
    std::fs::write(&down_filepath, &down_content)?;

    println!("  {} {}", "✓ Created:".green(), up_filepath.display());
    println!("  {} {}", "✓ Created:".green(), down_filepath.display());
    println!();
    println!("  Migration: {}", format!("{}_{}", timestamp, name).cyan());

    if let Some(deps) = depends {
        println!("  Depends:   {}", deps.yellow());
    }
    if let Some(auth) = author {
        println!("  Author:    {}", auth.dimmed());
    }
    println!();
    println!("  Next steps:");
    println!(
        "    1. Edit {} with your schema changes",
        up_filename.yellow()
    );
    println!("    2. Edit {} with rollback logic", down_filename.yellow());
    println!(
        "    3. Run: {} schema.qail:deltas/ postgres://...",
        "qail migrate up".cyan()
    );

    Ok(())
}