juniper 0.18.0

GraphQL server library.
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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
use std::borrow::Cow;

use crate::{
    ast, graphql,
    parser::{ParseError, SourcePosition, Spanning, Token, document::parse_document_source},
    schema::model::SchemaType,
    types::scalars::{EmptyMutation, EmptySubscription},
    validation::test_harness::{MutationRoot, QueryRoot, SubscriptionRoot},
    value::{DefaultScalarValue, ScalarValue},
};

fn parse_document<S>(s: &str) -> ast::OwnedDocument<'_, S>
where
    S: ScalarValue,
{
    parse_document_source(
        s,
        &SchemaType::new::<QueryRoot, MutationRoot, SubscriptionRoot>(&(), &(), &()),
    )
    .unwrap_or_else(|e| panic!("parse error on input {s:#?}:\n{e}"))
}

fn parse_document_error<S: ScalarValue>(s: &str) -> Spanning<ParseError> {
    match parse_document_source::<S>(
        s,
        &SchemaType::new::<QueryRoot, MutationRoot, SubscriptionRoot>(&(), &(), &()),
    ) {
        Ok(doc) => panic!("*No* parse error on input {s:#?} =>\n{doc:#?}"),
        Err(err) => err,
    }
}

#[test]
fn simple_ast() {
    assert_eq!(
        parse_document::<DefaultScalarValue>(
            // language=GraphQL
            r#"{
                node(id: 4) {
                    id
                    name
                }
            }"#,
        ),
        vec![ast::Definition::Operation(Spanning::start_end(
            &SourcePosition::new(0, 0, 0),
            &SourcePosition::new(111, 5, 13),
            ast::Operation {
                operation_type: ast::OperationType::Query,
                name: None,
                description: None,
                variables_definition: None,
                directives: None,
                selection_set: vec![ast::Selection::Field(Spanning::start_end(
                    &SourcePosition::new(18, 1, 16),
                    &SourcePosition::new(97, 4, 17),
                    ast::Field {
                        alias: None,
                        name: Spanning::start_end(
                            &SourcePosition::new(18, 1, 16),
                            &SourcePosition::new(22, 1, 20),
                            "node",
                        ),
                        arguments: Some(Spanning::start_end(
                            &SourcePosition::new(22, 1, 20),
                            &SourcePosition::new(29, 1, 27),
                            ast::Arguments {
                                items: vec![(
                                    Spanning::start_end(
                                        &SourcePosition::new(23, 1, 21),
                                        &SourcePosition::new(25, 1, 23),
                                        "id",
                                    ),
                                    Spanning::start_end(
                                        &SourcePosition::new(27, 1, 25),
                                        &SourcePosition::new(28, 1, 26),
                                        graphql::input_value!(4),
                                    ),
                                )],
                            },
                        )),
                        directives: None,
                        selection_set: Some(vec![
                            ast::Selection::Field(Spanning::start_end(
                                &SourcePosition::new(52, 2, 20),
                                &SourcePosition::new(54, 2, 22),
                                ast::Field {
                                    alias: None,
                                    name: Spanning::start_end(
                                        &SourcePosition::new(52, 2, 20),
                                        &SourcePosition::new(54, 2, 22),
                                        "id",
                                    ),
                                    arguments: None,
                                    directives: None,
                                    selection_set: None,
                                },
                            )),
                            ast::Selection::Field(Spanning::start_end(
                                &SourcePosition::new(75, 3, 20),
                                &SourcePosition::new(79, 3, 24),
                                ast::Field {
                                    alias: None,
                                    name: Spanning::start_end(
                                        &SourcePosition::new(75, 3, 20),
                                        &SourcePosition::new(79, 3, 24),
                                        "name",
                                    ),
                                    arguments: None,
                                    directives: None,
                                    selection_set: None,
                                },
                            )),
                        ]),
                    },
                ))],
            },
        ))]
    )
}

