Zum Inhalt

Factsheet: Spectral

Gruppe: Testing

Zweck: Spectral ist ein flexibler Linter für JSON/YAML, spezialisiert auf OpenAPI

Spectral ermöglicht das Linting von API-Beschreibungen (OpenAPI v2/v3, AsyncAPI), um die Einhaltung von Best Practices und Design-Richtlinien sicherzustellen. Es ist hochgradig erweiterbar durch eigene Regelsätze.

Eigenschaft Wert
Latest 6.11.1
LTS N/A
Reifegrad Stabil
Technische Schulden Gering
Erwartetes Lebensende Kein EOL bekannt
Referenzhandbuch stoplight.io/open-source/spectral

Installation (Ubuntu 24.04)

npm install @stoplight/spectral-cli

Hello World

spectral lint openapi.yaml

Beispieldaten

Die folgenden Beispieldaten befinden sich im Ordner examples/:

  • api.yaml: Eine einfache, valide OpenAPI-Spezifikation.
  • api-v2.yaml: Eine OpenAPI 2.0 (Swagger) Spezifikation.
  • invalid.yaml: Eine OpenAPI-Spezifikation mit absichtlichen Design-Fehlern.
  • .spectral.yaml: Standard-Konfigurationsdatei für Spectral.
  • custom-ruleset.yaml: Ein Beispiel für benutzerdefinierte Regeln.
  • lint.sh: Shell-Skript zur Ausführung des Linting-Prozesses.

Validierung

OpenAPI-Schema linten:

npx spectral lint factsheets/testing/spectral/examples/api.yaml --ruleset factsheets/testing/spectral/examples/.spectral.yaml