/* * Copyright 2024, gRPC Authors All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #if os(macOS) || os(Linux) // swift-format doesn't like canImport(Foundation.Process) import XCTest @testable import GRPCCodeGen final class IDLToStructuredSwiftTranslatorSnippetBasedTests: XCTestCase { typealias MethodDescriptor = GRPCCodeGen.CodeGenerationRequest.ServiceDescriptor.MethodDescriptor typealias ServiceDescriptor = GRPCCodeGen.CodeGenerationRequest.ServiceDescriptor typealias Name = GRPCCodeGen.CodeGenerationRequest.Name func testImports() throws { var dependencies = [CodeGenerationRequest.Dependency]() dependencies.append(CodeGenerationRequest.Dependency(module: "Foo", accessLevel: .public)) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .typealias, name: "Bar"), module: "Foo", accessLevel: .internal ) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .struct, name: "Baz"), module: "Foo", accessLevel: .package ) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .class, name: "Bac"), module: "Foo", accessLevel: .package ) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .enum, name: "Bap"), module: "Foo", accessLevel: .package ) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .protocol, name: "Bat"), module: "Foo", accessLevel: .package ) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .let, name: "Baq"), module: "Foo", accessLevel: .package ) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .var, name: "Bag"), module: "Foo", accessLevel: .package ) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .func, name: "Bak"), module: "Foo", accessLevel: .package ) ) let expectedSwift = """ /// Some really exciting license header 2023. public import GRPCCore public import Foo internal import typealias Foo.Bar package import struct Foo.Baz package import class Foo.Bac package import enum Foo.Bap package import protocol Foo.Bat package import let Foo.Baq package import var Foo.Bag package import func Foo.Bak """ try self.assertIDLToStructuredSwiftTranslation( codeGenerationRequest: makeCodeGenerationRequest(dependencies: dependencies), expectedSwift: expectedSwift, accessLevel: .public ) } func testPreconcurrencyImports() throws { var dependencies = [CodeGenerationRequest.Dependency]() dependencies.append( CodeGenerationRequest.Dependency( module: "Foo", preconcurrency: .required, accessLevel: .internal ) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .enum, name: "Bar"), module: "Foo", preconcurrency: .required, accessLevel: .internal ) ) dependencies.append( CodeGenerationRequest.Dependency( module: "Baz", preconcurrency: .requiredOnOS(["Deq", "Der"]), accessLevel: .internal ) ) let expectedSwift = """ /// Some really exciting license header 2023. public import GRPCCore @preconcurrency internal import Foo @preconcurrency internal import enum Foo.Bar #if os(Deq) || os(Der) @preconcurrency internal import Baz #else internal import Baz #endif """ try self.assertIDLToStructuredSwiftTranslation( codeGenerationRequest: makeCodeGenerationRequest(dependencies: dependencies), expectedSwift: expectedSwift, accessLevel: .public ) } func testSPIImports() throws { var dependencies = [CodeGenerationRequest.Dependency]() dependencies.append( CodeGenerationRequest.Dependency(module: "Foo", spi: "Secret", accessLevel: .internal) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .enum, name: "Bar"), module: "Foo", spi: "Secret", accessLevel: .internal ) ) let expectedSwift = """ /// Some really exciting license header 2023. public import GRPCCore @_spi(Secret) internal import Foo @_spi(Secret) internal import enum Foo.Bar """ try self.assertIDLToStructuredSwiftTranslation( codeGenerationRequest: makeCodeGenerationRequest(dependencies: dependencies), expectedSwift: expectedSwift, accessLevel: .public ) } func testGeneration() throws { var dependencies = [CodeGenerationRequest.Dependency]() dependencies.append( CodeGenerationRequest.Dependency(module: "Foo", spi: "Secret", accessLevel: .internal) ) dependencies.append( CodeGenerationRequest.Dependency( item: .init(kind: .enum, name: "Bar"), module: "Foo", spi: "Secret", accessLevel: .internal ) ) let serviceA = ServiceDescriptor( documentation: "/// Documentation for AService\n", name: Name(base: "ServiceA", generatedUpperCase: "ServiceA", generatedLowerCase: "serviceA"), namespace: Name( base: "namespaceA", generatedUpperCase: "NamespaceA", generatedLowerCase: "namespaceA" ), methods: [] ) let expectedSwift = """ /// Some really exciting license header 2023. public import GRPCCore @_spi(Secret) internal import Foo @_spi(Secret) internal import enum Foo.Bar public enum NamespaceA_ServiceA { public static let descriptor = GRPCCore.ServiceDescriptor.namespaceA_ServiceA public enum Method { public static let descriptors: [GRPCCore.MethodDescriptor] = [] } @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) public typealias StreamingServiceProtocol = NamespaceA_ServiceAStreamingServiceProtocol @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) public typealias ServiceProtocol = NamespaceA_ServiceAServiceProtocol } extension GRPCCore.ServiceDescriptor { public static let namespaceA_ServiceA = Self( package: "namespaceA", service: "ServiceA" ) } /// Documentation for AService @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) public protocol NamespaceA_ServiceAStreamingServiceProtocol: GRPCCore.RegistrableRPCService {} /// Conformance to `GRPCCore.RegistrableRPCService`. @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) extension NamespaceA_ServiceA.StreamingServiceProtocol { @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) public func registerMethods(with router: inout GRPCCore.RPCRouter) {} } /// Documentation for AService @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) public protocol NamespaceA_ServiceAServiceProtocol: NamespaceA_ServiceA.StreamingServiceProtocol {} /// Partial conformance to `NamespaceA_ServiceAStreamingServiceProtocol`. @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) extension NamespaceA_ServiceA.ServiceProtocol { } """ try self.assertIDLToStructuredSwiftTranslation( codeGenerationRequest: makeCodeGenerationRequest( services: [serviceA], dependencies: dependencies ), expectedSwift: expectedSwift, accessLevel: .public, server: true ) } private func assertIDLToStructuredSwiftTranslation( codeGenerationRequest: CodeGenerationRequest, expectedSwift: String, accessLevel: SourceGenerator.Configuration.AccessLevel, server: Bool = false ) throws { let translator = IDLToStructuredSwiftTranslator() let structuredSwift = try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: accessLevel, accessLevelOnImports: true, client: false, server: server ) let renderer = TextBasedRenderer.default let sourceFile = try renderer.render(structured: structuredSwift) let contents = sourceFile.contents try XCTAssertEqualWithDiff(contents, expectedSwift) } func testSameNameServicesNoNamespaceError() throws { let serviceA = ServiceDescriptor( documentation: "Documentation for AService", name: Name(base: "AService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name(base: "", generatedUpperCase: "", generatedLowerCase: ""), methods: [] ) let codeGenerationRequest = makeCodeGenerationRequest(services: [serviceA, serviceA]) let translator = IDLToStructuredSwiftTranslator() XCTAssertThrowsError( ofType: CodeGenError.self, try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: .public, accessLevelOnImports: true, client: true, server: true ) ) { error in XCTAssertEqual( error as CodeGenError, CodeGenError( code: .nonUniqueServiceName, message: """ Services must have unique descriptors. \ AService is the descriptor of at least two different services. """ ) ) } } func testSameDescriptorsServicesNoNamespaceError() throws { let serviceA = ServiceDescriptor( documentation: "Documentation for AService", name: Name(base: "AService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name(base: "", generatedUpperCase: "", generatedLowerCase: ""), methods: [] ) let serviceB = ServiceDescriptor( documentation: "Documentation for BService", name: Name(base: "AService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name(base: "", generatedUpperCase: "", generatedLowerCase: ""), methods: [] ) let codeGenerationRequest = makeCodeGenerationRequest(services: [serviceA, serviceB]) let translator = IDLToStructuredSwiftTranslator() XCTAssertThrowsError( ofType: CodeGenError.self, try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: .public, accessLevelOnImports: true, client: true, server: true ) ) { error in XCTAssertEqual( error as CodeGenError, CodeGenError( code: .nonUniqueServiceName, message: """ Services must have unique descriptors. AService is the descriptor of at least two different services. """ ) ) } } func testSameDescriptorsSameNamespaceError() throws { let serviceA = ServiceDescriptor( documentation: "Documentation for AService", name: Name(base: "AService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name( base: "namespacea", generatedUpperCase: "NamespaceA", generatedLowerCase: "namespacea" ), methods: [] ) let codeGenerationRequest = makeCodeGenerationRequest(services: [serviceA, serviceA]) let translator = IDLToStructuredSwiftTranslator() XCTAssertThrowsError( ofType: CodeGenError.self, try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: .public, accessLevelOnImports: true, client: true, server: true ) ) { error in XCTAssertEqual( error as CodeGenError, CodeGenError( code: .nonUniqueServiceName, message: """ Services must have unique descriptors. \ namespacea.AService is the descriptor of at least two different services. """ ) ) } } func testSameGeneratedNameServicesSameNamespaceError() throws { let serviceA = ServiceDescriptor( documentation: "/// Documentation for AService\n", name: Name(base: "AService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name( base: "namespacea", generatedUpperCase: "NamespaceA", generatedLowerCase: "namespacea" ), methods: [] ) let serviceB = ServiceDescriptor( documentation: "/// Documentation for BService\n", name: Name(base: "BService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name( base: "namespacea", generatedUpperCase: "NamespaceA", generatedLowerCase: "namespacea" ), methods: [] ) let codeGenerationRequest = makeCodeGenerationRequest(services: [serviceA, serviceB]) let translator = IDLToStructuredSwiftTranslator() XCTAssertThrowsError( ofType: CodeGenError.self, try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: .internal, accessLevelOnImports: true, client: true, server: true ) ) { error in XCTAssertEqual( error as CodeGenError, CodeGenError( code: .nonUniqueServiceName, message: """ There must be a unique (namespace, service_name) pair for each service. \ NamespaceA_AService is used as a _ construction for multiple services. """ ) ) } } func testSameBaseNameMethodsSameServiceError() throws { let methodA = MethodDescriptor( documentation: "Documentation for MethodA", name: Name(base: "MethodA", generatedUpperCase: "MethodA", generatedLowerCase: "methodA"), isInputStreaming: false, isOutputStreaming: false, inputType: "NamespaceA_ServiceARequest", outputType: "NamespaceA_ServiceAResponse" ) let service = ServiceDescriptor( documentation: "Documentation for AService", name: Name(base: "AService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name( base: "namespacea", generatedUpperCase: "NamespaceA", generatedLowerCase: "namespacea" ), methods: [methodA, methodA] ) let codeGenerationRequest = makeCodeGenerationRequest(services: [service]) let translator = IDLToStructuredSwiftTranslator() XCTAssertThrowsError( ofType: CodeGenError.self, try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: .public, accessLevelOnImports: true, client: true, server: true ) ) { error in XCTAssertEqual( error as CodeGenError, CodeGenError( code: .nonUniqueMethodName, message: """ Methods of a service must have unique base names. \ MethodA is used as a base name for multiple methods of the AService service. """ ) ) } } func testSameGeneratedUpperCaseNameMethodsSameServiceError() throws { let methodA = MethodDescriptor( documentation: "Documentation for MethodA", name: Name(base: "MethodA", generatedUpperCase: "MethodA", generatedLowerCase: "methodA"), isInputStreaming: false, isOutputStreaming: false, inputType: "NamespaceA_ServiceARequest", outputType: "NamespaceA_ServiceAResponse" ) let methodB = MethodDescriptor( documentation: "Documentation for MethodA", name: Name(base: "MethodB", generatedUpperCase: "MethodA", generatedLowerCase: "methodA"), isInputStreaming: false, isOutputStreaming: false, inputType: "NamespaceA_ServiceARequest", outputType: "NamespaceA_ServiceAResponse" ) let service = ServiceDescriptor( documentation: "Documentation for AService", name: Name(base: "AService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name( base: "namespacea", generatedUpperCase: "NamespaceA", generatedLowerCase: "namespacea" ), methods: [methodA, methodB] ) let codeGenerationRequest = makeCodeGenerationRequest(services: [service]) let translator = IDLToStructuredSwiftTranslator() XCTAssertThrowsError( ofType: CodeGenError.self, try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: .public, accessLevelOnImports: true, client: true, server: true ) ) { error in XCTAssertEqual( error as CodeGenError, CodeGenError( code: .nonUniqueMethodName, message: """ Methods of a service must have unique generated upper case names. \ MethodA is used as a generated upper case name for multiple methods of the AService service. """ ) ) } } func testSameLowerCaseNameMethodsSameServiceError() throws { let methodA = MethodDescriptor( documentation: "Documentation for MethodA", name: Name(base: "MethodA", generatedUpperCase: "MethodA", generatedLowerCase: "methodA"), isInputStreaming: false, isOutputStreaming: false, inputType: "NamespaceA_ServiceARequest", outputType: "NamespaceA_ServiceAResponse" ) let methodB = MethodDescriptor( documentation: "Documentation for MethodA", name: Name(base: "MethodB", generatedUpperCase: "MethodB", generatedLowerCase: "methodA"), isInputStreaming: false, isOutputStreaming: false, inputType: "NamespaceA_ServiceARequest", outputType: "NamespaceA_ServiceAResponse" ) let service = ServiceDescriptor( documentation: "Documentation for AService", name: Name(base: "AService", generatedUpperCase: "AService", generatedLowerCase: "aService"), namespace: Name( base: "namespacea", generatedUpperCase: "NamespaceA", generatedLowerCase: "namespacea" ), methods: [methodA, methodB] ) let codeGenerationRequest = makeCodeGenerationRequest(services: [service]) let translator = IDLToStructuredSwiftTranslator() XCTAssertThrowsError( ofType: CodeGenError.self, try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: .public, accessLevelOnImports: true, client: true, server: true ) ) { error in XCTAssertEqual( error as CodeGenError, CodeGenError( code: .nonUniqueMethodName, message: """ Methods of a service must have unique lower case names. \ methodA is used as a signature name for multiple methods of the AService service. """ ) ) } } func testSameGeneratedNameNoNamespaceServiceAndNamespaceError() throws { let serviceA = ServiceDescriptor( documentation: "Documentation for SameName service with no namespace", name: Name( base: "SameName", generatedUpperCase: "SameName_BService", generatedLowerCase: "sameName" ), namespace: Name(base: "", generatedUpperCase: "", generatedLowerCase: ""), methods: [] ) let serviceB = ServiceDescriptor( documentation: "Documentation for BService", name: Name(base: "BService", generatedUpperCase: "BService", generatedLowerCase: "bService"), namespace: Name( base: "sameName", generatedUpperCase: "SameName", generatedLowerCase: "sameName" ), methods: [] ) let codeGenerationRequest = makeCodeGenerationRequest(services: [serviceA, serviceB]) let translator = IDLToStructuredSwiftTranslator() XCTAssertThrowsError( ofType: CodeGenError.self, try translator.translate( codeGenerationRequest: codeGenerationRequest, accessLevel: .public, accessLevelOnImports: true, client: true, server: true ) ) { error in XCTAssertEqual( error as CodeGenError, CodeGenError( code: .nonUniqueServiceName, message: """ There must be a unique (namespace, service_name) pair for each service. \ SameName_BService is used as a _ construction for multiple services. """ ) ) } } } #endif // os(macOS) || os(Linux)