#[test]
fn description() {
    assert_eq!(
        parse_document::<DefaultScalarValue>(
            // language=GraphQL
            r#"
                "Some description with \u90AB symbol"
                query SomeOperation(
                  "ID you should provide and \u{90AB} symbol"
                  $id: String
                  """
                  Switch for experiment ....
                  Multiline
                  """
                  $enableBaz: Boolean = false
                ) {
                  foo(id: $id) {
                    bar
                    baz @include(if: $enableBaz) {
                      ...BazInfo
                    }
                  }
                }

                """
                Some block description here
                Multiline
                """
                fragment BazInfo on Baz {
                    whatever
                }
            "#,
        ),
        vec![
            ast::Definition::Operation(Spanning::start_end(
                &SourcePosition::new(71, 2, 16),
                &SourcePosition::new(567, 17, 17),
                ast::Operation {
                    operation_type: ast::OperationType::Query,
                    name: Some(Spanning::start_end(
                        &SourcePosition::new(77, 2, 22),
                        &SourcePosition::new(90, 2, 35),
                        "SomeOperation",
                    )),
                    description: Some(Spanning::start_end(
                        &SourcePosition::new(17, 1, 16),
                        &SourcePosition::new(54, 1, 53),
                        Cow::Owned("Some description with \u{90AB} symbol".into()),
                    )),
                    variables_definition: Some(Spanning::start_end(
                        &SourcePosition::new(90, 2, 35),
                        &SourcePosition::new(364, 10, 17),
                        ast::VariablesDefinition {
                            items: vec![
                                (
                                    Spanning::start_end(
                                        &SourcePosition::new(172, 4, 18),
                                        &SourcePosition::new(175, 4, 21),
                                        "id",
                                    ),
                                    ast::VariableDefinition {
                                        description: Some(Spanning::start_end(
                                            &SourcePosition::new(110, 3, 18),
                                            &SourcePosition::new(153, 3, 61),
                                            Cow::Owned(
                                                "ID you should provide and \u{90AB} symbol".into(),
                                            ),
                                        )),
                                        var_type: Spanning::start_end(
                                            &SourcePosition::new(177, 4, 23),
                                            &SourcePosition::new(183, 4, 29),
                                            ast::Type::nullable("String"),
                                        ),
                                        default_value: None,
                                        directives: None,
                                    },
                                ),
                                (
                                    Spanning::start_end(
                                        &SourcePosition::new(319, 9, 18),
                                        &SourcePosition::new(329, 9, 28),
                                        "enableBaz",
                                    ),
                                    ast::VariableDefinition {
                                        description: Some(Spanning::start_end(
                                            &SourcePosition::new(202, 5, 18),
                                            &SourcePosition::new(300, 8, 21),
                                            Cow::Borrowed("Switch for experiment ....\nMultiline"),
                                        )),
                                        var_type: Spanning::start_end(
                                            &SourcePosition::new(331, 9, 30),
                                            &SourcePosition::new(338, 9, 37),
                                            ast::Type::nullable("Boolean"),
                                        ),
                                        default_value: Some(Spanning::start_end(
                                            &SourcePosition::new(341, 9, 40),
                                            &SourcePosition::new(346, 9, 45),
                                            graphql::input_value!(false),
                                        )),
                                        directives: None,
                                    },
                                )
                            ],
                        }
                    )),
                    directives: None,
                    selection_set: vec![ast::Selection::Field(Spanning::start_end(
                        &SourcePosition::new(385, 11, 18),
                        &SourcePosition::new(549, 16, 19),
                        ast::Field {
                            alias: None,
                            name: Spanning::start_end(
                                &SourcePosition::new(385, 11, 18),
                                &SourcePosition::new(388, 11, 21),
                                "foo",
                            ),
                            arguments: Some(Spanning::start_end(
                                &SourcePosition::new(388, 11, 21),
                                &SourcePosition::new(397, 11, 30),
                                ast::Arguments {
                                    items: vec![(
                                        Spanning::start_end(
                                            &SourcePosition::new(389, 11, 22),
                                            &SourcePosition::new(391, 11, 24),
                                            "id",
                                        ),
                                        Spanning::start_end(
                                            &SourcePosition::new(393, 11, 26),
                                            &SourcePosition::new(396, 11, 29),
                                            graphql::input_value!(@id),
                                        ),
                                    )],
                                },
                            )),
                            directives: None,
                            selection_set: Some(vec![
                                ast::Selection::Field(Spanning::start_end(
                                    &SourcePosition::new(420, 12, 20),
                                    &SourcePosition::new(423, 12, 23),
                                    ast::Field {
                                        alias: None,
                                        name: Spanning::start_end(
                                            &SourcePosition::new(420, 12, 20),
                                            &SourcePosition::new(423, 12, 23),
                                            "bar",
                                        ),
                                        arguments: None,
                                        directives: None,
                                        selection_set: None,
                                    },
                                )),
                                ast::Selection::Field(Spanning::start_end(
                                    &SourcePosition::new(444, 13, 20),
                                    &SourcePosition::new(529, 15, 21),
                                    ast::Field {
                                        alias: None,
                                        name: Spanning::start_end(
                                            &SourcePosition::new(444, 13, 20),
                                            &SourcePosition::new(447, 13, 23),
                                            "baz",
                                        ),
                                        arguments: None,
                                        directives: Some(vec![Spanning::start_end(
                                            &SourcePosition::new(448, 13, 24),
                                            &SourcePosition::new(472, 13, 48),
                                            ast::Directive {
                                                name: Spanning::start_end(
                                                    &SourcePosition::new(449, 13, 25),
                                                    &SourcePosition::new(456, 13, 32),
                                                    "include",
                                                ),
                                                arguments: Some(Spanning::start_end(
                                                    &SourcePosition::new(456, 13, 32),
                                                    &SourcePosition::new(472, 13, 48),
                                                    ast::Arguments {
                                                        items: vec![(
                                                            Spanning::start_end(
                                                                &SourcePosition::new(457, 13, 33),
                                                                &SourcePosition::new(459, 13, 35),
                                                                "if",
                                                            ),
                                                            Spanning::start_end(
                                                                &SourcePosition::new(461, 13, 37),
                                                                &SourcePosition::new(471, 13, 47),
                                                                graphql::input_value!(@enableBaz),
                                                            ),
                                                        )],
                                                    },
                                                )),
                                            },
                                        )]),
                                        selection_set: Some(vec![ast::Selection::FragmentSpread(
                                            Spanning::start_end(
                                                &SourcePosition::new(497, 14, 22),
                                                &SourcePosition::new(507, 14, 32),
                                                ast::FragmentSpread {
                                                    name: Spanning::start_end(
                                                        &SourcePosition::new(500, 14, 25),
                                                        &SourcePosition::new(507, 14, 32),
                                                        "BazInfo",
                                                    ),
                                                    directives: None,
                                                },
                                            )
                                        )]),
                                    },
                                )),
                            ]),
                        },
                    ))],
                },
            )),
            ast::Definition::Fragment(Spanning::start_end(
                &SourcePosition::new(695, 23, 16),
                &SourcePosition::new(767, 25, 17),
                ast::Fragment {
                    name: Spanning::start_end(
                        &SourcePosition::new(704, 23, 25),
                        &SourcePosition::new(711, 23, 32),
                        "BazInfo",
                    ),
                    description: Some(Spanning::start_end(
                        &SourcePosition::new(585, 19, 16),
                        &SourcePosition::new(678, 22, 19),
                        Cow::Borrowed("Some block description here\nMultiline"),
                    )),
                    type_condition: Spanning::start_end(
                        &SourcePosition::new(715, 23, 36),
                        &SourcePosition::new(718, 23, 39),
                        "Baz",
                    ),
                    directives: None,
                    selection_set: vec![ast::Selection::Field(Spanning::start_end(
                        &SourcePosition::new(741, 24, 20),
                        &SourcePosition::new(749, 24, 28),
                        ast::Field {
                            alias: None,
                            name: Spanning::start_end(
                                &SourcePosition::new(741, 24, 20),
                                &SourcePosition::new(749, 24, 28),
                                "whatever",
                            ),
                            arguments: None,
                            directives: None,
                            selection_set: None,
                        },
                    ))]
                }
            ))
        ]
    )
}

