SnippetBasedReferenceTests.swift

//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftOpenAPIGenerator open source project
//
// Copyright (c) 2023 Apple Inc. and the SwiftOpenAPIGenerator project authors
// Licensed under Apache License v2.0
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftOpenAPIGenerator project authors
//
// SPDX-License-Identifier: Apache-2.0
//
//===----------------------------------------------------------------------===//
import OpenAPIKit
import XCTest
import Yams
@testable import _OpenAPIGeneratorCore

/// Tests that the generator produces Swift code that match a reference.
final class SnippetBasedReferenceTests: XCTestCase {
    func testComponentsHeadersInline() throws {
        try self.assertHeadersTranslation(
            """
            headers:
              MyHeader:
                schema:
                  type: string
            """,
            """
            public enum Headers {
                public typealias MyHeader = Swift.String
            }
            """
        )
    }

    func testComponentsHeadersReference() throws {
        try self.assertHeadersTranslation(
            """
            schemas:
              MySchema:
                type: string
            headers:
              MyHeader:
                schema:
                  $ref: "#/components/schemas/MySchema"
            """,
            """
            public enum Headers {
                public typealias MyHeader = Components.Schemas.MySchema
            }
            """
        )
    }

    func testComponentsParametersInline() throws {
        try self.assertParametersTranslation(
            """
            parameters:
              MyParam:
                in: query
                name: my_param
                schema:
                  type: string
            """,
            """
            public enum Parameters {
                public typealias MyParam = Swift.String
            }
            """
        )
    }

    func test_accessModifier_public() throws {
        try self.assertParametersTranslation(
            """
            parameters:
              MyParam:
                in: query
                name: my_param
                schema:
                  type: string
            """,
            """
            public enum Parameters {
                public typealias MyParam = Swift.String
            }
            """,
            accessModifier: .`public`
        )
    }

    func test_accessModifier_package() throws {
        try self.assertParametersTranslation(
            """
            parameters:
              MyParam:
                in: query
                name: my_param
                schema:
                  type: string
            """,
            """
            package enum Parameters {
                package typealias MyParam = Swift.String
            }
            """,
            accessModifier: .`package`
        )
    }

    func test_accessModifier_internal() throws {
        try self.assertParametersTranslation(
            """
            parameters:
              MyParam:
                in: query
                name: my_param
                schema:
                  type: string
            """,
            """
            internal enum Parameters {
                internal typealias MyParam = Swift.String
            }
            """,
            accessModifier: .`internal`
        )
    }

    func testComponentsParametersReference() throws {
        try self.assertParametersTranslation(
            """
            schemas:
              MySchema:
                type: string
            parameters:
              MyParam:
                in: query
                name: my_param
                schema:
                  $ref: "#/components/schemas/MySchema"
            """,
            """
            public enum Parameters {
                public typealias MyParam = Components.Schemas.MySchema
            }
            """
        )
    }

