prax-schema 0.10.0

Schema parser and AST for the Prax ORM
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

//! Validator coverage for @generated and aggregate field combinations.

use prax_schema::SchemaError;

/// Parse and validate the given schema text; return an error string that
/// contains the concatenated messages of every sub-error inside
/// `ValidationFailed`, or the top-level error text if it isn't that variant.
fn error_text(schema_text: &str) -> String {
    match prax_schema::validate_schema(schema_text) {
        Ok(_) => String::new(), // no error
        Err(SchemaError::ValidationFailed { errors, .. }) => errors
            .iter()
            .map(|e| format!("{e}"))
            .collect::<Vec<_>>()
            .join("\n"),
        Err(e) => format!("{e}"),
    }
}

fn assert_error_contains(schema_text: &str, expected_fragment: &str) {
    let result = prax_schema::validate_schema(schema_text);
    assert!(
        result.is_err(),
        "expected validation error containing `{expected_fragment}`, but schema parsed clean"
    );
    let text = error_text(schema_text);
    assert!(
        text.contains(expected_fragment),
        "expected `{expected_fragment}` in error output, got:\n{text}"
    );
}

// ── helpers ────────────────────────────────────────────────────────────────

const DS: &str = r#"
datasource db {
    provider = "postgresql"
    url = env("DATABASE_URL")
}
"#;

// ── tests ──────────────────────────────────────────────────────────────────

#[test]
fn rejects_generated_with_id() {
    let schema = format!(
        r#"{DS}
model User {{
    id Int @id @auto @generated("1")
}}
"#
    );
    assert_error_contains(&schema, "cannot be both @generated and @id/@auto");
}

#[test]
fn rejects_empty_generated_expression() {
    let schema = format!(
        r#"{DS}
model User {{
    id   Int    @id @auto
    name String @generated("   ")
}}
"#
    );
    assert_error_contains(&schema, "@generated expression must not be empty");
}

#[test]
fn rejects_count_with_field_path() {
    let schema = format!(
        r#"{DS}
model Post {{
    id        Int @id @auto
    author_id Int
}}

model User {{
    id    Int    @id @auto
    posts Post[]  @relation(fields: [author_id], references: [id])
    bad   Int     @count(posts.id)
}}
"#
    );
    assert_error_contains(&schema, "@count takes a relation name");
}

#[test]
fn rejects_sum_without_field() {
    let schema = format!(
        r#"{DS}
model Post {{
    id        Int @id @auto
    author_id Int
    views     Int
}}

model User {{
    id    Int    @id @auto
    posts Post[]  @relation(fields: [author_id], references: [id])
    bad   Int     @sum(posts)
}}
"#
    );
    assert_error_contains(&schema, "requires `relation.field`");
}

#[test]
fn rejects_unknown_relation_in_count() {
    let schema = format!(
        r#"{DS}
model User {{
    id  Int @id @auto
    bad Int @count(nope)
}}
"#
    );
    assert_error_contains(&schema, "unknown relation `nope`");
}

#[test]
fn rejects_orphan_stored() {
    let schema = format!(
        r#"{DS}
model User {{
    id   Int    @id @auto
    name String @stored
}}
"#
    );
    assert_error_contains(&schema, "@stored is only valid alongside @generated");
}