Added (first version of) sample Hummingbird app. (#4)
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>
This commit was merged in pull request #4.
This commit is contained in:
@@ -0,0 +1,86 @@
|
||||
// ===----------------------------------------------------------------------===
|
||||
//
|
||||
// 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
|
||||
}
|
||||
|
||||
}
|
||||
Reference in New Issue
Block a user