Swiftpack.co -  hummingbird-project/hummingbird-core as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
HTTP server for Hummingbird the lightweight, flexible web application framework written in Swift
.package(url: "https://github.com/hummingbird-project/hummingbird-core.git", from: "0.11.0")


Swift NIO based HTTP server. The core HTTP server component for the Hummingbird web framework.


HummingbirdCore contains a Swift NIO based HTTP server. When starting the server you provide it with a struct that conforms to HBHTTPResponder to define how the server should respond to requests. For example the following is a responder that always returns a response containing the word "Hello" in the body.

struct HelloResponder: HBHTTPResponder {
    func respond(to request: HBHTTPRequest, context: ChannelHandlerContext, onComplete: @escaping (Result<HBHTTPResponse, Error>) -> Void) {
        let responseHead = HTTPResponseHead(version: .init(major: 1, minor: 1), status: .ok)
        let responseBody = context.channel.allocator.buffer(string: "Hello")
        let response = HBHTTPResponse(head: responseHead, body: .byteBuffer(responseBody))

The following will start up a server using the above HelloResponder.

let eventLoopGroup = MultiThreadedEventLoopGroup(numberOfThreads: System.coreCount)
let server = HBHTTPServer(
    group: eventLoopGroup, 
    configuration: .init(address: .hostname("", port: 8080))
try server.start(responder: HelloResponder()).wait()
// Wait until server closes which never happens as server channel is never closed
try server.wait()

Swift service lifecycle

If you are using HummingbirdCore outside of Hummingbird ideally you would use it along with the swift-server library swift-service-lifecycle. This gives you a framework for clean initialization and shutdown of your server. The following sets up a Lifecycle that initializes the HTTP server and stops it when the application shuts down.

import Lifecycle
import LifecycleNIOCompat

let lifecycle = ServiceLifecycle()
    label: "HTTP Server",
    start: .eventLoopFuture { self.server.start(responder: MyResponder()) },
    shutdown: .eventLoopFuture(self.server.stop)
lifecycle.start { error in
    if let error = error {
        print("ERROR: \(error)")

HummingbirdCore Extensions

The HummingbirdCore can be extended to support TLS and HTTP2 via the HummingbirdTLS and HummingbirdHTTP2 libraries. The following will add TLS support

import HummingbirdTLS
server.addTLS(tlsConfiguration: myTLSConfiguration)

and this will add an HTTP2 upgrade option

import HummingbirdHTTP2
server.addHTTP2Upgrade(tlsConfiguration: myTLSConfiguration)

As the HTTP2 upgrade requires a TLS connection this is added automatically when enabling HTTP2 upgrade. So don't call both function as this will setup two TLS handlers.


Reference documentation for both HummingbirdCore and Hummingbird can be found here


Stars: 14
Last commit: 3 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Release Notes

5 weeks ago
  • Add new protocol HBStreamerProtocol to allow for multiple types of buffer streaming.
  • Allow HBRequestBody.stream to create a HBStreamerProtocol from a ByteBuffer. Fixes issue when trying to stream small buffers that never create a Streamer type.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API