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
//! # sqltrail-cli
//!
//! 通用的 PostgreSQL 结构迁移库与命令行工具。
//!
//! 提供完整迁移流水线:
//! **连接数据库 → 读取实际结构 → 与期望结构比较 → 生成迁移计划 → 渲染 SQL → 执行并记录历史**。
//!
//! ## 作为库使用(可被任意 Rust 项目引用)
//!
//! ```rust,ignore
//! use sqltrail_cli::{plan_from_database, SchemaModel, MigrationPlan};
//!
//! #[tokio::main]
//! async fn main() -> anyhow::Result<()> {
//! let client = sqltrail_cli::database::connect("postgres://user:pass@localhost:5432/db").await?;
//!
//! // 期望结构来源一:你的 Rust struct(配合 sqltrail-macros 派生宏)
//! let desired: SchemaModel = /* User::schema() 或从 JSON 加载 */ SchemaModel::default();
//!
//! // 期望结构来源二:加载 SchemaModel JSON 文件(可由 inspect 导出)
//! // let desired: SchemaModel = serde_json::from_str(&std::fs::read_to_string("desired.json")?)?;
//!
//! let plan: MigrationPlan = plan_from_database(&client, &desired).await?;
//! println!("{}", sqltrail_cli::generator::render_plan(&plan));
//! Ok(())
//! }
//! ```
//!
//! ## 作为 CLI 使用
//!
//! ```text
//! sqltrail-cli status
//! sqltrail-cli inspect
//! sqltrail-cli plan --desired desired.json
//! sqltrail-cli generate add_user_avatar --desired desired.json
//! sqltrail-cli apply [--allow-destructive]
//! ```
// 结构模型、差异计算、迁移计划与统一校验全部通过本 crate 再导出,
// 接入项目只需依赖 sqltrail-cli(或直接依赖 sqltrail-core)。
pub use *;
/// 便捷入口:读取数据库实际结构,与期望结构比较,返回迁移计划。
///
/// 等价于 `build_plan(&compute_diff(desired, &introspection::introspect(client).await?))`。
pub async