This release is a pre-release and may not be stable for production use.
Jentic API Tools - Pipelines
High-level workflows that orchestrate analyze, score, repair, and storage operations for OpenAPI specifications.
Key Features
The pipelines package provides three main workflow functions: import_openapi runs the full import pipeline (fetch, parse, validate, convert, bundle, repair, score, store), score_openapi runs a lighter scoring pipeline (fetch, parse, bundle, validate, score), and improve_openapi orchestrates the apply-overlays-and/or-replace-spec, score, and lay-out-per-run-snapshot flow used behind /public-apis/improve and the jentic-apitools improve CLI command. The first two accept an OASJsonRequest with processing configuration and an optional progress callback for real-time updates. By default, import_openapi rejects specs with invalid server URLs and invalid security definitions; these are controlled by reject_invalid_server_urls and reject_invalid_security in OASProcessConfiguration. The improve orchestrator depends on the repair.overlay backend to apply overlays and to verify the cumulative-overlays invariant, raising CumulativeInvariantError (with a structured diff) when applying cumulative + per_run overlays to the immutable bundled input does not reproduce the produced spec. The package handles format conversion from Swagger 2.0 and Google Discovery to OpenAPI 3.x, reference bundling via Redocly, and artifact management through configurable storage contexts. The repo_tools module provides rebuild_scores_json and rebuild_apis_json for rebuilding the root scores.json and apis.json catalog files from all API specs in a local repository clone.
Dependencies
Internal: common, llm, analyze, score, repair, storage. External: jentic-openapi-transformer (with redocly), datadog. Note: repair is a hard dependency (used by both the import flow and the new improve orchestrator).
Installation
pip install jentic-apitools-pipelines
Quick Start
from jentic.apitools.common.models import OASJsonRequest, OASRequestMeta, OASProcessConfiguration
from jentic.apitools.pipelines import score_openapi
request = OASJsonRequest(meta=OASRequestMeta(oas_process_configuration=OASProcessConfiguration()))
result = score_openapi(request, spec_url="https://petstore3.swagger.io/api/v3/openapi.json")
print(f"Success: {result.success}")
Testing
pytest tests -v
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file jentic_apitools_pipelines-1.0.0a24.tar.gz.
File metadata
- Download URL: jentic_apitools_pipelines-1.0.0a24.tar.gz
- Upload date:
- Size: 45.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
88a31d296b708dd36f9564a44c3f2e02a85410e21df5fcf32a461881ce453eed
|
|
| MD5 |
b777237c191579ad4c59882c6c6559c9
|
|
| BLAKE2b-256 |
a2618fbbc89b12f0f5edf1693467cbbd03231a23f1e75c325f5444a9ec3209e1
|
File details
Details for the file jentic_apitools_pipelines-1.0.0a24-py3-none-any.whl.
File metadata
- Download URL: jentic_apitools_pipelines-1.0.0a24-py3-none-any.whl
- Upload date:
- Size: 55.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
504b175f6128e92324e8d31ef8e08511c0f2b68322ea8e8876ef0361e00246ee
|
|
| MD5 |
d1b5a320b1e903b908d8d17dff771177
|
|
| BLAKE2b-256 |
340b42c0d89cc3b1dd5fc60447ced91fc9933d0748f80754ea5eedd324f08575
|
