Schema-First
Validate and convert OpenAPI specification via Marshmallow schemas to Marshmallow schemas.
Features
- OpenAPI specification validate.
- Convert OpenAPI schemas to Marshmallow schemas.
Installation
Recommended using the latest version of Python. Schema-First supports Python 3.12 and newer.
Install and update using pip:
$ pip install -U schema_first
Example
Create specification - openapi.yaml:
openapi: 3.2.0
info:
title: Example API for testing Schema-First
version: 1.0.1
paths:
/endpoint:
get:
operationId: endpoint
responses:
'200':
content:
application/json:
schema:
properties:
message:
type: string
type: object
description: OK
Create script - main.py:
from pathlib import Path
from pprint import pprint
from schema_first.specification import Specification
spec_file = Path('openapi.yaml')
spec = Specification(spec_file)
spec.load()
pprint(spec.reassembly_spec)
print(
'Marshmallow schema generated from OpenAPI schema',
spec.reassembly_spec['paths']['/endpoint']['get']['responses']['200']['content'][
'application/json'
]['schema'],
)
More example see to ./example folder.
Additional documentation
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
schema_first-0.15.1.tar.gz
(16.6 kB
view details)
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 schema_first-0.15.1.tar.gz.
File metadata
- Download URL: schema_first-0.15.1.tar.gz
- Upload date:
- Size: 16.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e8362690c6cb1e4c71b4587e3b01c59221431f116ea055c6bc29fe146fe9be06
|
|
| MD5 |
c8acd47fd1c9be810056dbd4a1e01b05
|
|
| BLAKE2b-256 |
280ec5c5fbb52bfc3f8db0f877cc2829eb20cf52f475dcffe7bc7d2fcb1ee3a6
|
File details
Details for the file schema_first-0.15.1-py3-none-any.whl.
File metadata
- Download URL: schema_first-0.15.1-py3-none-any.whl
- Upload date:
- Size: 25.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4049af994a5d74f33a660aa17ec4908e6e7f1117487617c1c675e6b795c4be22
|
|
| MD5 |
2516fd4de7602902e45f9e98f7ba1e8b
|
|
| BLAKE2b-256 |
0290a3edc25c7e4d8ada3bc39fdfee75f0ff3c27488aed5e34d207308e44ab2b
|