    func testComponentsSchemasFrozenEnum_accessModifier_public() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyEnum:
                type: string
                enum:
                  - one
                  - two
            """,
            """
            public enum Schemas {
                @frozen public enum MyEnum: String, Codable, Hashable, Sendable, CaseIterable {
                    case one = "one"
                    case two = "two"
                }
            }
            """,
            accessModifier: .public
        )
    }

    func testComponentsSchemasFrozenEnum_accessModifier_package() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyEnum:
                type: string
                enum:
                  - one
                  - two
            """,
            """
            package enum Schemas {
                @frozen package enum MyEnum: String, Codable, Hashable, Sendable, CaseIterable {
                    case one = "one"
                    case two = "two"
                }
            }
            """,
            accessModifier: .package
        )
    }

    func testComponentsSchemasFrozenEnum_accessModifier_internal() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyEnum:
                type: string
                enum:
                  - one
                  - two
            """,
            """
            internal enum Schemas {
                internal enum MyEnum: String, Codable, Hashable, Sendable, CaseIterable {
                    case one = "one"
                    case two = "two"
                }
            }
            """,
            accessModifier: .internal
        )
    }

    func testComponentsSchemasFrozenEnum_accessModifier_fileprivate() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyEnum:
                type: string
                enum:
                  - one
                  - two
            """,
            """
            fileprivate enum Schemas {
                fileprivate enum MyEnum: String, Codable, Hashable, Sendable, CaseIterable {
                    case one = "one"
                    case two = "two"
                }
            }
            """,
            accessModifier: .fileprivate
        )
    }

    func testComponentsSchemasFrozenEnum_accessModifier_private() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyEnum:
                type: string
                enum:
                  - one
                  - two
            """,
            """
            private enum Schemas {
                private enum MyEnum: String, Codable, Hashable, Sendable, CaseIterable {
                    case one = "one"
                    case two = "two"
                }
            }
            """,
            accessModifier: .private
        )
    }

    func testComponentsSchemasString() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyString:
                type: string
            """,
            """
            public enum Schemas {
                public typealias MyString = Swift.String
            }
            """
        )
    }

    func testComponentsSchemasNullableString() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyString:
                type: string
            """,
            // NOTE: We don't generate a typealias to an optional; instead nullable is considered at point of use.
            """
            public enum Schemas {
                public typealias MyString = Swift.String
            }
            """
        )
    }

    func testComponentsSchemasArrayWithNullableItems() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              StringArray:
                type: array
                items:
                  type: string

              StringArrayNullableItems:
                type: array
                items:
                  type: [string, null]
            """,
            """
            public enum Schemas {
                public typealias StringArray = [Swift.String]
                public typealias StringArrayNullableItems = [Swift.String?]
            }
            """
        )
    }

    func testComponentsSchemasArrayOfRefsOfNullableItems() throws {
        try XCTSkipIf(true, "TODO: Still need to propagate nullability through reference at time of use")
        try self.assertSchemasTranslation(
            """
            schemas:
              ArrayOfRefsToNullableItems:
                type: array
                items:
                  $ref: '#/components/schemas/NullableString'
              NullableString:
                type: [string, null]
            """,
            """
            public enum Schemas {
                public typealias ArrayOfRefsToNullableItems = [Components.Schemas.NullableString?]
                public typealias NullableString = Swift.String
            }
            """
        )
    }

    func testComponentsSchemasNullableStringProperty() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyObj:
                type: object
                properties:
                  fooOptional:
                    type: string
                  fooRequired:
                    type: string
                  fooOptionalNullable:
                    type: [string, null]
                  fooRequiredNullable:
                    type: [string, null]

                  fooOptionalArray:
                    type: array
                    items:
                      type: string
                  fooRequiredArray:
                    type: array
                    items:
                      type: string
                  fooOptionalNullableArray:
                    type: [array, null]
                    items:
                      type: string
                  fooRequiredNullableArray:
                    type: [array, null]
                    items:
                      type: string

                  fooOptionalArrayOfNullableItems:
                    type: array
                    items:
                      type: [string, null]
                  fooRequiredArrayOfNullableItems:
                    type: array
                    items:
                      type: [string, null]
                  fooOptionalNullableArrayOfNullableItems:
                    type: [array, null]
                    items:
                      type: [string, null]
                  fooRequiredNullableArrayOfNullableItems:
                    type: [array, null]
                    items:
                      type: [string, null]
                required:
                  - fooRequired
                  - fooRequiredNullable
                  - fooRequiredArray
                  - fooRequiredNullableArray
                  - fooRequiredArrayOfNullableItems
                  - fooRequiredNullableArrayOfNullableItems
            """,
            """
            public enum Schemas {
                public struct MyObj: Codable, Hashable, Sendable {
                    public var fooOptional: Swift.String?
                    public var fooRequired: Swift.String
                    public var fooOptionalNullable: Swift.String?
                    public var fooRequiredNullable: Swift.String?
                    public var fooOptionalArray: [Swift.String]?
                    public var fooRequiredArray: [Swift.String]
                    public var fooOptionalNullableArray: [Swift.String]?
                    public var fooRequiredNullableArray: [Swift.String]?
                    public var fooOptionalArrayOfNullableItems: [Swift.String?]?
                    public var fooRequiredArrayOfNullableItems: [Swift.String?]
                    public var fooOptionalNullableArrayOfNullableItems: [Swift.String?]?
                    public var fooRequiredNullableArrayOfNullableItems: [Swift.String?]?
                    public init(
                        fooOptional: Swift.String? = nil,
                        fooRequired: Swift.String,
                        fooOptionalNullable: Swift.String? = nil,
                        fooRequiredNullable: Swift.String? = nil,
                        fooOptionalArray: [Swift.String]? = nil,
                        fooRequiredArray: [Swift.String],
                        fooOptionalNullableArray: [Swift.String]? = nil,
                        fooRequiredNullableArray: [Swift.String]? = nil,
                        fooOptionalArrayOfNullableItems: [Swift.String?]? = nil,
                        fooRequiredArrayOfNullableItems: [Swift.String?],
                        fooOptionalNullableArrayOfNullableItems: [Swift.String?]? = nil,
                        fooRequiredNullableArrayOfNullableItems: [Swift.String?]? = nil
                    ) {
                        self.fooOptional = fooOptional
                        self.fooRequired = fooRequired
                        self.fooOptionalNullable = fooOptionalNullable
                        self.fooRequiredNullable = fooRequiredNullable
                        self.fooOptionalArray = fooOptionalArray
                        self.fooRequiredArray = fooRequiredArray
                        self.fooOptionalNullableArray = fooOptionalNullableArray
                        self.fooRequiredNullableArray = fooRequiredNullableArray
                        self.fooOptionalArrayOfNullableItems = fooOptionalArrayOfNullableItems
                        self.fooRequiredArrayOfNullableItems = fooRequiredArrayOfNullableItems
                        self.fooOptionalNullableArrayOfNullableItems = fooOptionalNullableArrayOfNullableItems
                        self.fooRequiredNullableArrayOfNullableItems = fooRequiredNullableArrayOfNullableItems
                    }
                    public enum CodingKeys: String, CodingKey {
                        case fooOptional
                        case fooRequired
                        case fooOptionalNullable
                        case fooRequiredNullable
                        case fooOptionalArray
                        case fooRequiredArray
                        case fooOptionalNullableArray
                        case fooRequiredNullableArray
                        case fooOptionalArrayOfNullableItems
                        case fooRequiredArrayOfNullableItems
                        case fooOptionalNullableArrayOfNullableItems
                        case fooRequiredNullableArrayOfNullableItems
                    }
                }
            }
            """
        )
    }

    func testEncodingDecodingArrayWithNullableItems() throws {
        struct MyObject: Codable, Equatable {
            let myArray: [String?]?

            var json: String { get throws { try String(data: JSONEncoder().encode(self), encoding: .utf8)! } }

            static func from(json: String) throws -> Self { try JSONDecoder().decode(Self.self, from: Data(json.utf8)) }
        }

        for (value, encoding) in [
            (MyObject(myArray: nil), #"{}"#), (MyObject(myArray: []), #"{"myArray":[]}"#),
            (MyObject(myArray: ["a"]), #"{"myArray":["a"]}"#), (MyObject(myArray: [nil]), #"{"myArray":[null]}"#),
            (MyObject(myArray: ["a", nil]), #"{"myArray":["a",null]}"#),
        ] {
            XCTAssertEqual(try value.json, encoding)
            XCTAssertEqual(try MyObject.from(json: value.json), value)
        }
    }

    func testComponentsSchemasObjectWithInferredProperty() throws {
        try self.assertSchemasTranslation(
            ignoredDiagnosticMessages: [
                "A property name only appears in the required list, but not in the properties map - this is likely a typo; skipping this property."
            ],
            """
            schemas:
              MyObj:
                type: object
                properties:
                  fooRequired:
                    type: string
                required:
                  - fooRequired
                  - fooInferred
            """,
            """
            public enum Schemas {
                public struct MyObj: Codable, Hashable, Sendable {
                    public var fooRequired: Swift.String
                    public init(fooRequired: Swift.String) {
                        self.fooRequired = fooRequired
                    }
                    public enum CodingKeys: String, CodingKey {
                        case fooRequired
                    }
                }
            }
            """
        )
    }

    func testComponentsObjectNoAdditionalProperties() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyObject:
                type: object
                properties: {}
                additionalProperties: false
            """,
            """
            public enum Schemas {
                public struct MyObject: Codable, Hashable, Sendable {
                    public init() {}
                    public init(from decoder: any Decoder) throws {
                        try decoder.ensureNoAdditionalProperties(knownKeys: [])
                    }
                }
            }
            """
        )
    }

    func testComponentsObjectExplicitUntypedAdditionalProperties() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyObject:
                type: object
                properties: {}
                additionalProperties: true
            """,
            """
            public enum Schemas {
                public struct MyObject: Codable, Hashable, Sendable {
                    public var additionalProperties: OpenAPIRuntime.OpenAPIObjectContainer
                    public init(additionalProperties: OpenAPIRuntime.OpenAPIObjectContainer = .init()) {
                        self.additionalProperties = additionalProperties
                    }
                    public init(from decoder: any Decoder) throws {
                        additionalProperties = try decoder.decodeAdditionalProperties(knownKeys: [])
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try encoder.encodeAdditionalProperties(additionalProperties)
                    }
                }
            }
            """
        )
    }

    func testComponentsObjectExplicitTypedAdditionalProperties() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyObject:
                type: object
                properties: {}
                additionalProperties:
                  type: integer
            """,
            """
            public enum Schemas {
                public struct MyObject: Codable, Hashable, Sendable {
                    public var additionalProperties: [String: Swift.Int]
                    public init(additionalProperties: [String: Swift.Int] = .init()) {
                        self.additionalProperties = additionalProperties
                    }
                    public init(from decoder: any Decoder) throws {
                        additionalProperties = try decoder.decodeAdditionalProperties(knownKeys: [])
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try encoder.encodeAdditionalProperties(additionalProperties)
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasObjectWithProperties() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyRequiredString:
                type: string
              MyNullableString:
                type: [string, null]
              MyObject:
                type: object
                properties:
                  id:
                    type: integer
                    format: int64
                  alias:
                    type: string
                  requiredString:
                    $ref: '#/components/schemas/MyRequiredString'
                  nullableString:
                    $ref: '#/components/schemas/MyNullableString'
                required:
                  - id
                  - requiredString
                  - nullableString
            """,
            """
            public enum Schemas {
                public typealias MyRequiredString = Swift.String
                public typealias MyNullableString = Swift.String
                public struct MyObject: Codable, Hashable, Sendable {
                    public var id: Swift.Int64
                    public var alias: Swift.String?
                    public var requiredString: Components.Schemas.MyRequiredString
                    public var nullableString: Components.Schemas.MyNullableString?
                    public init(
                        id: Swift.Int64,
                        alias: Swift.String? = nil,
                        requiredString: Components.Schemas.MyRequiredString,
                        nullableString: Components.Schemas.MyNullableString? = nil
                    ) {
                        self.id = id
                        self.alias = alias
                        self.requiredString = requiredString
                        self.nullableString = nullableString
                    }
                    public enum CodingKeys: String, CodingKey {
                        case id
                        case alias
                        case requiredString
                        case nullableString
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasObjectWithPropertiesBinaryIsSkipped() throws {
        try self.assertSchemasTranslation(
            ignoredDiagnosticMessages: [
                "Schema \"string (binary)\" is not supported, reason: \"Binary properties in object schemas.\", skipping"
            ],
            """
            schemas:
              MyObject:
                type: object
                properties:
                  actualString:
                    type: string
                  binaryProperty:
                    type: string
                    format: binary
                required:
                  - actualString
                  - binaryProperty
            """,
            """
            public enum Schemas {
                public struct MyObject: Codable, Hashable, Sendable {
                    public var actualString: Swift.String
                    public init(actualString: Swift.String) {
                        self.actualString = actualString
                    }
                    public enum CodingKeys: String, CodingKey {
                        case actualString
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasAllOf() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A: {}
              B: {}
              MyAllOf:
                allOf:
                  - $ref: '#/components/schemas/A'
                  - $ref: '#/components/schemas/B'
                  - type: string
                  - type: array
                    items:
                      type: integer
            """,
            """
            public enum Schemas {
                public typealias A = OpenAPIRuntime.OpenAPIValueContainer
                public typealias B = OpenAPIRuntime.OpenAPIValueContainer
                public struct MyAllOf: Codable, Hashable, Sendable {
                    public var value1: Components.Schemas.A
                    public var value2: Components.Schemas.B
                    public var value3: Swift.String
                    public var value4: [Swift.Int]
                    public init(
                        value1: Components.Schemas.A,
                        value2: Components.Schemas.B,
                        value3: Swift.String,
                        value4: [Swift.Int]
                    ) {
                        self.value1 = value1
                        self.value2 = value2
                        self.value3 = value3
                        self.value4 = value4
                    }
                    public init(from decoder: any Decoder) throws {
                        value1 = try .init(from: decoder)
                        value2 = try .init(from: decoder)
                        value3 = try decoder.decodeFromSingleValueContainer()
                        value4 = try decoder.decodeFromSingleValueContainer()
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try encoder.encodeToSingleValueContainer(value3)
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasAnyOf() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A: {}
              B: {}
              MyAnyOf:
                anyOf:
                  - $ref: '#/components/schemas/A'
                  - $ref: '#/components/schemas/B'
                  - type: string
                  - type: array
                    items:
                      type: integer
            """,
            """
            public enum Schemas {
                public typealias A = OpenAPIRuntime.OpenAPIValueContainer
                public typealias B = OpenAPIRuntime.OpenAPIValueContainer
                public struct MyAnyOf: Codable, Hashable, Sendable {
                    public var value1: Components.Schemas.A?
                    public var value2: Components.Schemas.B?
                    public var value3: Swift.String?
                    public var value4: [Swift.Int]?
                    public init(
                        value1: Components.Schemas.A? = nil,
                        value2: Components.Schemas.B? = nil,
                        value3: Swift.String? = nil,
                        value4: [Swift.Int]? = nil
                    ) {
                        self.value1 = value1
                        self.value2 = value2
                        self.value3 = value3
                        self.value4 = value4
                    }
                    public init(from decoder: any Decoder) throws {
                        var errors: [any Error] = []
                        do {
                            value1 = try .init(from: decoder)
                        } catch {
                            errors.append(error)
                        }
                        do {
                            value2 = try .init(from: decoder)
                        } catch {
                            errors.append(error)
                        }
                        do {
                            value3 = try decoder.decodeFromSingleValueContainer()
                        } catch {
                            errors.append(error)
                        }
                        do {
                            value4 = try decoder.decodeFromSingleValueContainer()
                        } catch {
                            errors.append(error)
                        }
                        try Swift.DecodingError.verifyAtLeastOneSchemaIsNotNil(
                            [
                                value1,
                                value2,
                                value3,
                                value4
                            ],
                            type: Self.self,
                            codingPath: decoder.codingPath,
                            errors: errors
                        )
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try encoder.encodeFirstNonNilValueToSingleValueContainer([
                            value3,
                            value4
                        ])
                        try value1?.encode(to: encoder)
                        try value2?.encode(to: encoder)
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasOneOfWithDiscriminator() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A:
                type: object
                properties:
                  which:
                    type: string
              B:
                type: object
                properties:
                  which:
                    type: string
              MyOneOf:
                oneOf:
                  - $ref: '#/components/schemas/A'
                  - $ref: '#/components/schemas/B'
                  - type: string
                  - type: object
                    properties:
                      p:
                        type: integer
                discriminator:
                  propertyName: which
            """,
            """
            public enum Schemas {
                public struct A: Codable, Hashable, Sendable {
                    public var which: Swift.String?
                    public init(which: Swift.String? = nil) {
                        self.which = which
                    }
                    public enum CodingKeys: String, CodingKey {
                        case which
                    }
                }
                public struct B: Codable, Hashable, Sendable {
                    public var which: Swift.String?
                    public init(which: Swift.String? = nil) {
                        self.which = which
                    }
                    public enum CodingKeys: String, CodingKey {
                        case which
                    }
                }
                @frozen public enum MyOneOf: Codable, Hashable, Sendable {
                    case A(Components.Schemas.A)
                    case B(Components.Schemas.B)
                    public enum CodingKeys: String, CodingKey {
                        case which
                    }
                    public init(from decoder: any Decoder) throws {
                        let container = try decoder.container(keyedBy: CodingKeys.self)
                        let discriminator = try container.decode(
                            Swift.String.self,
                            forKey: .which
                        )
                        switch discriminator {
                        case "A", "#/components/schemas/A":
                            self = .A(try .init(from: decoder))
                        case "B", "#/components/schemas/B":
                            self = .B(try .init(from: decoder))
                        default:
                            throw Swift.DecodingError.unknownOneOfDiscriminator(
                                discriminatorKey: CodingKeys.which,
                                discriminatorValue: discriminator,
                                codingPath: decoder.codingPath
                            )
                        }
                    }
                    public func encode(to encoder: any Encoder) throws {
                        switch self {
                        case let .A(value):
                            try value.encode(to: encoder)
                        case let .B(value):
                            try value.encode(to: encoder)
                        }
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasOneOfWithDiscriminatorWithMapping() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A:
                type: object
                properties:
                  which:
                    type: string
              B:
                type: object
                properties:
                  which:
                    type: string
              C:
                type: object
                properties:
                  which:
                    type: string
              MyOneOf:
                oneOf:
                  - $ref: '#/components/schemas/A'
                  - $ref: '#/components/schemas/B'
                  - $ref: '#/components/schemas/C'
                discriminator:
                  propertyName: which
                  mapping:
                    a: '#/components/schemas/A'
                    a2: '#/components/schemas/A'
                    b: '#/components/schemas/B'
            """,
            """
            public enum Schemas {
                public struct A: Codable, Hashable, Sendable {
                    public var which: Swift.String?
                    public init(which: Swift.String? = nil) {
                        self.which = which
                    }
                    public enum CodingKeys: String, CodingKey {
                        case which
                    }
                }
                public struct B: Codable, Hashable, Sendable {
                    public var which: Swift.String?
                    public init(which: Swift.String? = nil) {
                        self.which = which
                    }
                    public enum CodingKeys: String, CodingKey {
                        case which
                    }
                }
                public struct C: Codable, Hashable, Sendable {
                    public var which: Swift.String?
                    public init(which: Swift.String? = nil) {
                        self.which = which
                    }
                    public enum CodingKeys: String, CodingKey {
                        case which
                    }
                }
                @frozen public enum MyOneOf: Codable, Hashable, Sendable {
                    case a(Components.Schemas.A)
                    case a2(Components.Schemas.A)
                    case b(Components.Schemas.B)
                    case C(Components.Schemas.C)
                    public enum CodingKeys: String, CodingKey {
                        case which
                    }
                    public init(from decoder: any Decoder) throws {
                        let container = try decoder.container(keyedBy: CodingKeys.self)
                        let discriminator = try container.decode(
                            Swift.String.self,
                            forKey: .which
                        )
                        switch discriminator {
                        case "a":
                            self = .a(try .init(from: decoder))
                        case "a2":
                            self = .a2(try .init(from: decoder))
                        case "b":
                            self = .b(try .init(from: decoder))
                        case "C", "#/components/schemas/C":
                            self = .C(try .init(from: decoder))
                        default:
                            throw Swift.DecodingError.unknownOneOfDiscriminator(
                                discriminatorKey: CodingKeys.which,
                                discriminatorValue: discriminator,
                                codingPath: decoder.codingPath
                            )
                        }
                    }
                    public func encode(to encoder: any Encoder) throws {
                        switch self {
                        case let .a(value):
                            try value.encode(to: encoder)
                        case let .a2(value):
                            try value.encode(to: encoder)
                        case let .b(value):
                            try value.encode(to: encoder)
                        case let .C(value):
                            try value.encode(to: encoder)
                        }
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasOneOf_closed() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A: {}
              MyOneOf:
                oneOf:
                  - type: string
                  - type: integer
                  - $ref: '#/components/schemas/A'
            """,
            """
            public enum Schemas {
                public typealias A = OpenAPIRuntime.OpenAPIValueContainer
                @frozen public enum MyOneOf: Codable, Hashable, Sendable {
                    case case1(Swift.String)
                    case case2(Swift.Int)
                    case A(Components.Schemas.A)
                    public init(from decoder: any Decoder) throws {
                        var errors: [any Error] = []
                        do {
                            self = .case1(try decoder.decodeFromSingleValueContainer())
                            return
                        } catch {
                            errors.append(error)
                        }
                        do {
                            self = .case2(try decoder.decodeFromSingleValueContainer())
                            return
                        } catch {
                            errors.append(error)
                        }
                        do {
                            self = .A(try .init(from: decoder))
                            return
                        } catch {
                            errors.append(error)
                        }
                        throw Swift.DecodingError.failedToDecodeOneOfSchema(
                            type: Self.self,
                            codingPath: decoder.codingPath,
                            errors: errors
                        )
                    }
                    public func encode(to encoder: any Encoder) throws {
                        switch self {
                        case let .case1(value):
                            try encoder.encodeToSingleValueContainer(value)
                        case let .case2(value):
                            try encoder.encodeToSingleValueContainer(value)
                        case let .A(value):
                            try value.encode(to: encoder)
                        }
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasOneOf_open_pattern() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A:
                type: object
                additionalProperties: false
              MyOpenOneOf:
                anyOf:
                  - oneOf:
                    - type: string
                    - type: integer
                    - $ref: '#/components/schemas/A'
                  - {}
            """,
            """
            public enum Schemas {
                public struct A: Codable, Hashable, Sendable {
                    public init() {}
                    public init(from decoder: any Decoder) throws {
                        try decoder.ensureNoAdditionalProperties(knownKeys: [])
                    }
                }
                public struct MyOpenOneOf: Codable, Hashable, Sendable {
                    @frozen public enum Value1Payload: Codable, Hashable, Sendable {
                        case case1(Swift.String)
                        case case2(Swift.Int)
                        case A(Components.Schemas.A)
                        public init(from decoder: any Decoder) throws {
                            var errors: [any Error] = []
                            do {
                                self = .case1(try decoder.decodeFromSingleValueContainer())
                                return
                            } catch {
                                errors.append(error)
                            }
                            do {
                                self = .case2(try decoder.decodeFromSingleValueContainer())
                                return
                            } catch {
                                errors.append(error)
                            }
                            do {
                                self = .A(try .init(from: decoder))
                                return
                            } catch {
                                errors.append(error)
                            }
                            throw Swift.DecodingError.failedToDecodeOneOfSchema(
                                type: Self.self,
                                codingPath: decoder.codingPath,
                                errors: errors
                            )
                        }
                        public func encode(to encoder: any Encoder) throws {
                            switch self {
                            case let .case1(value):
                                try encoder.encodeToSingleValueContainer(value)
                            case let .case2(value):
                                try encoder.encodeToSingleValueContainer(value)
                            case let .A(value):
                                try value.encode(to: encoder)
                            }
                        }
                    }
                    public var value1: Components.Schemas.MyOpenOneOf.Value1Payload?
                    public var value2: OpenAPIRuntime.OpenAPIValueContainer?
                    public init(
                        value1: Components.Schemas.MyOpenOneOf.Value1Payload? = nil,
                        value2: OpenAPIRuntime.OpenAPIValueContainer? = nil
                    ) {
                        self.value1 = value1
                        self.value2 = value2
                    }
                    public init(from decoder: any Decoder) throws {
                        var errors: [any Error] = []
                        do {
                            value1 = try .init(from: decoder)
                        } catch {
                            errors.append(error)
                        }
                        do {
                            value2 = try .init(from: decoder)
                        } catch {
                            errors.append(error)
                        }
                        try Swift.DecodingError.verifyAtLeastOneSchemaIsNotNil(
                            [
                                value1,
                                value2
                            ],
                            type: Self.self,
                            codingPath: decoder.codingPath,
                            errors: errors
                        )
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try value1?.encode(to: encoder)
                        try value2?.encode(to: encoder)
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasAllOfOneStringRef() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A:
                type: string
              MyAllOf:
                allOf:
                  - $ref: '#/components/schemas/A'
            """,
            """
            public enum Schemas {
                public typealias A = Swift.String
                public struct MyAllOf: Codable, Hashable, Sendable {
                    public var value1: Components.Schemas.A
                    public init(value1: Components.Schemas.A) {
                        self.value1 = value1
                    }
                    public init(from decoder: any Decoder) throws {
                        value1 = try decoder.decodeFromSingleValueContainer()
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try encoder.encodeToSingleValueContainer(value1)
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasObjectWithRequiredAllOfOneStringRefProperty() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A:
                type: string
              B:
                type: object
                required:
                  - c
                properties:
                  c:
                    allOf:
                      - $ref: "#/components/schemas/A"
            """,
            """
            public enum Schemas {
                public typealias A = Swift.String
                public struct B: Codable, Hashable, Sendable {
                    public struct cPayload: Codable, Hashable, Sendable {
                        public var value1: Components.Schemas.A
                        public init(value1: Components.Schemas.A) {
                            self.value1 = value1
                        }
                        public init(from decoder: any Decoder) throws {
                            value1 = try decoder.decodeFromSingleValueContainer()
                        }
                        public func encode(to encoder: any Encoder) throws {
                            try encoder.encodeToSingleValueContainer(value1)
                        }
                    }
                    public var c: Components.Schemas.B.cPayload
                    public init(c: Components.Schemas.B.cPayload) {
                        self.c = c
                    }
                    public enum CodingKeys: String, CodingKey {
                        case c
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasObjectWithOptionalAllOfOneStringRefProperty() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              A:
                type: string
              B:
                type: object
                required: []
                properties:
                  c:
                    allOf:
                      - $ref: "#/components/schemas/A"
            """,
            """
            public enum Schemas {
                public typealias A = Swift.String
                public struct B: Codable, Hashable, Sendable {
                    public struct cPayload: Codable, Hashable, Sendable {
                        public var value1: Components.Schemas.A
                        public init(value1: Components.Schemas.A) {
                            self.value1 = value1
                        }
                        public init(from decoder: any Decoder) throws {
                            value1 = try decoder.decodeFromSingleValueContainer()
                        }
                        public func encode(to encoder: any Encoder) throws {
                            try encoder.encodeToSingleValueContainer(value1)
                        }
                    }
                    public var c: Components.Schemas.B.cPayload?
                    public init(c: Components.Schemas.B.cPayload? = nil) {
                        self.c = c
                    }
                    public enum CodingKeys: String, CodingKey {
                        case c
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasStringEnum() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyEnum:
                type: string
                enum:
                  - one
                  -
                  - $tart
                  - public
            """,
            """
            public enum Schemas {
                @frozen public enum MyEnum: String, Codable, Hashable, Sendable, CaseIterable {
                    case one = "one"
                    case _empty = ""
                    case _dollar_tart = "$tart"
                    case _public = "public"
                }
            }
            """
        )
    }

    func testComponentsSchemasIntEnum() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyEnum:
                type: integer
                enum:
                  - 0
                  - 10
                  - 20
            """,
            """
            public enum Schemas {
                @frozen public enum MyEnum: Int, Codable, Hashable, Sendable, CaseIterable {
                    case _0 = 0
                    case _10 = 10
                    case _20 = 20
                }
            }
            """
        )
    }

    func testComponentsSchemasEnum_open_pattern() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyOpenEnum:
                anyOf:
                  - type: string
                    enum:
                      - one
                      - two
                  - type: string
            """,
            """
            public enum Schemas {
                public struct MyOpenEnum: Codable, Hashable, Sendable {
                    @frozen public enum Value1Payload: String, Codable, Hashable, Sendable, CaseIterable {
                        case one = "one"
                        case two = "two"
                    }
                    public var value1: Components.Schemas.MyOpenEnum.Value1Payload?
                    public var value2: Swift.String?
                    public init(
                        value1: Components.Schemas.MyOpenEnum.Value1Payload? = nil,
                        value2: Swift.String? = nil
                    ) {
                        self.value1 = value1
                        self.value2 = value2
                    }
                    public init(from decoder: any Decoder) throws {
                        var errors: [any Error] = []
                        do {
                            value1 = try decoder.decodeFromSingleValueContainer()
                        } catch {
                            errors.append(error)
                        }
                        do {
                            value2 = try decoder.decodeFromSingleValueContainer()
                        } catch {
                            errors.append(error)
                        }
                        try Swift.DecodingError.verifyAtLeastOneSchemaIsNotNil(
                            [
                                value1,
                                value2
                            ],
                            type: Self.self,
                            codingPath: decoder.codingPath,
                            errors: errors
                        )
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try encoder.encodeFirstNonNilValueToSingleValueContainer([
                            value1,
                            value2
                        ])
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasDeprecatedObject() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyObject:
                type: object
                properties: {}
                additionalProperties: false
                deprecated: true
            """,
            """
            public enum Schemas {
                @available(*, deprecated)
                public struct MyObject: Codable, Hashable, Sendable {
                    public init() {}
                    public init(from decoder: any Decoder) throws {
                        try decoder.ensureNoAdditionalProperties(knownKeys: [])
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasObjectWithDeprecatedProperty() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyObject:
                type: object
                properties:
                  id:
                    type: string
                    deprecated: true
            """,
            """
            public enum Schemas {
                public struct MyObject: Codable, Hashable, Sendable {
                    @available(*, deprecated)
                    public var id: Swift.String?
                    public init(id: Swift.String? = nil) {
                        self.id = id
                    }
                    public enum CodingKeys: String, CodingKey {
                        case id
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasDateTime() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyDate:
                type: string
                format: date-time
            """,
            """
            public enum Schemas {
                public typealias MyDate = Foundation.Date
            }
            """
        )
    }
    func testComponentsSchemasUUID() throws {
        try self.assertSchemasTranslation(
            featureFlags: [.uuidSupport],
            """
            schemas:
              MyUUID:
                type: string
                format: uuid
            """,
            """
            public enum Schemas {
                public typealias MyUUID = Foundation.UUID
            }
            """
        )
        // Without UUID support, the schema will be translated as a string
        try self.assertSchemasTranslation(
            """
            schemas:
              MyUUID:
                type: string
                format: uuid
            """,
            """
            public enum Schemas {
                public typealias MyUUID = Swift.String
            }
            """
        )
    }

    func testComponentsSchemasBase64() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyData:
                type: string
                contentEncoding: base64
            """,
            """
            public enum Schemas {
                public typealias MyData = OpenAPIRuntime.Base64EncodedData
            }
            """
        )
    }

    func testComponentsSchemasBase64Object() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              MyObj:
                type: object
                properties:
                  stuff:
                    type: string
                    contentEncoding: base64
            """,
            """
            public enum Schemas {
                public struct MyObj: Codable, Hashable, Sendable {
                    public var stuff: OpenAPIRuntime.Base64EncodedData?
                    public init(stuff: OpenAPIRuntime.Base64EncodedData? = nil) {
                        self.stuff = stuff
                    }
                    public enum CodingKeys: String, CodingKey {
                        case stuff
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasRecursive_object() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              Node:
                type: object
                properties:
                  parent:
                    $ref: '#/components/schemas/Node'
            """,
            """
            public enum Schemas {
                public struct Node: Codable, Hashable, Sendable {
                    public var parent: Components.Schemas.Node? {
                        get  {
                            storage.value.parent
                        }
                        _modify {
                            yield &storage.value.parent
                        }
                    }
                    public init(parent: Components.Schemas.Node? = nil) {
                        storage = .init(value: .init(parent: parent))
                    }
                    public enum CodingKeys: String, CodingKey {
                        case parent
                    }
                    public init(from decoder: any Decoder) throws {
                        storage = try .init(from: decoder)
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try storage.encode(to: encoder)
                    }
                    private var storage: OpenAPIRuntime.CopyOnWriteBox<Storage>
                    private struct Storage: Codable, Hashable, Sendable {
                        var parent: Components.Schemas.Node?
                        init(parent: Components.Schemas.Node? = nil) {
                            self.parent = parent
                        }
                        typealias CodingKeys = Components.Schemas.Node.CodingKeys
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasRecursive_objectNested() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              Node:
                type: object
                properties:
                  name:
                    type: string
                  parent:
                    type: object
                    properties:
                      nested:
                        $ref: '#/components/schemas/Node'
                    required:
                      - nested
                required:
                  - name
            """,
            """
            public enum Schemas {
                public struct Node: Codable, Hashable, Sendable {
                    public var name: Swift.String {
                        get  {
                            storage.value.name
                        }
                        _modify {
                            yield &storage.value.name
                        }
                    }
                    public struct parentPayload: Codable, Hashable, Sendable {
                        public var nested: Components.Schemas.Node
                        public init(nested: Components.Schemas.Node) {
                            self.nested = nested
                        }
                        public enum CodingKeys: String, CodingKey {
                            case nested
                        }
                    }
                    public var parent: Components.Schemas.Node.parentPayload? {
                        get  {
                            storage.value.parent
                        }
                        _modify {
                            yield &storage.value.parent
                        }
                    }
                    public init(
                        name: Swift.String,
                        parent: Components.Schemas.Node.parentPayload? = nil
                    ) {
                        storage = .init(value: .init(
                            name: name,
                            parent: parent
                        ))
                    }
                    public enum CodingKeys: String, CodingKey {
                        case name
                        case parent
                    }
                    public init(from decoder: any Decoder) throws {
                        storage = try .init(from: decoder)
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try storage.encode(to: encoder)
                    }
                    private var storage: OpenAPIRuntime.CopyOnWriteBox<Storage>
                    private struct Storage: Codable, Hashable, Sendable {
                        var name: Swift.String
                        struct parentPayload: Codable, Hashable, Sendable {
                            public var nested: Components.Schemas.Node
                            public init(nested: Components.Schemas.Node) {
                                self.nested = nested
                            }
                            public enum CodingKeys: String, CodingKey {
                                case nested
                            }
                        }
                        var parent: Components.Schemas.Node.parentPayload?
                        init(
                            name: Swift.String,
                            parent: Components.Schemas.Node.parentPayload? = nil
                        ) {
                            self.name = name
                            self.parent = parent
                        }
                        typealias CodingKeys = Components.Schemas.Node.CodingKeys
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasRecursive_allOf() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              Node:
                allOf:
                  - type: object
                    properties:
                      parent:
                        $ref: '#/components/schemas/Node'
            """,
            """
            public enum Schemas {
                public struct Node: Codable, Hashable, Sendable {
                    public struct Value1Payload: Codable, Hashable, Sendable {
                        public var parent: Components.Schemas.Node?
                        public init(parent: Components.Schemas.Node? = nil) {
                            self.parent = parent
                        }
                        public enum CodingKeys: String, CodingKey {
                            case parent
                        }
                    }
                    public var value1: Components.Schemas.Node.Value1Payload {
                        get  {
                            storage.value.value1
                        }
                        _modify {
                            yield &storage.value.value1
                        }
                    }
                    public init(value1: Components.Schemas.Node.Value1Payload) {
                        storage = .init(value: .init(value1: value1))
                    }
                    public init(from decoder: any Decoder) throws {
                        storage = try .init(from: decoder)
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try storage.encode(to: encoder)
                    }
                    private var storage: OpenAPIRuntime.CopyOnWriteBox<Storage>
                    private struct Storage: Codable, Hashable, Sendable {
                        struct Value1Payload: Codable, Hashable, Sendable {
                            public var parent: Components.Schemas.Node?
                            public init(parent: Components.Schemas.Node? = nil) {
                                self.parent = parent
                            }
                            public enum CodingKeys: String, CodingKey {
                                case parent
                            }
                        }
                        var value1: Components.Schemas.Node.Value1Payload
                        init(value1: Components.Schemas.Node.Value1Payload) {
                            self.value1 = value1
                        }
                        init(from decoder: any Decoder) throws {
                            value1 = try .init(from: decoder)
                        }
                        func encode(to encoder: any Encoder) throws {
                            try value1.encode(to: encoder)
                        }
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasRecursive_anyOf() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              Node:
                anyOf:
                  - $ref: '#/components/schemas/Node'
                  - type: string
            """,
            """
            public enum Schemas {
                public struct Node: Codable, Hashable, Sendable {
                    public var value1: Components.Schemas.Node? {
                        get  {
                            storage.value.value1
                        }
                        _modify {
                            yield &storage.value.value1
                        }
                    }
                    public var value2: Swift.String? {
                        get  {
                            storage.value.value2
                        }
                        _modify {
                            yield &storage.value.value2
                        }
                    }
                    public init(
                        value1: Components.Schemas.Node? = nil,
                        value2: Swift.String? = nil
                    ) {
                        storage = .init(value: .init(
                            value1: value1,
                            value2: value2
                        ))
                    }
                    public init(from decoder: any Decoder) throws {
                        storage = try .init(from: decoder)
                    }
                    public func encode(to encoder: any Encoder) throws {
                        try storage.encode(to: encoder)
                    }
                    private var storage: OpenAPIRuntime.CopyOnWriteBox<Storage>
                    private struct Storage: Codable, Hashable, Sendable {
                        var value1: Components.Schemas.Node?
                        var value2: Swift.String?
                        init(
                            value1: Components.Schemas.Node? = nil,
                            value2: Swift.String? = nil
                        ) {
                            self.value1 = value1
                            self.value2 = value2
                        }
                        init(from decoder: any Decoder) throws {
                            var errors: [any Error] = []
                            do {
                                value1 = try .init(from: decoder)
                            } catch {
                                errors.append(error)
                            }
                            do {
                                value2 = try decoder.decodeFromSingleValueContainer()
                            } catch {
                                errors.append(error)
                            }
                            try Swift.DecodingError.verifyAtLeastOneSchemaIsNotNil(
                                [
                                    value1,
                                    value2
                                ],
                                type: Self.self,
                                codingPath: decoder.codingPath,
                                errors: errors
                            )
                        }
                        func encode(to encoder: any Encoder) throws {
                            try encoder.encodeFirstNonNilValueToSingleValueContainer([
                                value2
                            ])
                            try value1?.encode(to: encoder)
                        }
                    }
                }
            }
            """
        )
    }

    func testComponentsSchemasRecursive_oneOf() throws {
        try self.assertSchemasTranslation(
            """
            schemas:
              Node:
                oneOf:
                  - $ref: '#/components/schemas/Node'
                  - type: string
            """,
            """
            public enum Schemas {
                @frozen public indirect enum Node: Codable, Hashable, Sendable {
                    case Node(Components.Schemas.Node)
                    case case2(Swift.String)
                    public init(from decoder: any Decoder) throws {
                        var errors: [any Error] = []
                        do {
                            self = .Node(try .init(from: decoder))
                            return
                        } catch {
                            errors.append(error)
                        }
                        do {
                            self = .case2(try decoder.decodeFromSingleValueContainer())
                            return
                        } catch {
                            errors.append(error)
                        }
                        throw Swift.DecodingError.failedToDecodeOneOfSchema(
                            type: Self.self,
                            codingPath: decoder.codingPath,
                            errors: errors
                        )
                    }
                    public func encode(to encoder: any Encoder) throws {
                        switch self {
                        case let .Node(value):
                            try value.encode(to: encoder)
                        case let .case2(value):
                            try encoder.encodeToSingleValueContainer(value)
                        }
                    }
                }
            }
            """
        )
    }

    func testComponentsResponsesResponseNoBody() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              BadRequest:
                description: Bad request
            """,
            """
            public enum Responses {
                public struct BadRequest: Sendable, Hashable {
                    public init() {}
                }
            }
            """
        )
    }

    func testComponentsResponsesResponseWithBody() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              BadRequest:
                description: Bad request
                content:
                  application/json:
                    schema:
                      type: string
            """,
            """
            public enum Responses {
                public struct BadRequest: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(Swift.String)
                        public var json: Swift.String {
                            get throws {
                                switch self {
                                case let .json(body):
                                    return body
                                }
                            }
                        }
                    }
                    public var body: Components.Responses.BadRequest.Body
                    public init(body: Components.Responses.BadRequest.Body) {
                        self.body = body
                    }
                }
            }
            """
        )
    }

    func testComponentsResponsesResponseMultipleContentTypes() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              MultipleContentTypes:
                description: Multiple content types
                content:
                  application/json:
                    schema:
                      type: integer
                  application/json; foo=bar:
                    schema:
                      type: integer
                  text/plain: {}
                  application/octet-stream: {}
            """,
            """
            public enum Responses {
                public struct MultipleContentTypes: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(Swift.Int)
                        public var json: Swift.Int {
                            get throws {
                                switch self {
                                case let .json(body):
                                    return body
                                default:
                                    try throwUnexpectedResponseBody(
                                        expectedContent: "application/json",
                                        body: self
                                    )
                                }
                            }
                        }
                        case application_json_foo_bar(Swift.Int)
                        public var application_json_foo_bar: Swift.Int {
                            get throws {
                                switch self {
                                case let .application_json_foo_bar(body):
                                    return body
                                default:
                                    try throwUnexpectedResponseBody(
                                        expectedContent: "application/json",
                                        body: self
                                    )
                                }
                            }
                        }
                        case plainText(OpenAPIRuntime.HTTPBody)
                        public var plainText: OpenAPIRuntime.HTTPBody {
                            get throws {
                                switch self {
                                case let .plainText(body):
                                    return body
                                default:
                                    try throwUnexpectedResponseBody(
                                        expectedContent: "text/plain",
                                        body: self
                                    )
                                }
                            }
                        }
                        case binary(OpenAPIRuntime.HTTPBody)
                        public var binary: OpenAPIRuntime.HTTPBody {
                            get throws {
                                switch self {
                                case let .binary(body):
                                    return body
                                default:
                                    try throwUnexpectedResponseBody(
                                        expectedContent: "application/octet-stream",
                                        body: self
                                    )
                                }
                            }
                        }
                    }
                    public var body: Components.Responses.MultipleContentTypes.Body
                    public init(body: Components.Responses.MultipleContentTypes.Body) {
                        self.body = body
                    }
                }
            }
            """
        )
    }

    func testComponentsResponsesResponseWithHeader() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              BadRequest:
                description: Bad request
                headers:
                  X-Reason:
                    schema:
                      type: string
            """,
            """
            public enum Responses {
                public struct BadRequest: Sendable, Hashable {
                    public struct Headers: Sendable, Hashable {
                        public var X_hyphen_Reason: Swift.String?
                        public init(X_hyphen_Reason: Swift.String? = nil) {
                            self.X_hyphen_Reason = X_hyphen_Reason
                        }
                    }
                    public var headers: Components.Responses.BadRequest.Headers
                    public init(headers: Components.Responses.BadRequest.Headers = .init()) {
                        self.headers = headers
                    }
                }
            }
            """
        )
    }

    func testComponentsResponsesResponseWithInlineHeader() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              BadRequest:
                description: Bad request
                headers:
                  X-Reason:
                    schema:
                      type: string
                      enum:
                        - badLuck
            """,
            """
            public enum Responses {
                public struct BadRequest: Sendable, Hashable {
                    public struct Headers: Sendable, Hashable {
                        @frozen public enum X_hyphen_ReasonPayload: String, Codable, Hashable, Sendable, CaseIterable {
                            case badLuck = "badLuck"
                        }
                        public var X_hyphen_Reason: Components.Responses.BadRequest.Headers.X_hyphen_ReasonPayload?
                        public init(X_hyphen_Reason: Components.Responses.BadRequest.Headers.X_hyphen_ReasonPayload? = nil) {
                            self.X_hyphen_Reason = X_hyphen_Reason
                        }
                    }
                    public var headers: Components.Responses.BadRequest.Headers
                    public init(headers: Components.Responses.BadRequest.Headers = .init()) {
                        self.headers = headers
                    }
                }
            }
            """
        )
    }

    func testComponentsResponsesResponseWithRequiredHeader() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              BadRequest:
                description: Bad request
                headers:
                  X-Reason:
                    schema:
                      type: string
                    required: true
            """,
            """
            public enum Responses {
                public struct BadRequest: Sendable, Hashable {
                    public struct Headers: Sendable, Hashable {
                        public var X_hyphen_Reason: Swift.String
                        public init(X_hyphen_Reason: Swift.String) {
                            self.X_hyphen_Reason = X_hyphen_Reason
                        }
                    }
                    public var headers: Components.Responses.BadRequest.Headers
                    public init(headers: Components.Responses.BadRequest.Headers) {
                        self.headers = headers
                    }
                }
            }
            """
        )
    }

    func testComponentsRequestBodiesInline() throws {
        try self.assertRequestBodiesTranslation(
            """
            requestBodies:
              MyResponseBody:
                content:
                  application/json:
                    schema:
                      type: string
            """,
            """
            public enum RequestBodies {
                @frozen public enum MyResponseBody: Sendable, Hashable {
                    case json(Swift.String)
                }
            }
            """
        )
    }

    func testComponentsRequestBodiesReference() throws {
        try self.assertRequestBodiesTranslation(
            """
            requestBodies:
              MyResponseBody:
                content:
                  application/json:
                    schema:
                      $ref: '#/components/schemas/MyBody'
            """,
            """
            public enum RequestBodies {
                @frozen public enum MyResponseBody: Sendable, Hashable {
                    case json(Components.Schemas.MyBody)
                }
            }
            """
        )
    }

    func testComponentsRequestBodiesMultipleContentTypes() throws {
        try self.assertRequestBodiesTranslation(
            """
            requestBodies:
              MyResponseBody:
                content:
                  application/json:
                    schema:
                      $ref: '#/components/schemas/MyBody'
                  text/plain: {}
                  application/octet-stream: {}
            """,
            """
            public enum RequestBodies {
                @frozen public enum MyResponseBody: Sendable, Hashable {
                    case json(Components.Schemas.MyBody)
                    case plainText(OpenAPIRuntime.HTTPBody)
                    case binary(OpenAPIRuntime.HTTPBody)
                }
            }
            """
        )
    }

    func testComponentsRequestBodiesInline_urlEncodedForm() throws {
        try self.assertRequestBodiesTranslation(
            """
            requestBodies:
              MyRequestBody:
                content:
                  application/x-www-form-urlencoded:
                    schema:
                      type: object
                      properties:
                        foo:
                          type: string
                      required: [foo]
            """,
            """
            public enum RequestBodies {
                @frozen public enum MyRequestBody: Sendable, Hashable {
                    public struct urlEncodedFormPayload: Codable, Hashable, Sendable {
                        public var foo: Swift.String
                        public init(foo: Swift.String) {
                            self.foo = foo
                        }
                        public enum CodingKeys: String, CodingKey {
                            case foo
                        }
                    }
                    case urlEncodedForm(Components.RequestBodies.MyRequestBody.urlEncodedFormPayload)
                }
            }
            """
        )
    }

    func testComponentsRequestBodiesInline_multipart() throws {
        try self.assertRequestBodiesTranslation(
            """
            requestBodies:
              MultipartUploadTypedRequest:
                required: true
                content:
                  multipart/form-data:
                    schema:
                      type: object
                      properties:
                        log:
                          type: string
                        metadata:
                          type: object
                          properties:
                            createdAt:
                              type: string
                              format: date-time
                          required:
                            - createdAt
                        keyword:
                          type: array
                          items:
                            type: string
                      required:
                        - log
                    encoding:
                      log:
                        headers:
                          x-log-type:
                            description: The type of the log.
                            schema:
                              type: string
                              enum:
                                - structured
                                - unstructured
            """,
            #"""
            public enum RequestBodies {
                @frozen public enum MultipartUploadTypedRequest: Sendable, Hashable {
                    @frozen public enum multipartFormPayload: Sendable, Hashable {
                        public struct logPayload: Sendable, Hashable {
                            public struct Headers: Sendable, Hashable {
                                @frozen public enum x_hyphen_log_hyphen_typePayload: String, Codable, Hashable, Sendable, CaseIterable {
                                    case structured = "structured"
                                    case unstructured = "unstructured"
                                }
                                public var x_hyphen_log_hyphen_type: Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.logPayload.Headers.x_hyphen_log_hyphen_typePayload?
                                public init(x_hyphen_log_hyphen_type: Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.logPayload.Headers.x_hyphen_log_hyphen_typePayload? = nil) {
                                    self.x_hyphen_log_hyphen_type = x_hyphen_log_hyphen_type
                                }
                            }
                            public var headers: Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.logPayload.Headers
                            public var body: OpenAPIRuntime.HTTPBody
                            public init(
                                headers: Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.logPayload.Headers = .init(),
                                body: OpenAPIRuntime.HTTPBody
                            ) {
                                self.headers = headers
                                self.body = body
                            }
                        }
                        case log(OpenAPIRuntime.MultipartPart<Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.logPayload>)
                        public struct metadataPayload: Sendable, Hashable {
                            public struct bodyPayload: Codable, Hashable, Sendable {
                                public var createdAt: Foundation.Date
                                public init(createdAt: Foundation.Date) {
                                    self.createdAt = createdAt
                                }
                                public enum CodingKeys: String, CodingKey {
                                    case createdAt
                                }
                            }
                            public var body: Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.metadataPayload.bodyPayload
                            public init(body: Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.metadataPayload.bodyPayload) {
                                self.body = body
                            }
                        }
                        case metadata(OpenAPIRuntime.MultipartPart<Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.metadataPayload>)
                        public struct keywordPayload: Sendable, Hashable {
                            public var body: OpenAPIRuntime.HTTPBody
                            public init(body: OpenAPIRuntime.HTTPBody) {
                                self.body = body
                            }
                        }
                        case keyword(OpenAPIRuntime.MultipartPart<Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload.keywordPayload>)
                        case undocumented(OpenAPIRuntime.MultipartRawPart)
                    }
                    case multipartForm(OpenAPIRuntime.MultipartBody<Components.RequestBodies.MultipartUploadTypedRequest.multipartFormPayload>)
                }
            }
            """#
        )
    }

    func testPaths() throws {
        let paths = """
            /healthOld:
              get:
                operationId: getHealthOld
                deprecated: true
                responses:
                  '200':
                    description: A success response with a greeting.
                    content:
                      text/plain:
                        schema:
                          type: string
            /healthNew:
              get:
                operationId: getHealthNew
                responses:
                  '200':
                    description: A success response with a greeting.
                    content:
                      text/plain:
                        schema:
                          type: string
            """
        try self.assertPathsTranslation(
            paths,
            """
            public protocol APIProtocol: Sendable {
                @available(*, deprecated)
                func getHealthOld(_ input: Operations.getHealthOld.Input) async throws -> Operations.getHealthOld.Output
                func getHealthNew(_ input: Operations.getHealthNew.Input) async throws -> Operations.getHealthNew.Output
            }
            """
        )
        try self.assertPathsTranslationExtension(
            paths,
            """
            extension APIProtocol {
                @available(*, deprecated)
                public func getHealthOld(headers: Operations.getHealthOld.Input.Headers = .init()) async throws -> Operations.getHealthOld.Output {
                    try await getHealthOld(Operations.getHealthOld.Input(headers: headers))
                }
                public func getHealthNew(headers: Operations.getHealthNew.Input.Headers = .init()) async throws -> Operations.getHealthNew.Output {
                    try await getHealthNew(Operations.getHealthNew.Input(headers: headers))
                }
            }
            """
        )
    }

    func testServerRegisterHandlers_oneOperation() throws {
        try self.assertServerRegisterHandlers(
            """
            /health:
              get:
                operationId: getHealth
                responses:
                  '200':
                    description: A success response with a greeting.
                    content:
                      text/plain:
                        schema:
                          type: string
            """,
            """
            public func registerHandlers(
                on transport: any ServerTransport,
                serverURL: Foundation.URL = .defaultOpenAPIServerURL,
                configuration: Configuration = .init(),
                middlewares: [any ServerMiddleware] = []
            ) throws {
                let server = UniversalServer(
                    serverURL: serverURL,
                    handler: self,
                    configuration: configuration,
                    middlewares: middlewares
                )
                try transport.register(
                    {
                        try await server.getHealth(
                            request: $0,
                            body: $1,
                            metadata: $2
                        )
                    },
                    method: .get,
                    path: server.apiPathComponentsWithServerPrefix("/health")
                )
            }
            """
        )
    }

    func testServerRegisterHandlers_noOperation() throws {
        try self.assertServerRegisterHandlers(
            """
            {}
            """,
            """
            public func registerHandlers(
                on transport: any ServerTransport,
                serverURL: Foundation.URL = .defaultOpenAPIServerURL,
                configuration: Configuration = .init(),
                middlewares: [any ServerMiddleware] = []
            ) throws {}
            """
        )
    }

    func testPathWithPathItemReference() throws {
        XCTAssertThrowsError(
            try self.assertPathsTranslation(
                """
                /health:
                  get:
                    operationId: getHealth
                    responses:
                      '200':
                        description: A success response with a greeting.
                        content:
                          text/plain:
                            schema:
                              type: string
                /health2:
                  $ref: "#/paths/~1health"
                """,
                """
                unused: This test throws an error.
                """
            )
        )
    }

    func testResponseWithExampleWithSummaryAndValue() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              MyResponse:
                description: Some response
                content:
                  application/json:
                    schema:
                      type: string
                    examples:
                      application/json:
                        summary: "a hello response"
                        value: "hello"
            """,
            """
            public enum Responses {
                public struct MyResponse: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(Swift.String)
                        public var json: Swift.String {
                            get throws {
                                switch self {
                                case let .json(body):
                                    return body
                                }
                            }
                        }
                    }
                    public var body: Components.Responses.MyResponse.Body
                    public init(body: Components.Responses.MyResponse.Body) {
                        self.body = body
                    }
                }
            }
            """
        )
    }

    func testResponseWithExampleWithOnlyValue() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              MyResponse:
                description: Some response
                content:
                  application/json:
                    schema:
                      type: string
                    examples:
                      application/json:
                        summary: "a hello response"
            """,
            """
            public enum Responses {
                public struct MyResponse: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(Swift.String)
                        public var json: Swift.String {
                            get throws {
                                switch self {
                                case let .json(body):
                                    return body
                                }
                            }
                        }
                    }
                    public var body: Components.Responses.MyResponse.Body
                    public init(body: Components.Responses.MyResponse.Body) {
                        self.body = body
                    }
                }
            }
            """
        )
    }

    func testRequestWithQueryItems() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              get:
                parameters:
                  - name: single
                    in: query
                    schema:
                      type: string
                  - name: manyExploded
                    in: query
                    explode: true
                    schema:
                      type: array
                      items:
                        type: string
                  - name: manyUnexploded
                    in: query
                    explode: false
                    schema:
                      type: array
                      items:
                        type: string
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    public struct Query: Sendable, Hashable {
                        public var single: Swift.String?
                        public var manyExploded: [Swift.String]?
                        public var manyUnexploded: [Swift.String]?
                        public init(
                            single: Swift.String? = nil,
                            manyExploded: [Swift.String]? = nil,
                            manyUnexploded: [Swift.String]? = nil
                        ) {
                            self.single = single
                            self.manyExploded = manyExploded
                            self.manyUnexploded = manyUnexploded
                        }
                    }
                    public var query: Operations.get_sol_foo.Input.Query
                    public init(query: Operations.get_sol_foo.Input.Query = .init()) {
                        self.query = query
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .get
                    )
                    suppressMutabilityWarning(&request)
                    try converter.setQueryItemAsURI(
                        in: &request,
                        style: .form,
                        explode: true,
                        name: "single",
                        value: input.query.single
                    )
                    try converter.setQueryItemAsURI(
                        in: &request,
                        style: .form,
                        explode: true,
                        name: "manyExploded",
                        value: input.query.manyExploded
                    )
                    try converter.setQueryItemAsURI(
                        in: &request,
                        style: .form,
                        explode: false,
                        name: "manyUnexploded",
                        value: input.query.manyUnexploded
                    )
                    return (request, nil)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let query: Operations.get_sol_foo.Input.Query = .init(
                        single: try converter.getOptionalQueryItemAsURI(
                            in: request.soar_query,
                            style: .form,
                            explode: true,
                            name: "single",
                            as: Swift.String.self
                        ),
                        manyExploded: try converter.getOptionalQueryItemAsURI(
                            in: request.soar_query,
                            style: .form,
                            explode: true,
                            name: "manyExploded",
                            as: [Swift.String].self
                        ),
                        manyUnexploded: try converter.getOptionalQueryItemAsURI(
                            in: request.soar_query,
                            style: .form,
                            explode: false,
                            name: "manyUnexploded",
                            as: [Swift.String].self
                        )
                    )
                    return Operations.get_sol_foo.Input(query: query)
                }
                """
        )
    }

    func testRequestWithPathParams() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo/a/{a}/b/{b}/c{num}:
              get:
                parameters:
                  - name: b
                    in: path
                    required: true
                    schema:
                      type: string
                  - name: a
                    in: path
                    required: true
                    schema:
                      type: string
                  - name: num
                    in: path
                    required: true
                    schema:
                      type: integer
                operationId: getFoo
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    public struct Path: Sendable, Hashable {
                        public var b: Swift.String
                        public var a: Swift.String
                        public var num: Swift.Int
                        public init(
                            b: Swift.String,
                            a: Swift.String,
                            num: Swift.Int
                        ) {
                            self.b = b
                            self.a = a
                            self.num = num
                        }
                    }
                    public var path: Operations.getFoo.Input.Path
                    public init(path: Operations.getFoo.Input.Path) {
                        self.path = path
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo/a/{}/b/{}/c{}",
                        parameters: [
                            input.path.a,
                            input.path.b,
                            input.path.num
                        ]
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .get
                    )
                    suppressMutabilityWarning(&request)
                    return (request, nil)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let path: Operations.getFoo.Input.Path = .init(
                        b: try converter.getPathParameterAsURI(
                            in: metadata.pathParameters,
                            name: "b",
                            as: Swift.String.self
                        ),
                        a: try converter.getPathParameterAsURI(
                            in: metadata.pathParameters,
                            name: "a",
                            as: Swift.String.self
                        ),
                        num: try converter.getPathParameterAsURI(
                            in: metadata.pathParameters,
                            name: "num",
                            as: Swift.Int.self
                        )
                    )
                    return Operations.getFoo.Input(path: path)
                }
                """
        )
    }

    func testRequestWithPathParamWithHyphenAndPeriod() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo/{p.a-b}:
              get:
                parameters:
                  - name: p.a-b
                    in: path
                    required: true
                    schema:
                      type: string
                operationId: getFoo
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    public struct Path: Sendable, Hashable {
                        public var p_period_a_hyphen_b: Swift.String
                        public init(p_period_a_hyphen_b: Swift.String) {
                            self.p_period_a_hyphen_b = p_period_a_hyphen_b
                        }
                    }
                    public var path: Operations.getFoo.Input.Path
                    public init(path: Operations.getFoo.Input.Path) {
                        self.path = path
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo/{}",
                        parameters: [
                            input.path.p_period_a_hyphen_b
                        ]
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .get
                    )
                    suppressMutabilityWarning(&request)
                    return (request, nil)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let path: Operations.getFoo.Input.Path = .init(p_period_a_hyphen_b: try converter.getPathParameterAsURI(
                        in: metadata.pathParameters,
                        name: "p.a-b",
                        as: Swift.String.self
                    ))
                    return Operations.getFoo.Input(path: path)
                }
                """
        )
    }

    func testRequestRequiredBodyPrimitiveSchema() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              get:
                requestBody:
                  required: true
                  content:
                    application/json:
                      schema:
                        type: string
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(Swift.String)
                    }
                    public var body: Operations.get_sol_foo.Input.Body
                    public init(body: Operations.get_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .get
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .json(value):
                        body = try converter.setRequiredRequestBodyAsJSON(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "application/json; charset=utf-8"
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.get_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "application/json"
                        ]
                    )
                    switch chosenContentType {
                    case "application/json":
                        body = try await converter.getRequiredRequestBodyAsJSON(
                            Swift.String.self,
                            from: requestBody,
                            transforming: { value in
                                .json(value)
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.get_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestRequiredBodyNullableSchema() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              get:
                requestBody:
                  required: true
                  content:
                    application/json:
                      schema:
                        type: [string, null]
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(Swift.String)
                    }
                    public var body: Operations.get_sol_foo.Input.Body
                    public init(body: Operations.get_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .get
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .json(value):
                        body = try converter.setRequiredRequestBodyAsJSON(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "application/json; charset=utf-8"
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.get_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "application/json"
                        ]
                    )
                    switch chosenContentType {
                    case "application/json":
                        body = try await converter.getRequiredRequestBodyAsJSON(
                            Swift.String.self,
                            from: requestBody,
                            transforming: { value in
                                .json(value)
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.get_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestOptionalBodyPrimitiveSchema() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              get:
                requestBody:
                  required: false
                  content:
                    application/json:
                      schema:
                        type: string
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(Swift.String)
                    }
                    public var body: Operations.get_sol_foo.Input.Body?
                    public init(body: Operations.get_sol_foo.Input.Body? = nil) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .get
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case .none:
                        body = nil
                    case let .json(value):
                        body = try converter.setOptionalRequestBodyAsJSON(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "application/json; charset=utf-8"
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.get_sol_foo.Input.Body?
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "application/json"
                        ]
                    )
                    switch chosenContentType {
                    case "application/json":
                        body = try await converter.getOptionalRequestBodyAsJSON(
                            Swift.String.self,
                            from: requestBody,
                            transforming: { value in
                                .json(value)
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.get_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestOptionalBodyNullableSchema() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              get:
                requestBody:
                  required: false
                  content:
                    application/json:
                      schema:
                        type: [string, null]
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(Swift.String)
                    }
                    public var body: Operations.get_sol_foo.Input.Body?
                    public init(body: Operations.get_sol_foo.Input.Body? = nil) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .get
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case .none:
                        body = nil
                    case let .json(value):
                        body = try converter.setOptionalRequestBodyAsJSON(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "application/json; charset=utf-8"
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.get_sol_foo.Input.Body?
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "application/json"
                        ]
                    )
                    switch chosenContentType {
                    case "application/json":
                        body = try await converter.getOptionalRequestBodyAsJSON(
                            Swift.String.self,
                            from: requestBody,
                            transforming: { value in
                                .json(value)
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.get_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyReferencedRequestBody() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  $ref: '#/components/requestBodies/MultipartRequest'
                responses:
                  default:
                    description: Response
            """,
            """
            requestBodies:
              MultipartRequest:
                required: true
                content:
                  multipart/form-data:
                    schema:
                      type: object
                      properties:
                        log:
                          type: string
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    public var body: Components.RequestBodies.MultipartRequest
                    public init(body: Components.RequestBodies.MultipartRequest) {
                        self.body = body
                    }
                }
                """,
            requestBodies: """
                public enum RequestBodies {
                    @frozen public enum MultipartRequest: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            public struct logPayload: Sendable, Hashable {
                                public var body: OpenAPIRuntime.HTTPBody
                                public init(body: OpenAPIRuntime.HTTPBody) {
                                    self.body = body
                                }
                            }
                            case log(OpenAPIRuntime.MultipartPart<Components.RequestBodies.MultipartRequest.multipartFormPayload.logPayload>)
                            case undocumented(OpenAPIRuntime.MultipartRawPart)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Components.RequestBodies.MultipartRequest.multipartFormPayload>)
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [
                                "log"
                            ],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .log(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsBinary(
                                        value.body,
                                        headerFields: &headerFields,
                                        contentType: "text/plain"
                                    )
                                    return .init(
                                        name: "log",
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                case let .undocumented(value):
                                    return value
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Components.RequestBodies.MultipartRequest
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Components.RequestBodies.MultipartRequest.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [
                                "log"
                            ],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                case "log":
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "text/plain"
                                    )
                                    let body = try converter.getRequiredRequestBodyAsBinary(
                                        OpenAPIRuntime.HTTPBody.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .log(.init(
                                        payload: .init(body: body),
                                        filename: filename
                                    ))
                                default:
                                    return .undocumented(part)
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyInlineRequestBody() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        type: object
                        properties:
                          log:
                            type: string
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            public struct logPayload: Sendable, Hashable {
                                public var body: OpenAPIRuntime.HTTPBody
                                public init(body: OpenAPIRuntime.HTTPBody) {
                                    self.body = body
                                }
                            }
                            case log(OpenAPIRuntime.MultipartPart<Operations.post_sol_foo.Input.Body.multipartFormPayload.logPayload>)
                            case undocumented(OpenAPIRuntime.MultipartRawPart)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [
                                "log"
                            ],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .log(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsBinary(
                                        value.body,
                                        headerFields: &headerFields,
                                        contentType: "text/plain"
                                    )
                                    return .init(
                                        name: "log",
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                case let .undocumented(value):
                                    return value
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [
                                "log"
                            ],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                case "log":
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "text/plain"
                                    )
                                    let body = try converter.getRequiredRequestBodyAsBinary(
                                        OpenAPIRuntime.HTTPBody.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .log(.init(
                                        payload: .init(body: body),
                                        filename: filename
                                    ))
                                default:
                                    return .undocumented(part)
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyInlineRequestBodyReferencedPartSchema() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        type: object
                        properties:
                          info:
                            $ref: '#/components/schemas/Info'
                responses:
                  default:
                    description: Response
            """,
            """
            schemas:
              Info:
                type: object
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            public struct infoPayload: Sendable, Hashable {
                                public var body: Components.Schemas.Info
                                public init(body: Components.Schemas.Info) {
                                    self.body = body
                                }
                            }
                            case info(OpenAPIRuntime.MultipartPart<Operations.post_sol_foo.Input.Body.multipartFormPayload.infoPayload>)
                            case undocumented(OpenAPIRuntime.MultipartRawPart)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [
                                "info"
                            ],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .info(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsJSON(
                                        value.body,
                                        headerFields: &headerFields,
                                        contentType: "application/json; charset=utf-8"
                                    )
                                    return .init(
                                        name: "info",
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                case let .undocumented(value):
                                    return value
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [
                                "info"
                            ],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                case "info":
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "application/json"
                                    )
                                    let body = try await converter.getRequiredRequestBodyAsJSON(
                                        Components.Schemas.Info.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .info(.init(
                                        payload: .init(body: body),
                                        filename: filename
                                    ))
                                default:
                                    return .undocumented(part)
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyReferencedSchema() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        $ref: '#/components/schemas/Multipet'
                responses:
                  default:
                    description: Response
            """,
            """
            schemas:
              Multipet:
                type: object
                properties:
                  log:
                    type: string
                required:
                  - log
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case multipartForm(OpenAPIRuntime.MultipartBody<Components.Schemas.Multipet>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            schemas: """
                public enum Schemas {
                    @frozen public enum Multipet: Sendable, Hashable {
                        public struct logPayload: Sendable, Hashable {
                            public var body: OpenAPIRuntime.HTTPBody
                            public init(body: OpenAPIRuntime.HTTPBody) {
                                self.body = body
                            }
                        }
                        case log(OpenAPIRuntime.MultipartPart<Components.Schemas.Multipet.logPayload>)
                        case undocumented(OpenAPIRuntime.MultipartRawPart)
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .log(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsBinary(
                                        value.body,
                                        headerFields: &headerFields,
                                        contentType: "text/plain"
                                    )
                                    return .init(
                                        name: "log",
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                case let .undocumented(value):
                                    return value
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Components.Schemas.Multipet>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                case "log":
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "text/plain"
                                    )
                                    let body = try converter.getRequiredRequestBodyAsBinary(
                                        OpenAPIRuntime.HTTPBody.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .log(.init(
                                        payload: .init(body: body),
                                        filename: filename
                                    ))
                                default:
                                    return .undocumented(part)
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyReferencedSchemaWithEncoding() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        $ref: '#/components/schemas/Multipet'
                      encoding:
                        log:
                          headers:
                            x-log-type:
                              schema:
                                type: string
                responses:
                  default:
                    description: Response
            """,
            """
            schemas:
              Multipet:
                type: object
                properties:
                  log:
                    type: string
                required:
                  - log
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            public struct logPayload: Sendable, Hashable {
                                public struct Headers: Sendable, Hashable {
                                    public var x_hyphen_log_hyphen_type: Swift.String?
                                    public init(x_hyphen_log_hyphen_type: Swift.String? = nil) {
                                        self.x_hyphen_log_hyphen_type = x_hyphen_log_hyphen_type
                                    }
                                }
                                public var headers: Operations.post_sol_foo.Input.Body.multipartFormPayload.logPayload.Headers
                                public var body: OpenAPIRuntime.HTTPBody
                                public init(
                                    headers: Operations.post_sol_foo.Input.Body.multipartFormPayload.logPayload.Headers = .init(),
                                    body: OpenAPIRuntime.HTTPBody
                                ) {
                                    self.headers = headers
                                    self.body = body
                                }
                            }
                            case log(OpenAPIRuntime.MultipartPart<Operations.post_sol_foo.Input.Body.multipartFormPayload.logPayload>)
                            case undocumented(OpenAPIRuntime.MultipartRawPart)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            schemas: """
                public enum Schemas {
                    @frozen public enum Multipet: Sendable, Hashable {
                        public struct logPayload: Sendable, Hashable {
                            public var body: OpenAPIRuntime.HTTPBody
                            public init(body: OpenAPIRuntime.HTTPBody) {
                                self.body = body
                            }
                        }
                        case log(OpenAPIRuntime.MultipartPart<Components.Schemas.Multipet.logPayload>)
                        case undocumented(OpenAPIRuntime.MultipartRawPart)
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .log(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    try converter.setHeaderFieldAsURI(
                                        in: &headerFields,
                                        name: "x-log-type",
                                        value: value.headers.x_hyphen_log_hyphen_type
                                    )
                                    let body = try converter.setRequiredRequestBodyAsBinary(
                                        value.body,
                                        headerFields: &headerFields,
                                        contentType: "text/plain"
                                    )
                                    return .init(
                                        name: "log",
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                case let .undocumented(value):
                                    return value
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                case "log":
                                    let headers: Operations.post_sol_foo.Input.Body.multipartFormPayload.logPayload.Headers = .init(x_hyphen_log_hyphen_type: try converter.getOptionalHeaderFieldAsURI(
                                        in: headerFields,
                                        name: "x-log-type",
                                        as: Swift.String.self
                                    ))
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "text/plain"
                                    )
                                    let body = try converter.getRequiredRequestBodyAsBinary(
                                        OpenAPIRuntime.HTTPBody.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .log(.init(
                                        payload: .init(
                                            headers: headers,
                                            body: body
                                        ),
                                        filename: filename
                                    ))
                                default:
                                    return .undocumented(part)
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyFragment() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data: {}
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            case undocumented(OpenAPIRuntime.MultipartRawPart)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .undocumented(value):
                                    return value
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, _) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                default:
                                    return .undocumented(part)
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyAdditionalPropertiesTrue() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        type: object
                        additionalProperties: true
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            case other(OpenAPIRuntime.MultipartRawPart)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .other(value):
                                    return value
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, _) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                default:
                                    return .other(part)
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyAdditionalPropertiesFalse() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        type: object
                        properties:
                          log:
                            type: string
                        required:
                          - log
                        additionalProperties: false
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            public struct logPayload: Sendable, Hashable {
                                public var body: OpenAPIRuntime.HTTPBody
                                public init(body: OpenAPIRuntime.HTTPBody) {
                                    self.body = body
                                }
                            }
                            case log(OpenAPIRuntime.MultipartPart<Operations.post_sol_foo.Input.Body.multipartFormPayload.logPayload>)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: false,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .log(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsBinary(
                                        value.body,
                                        headerFields: &headerFields,
                                        contentType: "text/plain"
                                    )
                                    return .init(
                                        name: "log",
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: false,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                case "log":
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "text/plain"
                                    )
                                    let body = try converter.getRequiredRequestBodyAsBinary(
                                        OpenAPIRuntime.HTTPBody.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .log(.init(
                                        payload: .init(body: body),
                                        filename: filename
                                    ))
                                default:
                                    preconditionFailure("Unknown part should be rejected by multipart validation.")
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyAdditionalPropertiesSchemaInline() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        type: object
                        properties:
                          log:
                            type: string
                        required:
                          - log
                        additionalProperties:
                          type: object
                          properties:
                            foo:
                              type: string
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            public struct logPayload: Sendable, Hashable {
                                public var body: OpenAPIRuntime.HTTPBody
                                public init(body: OpenAPIRuntime.HTTPBody) {
                                    self.body = body
                                }
                            }
                            case log(OpenAPIRuntime.MultipartPart<Operations.post_sol_foo.Input.Body.multipartFormPayload.logPayload>)
                            public struct additionalPropertiesPayload: Codable, Hashable, Sendable {
                                public var foo: Swift.String?
                                public init(foo: Swift.String? = nil) {
                                    self.foo = foo
                                }
                                public enum CodingKeys: String, CodingKey {
                                    case foo
                                }
                            }
                            case additionalProperties(OpenAPIRuntime.MultipartDynamicallyNamedPart<Operations.post_sol_foo.Input.Body.multipartFormPayload.additionalPropertiesPayload>)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .log(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsBinary(
                                        value.body,
                                        headerFields: &headerFields,
                                        contentType: "text/plain"
                                    )
                                    return .init(
                                        name: "log",
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                case let .additionalProperties(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsJSON(
                                        value,
                                        headerFields: &headerFields,
                                        contentType: "application/json; charset=utf-8"
                                    )
                                    return .init(
                                        name: wrapped.name,
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                case "log":
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "text/plain"
                                    )
                                    let body = try converter.getRequiredRequestBodyAsBinary(
                                        OpenAPIRuntime.HTTPBody.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .log(.init(
                                        payload: .init(body: body),
                                        filename: filename
                                    ))
                                default:
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "application/json"
                                    )
                                    let body = try await converter.getRequiredRequestBodyAsJSON(
                                        Operations.post_sol_foo.Input.Body.multipartFormPayload.additionalPropertiesPayload.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .additionalProperties(.init(
                                        payload: body,
                                        filename: filename,
                                        name: name
                                    ))
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyAdditionalPropertiesSchemaReferenced() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        type: object
                        properties:
                          log:
                            type: string
                        required:
                          - log
                        additionalProperties:
                          $ref: '#/components/schemas/AssociatedValue'
                responses:
                  default:
                    description: Response
            """,
            """
            schemas:
              AssociatedValue:
                type: object
                properties:
                  foo:
                    type: string
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            public struct logPayload: Sendable, Hashable {
                                public var body: OpenAPIRuntime.HTTPBody
                                public init(body: OpenAPIRuntime.HTTPBody) {
                                    self.body = body
                                }
                            }
                            case log(OpenAPIRuntime.MultipartPart<Operations.post_sol_foo.Input.Body.multipartFormPayload.logPayload>)
                            case additionalProperties(OpenAPIRuntime.MultipartDynamicallyNamedPart<Components.Schemas.AssociatedValue>)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .log(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsBinary(
                                        value.body,
                                        headerFields: &headerFields,
                                        contentType: "text/plain"
                                    )
                                    return .init(
                                        name: "log",
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                case let .additionalProperties(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsJSON(
                                        value,
                                        headerFields: &headerFields,
                                        contentType: "application/json; charset=utf-8"
                                    )
                                    return .init(
                                        name: wrapped.name,
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [
                                "log"
                            ],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                case "log":
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "text/plain"
                                    )
                                    let body = try converter.getRequiredRequestBodyAsBinary(
                                        OpenAPIRuntime.HTTPBody.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .log(.init(
                                        payload: .init(body: body),
                                        filename: filename
                                    ))
                                default:
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "application/json"
                                    )
                                    let body = try await converter.getRequiredRequestBodyAsJSON(
                                        Components.Schemas.AssociatedValue.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .additionalProperties(.init(
                                        payload: body,
                                        filename: filename,
                                        name: name
                                    ))
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testRequestMultipartBodyAdditionalPropertiesSchemaBuiltin() throws {
        try self.assertRequestInTypesClientServerTranslation(
            """
            /foo:
              post:
                requestBody:
                  required: true
                  content:
                    multipart/form-data:
                      schema:
                        type: object
                        additionalProperties:
                          type: string
                responses:
                  default:
                    description: Response
            """,
            types: """
                public struct Input: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        @frozen public enum multipartFormPayload: Sendable, Hashable {
                            case additionalProperties(OpenAPIRuntime.MultipartDynamicallyNamedPart<OpenAPIRuntime.HTTPBody>)
                        }
                        case multipartForm(OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>)
                    }
                    public var body: Operations.post_sol_foo.Input.Body
                    public init(body: Operations.post_sol_foo.Input.Body) {
                        self.body = body
                    }
                }
                """,
            client: """
                { input in
                    let path = try converter.renderedPath(
                        template: "/foo",
                        parameters: []
                    )
                    var request: HTTPTypes.HTTPRequest = .init(
                        soar_path: path,
                        method: .post
                    )
                    suppressMutabilityWarning(&request)
                    let body: OpenAPIRuntime.HTTPBody?
                    switch input.body {
                    case let .multipartForm(value):
                        body = try converter.setRequiredRequestBodyAsMultipart(
                            value,
                            headerFields: &request.headerFields,
                            contentType: "multipart/form-data",
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            encoding: { part in
                                switch part {
                                case let .additionalProperties(wrapped):
                                    var headerFields: HTTPTypes.HTTPFields = .init()
                                    let value = wrapped.payload
                                    let body = try converter.setRequiredRequestBodyAsBinary(
                                        value,
                                        headerFields: &headerFields,
                                        contentType: "text/plain"
                                    )
                                    return .init(
                                        name: wrapped.name,
                                        filename: wrapped.filename,
                                        headerFields: headerFields,
                                        body: body
                                    )
                                }
                            }
                        )
                    }
                    return (request, body)
                }
                """,
            server: """
                { request, requestBody, metadata in
                    let contentType = converter.extractContentTypeIfPresent(in: request.headerFields)
                    let body: Operations.post_sol_foo.Input.Body
                    let chosenContentType = try converter.bestContentType(
                        received: contentType,
                        options: [
                            "multipart/form-data"
                        ]
                    )
                    switch chosenContentType {
                    case "multipart/form-data":
                        body = try converter.getRequiredRequestBodyAsMultipart(
                            OpenAPIRuntime.MultipartBody<Operations.post_sol_foo.Input.Body.multipartFormPayload>.self,
                            from: requestBody,
                            transforming: { value in
                                .multipartForm(value)
                            },
                            boundary: contentType.requiredBoundary(),
                            allowsUnknownParts: true,
                            requiredExactlyOncePartNames: [],
                            requiredAtLeastOncePartNames: [],
                            atMostOncePartNames: [],
                            zeroOrMoreTimesPartNames: [],
                            decoding: { part in
                                let headerFields = part.headerFields
                                let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                switch name {
                                default:
                                    try converter.verifyContentTypeIfPresent(
                                        in: headerFields,
                                        matches: "text/plain"
                                    )
                                    let body = try converter.getRequiredRequestBodyAsBinary(
                                        OpenAPIRuntime.HTTPBody.self,
                                        from: part.body,
                                        transforming: {
                                            $0
                                        }
                                    )
                                    return .additionalProperties(.init(
                                        payload: body,
                                        filename: filename,
                                        name: name
                                    ))
                                }
                            }
                        )
                    default:
                        preconditionFailure("bestContentType chose an invalid content type.")
                    }
                    return Operations.post_sol_foo.Input(body: body)
                }
                """
        )
    }

    func testResponseMultipartReferencedResponse() throws {
        try self.assertResponseInTypesClientServerTranslation(
            """
            /foo:
              get:
                responses:
                  '200':
                    $ref: '#/components/responses/MultipartResponse'
            """,
            """
            responses:
              MultipartResponse:
                description: Multipart
                content:
                  multipart/form-data:
                    schema:
                      type: object
                      properties:
                        log:
                          type: string
            """,
            types: """
                @frozen public enum Output: Sendable, Hashable {
                    case ok(Components.Responses.MultipartResponse)
                    public var ok: Components.Responses.MultipartResponse {
                        get throws {
                            switch self {
                            case let .ok(response):
                                return response
                            default:
                                try throwUnexpectedResponseStatus(
                                    expectedStatus: "ok",
                                    response: self
                                )
                            }
                        }
                    }
                    case undocumented(statusCode: Swift.Int, OpenAPIRuntime.UndocumentedPayload)
                }
                """,
            responses: """
                public enum Responses {
                    public struct MultipartResponse: Sendable, Hashable {
                        @frozen public enum Body: Sendable, Hashable {
                            @frozen public enum multipartFormPayload: Sendable, Hashable {
                                public struct logPayload: Sendable, Hashable {
                                    public var body: OpenAPIRuntime.HTTPBody
                                    public init(body: OpenAPIRuntime.HTTPBody) {
                                        self.body = body
                                    }
                                }
                                case log(OpenAPIRuntime.MultipartPart<Components.Responses.MultipartResponse.Body.multipartFormPayload.logPayload>)
                                case undocumented(OpenAPIRuntime.MultipartRawPart)
                            }
                            case multipartForm(OpenAPIRuntime.MultipartBody<Components.Responses.MultipartResponse.Body.multipartFormPayload>)
                            public var multipartForm: OpenAPIRuntime.MultipartBody<Components.Responses.MultipartResponse.Body.multipartFormPayload> {
                                get throws {
                                    switch self {
                                    case let .multipartForm(body):
                                        return body
                                    }
                                }
                            }
                        }
                        public var body: Components.Responses.MultipartResponse.Body
                        public init(body: Components.Responses.MultipartResponse.Body) {
                            self.body = body
                        }
                    }
                }
                """,
            server: """
                { output, request in
                    switch output {
                    case let .ok(value):
                        suppressUnusedWarning(value)
                        var response = HTTPTypes.HTTPResponse(soar_statusCode: 200)
                        suppressMutabilityWarning(&response)
                        let body: OpenAPIRuntime.HTTPBody
                        switch value.body {
                        case let .multipartForm(value):
                            try converter.validateAcceptIfPresent(
                                "multipart/form-data",
                                in: request.headerFields
                            )
                            body = try converter.setResponseBodyAsMultipart(
                                value,
                                headerFields: &response.headerFields,
                                contentType: "multipart/form-data",
                                allowsUnknownParts: true,
                                requiredExactlyOncePartNames: [],
                                requiredAtLeastOncePartNames: [],
                                atMostOncePartNames: [
                                    "log"
                                ],
                                zeroOrMoreTimesPartNames: [],
                                encoding: { part in
                                    switch part {
                                    case let .log(wrapped):
                                        var headerFields: HTTPTypes.HTTPFields = .init()
                                        let value = wrapped.payload
                                        let body = try converter.setResponseBodyAsBinary(
                                            value.body,
                                            headerFields: &headerFields,
                                            contentType: "text/plain"
                                        )
                                        return .init(
                                            name: "log",
                                            filename: wrapped.filename,
                                            headerFields: headerFields,
                                            body: body
                                        )
                                    case let .undocumented(value):
                                        return value
                                    }
                                }
                            )
                        }
                        return (response, body)
                    case let .undocumented(statusCode, _):
                        return (.init(soar_statusCode: statusCode), nil)
                    }
                }
                """,
            client: """
                { response, responseBody in
                    switch response.status.code {
                    case 200:
                        let contentType = converter.extractContentTypeIfPresent(in: response.headerFields)
                        let body: Components.Responses.MultipartResponse.Body
                        let chosenContentType = try converter.bestContentType(
                            received: contentType,
                            options: [
                                "multipart/form-data"
                            ]
                        )
                        switch chosenContentType {
                        case "multipart/form-data":
                            body = try converter.getResponseBodyAsMultipart(
                                OpenAPIRuntime.MultipartBody<Components.Responses.MultipartResponse.Body.multipartFormPayload>.self,
                                from: responseBody,
                                transforming: { value in
                                    .multipartForm(value)
                                },
                                boundary: contentType.requiredBoundary(),
                                allowsUnknownParts: true,
                                requiredExactlyOncePartNames: [],
                                requiredAtLeastOncePartNames: [],
                                atMostOncePartNames: [
                                    "log"
                                ],
                                zeroOrMoreTimesPartNames: [],
                                decoding: { part in
                                    let headerFields = part.headerFields
                                    let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                    switch name {
                                    case "log":
                                        try converter.verifyContentTypeIfPresent(
                                            in: headerFields,
                                            matches: "text/plain"
                                        )
                                        let body = try converter.getResponseBodyAsBinary(
                                            OpenAPIRuntime.HTTPBody.self,
                                            from: part.body,
                                            transforming: {
                                                $0
                                            }
                                        )
                                        return .log(.init(
                                            payload: .init(body: body),
                                            filename: filename
                                        ))
                                    default:
                                        return .undocumented(part)
                                    }
                                }
                            )
                        default:
                            preconditionFailure("bestContentType chose an invalid content type.")
                        }
                        return .ok(.init(body: body))
                    default:
                        return .undocumented(
                            statusCode: response.status.code,
                            .init(
                                headerFields: response.headerFields,
                                body: responseBody
                            )
                        )
                    }
                }
                """
        )
    }

    func testResponseMultipartInlineResponse() throws {
        try self.assertResponseInTypesClientServerTranslation(
            """
            /foo:
              get:
                responses:
                  '200':
                    description: Multipart
                    content:
                      multipart/form-data:
                        schema:
                          type: object
                          properties:
                            log:
                              type: string
            """,
            types: """
                @frozen public enum Output: Sendable, Hashable {
                    public struct Ok: Sendable, Hashable {
                        @frozen public enum Body: Sendable, Hashable {
                            @frozen public enum multipartFormPayload: Sendable, Hashable {
                                public struct logPayload: Sendable, Hashable {
                                    public var body: OpenAPIRuntime.HTTPBody
                                    public init(body: OpenAPIRuntime.HTTPBody) {
                                        self.body = body
                                    }
                                }
                                case log(OpenAPIRuntime.MultipartPart<Operations.get_sol_foo.Output.Ok.Body.multipartFormPayload.logPayload>)
                                case undocumented(OpenAPIRuntime.MultipartRawPart)
                            }
                            case multipartForm(OpenAPIRuntime.MultipartBody<Operations.get_sol_foo.Output.Ok.Body.multipartFormPayload>)
                            public var multipartForm: OpenAPIRuntime.MultipartBody<Operations.get_sol_foo.Output.Ok.Body.multipartFormPayload> {
                                get throws {
                                    switch self {
                                    case let .multipartForm(body):
                                        return body
                                    }
                                }
                            }
                        }
                        public var body: Operations.get_sol_foo.Output.Ok.Body
                        public init(body: Operations.get_sol_foo.Output.Ok.Body) {
                            self.body = body
                        }
                    }
                    case ok(Operations.get_sol_foo.Output.Ok)
                    public var ok: Operations.get_sol_foo.Output.Ok {
                        get throws {
                            switch self {
                            case let .ok(response):
                                return response
                            default:
                                try throwUnexpectedResponseStatus(
                                    expectedStatus: "ok",
                                    response: self
                                )
                            }
                        }
                    }
                    case undocumented(statusCode: Swift.Int, OpenAPIRuntime.UndocumentedPayload)
                }
                """,
            server: """
                { output, request in
                    switch output {
                    case let .ok(value):
                        suppressUnusedWarning(value)
                        var response = HTTPTypes.HTTPResponse(soar_statusCode: 200)
                        suppressMutabilityWarning(&response)
                        let body: OpenAPIRuntime.HTTPBody
                        switch value.body {
                        case let .multipartForm(value):
                            try converter.validateAcceptIfPresent(
                                "multipart/form-data",
                                in: request.headerFields
                            )
                            body = try converter.setResponseBodyAsMultipart(
                                value,
                                headerFields: &response.headerFields,
                                contentType: "multipart/form-data",
                                allowsUnknownParts: true,
                                requiredExactlyOncePartNames: [],
                                requiredAtLeastOncePartNames: [],
                                atMostOncePartNames: [
                                    "log"
                                ],
                                zeroOrMoreTimesPartNames: [],
                                encoding: { part in
                                    switch part {
                                    case let .log(wrapped):
                                        var headerFields: HTTPTypes.HTTPFields = .init()
                                        let value = wrapped.payload
                                        let body = try converter.setResponseBodyAsBinary(
                                            value.body,
                                            headerFields: &headerFields,
                                            contentType: "text/plain"
                                        )
                                        return .init(
                                            name: "log",
                                            filename: wrapped.filename,
                                            headerFields: headerFields,
                                            body: body
                                        )
                                    case let .undocumented(value):
                                        return value
                                    }
                                }
                            )
                        }
                        return (response, body)
                    case let .undocumented(statusCode, _):
                        return (.init(soar_statusCode: statusCode), nil)
                    }
                }
                """,
            client: """
                { response, responseBody in
                    switch response.status.code {
                    case 200:
                        let contentType = converter.extractContentTypeIfPresent(in: response.headerFields)
                        let body: Operations.get_sol_foo.Output.Ok.Body
                        let chosenContentType = try converter.bestContentType(
                            received: contentType,
                            options: [
                                "multipart/form-data"
                            ]
                        )
                        switch chosenContentType {
                        case "multipart/form-data":
                            body = try converter.getResponseBodyAsMultipart(
                                OpenAPIRuntime.MultipartBody<Operations.get_sol_foo.Output.Ok.Body.multipartFormPayload>.self,
                                from: responseBody,
                                transforming: { value in
                                    .multipartForm(value)
                                },
                                boundary: contentType.requiredBoundary(),
                                allowsUnknownParts: true,
                                requiredExactlyOncePartNames: [],
                                requiredAtLeastOncePartNames: [],
                                atMostOncePartNames: [
                                    "log"
                                ],
                                zeroOrMoreTimesPartNames: [],
                                decoding: { part in
                                    let headerFields = part.headerFields
                                    let (name, filename) = try converter.extractContentDispositionNameAndFilename(in: headerFields)
                                    switch name {
                                    case "log":
                                        try converter.verifyContentTypeIfPresent(
                                            in: headerFields,
                                            matches: "text/plain"
                                        )
                                        let body = try converter.getResponseBodyAsBinary(
                                            OpenAPIRuntime.HTTPBody.self,
                                            from: part.body,
                                            transforming: {
                                                $0
                                            }
                                        )
                                        return .log(.init(
                                            payload: .init(body: body),
                                            filename: filename
                                        ))
                                    default:
                                        return .undocumented(part)
                                    }
                                }
                            )
                        default:
                            preconditionFailure("bestContentType chose an invalid content type.")
                        }
                        return .ok(.init(body: body))
                    default:
                        return .undocumented(
                            statusCode: response.status.code,
                            .init(
                                headerFields: response.headerFields,
                                body: responseBody
                            )
                        )
                    }
                }
                """
        )
    }

    func testResponseWithExampleWithOnlyValueByte() throws {
        try self.assertResponsesTranslation(
            """
            responses:
              MyResponse:
                description: Some response
                content:
                  application/json:
                    schema:
                      type: string
                      contentEncoding: base64
                    examples:
                      application/json:
                        summary: "a hello response"
            """,
            """
            public enum Responses {
                public struct MyResponse: Sendable, Hashable {
                    @frozen public enum Body: Sendable, Hashable {
                        case json(OpenAPIRuntime.Base64EncodedData)
                        public var json: OpenAPIRuntime.Base64EncodedData {
                            get throws {
                                switch self {
                                case let .json(body):
                                    return body
                                }
                            }
                        }
                    }
                    public var body: Components.Responses.MyResponse.Body
                    public init(body: Components.Responses.MyResponse.Body) {
                        self.body = body
                    }
                }
            }
            """
        )
    }

}

extension SnippetBasedReferenceTests {
    func makeTypesTranslator(openAPIDocumentYAML: String) throws -> TypesFileTranslator {
        let document = try YAMLDecoder().decode(OpenAPI.Document.self, from: openAPIDocumentYAML)
        return TypesFileTranslator(
            config: Config(mode: .types, access: .public),
            diagnostics: XCTestDiagnosticCollector(test: self),
            components: document.components
        )
    }

    func makeTypesTranslator(
        accessModifier: AccessModifier = .public,
        featureFlags: FeatureFlags = [],
        ignoredDiagnosticMessages: Set<String> = [],
        componentsYAML: String
    ) throws -> TypesFileTranslator {
        let components = try YAMLDecoder().decode(OpenAPI.Components.self, from: componentsYAML)
        return TypesFileTranslator(
            config: Config(mode: .types, access: accessModifier, featureFlags: featureFlags),
            diagnostics: XCTestDiagnosticCollector(test: self, ignoredDiagnosticMessages: ignoredDiagnosticMessages),
            components: components
        )
    }

    func makeTranslators(
        components: OpenAPI.Components = .noComponents,
        featureFlags: FeatureFlags = [],
        ignoredDiagnosticMessages: Set<String> = []
    ) throws -> (TypesFileTranslator, ClientFileTranslator, ServerFileTranslator) {
        let collector = XCTestDiagnosticCollector(test: self, ignoredDiagnosticMessages: ignoredDiagnosticMessages)
        return (
            TypesFileTranslator(
                config: Config(mode: .types, access: .public, featureFlags: featureFlags),
                diagnostics: collector,
                components: components
            ),
            ClientFileTranslator(
                config: Config(mode: .client, access: .public, featureFlags: featureFlags),
                diagnostics: collector,
                components: components
            ),
            ServerFileTranslator(
                config: Config(mode: .server, access: .public, featureFlags: featureFlags),
                diagnostics: collector,
                components: components
            )
        )
    }

    func assertHeadersTranslation(
        _ componentsYAML: String,
        _ expectedSwift: String,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        let translator = try makeTypesTranslator(componentsYAML: componentsYAML)
        let translation = try translator.translateComponentHeaders(translator.components.headers)
        try XCTAssertSwiftEquivalent(translation, expectedSwift, file: file, line: line)
    }

    func assertParametersTranslation(
        _ componentsYAML: String,
        _ expectedSwift: String,
        accessModifier: AccessModifier = .public,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        let translator = try makeTypesTranslator(accessModifier: accessModifier, componentsYAML: componentsYAML)
        let translation = try translator.translateComponentParameters(translator.components.parameters)
        try XCTAssertSwiftEquivalent(translation, expectedSwift, file: file, line: line)
    }

    func assertRequestInTypesClientServerTranslation(
        _ pathsYAML: String,
        _ componentsYAML: String? = nil,
        types expectedTypesSwift: String,
        schemas expectedSchemasSwift: String? = nil,
        requestBodies expectedRequestBodiesSwift: String? = nil,
        client expectedClientSwift: String,
        server expectedServerSwift: String,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        continueAfterFailure = false
        let components =
            try componentsYAML.flatMap { componentsYAML in
                try YAMLDecoder().decode(OpenAPI.Components.self, from: componentsYAML)
            } ?? OpenAPI.Components.noComponents
        let (types, client, server) = try makeTranslators(components: components)
        let paths = try YAMLDecoder().decode(OpenAPI.PathItem.Map.self, from: pathsYAML)
        let document = OpenAPI.Document(
            openAPIVersion: .v3_1_0,
            info: .init(title: "Test", version: "1.0.0"),
            servers: [],
            paths: paths,
            components: components
        )
        let multipartSchemaNames = try types.parseSchemaNamesUsedInMultipart(paths: paths, components: components)
        let operationDescriptions = try OperationDescription.all(
            from: document.paths,
            in: document.components,
            context: types.context
        )
        let operation = try XCTUnwrap(operationDescriptions.first)
        let generatedTypesStructuredSwift = try types.translateOperationInput(operation)
        try XCTAssertSwiftEquivalent(generatedTypesStructuredSwift, expectedTypesSwift, file: file, line: line)
        if let expectedSchemasSwift {
            let generatedSchemasStructuredSwift = try types.translateSchemas(
                document.components.schemas,
                multipartSchemaNames: multipartSchemaNames
            )
            try XCTAssertSwiftEquivalent(generatedSchemasStructuredSwift, expectedSchemasSwift, file: file, line: line)
        }
        if let expectedRequestBodiesSwift {
            let generatedRequestBodiesStructuredSwift = try types.translateComponentRequestBodies(
                document.components.requestBodies
            )
            try XCTAssertSwiftEquivalent(
                generatedRequestBodiesStructuredSwift,
                expectedRequestBodiesSwift,
                file: file,
                line: line
            )
        }
        let generatedClientStructuredSwift = try client.translateClientSerializer(operation)
        try XCTAssertSwiftEquivalent(generatedClientStructuredSwift, expectedClientSwift, file: file, line: line)

        let generatedServerStructuredSwift = try server.translateServerDeserializer(operation)
        try XCTAssertSwiftEquivalent(generatedServerStructuredSwift, expectedServerSwift, file: file, line: line)
    }

    func assertResponseInTypesClientServerTranslation(
        _ pathsYAML: String,
        _ componentsYAML: String? = nil,
        types expectedTypesSwift: String,
        schemas expectedSchemasSwift: String? = nil,
        responses expectedResponsesSwift: String? = nil,
        server expectedServerSwift: String,
        client expectedClientSwift: String,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        continueAfterFailure = false
        let components =
            try componentsYAML.flatMap { componentsYAML in
                try YAMLDecoder().decode(OpenAPI.Components.self, from: componentsYAML)
            } ?? OpenAPI.Components.noComponents
        let (types, client, server) = try makeTranslators(components: components)
        let paths = try YAMLDecoder().decode(OpenAPI.PathItem.Map.self, from: pathsYAML)
        let document = OpenAPI.Document(
            openAPIVersion: .v3_1_0,
            info: .init(title: "Test", version: "1.0.0"),
            servers: [],
            paths: paths,
            components: components
        )
        let multipartSchemaNames = try types.parseSchemaNamesUsedInMultipart(paths: paths, components: components)
        let operationDescriptions = try OperationDescription.all(
            from: document.paths,
            in: document.components,
            context: types.context
        )
        let operation = try XCTUnwrap(operationDescriptions.first)
        let generatedTypesStructuredSwift = try types.translateOperationOutput(operation)
        try XCTAssertSwiftEquivalent(generatedTypesStructuredSwift, expectedTypesSwift, file: file, line: line)
        if let expectedSchemasSwift {
            let generatedSchemasStructuredSwift = try types.translateSchemas(
                document.components.schemas,
                multipartSchemaNames: multipartSchemaNames
            )
            try XCTAssertSwiftEquivalent(generatedSchemasStructuredSwift, expectedSchemasSwift, file: file, line: line)
        }
        if let expectedResponsesSwift {
            let generatedRequestBodiesStructuredSwift = try types.translateComponentResponses(
                document.components.responses
            )
            try XCTAssertSwiftEquivalent(
                generatedRequestBodiesStructuredSwift,
                expectedResponsesSwift,
                file: file,
                line: line
            )
        }
        let generatedServerStructuredSwift = try server.translateServerSerializer(operation)
        try XCTAssertSwiftEquivalent(generatedServerStructuredSwift, expectedServerSwift, file: file, line: line)

        let generatedClientStructuredSwift = try client.translateClientDeserializer(operation)
        try XCTAssertSwiftEquivalent(generatedClientStructuredSwift, expectedClientSwift, file: file, line: line)
    }

    func assertSchemasTranslation(
        featureFlags: FeatureFlags = [],
        ignoredDiagnosticMessages: Set<String> = [],
        _ componentsYAML: String,
        _ expectedSwift: String,
        accessModifier: AccessModifier = .public,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        let translator = try makeTypesTranslator(
            accessModifier: accessModifier,
            featureFlags: featureFlags,
            ignoredDiagnosticMessages: ignoredDiagnosticMessages,
            componentsYAML: componentsYAML
        )
        let components = translator.components
        let multipartSchemaNames = try translator.parseSchemaNamesUsedInMultipart(paths: [:], components: components)
        let translation = try translator.translateSchemas(
            components.schemas,
            multipartSchemaNames: multipartSchemaNames
        )
        try XCTAssertSwiftEquivalent(translation, expectedSwift, file: file, line: line)
    }

    func assertResponsesTranslation(
        featureFlags: FeatureFlags = [],
        ignoredDiagnosticMessages: Set<String> = [],
        _ componentsYAML: String,
        _ expectedSwift: String,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        let translator = try makeTypesTranslator(
            featureFlags: featureFlags,
            ignoredDiagnosticMessages: ignoredDiagnosticMessages,
            componentsYAML: componentsYAML
        )
        let translation = try translator.translateComponentResponses(translator.components.responses)
        try XCTAssertSwiftEquivalent(translation, expectedSwift, file: file, line: line)
    }

    func assertRequestBodiesTranslation(
        featureFlags: FeatureFlags = [],
        ignoredDiagnosticMessages: Set<String> = [],
        _ componentsYAML: String,
        _ expectedSwift: String,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        let translator = try makeTypesTranslator(
            featureFlags: featureFlags,
            ignoredDiagnosticMessages: ignoredDiagnosticMessages,
            componentsYAML: componentsYAML
        )
        let translation = try translator.translateComponentRequestBodies(translator.components.requestBodies)
        try XCTAssertSwiftEquivalent(translation, expectedSwift, file: file, line: line)
    }

    func assertPathsTranslation(
        _ pathsYAML: String,
        componentsYAML: String = "{}",
        _ expectedSwift: String,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        let translator = try makeTypesTranslator(componentsYAML: componentsYAML)
        let paths = try YAMLDecoder().decode(OpenAPI.PathItem.Map.self, from: pathsYAML)
        let translation = try translator.translateAPIProtocol(paths)
        try XCTAssertSwiftEquivalent(translation, expectedSwift, file: file, line: line)
    }

    func assertPathsTranslationExtension(
        _ pathsYAML: String,
        componentsYAML: String = "{}",
        _ expectedSwift: String,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        let translator = try makeTypesTranslator(componentsYAML: componentsYAML)
        let paths = try YAMLDecoder().decode(OpenAPI.PathItem.Map.self, from: pathsYAML)
        let translation = try translator.translateAPIProtocolExtension(paths)
        try XCTAssertSwiftEquivalent(translation, expectedSwift, file: file, line: line)
    }

    func assertServerRegisterHandlers(
        _ pathsYAML: String,
        _ expectedSwift: String,
        file: StaticString = #filePath,
        line: UInt = #line
    ) throws {
        let (_, _, translator) = try makeTranslators()
        let paths = try YAMLDecoder().decode(OpenAPI.PathItem.Map.self, from: pathsYAML)
        let operations = try OperationDescription.all(from: paths, in: .noComponents, context: translator.context)
        let (registerHandlersDecl, _) = try translator.translateRegisterHandlers(operations)
        try XCTAssertSwiftEquivalent(registerHandlersDecl, expectedSwift, file: file, line: line)
    }
}

private func XCTAssertEqualWithDiff(
    _ actual: String,
    _ expected: String,
    file: StaticString = #filePath,
    line: UInt = #line
) throws {
    if actual == expected { return }
    XCTFail(
        """
        XCTAssertEqualWithDiff failed (click for diff)
        \(try diff(expected: expected, actual: actual))
        """,
        file: file,
        line: line
    )
}

private func XCTAssertSwiftEquivalent(
    _ declaration: Declaration,
    _ expectedSwift: String,
    file: StaticString = #filePath,
    line: UInt = #line
) throws {
    let renderer = TextBasedRenderer.default
    renderer.renderDeclaration(declaration.strippingComments)
    let contents = renderer.renderedContents()
    try XCTAssertEqualWithDiff(contents, expectedSwift, file: file, line: line)
}

private func XCTAssertSwiftEquivalent(
    _ codeBlock: CodeBlock,
    _ expectedSwift: String,
    file: StaticString = #filePath,
    line: UInt = #line
) throws {
    let renderer = TextBasedRenderer.default
    renderer.renderCodeBlock(codeBlock)
    let contents = renderer.renderedContents()
    try XCTAssertEqualWithDiff(contents, expectedSwift, file: file, line: line)
}

private func XCTAssertSwiftEquivalent(
    _ expression: _OpenAPIGeneratorCore.Expression,
    _ expectedSwift: String,
    file: StaticString = #filePath,
    line: UInt = #line
) throws {
    let renderer = TextBasedRenderer.default
    renderer.renderExpression(expression)
    let contents = renderer.renderedContents()
    try XCTAssertEqualWithDiff(contents, expectedSwift, file: file, line: line)
}

private func diff(expected: String, actual: String) throws -> String {
    let process = Process()
    process.executableURL = URL(fileURLWithPath: "/usr/bin/env")
    process.arguments = [
        "bash", "-c", "diff -U5 --label=expected <(echo '\(expected)') --label=actual <(echo '\(actual)')",
    ]
    let pipe = Pipe()
    process.standardOutput = pipe
    try process.run()
    process.waitUntilExit()
    let pipeData = try XCTUnwrap(
        pipe.fileHandleForReading.readToEnd(),
        """
        No output from command:
        \(process.executableURL!.path) \(process.arguments!.joined(separator: " "))
        """
    )
    return String(decoding: pipeData, as: UTF8.self)
}

fileprivate extension Declaration {
    var strippingComments: Self { stripComments(self) }

    func stripComments(_ decl: Declaration) -> Declaration {
        switch decl {
        case let .commentable(_, d): return stripComments(d)
        case let .deprecated(a, b): return .deprecated(a, stripComments(b))
        case var .protocol(p):
            p.members = p.members.map(stripComments(_:))
            return .protocol(p)
        case var .function(f):
            f.body = f.body?.map(stripComments(_:))
            return .function(f)
        case var .extension(e):
            e.declarations = e.declarations.map(stripComments(_:))
            return .extension(e)
        case var .struct(s):
            s.members = s.members.map(stripComments(_:))
            return .struct(s)
        case var .enum(e):
            e.members = e.members.map(stripComments(_:))
            return .enum(e)
        case var .variable(v):
            v.getter = stripComments(v.getter)
            return .variable(v)
        case let .typealias(t): return .typealias(t)
        case let .enumCase(e): return .enumCase(e)
        }
    }

    func stripComments(_ body: [CodeBlock]?) -> [CodeBlock]? { body.map(stripComments(_:)) }

    func stripComments(_ body: [CodeBlock]) -> [CodeBlock] { body.map(stripComments(_:)) }

    func stripComments(_ codeBlock: CodeBlock) -> CodeBlock {
        CodeBlock(comment: nil, item: stripComments(codeBlock.item))
    }

    func stripComments(_ codeBlockItem: CodeBlockItem) -> CodeBlockItem {
        switch codeBlockItem {
        case let .declaration(d): return .declaration(stripComments(d))
        case .expression: return codeBlockItem
        }
    }
}