Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Jentic API Tools - Analyze

Multi-backend OpenAPI validation using Redocly, Spectral, Speclynx, and optional LLM-powered semantic analysis. Produces unified diagnostics with severity, source, and structured metadata.

Key Features

The OpenAPIAnalyzer class validates specs against multiple backends in parallel. Redocly checks standards compliance, Spectral applies linting rules, the Speclynx backend uses the ApiDOM engine with custom JavaScript plugins for reference resolution analysis, and the optional semantic backend uses LLMs to evaluate description clarity. Each backend produces JenticDiagnostic objects with consistent severity levels. Error handling wraps each backend so failures don't block others.

Dependencies

Internal: jentic.apitools.common, jentic.apitools.llm. External: jentic-openapi-validator (with redocly, spectral, and speclynx backends), DeepDiff.

Installation

pip install jentic-apitools-analyze

Quick Start

from jentic.apitools.analyze.openapi_analyzer import OpenAPIAnalyzer
from jentic.apitools.common.models import DiagnosticTarget

analyzer = OpenAPIAnalyzer()
diagnostics = analyzer.analyze(
    "file:///path/to/spec.json",
    base_url="https://api.example.com",
    target=DiagnosticTarget.BUNDLED_SPEC,
)
print(f"Found {len(diagnostics)} issues")

Testing

pytest tests -v

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jentic_apitools_analyze-1.0.0a24.tar.gz (31.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jentic_apitools_analyze-1.0.0a24-py3-none-any.whl (51.4 kB view details)

Uploaded Python 3

File details

Details for the file jentic_apitools_analyze-1.0.0a24.tar.gz.

File metadata

File hashes

Hashes for jentic_apitools_analyze-1.0.0a24.tar.gz
Algorithm Hash digest
SHA256 398e6b577776826a912a1de4b81677bbe03397734afca17c98cce1e6f2902e76
MD5 328a9a21a9134220ec54b98b321d0a1d
BLAKE2b-256 e6b0452b2896a84e4977fb797bb2aecd4b8bf83cfa95562c16d3bc5147927fe2

See more details on using hashes here.

File details

Details for the file jentic_apitools_analyze-1.0.0a24-py3-none-any.whl.

File metadata

File hashes

Hashes for jentic_apitools_analyze-1.0.0a24-py3-none-any.whl
Algorithm Hash digest
SHA256 f8dc7f00f18a1457ec858fac3dab82f94a57df33cb70b7cdecee906742764503
MD5 eec9177ea0cb41878836e842641c43b3
BLAKE2b-256 637f5cc554b3563a74401835bf4bd6a1f2c71cdae0122a2c39a32e5328c9ffb8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page