javier
a045a23519
This PR contains the work done to introduce a new Web Swift package that provides a reusable, declarative way to register route controllers on a Hummingbird router, then adopt it in the Website service.
To provide further details about the work:
* Web package
* The `RouterController` protocol — a Sendable protocol to group controllers behind one `routes` property.
* The `RouteCollectionBuilder` — a result builder that collects controllers' route collections into a stack, with full support for optionals, conditionals, and arrays.
* The `addController(_:)` method — a `RouterMethods` extension letting controllers be listed declaratively and adding each one's routes at the router root.
* Website service
* Added Web as a dependency of the _WebsiteLibrary_ target.
* Conformed the `RootController` and `HealthController`controllers to the `RouterController` protocol.
* Updated the `App+Build` extension to to use the cleaner `router.addController { … }` instead.
Reviewed-on: rock-n-code/loud-amsterdam#17
Co-authored-by: Javier Cicchelli <javier@rock-n-code.com>
Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>
35 lines
992 B
Swift
35 lines
992 B
Swift
import Hummingbird
|
|
|
|
public extension RouterMethods {
|
|
|
|
// MARK: Methods
|
|
|
|
/// Adds the routes of ``RouterController`` values to the router using the
|
|
/// ``RouteCollectionBuilder`` result builder.
|
|
///
|
|
/// Mirrors `addMiddleware`, letting controllers be listed declaratively:
|
|
///
|
|
/// ```swift
|
|
/// router.addController {
|
|
/// RootController<AppRequestContext>()
|
|
/// HealthController<AppRequestContext>()
|
|
/// }
|
|
/// ```
|
|
///
|
|
/// Each controller's route collection is added at the router's root, exactly as a
|
|
/// sequence of `addRoutes(_:)` calls would.
|
|
/// - Parameter build: the controller stack result builder.
|
|
/// - Returns: the router, so calls can be chained.
|
|
@discardableResult
|
|
func addController(
|
|
@RouteCollectionBuilder<Context> _ build: () -> [RouteCollection<Context>]
|
|
) -> Self {
|
|
for collection in build() {
|
|
addRoutes(collection)
|
|
}
|
|
|
|
return self
|
|
}
|
|
|
|
}
|