Skip to main content

Standard Plugins

Project Drift comes bundled with several core plugins that provide essential testing, validation, and reporting capabilities out-of-the-box.

🔌 Available Plugins​

OpenAPI (oas)​

The foundational plugin for spec-first testing. It parses OpenAPI 3.0 and 3.1 documents to resolve endpoints, schemas, and examples.

  • Key Feature: Automatic validation of response bodies against JSON schemas.
  • Key Feature: Support for source:method:path targeting when operationId is missing.

JSON (json)​

Provides specialized validation for JSON payloads.

  • Automatic Parsing: Recognizes application/json content types and parses them into traversable Lua tables.
  • Schema Support: Powers deep property and type checking for API responses.

Data (data)​

Manages the loading and injection of external datasets into your test cases.

  • Dataset Management: Resolves references like ${product:products.product10.id} from drift-dataset-file sources.
  • Dynamic Generation: Supports advanced expressions like notIn() to create unique test data on the fly.

JUnit Reporter (junit-output)​

Generates standardized XML reports for integration with CI/CD tools like GitHub Actions, Jenkins, or GitLab.

  • Format: Produces testsuite and testcase elements compatible with universal JUnit XML schemas.
  • CI Integration: Allows build systems to visualize pass/fail counts and execution times natively.

HTTP Dump (http-dump)​

A debugging utility that logs raw HTTP traffic.

  • Use Case: Enable this plugin to inspect the exact headers and bodies being sent and received during a test run.
  • Configuration: Can be configured via config.toml to adjust log verbosity.