rok-sqlc 0.7.0

Generate SQLx Rust database modules from SQL schema files
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

//! A feature's small files: `mod.rs`, declaring the others and re-exporting
//! what `generated.rs` and `app.rs` use, and `model.rs` and `repo.rs`,
//! re-exporting the table's rows and functions from the data layer.

use super::feature::Feature;
use crate::generator::HEADER;

/// Renders the feature's `mod.rs`.
pub fn render_mod(feature: &Feature<'_>) -> String {
    format!(
        "{HEADER}
//! The `{table}` API feature, under `{url}`. Every file but `service.rs` is
//! regenerated by `rok-sqlc g`; `service.rs` is yours.

/// Request and response bodies.
pub mod dto;
/// The handlers: parse, call one service method, answer.
pub mod handlers;
/// The rows and typed ids, from the data layer.
pub mod model;
/// The data layer's functions for `{table}`.
pub mod repo;
/// The URL to handler mapping.
pub mod routes;
/// `{service}`: yours to change.
pub mod service;
/// `{service_api}`: one method per endpoint, each with a default.
pub mod service_api;

pub use routes::routes;
pub use service::{service};
pub use service_api::{service_api};
",
        table = feature.table.display_name(),
        url = feature.url,
        service = feature.service(),
        service_api = feature.service_api(),
    )
}

/// Renders `model.rs`.
pub fn render_model(feature: &Feature<'_>) -> String {
    format!(
        "{HEADER}\n//! The `{}` rows, inputs and typed ids, from the data layer.\n\npub use {}::models::*;\n",
        feature.table.display_name(),
        feature.db_module()
    )
}

/// Renders `repo.rs`.
pub fn render_repo(feature: &Feature<'_>) -> String {
    let module = feature.db_module();
    let mut output = format!(
        "{HEADER}\n//! The data layer's functions for `{}`: reads, writes, and the list's.\n\n",
        feature.table.display_name()
    );
    if super::has_listing(feature) {
        output.push_str(&format!("pub use {module}::listing::*;\n"));
    }
    output.push_str(&format!("pub use {module}::read::*;\n"));
    if !feature.relations.is_empty() {
        output.push_str(&format!("pub use {module}::relationships::*;\n"));
    }
    output.push_str(&format!("pub use {module}::write::*;\n"));
    output
}