vapor · 0xTim · Feb 19, 2023 · Feb 19, 2023 · Feb 19, 2023 · Feb 19, 2023
@@ -6,8 +6,9 @@ on:
 
 jobs:
   build-and-deploy:
-     uses: vapor/api-docs/.github/workflows/build-and-deploy-docs-workflow.yml@fc8584486d15d22fbb3dabc28b27f518eb77a84c
+     uses: vapor/api-docs/.github/workflows/build-and-deploy-docs-workflow.yml@main
      secrets: inherit
      with:
        package_name: vapor
        modules: Vapor,XCTVapor
+       pathsToInvalidate: /vapor /xctvapor
@@ -37,3 +37,13 @@ jobs:
        with_coverage: false
        with_tsan: false
        with_public_api_check: true
+  test-exports:
+    name: Test exports
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out Vapor
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Build
+        run: swift build -Xswiftc -DBUILDING_DOCC
@@ -1,3 +1,5 @@
 version: 1
 metadata:
   authors: "Maintained by the Vapor Core Team with hundreds of contributions from the Vapor Community."
+external_links:
+  documentation: "https://docs.vapor.codes"
@@ -1,4 +1,5 @@
 import Vapor
+import Logging
 
 var env = try Environment.detect()
 try LoggingSystem.bootstrap(from: &env)

@@ -1,4 +1,6 @@
 import Vapor
