/* * Copyright 2020, 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. */ @testable import GRPC import NIOHPACK import XCTest struct UnwrapError: Error {} // We support Swift versions before 'XCTUnwrap' was introduced. func assertNotNil( _ expression: @autoclosure () throws -> Value?, message: @autoclosure () -> String = "Optional value was nil", file: StaticString = #file, line: UInt = #line ) throws -> Value { guard let value = try expression() else { XCTFail(message(), file: file, line: line) throw UnwrapError() } return value } func assertNoThrow( _ expression: @autoclosure () throws -> Value, message: @autoclosure () -> String = "Unexpected error thrown", file: StaticString = #file, line: UInt = #line ) throws -> Value { do { return try expression() } catch { XCTFail(message(), file: file, line: line) throw error } } // MARK: - Matchers. func assertThat( _ expression: @autoclosure @escaping () throws -> Value, _ matcher: Matcher, file: StaticString = #file, line: UInt = #line ) { // For value matchers we'll assert that we don't throw by default. assertThat(try expression(), .doesNotThrow(matcher), file: file, line: line) } func assertThat( _ expression: @autoclosure @escaping () throws -> Value, _ matcher: ExpressionMatcher, file: StaticString = #file, line: UInt = #line ) { switch matcher.evaluate(expression) { case .match: () case let .noMatch(actual: actual, expected: expected): XCTFail("ACTUAL: \(actual), EXPECTED: \(expected)", file: file, line: line) } } enum MatchResult { case match case noMatch(actual: String, expected: String) } struct Matcher { private typealias Evaluator = (Value) -> MatchResult private var matcher: Evaluator private init(_ matcher: @escaping Evaluator) { self.matcher = matcher } fileprivate func evaluate(_ value: Value) -> MatchResult { return self.matcher(value) } // MARK: Sugar /// Just returns the provided matcher. static func `is`(_ matcher: Matcher) -> Matcher { return matcher } /// Just returns the provided matcher. static func and(_ matcher: Matcher) -> Matcher { return matcher } // MARK: Equality /// Checks the equality of the actual value against the provided value. See `equalTo(_:)`. static func `is`(_ value: Value) -> Matcher { return .equalTo(value) } /// Checks the equality of the actual value against the provided value. static func equalTo(_ expected: Value) -> Matcher { return .init { actual in actual == expected ? .match : .noMatch(actual: "\(actual)", expected: "equal to \(expected)") } } /// Always returns a 'match', useful when the expected value is `Void`. static func isVoid() -> Matcher { return .init { return .match } } /// Matches if the value is `nil`. static func `nil`() -> Matcher { return .init { actual in actual == nil ? .match : .noMatch(actual: String(describing: actual), expected: "nil") } } /// Matches if the value is not `nil`. static func notNil(_ matcher: Matcher? = nil) -> Matcher { return .init { actual in if let actual = actual { return matcher?.evaluate(actual) ?? .match } else { return .noMatch(actual: "nil", expected: "not nil") } } } // MARK: Type /// Checks that the actual value is an instance of the given type. static func instanceOf(_: Expected.Type) -> Matcher { return .init { actual in if actual is Expected { return .match } else { return .noMatch( actual: String(describing: type(of: actual)) + " (\(actual))", expected: "value of type \(Expected.self)" ) } } } // MARK: Collection /// Checks whether the collection has the expected count. static func hasCount(_ count: Int) -> Matcher { return .init { actual in actual.count == count ? .match : .noMatch(actual: "has count \(actual.count)", expected: "count of \(count)") } } static func isEmpty() -> Matcher { return .init { actual in actual.isEmpty ? .match : .noMatch(actual: "has \(actual.count) items", expected: "is empty") } } // MARK: gRPC matchers static func hasCode(_ code: GRPCStatus.Code) -> Matcher { return .init { actual in actual.code == code ? .match : .noMatch(actual: "has status code \(actual)", expected: "\(code)") } } static func metadata( _ matcher: Matcher? = nil ) -> Matcher> { return .init { actual in switch actual { case let .metadata(headers): return matcher?.evaluate(headers) ?? .match default: return .noMatch(actual: String(describing: actual), expected: "metadata") } } } static func message( _ matcher: Matcher? = nil ) -> Matcher> { return .init { actual in switch actual { case let .message(message): return matcher?.evaluate(message) ?? .match default: return .noMatch(actual: String(describing: actual), expected: "message") } } } static func metadata( _ matcher: Matcher? = nil ) -> Matcher> { return .init { actual in switch actual { case let .metadata(headers): return matcher?.evaluate(headers) ?? .match default: return .noMatch(actual: String(describing: actual), expected: "metadata") } } } static func message( _ matcher: Matcher? = nil ) -> Matcher> { return .init { actual in switch actual { case let .message(message, _): return matcher?.evaluate(message) ?? .match default: return .noMatch(actual: String(describing: actual), expected: "message") } } } static func end( status statusMatcher: Matcher? = nil, trailers trailersMatcher: Matcher? = nil ) -> Matcher> { return .init { actual in switch actual { case let .end(status, trailers): let statusMatch = (statusMatcher?.evaluate(status) ?? .match) switch statusMatcher?.evaluate(status) ?? .match { case .match: return trailersMatcher?.evaluate(trailers) ?? .match case .noMatch: return statusMatch } default: return .noMatch(actual: String(describing: actual), expected: "end") } } } static func headers( _ matcher: Matcher? = nil ) -> Matcher<_GRPCServerResponsePart> { return .init { actual in switch actual { case let .headers(headers): return matcher?.evaluate(headers) ?? .match default: return .noMatch(actual: String(describing: actual), expected: "headers") } } } static func message( _ matcher: Matcher? = nil ) -> Matcher<_GRPCServerResponsePart> { return .init { actual in switch actual { case let .message(message): return matcher?.evaluate(message.message) ?? .match default: return .noMatch(actual: String(describing: actual), expected: "message") } } } static func end( _ matcher: Matcher? = nil ) -> Matcher<_GRPCServerResponsePart> { return .init { actual in switch actual { case let .statusAndTrailers(status, _): return matcher?.evaluate(status) ?? .match default: return .noMatch(actual: String(describing: actual), expected: "end") } } } // MARK: HTTP/2 static func contains( _ name: String, _ matcher: Matcher<[String]>? = nil ) -> Matcher { return .init { actual in let headers = actual[name] if headers.isEmpty { return .noMatch(actual: "does not contain '\(name)'", expected: "contains '\(name)'") } else { return matcher?.evaluate(headers) ?? .match } } } } struct ExpressionMatcher { typealias Expression = () throws -> Value private typealias Evaluator = (Expression) -> MatchResult private var evaluator: Evaluator private init(_ evaluator: @escaping Evaluator) { self.evaluator = evaluator } fileprivate func evaluate(_ expression: Expression) -> MatchResult { return self.evaluator(expression) } /// Asserts that the expression does not throw and error. Returns the result of any provided /// matcher on the result of the expression. static func doesNotThrow(_ matcher: Matcher? = nil) -> ExpressionMatcher { return .init { expression in do { let value = try expression() return matcher?.evaluate(value) ?? .match } catch { return .noMatch(actual: "threw '\(error)'", expected: "should not throw error") } } } /// Asserts that the expression throws and error. Returns the result of any provided matcher /// on the error thrown by the expression. static func `throws`(_ matcher: Matcher? = nil) -> ExpressionMatcher { return .init { expression in do { let value = try expression() return .noMatch(actual: "returned '\(value)'", expected: "should throw error") } catch { return matcher?.evaluate(error) ?? .match } } } }