#[test]
fn errors() {
    assert_eq!(
        parse_document_error::<DefaultScalarValue>("{"),
        Spanning::zero_width(
            &SourcePosition::new(1, 0, 1),
            ParseError::UnexpectedEndOfFile
        )
    );

    assert_eq!(
        parse_document_error::<DefaultScalarValue>("{ ...MissingOn }\nfragment MissingOn Type"),
        Spanning::start_end(
            &SourcePosition::new(36, 1, 19),
            &SourcePosition::new(40, 1, 23),
            ParseError::UnexpectedToken("Type".into())
        )
    );

    assert_eq!(
        parse_document_error::<DefaultScalarValue>("{ ...on }"),
        Spanning::start_end(
            &SourcePosition::new(8, 0, 8),
            &SourcePosition::new(9, 0, 9),
            ParseError::unexpected_token(Token::CurlyClose)
        )
    );

    // Descriptions are not permitted on query shorthand.
    // See: https://spec.graphql.org/September2025#sel-GAFTRJABAByBz7P
    assert_eq!(
        parse_document_error::<DefaultScalarValue>(r#""description" { foo }"#),
        Spanning::start_end(
            &SourcePosition::new(14, 0, 14),
            &SourcePosition::new(15, 0, 15),
            ParseError::unexpected_token(Token::CurlyOpen)
        ),
    );
}

#[test]
fn issue_427_panic_is_not_expected() {
    struct QueryWithoutFloat;

    #[crate::graphql_object]
    impl QueryWithoutFloat {
        fn echo(value: String) -> String {
            value
        }
    }

    let schema = <SchemaType<DefaultScalarValue>>::new::<
        QueryWithoutFloat,
        EmptyMutation<()>,
        EmptySubscription<()>,
    >(&(), &(), &());
    let parse_result = parse_document_source(r##"{ echo(value: 123.0) }"##, &schema);

    assert_eq!(
        parse_result.unwrap_err().item,
        ParseError::ExpectedScalarError("There needs to be a Float type")
    );
}