Hummingbird

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/hummingbird-project/hummingbird/assets/9382567/48de534f-8301-44bd-b117-dfb614909efd"> <img src="https://github.com/hummingbird-project/hummingbird/assets/9382567/e371ead8-7ca1-43e3-8077-61d8b5eab879"> </picture> </p> <p align="center"> <a href="https://swift.org"> <img src="https://img.shields.io/badge/swift-5.10+-f05138.svg"/> </a> <a href="https://github.com/hummingbird-project/hummingbird/actions?query=workflow%3ACI"> <img src="https://github.com/hummingbird-project/hummingbird/actions/workflows/ci.yml/badge.svg?branch=main"/> </a> <a href="https://www.swift.org/sswg/incubation-process.html"> <img src="https://img.shields.io/badge/sswg-incubated-blue.svg"/> </a> <a href="https://discord.gg/4twfgYqdat"> <img src="https://img.shields.io/badge/chat-discord-7289da.svg?logo=discord&logoColor=white"/> </a> </p>

Lightweight, flexible, modern server framework written in Swift.

Hummingbird

Hummingbird is a lightweight, flexible modern web application framework that runs on top of a SwiftNIO based server implementation. It is designed to require the minimum number of dependencies.

It provides a router for directing different endpoints to their handlers, middleware for processing requests before they reach your handlers and processing the responses returned, custom encoding/decoding of requests/responses, TLS and HTTP2.

import Hummingbird

// create router and add a single GET /hello route
let router = Router()
router.get("hello") { request, _ -> String in
    return "Hello"
}
// create application using router
let app = Application(
    router: router,
    configuration: .init(address: .hostname("127.0.0.1", port: 8080))
)
// run hummingbird application
try await app.runService()

Extending Hummingbird

Hummingbird's core is designed to be minimal, with additional features provided through extensions. Here are some official extensions:

Built-in Extensions

• HummingbirdRouter: An alternative router using result builders
• HummingbirdTLS: TLS support
• HummingbirdHTTP2: HTTP2 upgrade support
• HummingbirdTesting: Helper functions for testing Hummingbird projects

Additional Extensions

The following extensions are available in separate repositories:

• HummingbirdAuth: Authentication framework
• HummingbirdFluent: Integration with Vapor's FluentKit ORM
• HummingbirdRedis: Redis support via RediStack
• HummingbirdWebSocket: WebSocket support
• HummingbirdLambda: Run Hummingbird on AWS Lambda
• Jobs: Job Queue Framework
• Mustache: Mustache templating engine

Documentation

You can find reference documentation and user guides for Hummingbird here. The hummingbird-examples repository has a number of examples of different uses of the library.

Installation

Add the following to your Package.swift file:

dependencies: [
    .package(url: "https://github.com/hummingbird-project/hummingbird.git", from: "2.0.0")
],
targets: [
  .executableTarget(
    name: "MyApp",
    dependencies: [
        .product(name: "Hummingbird", package: "hummingbird"),
    ]),
]

Or run the following commands on your package using SwiftPM, replacing MyApp with the name of your target:

swift package add-dependency https://github.com/hummingbird-project/hummingbird.git --from 2.0.0
swift package add-target-dependency Hummingbird MyApp --package hummingbird

Contributing

We welcome contributions to Hummingbird! Please read our contributing guidelines before submitting a pull request.

License

Hummingbird is released under the Apache 2.0 license.