grpc-swift/Tests/GRPCTests/EventLoopFuture+Assertions.swift

/*
 * Copyright 2019, 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.
 */
import Foundation
import NIO
import XCTest

extension EventLoopFuture where Value: Equatable {
  /// Registers a callback which asserts the value promised by this future is equal to
  /// the expected value. Causes a test failure if the future returns an error.
  ///
  /// - Parameters:
  ///   - expected: The expected value.
  ///   - expectation: A test expectation to fulfill once the future has completed.
  func assertEqual(_ expected: Value, fulfill expectation: XCTestExpectation, file: StaticString = magicFile(), line: UInt = #line) {
    self.whenComplete { result in
      defer {
        expectation.fulfill()
      }

      switch result {
      case .success(let actual):
        XCTAssertEqual(expected, actual, file: file, line: line)

      case .failure(let error):
        XCTFail("Expecteded '\(expected)' but received error: \(error)", file: file, line: line)
      }
    }
  }
}

extension EventLoopFuture {
  /// Registers a callback which asserts that this future is fulfilled with an error. Causes a test
  /// failure if the future is not fulfilled with an error.
  ///
  /// Callers can additionally verify the error by providing an error handler.
  ///
  /// - Parameters:
  ///   - expectation: A test expectation to fulfill once the future has completed.
  ///   - handler: A block to run additional verification on the error. Defaults to no-op.
  func assertError(fulfill expectation: XCTestExpectation, file: StaticString = magicFile(), line: UInt = #line, handler: @escaping (Error) -> Void = { _ in }) {
    self.whenComplete { result in
      defer {
        expectation.fulfill()
      }

      switch result {
      case .success:
        XCTFail("Unexpectedly received \(Value.self), expected an error", file: file, line: line)

      case .failure(let error):
        handler(error)
      }
    }
  }

  /// Registers a callback which fulfills an expectation when the future succeeds.
  ///
  /// - Parameter expectation: The expectation to fulfill.
  func assertSuccess(fulfill expectation: XCTestExpectation, file: StaticString = #file, line: UInt = #line) {
    self.whenSuccess { _ in
      expectation.fulfill()
    }
  }
}

extension EventLoopFuture {
  // TODO: Replace with `always` once https://github.com/apple/swift-nio/pull/981 is released.
  func peekError(callback: @escaping (Error) -> ()) -> EventLoopFuture<Value> {
    self.whenFailure(callback)
    return self
  }

  // TODO: Replace with `always` once https://github.com/apple/swift-nio/pull/981 is released.
  func peek(callback: @escaping (Value) -> ()) -> EventLoopFuture<Value> {
    self.whenSuccess(callback)
    return self
  }
}