satay-codegen 0.8.0

Generate Rust client code from OpenAPI 3.1 documents
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

use crate::ast::*;
use crate::common::*;

#[test]
fn integer_bounds_infer_smallest_rust_type_and_can_be_overridden() {
    let files = satay_codegen::generate(
        r#"
openapi: 3.1.0
info:
  title: Test API
  version: 1.0.0
paths:
  /buses:
    get:
      operationId: getBuses
      responses:
        '200':
          description: Buses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bus'
components:
  schemas:
    Bus:
      type: object
      required:
        - direction
        - byte
        - legacyDirection
        - noBounds
      properties:
        direction:
          type: integer
          format: int32
          minimum: 1
          maximum: 2
        byte:
          type: integer
          format: int64
          minimum: 0
          maximum: 255
        legacyDirection:
          type: integer
          format: int32
          minimum: 1
          maximum: 2
          x-satay:
            integer-type: i32
        noBounds:
          type: integer
          format: int32
"#,
    )
    .expect("generate integer inference fixture");

    let types_rs = parse_rust(find_file(&files, "types.rs"));
    assert_tuple_struct(&types_rs, "BusDirection", "u8");
    assert_tuple_struct(&types_rs, "BusLegacyDirection", "i32");
    let bus = find_struct(&types_rs, "Bus");
    assert_field(bus, "byte", "u8");
    assert_field(bus, "no_bounds", "i32");
}

#[test]
fn open_ended_non_negative_unformatted_integer_parameters_use_unsigned() {
    let files = satay_codegen::generate(
        r#"
openapi: 3.1.0
info:
  title: Test API
  version: 1.0.0
paths:
  /buses:
    get:
      operationId: getBuses
      parameters:
        - name: $skip
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
        - name: page
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: 0
      responses:
        '204':
          description: No content
"#,
    )
    .expect("generate open-ended integer parameter fixture");

    let parts_rs = parse_rust(find_file(&files, "get_buses/parts.rs"));
    let input = find_struct(&parts_rs, "GetBusesInput");
    assert_field(input, "skip", "Option<u64>");
    assert!(!contains_ident(&parts_rs, "GetBusesSkipParameter"));
    let types_rs = parse_rust(find_file(&files, "types.rs"));
    assert_tuple_struct(&types_rs, "GetBusesPageParameter", "i32");
    assert_field(input, "page", "Option<GetBusesPageParameter>");
}