javier
1382f33ae6
This PR contains the work done to: * Implemented a basic `Hummingbird` application in which to integrate the `HummingbirdDocC` library. * Added the *ArgumentParser* package dependency to the `Package.swift` file; * Added a new *sample* target to the `Package.swift` file; * Added library and documentation tasks to the `Makefile` file. Reviewed-on: #4 Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>
87 lines
2.2 KiB
Swift
87 lines
2.2 KiB
Swift
// ===----------------------------------------------------------------------===
|
|
//
|
|
// This source file is part of the Hummingbird DocC Middleware open source project
|
|
//
|
|
// Copyright (c) 2025 Röck+Cöde VoF. and the Hummingbird DocC Middleware project authors
|
|
// Licensed under the EUPL 1.2 or later.
|
|
//
|
|
// See LICENSE for license information
|
|
// See CONTRIBUTORS for the list of Hummingbird DocC Middleware project authors
|
|
//
|
|
// ===----------------------------------------------------------------------===
|
|
|
|
import class Hummingbird.Router
|
|
|
|
import protocol Hummingbird.ApplicationProtocol
|
|
|
|
import struct Hummingbird.Application
|
|
import struct Hummingbird.BasicRequestContext
|
|
import struct Hummingbird.BindAddress
|
|
import struct Hummingbird.LogRequestsMiddleware
|
|
import struct HummingbirdDocC.DocCConfiguration
|
|
import struct HummingbirdDocC.DocCMiddleware
|
|
import struct Logging.Logger
|
|
|
|
struct AppBuilder {
|
|
|
|
// MARK: Properties
|
|
|
|
/// A type that interacts with the logging system.
|
|
private let logger: Logger
|
|
|
|
// MARK: Initializers
|
|
|
|
/// Initializes this builder.
|
|
/// - Parameter logger: A type that interacts with the logging system.
|
|
init(logger: Logger) {
|
|
self.logger = logger
|
|
}
|
|
|
|
// MARK: Functions
|
|
|
|
func callAsFunction(
|
|
_ arguments: AppArguments
|
|
) -> some ApplicationProtocol {
|
|
return Application(
|
|
router: router(),
|
|
configuration: .init(
|
|
address: .hostname(
|
|
arguments.hostname,
|
|
port: arguments.port
|
|
)
|
|
),
|
|
logger: logger
|
|
)
|
|
}
|
|
|
|
}
|
|
|
|
// MARK: - Helpers
|
|
|
|
private extension AppBuilder {
|
|
|
|
// MARK: Type aliases
|
|
|
|
typealias AppRequestContext = BasicRequestContext
|
|
|
|
// MARK: Functions
|
|
|
|
func router() -> Router<AppRequestContext> {
|
|
let router = Router()
|
|
|
|
router.addMiddleware {
|
|
LogRequestsMiddleware(logger.logLevel)
|
|
DocCMiddleware (
|
|
configuration: DocCConfiguration(
|
|
uriRoot: "/archives",
|
|
folderRoot: "Samples/HummingbirdDocC/Archives"
|
|
),
|
|
logger: logger
|
|
)
|
|
}
|
|
|
|
return router
|
|
}
|
|
|
|
}
|