+import NIOCore
+import NIOHTTP1
 
 struct Creds: Content {
     var email: String

@@ -1,5 +1,9 @@
 import Backtrace
 import NIOConcurrencyHelpers
+import NIOCore
+import Logging
+import ConsoleKit
+import NIOPosix
 
 /// Core type representing a Vapor application.
 public final class Application {

@@ -1,3 +1,5 @@
+import NIOCore
+
 /// Capable of being authenticated.
 public protocol Authenticatable { }
 

@@ -1,3 +1,6 @@
+import Foundation
+import NIOHTTP1
+
 /// A basic username and password.
 public struct BasicAuthorization {
     /// The username, sometimes an email address

@@ -1,3 +1,5 @@
+import NIOHTTP1
+
 /// A bearer token.
 public struct BearerAuthorization {
     /// The plaintext token

@@ -1,3 +1,5 @@
+import NIOCore
+
 extension Authenticatable {
     /// This middleware ensures that an `Authenticatable` type `A` has been authenticated
     /// by a previous `Middleware` or throws an `Error`. The middlewares that actually perform

@@ -1,3 +1,5 @@
+import NIOCore
+
 extension Authenticatable {
     /// Basic middleware to redirect unauthenticated requests to the supplied path
     ///

@@ -1,3 +1,5 @@
+import NIOCore
+
 /// Helper for creating authentication middleware in conjunction with `SessionsMiddleware`.
 public protocol SessionAuthenticator: Authenticator {
     associatedtype User: SessionAuthenticatable

@@ -1,3 +1,4 @@
+import Foundation
 import CVaporBcrypt
 
 // MARK: BCrypt

@@ -1,3 +1,4 @@
+import Foundation
 import NIOCore
 import NIOConcurrencyHelpers
 

@@ -1,3 +1,7 @@
+import NIOCore
+import Logging
+import NIOHTTP1
+
 public protocol Client {
     var eventLoop: EventLoop { get }
     var byteBufferAllocator: ByteBufferAllocator { get }

@@ -1,3 +1,7 @@
+import NIOCore
+import NIOHTTP1
+import Foundation
+
 public struct ClientRequest {
     public var method: HTTPMethod
     public var url: URI

@@ -1,4 +1,6 @@
-import NIO
+import NIOCore
+import NIOHTTP1
+import Foundation
 
 public struct ClientResponse {
     public var status: HTTPStatus

@@ -1,3 +1,5 @@
+import ConsoleKit
+
 /// Boots the `Application` then exits successfully.
 ///
 ///     $ swift run Run boot

@@ -1,3 +1,5 @@
+import ConsoleKit
+
 extension CommandContext {
     public var application: Application {
         get {

@@ -1,3 +1,6 @@
+import ConsoleKit
+import RoutingKit
+
 /// Displays all routes registered to the `Application`'s `Router` in an ASCII-formatted table.
 ///
 ///     $ swift run Run routes

@@ -1,3 +1,6 @@
+import Foundation
+import ConsoleKit
+
 /// Boots the application's server. Listens for `SIGINT` and `SIGTERM` for graceful shutdown.
 ///
 ///     $ swift run Run serve

@@ -1,5 +1,6 @@
 #if compiler(>=5.5) && canImport(_Concurrency)
 import NIOCore
+import Foundation
 
 @available(macOS 10.15, iOS 13, tvOS 13, watchOS 6, *)
 extension AsyncPasswordHasher {

@@ -1,5 +1,6 @@
 #if compiler(>=5.5) && canImport(_Concurrency)
 import NIOCore
+import NIOHTTP1
 
 @available(macOS 10.15, iOS 13, tvOS 13, watchOS 6, *)
 extension Client {

@@ -1,4 +1,5 @@
 import NIOCore
+import NIOHTTP1
 
 /// Can convert `self` to a `Response`.
 ///

@@ -1,5 +1,7 @@
 #if compiler(>=5.5) && canImport(_Concurrency)
 import NIOCore
+import NIOHTTP1
+import RoutingKit
 
 @available(macOS 10.15, iOS 13, tvOS 13, watchOS 6, *)
 extension RoutesBuilder {

@@ -1,5 +1,8 @@
 #if compiler(>=5.5) && canImport(_Concurrency)
 import NIOCore
+import NIOHTTP1
+import WebSocketKit
+import RoutingKit
 
 @available(macOS 10.15, iOS 13, tvOS 13, watchOS 6, *)
 extension Request {

@@ -1,3 +1,5 @@
+import NIOCore
+
 /// Convertible to / from content in an HTTP message.
 ///
 /// Conformance to this protocol consists of:

@@ -1,3 +1,7 @@
+import Foundation
+import NIOCore
+import NIOHTTP1
+
 public protocol ContentEncoder {
     func encode<E>(_ encodable: E, to body: inout ByteBuffer, headers: inout HTTPHeaders) throws
         where E: Encodable

@@ -1,3 +1,6 @@
+import Foundation
+import MultipartKit
+
 /// Configures which `Encoder`s and `Decoder`s to use when interacting with data in HTTP messages.
 ///
 ///     ContentConfiguration.global.use(encoder: JSONEncoder(), for: .json)

@@ -1,3 +1,7 @@
+import Foundation
+import NIOCore
+import NIOHTTP1
+
 extension JSONEncoder: ContentEncoder {
     public func encode<E>(_ encodable: E, to body: inout ByteBuffer, headers: inout HTTPHeaders) throws
         where E: Encodable

@@ -1,3 +1,6 @@
+import NIOCore
+import NIOHTTP1
+
 /// Decodes data as plaintext, utf8.
 public struct PlaintextDecoder: ContentDecoder {
 

@@ -1,3 +1,7 @@
+import Foundation
+import NIOCore
+import NIOHTTP1
+
 /// Encodes data as plaintext, utf8.
 public struct PlaintextEncoder: ContentEncoder {
     /// Private encoder.

@@ -1,3 +1,7 @@
+import ConsoleKit
+import NIOCore
+import NIOPosix
+
 extension Application {
     public var console: Console {
         get { self.core.storage.console }

@@ -1,3 +1,5 @@
+import NIOCore
+
 extension Application {
     public struct Running {
         final class Storage {

@@ -1,3 +1,5 @@
+import NIOHTTP1
+
 extension CORSMiddleware.Configuration {
     /// Instantiate a CORSConfiguration struct that can be used to create a `CORSConfiguration`
     /// middleware for adding support for CORS in your responses.

@@ -1,3 +1,7 @@
+import Logging
+import NIOCore
+import NIOPosix
+
 extension DotEnvFile {
     /// Reads the dotenv files relevant to the environment and loads them into the process.
     ///

@@ -1,3 +1,5 @@
+import Foundation
+
 extension Environment {    
     /// The process information of an environment. Wraps `ProcessInto.processInfo`.
     @dynamicMemberLookup public struct Process {

@@ -1,3 +1,7 @@
+import NIOCore
+import NIOPosix
+import AsyncKit
+
 extension Environment {
     /// Reads a file's content for a secret. The secret key is the name of the environment variable that is expected to
     /// specify the path of the file containing the secret.

@@ -1,3 +1,4 @@
+import Foundation
 import ConsoleKit
 
 /// The environment the application is running in, i.e., production, dev, etc. All `Container`s will have

@@ -1,3 +1,5 @@
+import NIOHTTP1
+
 /// Default implementation of `AbortError`. You can use this as a convenient method for throwing
 /// `AbortError`s without having to conform your own error-type to `AbortError`.
 ///

@@ -1,3 +1,5 @@
+import NIOHTTP1
+
 /// Errors conforming to this protocol will always be displayed by
 /// Vapor to the end-user (even in production mode where most errors are silenced).
 ///

@@ -1,4 +1,5 @@
 import Foundation
+import Logging
 
 /// `Debuggable` provides an interface that allows a type
 /// to be more easily debugged in the case of an error.

@@ -1,3 +1,4 @@
+import Foundation
 #if os(Linux)
 import Backtrace
 import CBacktrace

@@ -1,3 +1,5 @@
+#if !BUILDING_DOCC
+
 @_exported import AsyncKit
 
 @_exported import class AsyncHTTPClient.HTTPClient
@@ -37,3 +39,4 @@
 
 @_exported import WebSocketKit
 @_exported import MultipartKit
+#endif
@@ -1,3 +1,5 @@
+import NIOCore
+
 /// A basic, closure-based `Responder`.
 public struct BasicResponder: Responder {
     /// The stored responder closure.

@@ -1,3 +1,5 @@
+import NIOCore
+
 public enum BodyStreamResult {
     /// A normal data chunk.
     /// There will be 0 or more of these.

@@ -1,3 +1,5 @@
+import AsyncHTTPClient
+
 extension Application.Clients.Provider {
     public static var http: Self {
         .init {

@@ -1,4 +1,7 @@
-import NIO
+import NIOCore
+import AsyncHTTPClient
+import Logging
+import Foundation
 
 extension HTTPClient {
     func delegating(to eventLoop: EventLoop, logger: Logger, byteBufferAllocator: ByteBufferAllocator) -> Client {

@@ -1,4 +1,8 @@
+import Foundation
 import NIOConcurrencyHelpers
+import NIOCore
+import Logging
+import NIOHTTP1
 
 public enum EndpointCacheError: Swift.Error {
     case unexpctedResponseStatus(HTTPStatus, uri: URI)

@@ -1,3 +1,6 @@
+import NIOHTTP1
+import NIOCore
+
 /// Less verbose typealias for `HTTPResponseStatus`.
 public typealias HTTPStatus = HTTPResponseStatus
 

@@ -1,3 +1,6 @@
+import Foundation
+import NIOHTTP1
+
 extension HTTPHeaders {
     /// Get and set `HTTPCookies` for an HTTP request
     /// This accesses the `"Cookie"` header.

@@ -1,4 +1,5 @@
-import NIO
+import Foundation
+import NIOHTTP1
 
 // Comments on these properties are copied from the mozilla doc URL shown below.
 extension HTTPHeaders {

@@ -1,4 +1,5 @@
-import NIO
+import Foundation
+import NIOHTTP1
 
 extension HTTPHeaders {
     public struct Expires {

@@ -1,3 +1,6 @@
+import Foundation
+import NIOHTTP1
+
 extension HTTPHeaders {
     /// Represents the HTTP `Last-Modified` header.
     /// - See Also:

@@ -1,3 +1,6 @@
+import Foundation
+import NIOHTTP1
+
 extension HTTPHeaders {
     /// Determines when the cached data should be expired.
     ///

@@ -1,3 +1,5 @@
+import NIOHTTP1
+
 extension HTTPHeaders {
     public struct Connection: ExpressibleByStringLiteral, Equatable {
         public static let close: Self = "close"