Feather Spec

Declarative HTTP specification testing for Swift, providing a shared API surface for runners and executors.

Features

• Declarative, fluent spec builder API
• Designed for modern Swift concurrency
• Extensible runner and executor protocols
• Unit tests and code coverage

Requirements

• Swift 6.1+
• Platforms:
  • Linux
  • macOS 15+
  • iOS 18+
  • tvOS 18+
  • watchOS 11+
  • visionOS 2+

Installation

Use Swift Package Manager; add the dependency to your Package.swift file:

.package(url: "https://github.com/feather-framework/feather-spec", exact: "1.0.0-beta.2"),

Then add FeatherSpec to your target dependencies:

.product(name: "FeatherSpec", package: "feather-spec"),

Usage

API documentation is available at the following link. Refer to the mock objects in the Tests directory if you want to build a custom runner or executor implementation.

Warning

This repository is a work in progress, things can break until it reaches v1.0.0.

Server-side runtimes

The following Swift server-side runtime integrations are available:

• Feather Vapor Spec
• Feather Hummingbird Spec

Development

• Build: swift build
• Test:
  • local: make test
  • using Docker: make docker-test
• Format: make format
• Check: make check

Contributing

Pull requests are welcome. Please keep changes focused and include tests for new logic.