Skip to content

api-evangelist/test-first

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Test First (test-first)

A software development approach where tests are written before the implementation code, ensuring code quality and driving design decisions through test requirements. Test-first development is the foundational principle behind test-driven development (TDD) and behavior-driven development (BDD), where the specification of expected behavior is captured in executable tests before any production code is written.

URL: Visit APIs.json URL

Run: Capabilities Using Naftiko

Tags:

  • Behavior-Driven Development, Best Practices, Methodology, Software Design, Software Development, Testing

Timestamps

  • Created: 2025
  • Modified: 2026-05-03

APIs

Cucumber API

REST API and tooling for Cucumber BDD framework supporting test-first development with Gherkin feature files, scenario definitions, and step implementations.

Human URL: https://cucumber.io

Tags:

  • Behavior-Driven Development, Gherkin, Test Automation, Testing

Properties

Pact Broker API

REST API for Pact Broker contract testing service, enabling consumer-driven contract testing where consumer tests define the API contract before providers implement it.

Human URL: https://docs.pact.io

Tags:

  • Consumer-Driven Contracts, Contract Testing, Microservices, Test-First

Properties

Stoplight API

API design-first platform enabling teams to write API specifications before implementation, supporting test-first development with mock servers, contract testing, and API style guides.

Human URL: https://stoplight.io

Tags:

  • API Design, Contract Testing, Mock Servers, Test-First

Properties

Microcks API

Open-source cloud-native tool for API mocking and contract testing, supporting test-first development by generating mocks from OpenAPI, Postman, and gRPC specifications.

Human URL: https://microcks.io

Tags:

  • API Mocking, Contract Testing, Open Source, Test-First

Properties

Dredd API

Command-line HTTP API testing framework that validates API implementations against API Blueprint or OpenAPI descriptions, enabling test-first API development.

Human URL: https://dredd.org

Tags:

  • API Testing, Contract Testing, OpenAPI, Test-First

Properties

Common Properties

Features

Name Description
Specification Before Implementation Write executable test specifications that define expected behavior before writing any production code.
API Contract Definition Define the API contract through tests before the implementation exists, ensuring design clarity.
Mock-First Development Use mock servers generated from specifications to enable parallel frontend and backend development.
Living Documentation Tests serve as up-to-date documentation of how the system is expected to behave.
Fail Fast Feedback Discover design issues early by specifying tests before implementation reveals constraints.
Consumer-Driven Contracts Let API consumers define their expectations as tests that the API provider must satisfy.

Use Cases

Name Description
API-First Design Write OpenAPI specifications and generate tests from them before building the implementation.
Consumer-Driven Contract Testing API consumers publish test expectations that API providers must verify in their CI pipelines.
Behavior-Driven Development Use Gherkin feature files to define expected system behavior before writing implementation.
Parallel Development Enable frontend and backend teams to develop in parallel using mock servers from specifications.
Specification Compliance Validate that API implementations comply with their published specifications using test-first assertions.

Integrations

Name Description
OpenAPI Generate test-first stubs and mocks directly from OpenAPI specifications.
Cucumber Use Gherkin scenarios as the test-first specification for behavior-driven development.
Pact Apply consumer-driven contract testing where consumer tests define provider expectations.
Prism Use Stoplight Prism to mock APIs from OpenAPI specs enabling test-first development.

Artifacts

Machine-readable API specifications organized by format.

JSON Schema

JSON Structure

JSON-LD

Examples

Vocabulary

  • Test First Vocabulary — Unified taxonomy mapping 3 resources, 9 actions, and 3 personas across test-first development domains.

Maintainers

FN: Kin Lane

Email: kin@apievangelist.com

About

A software development approach where tests are written before the implementation code, ensuring code quality and driving design decisions through test requirements.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors