All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Adds support for Python 3.12.
- Adds
MarkupSafe
among required dependencies (and not optional). - Adds support for latest function
model_dump
in Pydantic 2 (for examples defined using Pydantic models). - Upgrades development dependencies.
- Fixes example generation breaks on explicitly enumerated array elements #31, by @jjedele.
- Fixes Markdown missing a newline after simple response types.
- Fixes Empty header when operations don't have any tag..
- When operations don't have any tag, the
h2
element - Improves tests.
- Adopts
pyproject.toml
. - Workflow maintenance.
- Fixes a bug happening when trying to serialize examples in JSON, when they contain datetimes and are provided in YAML; (bug report).
- Fixes a bug related to missing resolution of references for
requestBody
; (bug report). - Fixes support for code fences (disables by default
autoescape
, since the source of OpenAPI Specification files is supposed to be trusted anyway. Those who still wants to haveautoescape
enabled withJinja
can do so setting an environment variable:SELECT_AUTOESCAPE=1
. (bug report).
- Fixes #22
- Fixes #18
- Workflow maintenance
- Changes how
httpx
version is pinned (<1
)
- Adds support for OpenAPI specification files split into multiple files Neoteroi/mkdocs-plugins#5
- Adds support for
externalDocs
andtags
root properties
- Adds a new output style, to provide an overview of the API endpoints with PlantUML
- Fixes two bugs caused by improper handling of OpenAPI Documentation without
components
Neoteroi/mkdocs-plugins#9
- Adds features and a CLI to generate artifacts from OpenAPI Documentation files (markdown for MkDocs and PyMdown extensions, PlantUML class diagrams from components schemas)
- Drops support for Python 3.6
- Adds
py.typed
file - Add
Python 3.10
to the GitHub Workflow
- Applies
isort
and enforcesisort
andblack
checks in CI pipeline - Adds support for examples defined using any class declaring a
dict
callable method, thus includingpydantic
models - Marks the package as
Production/Stable
- Restores support for enums on examples
@dataclasses
, after the fix implemented in0.1.3
- Adds support for built-in
UUID
,time
,date
,datetime
,bytes
, handling in examples forYAML
format - Adds
partial-time
ValueFormat fortime
(see https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)
- Corrects a bug forcing
camelCase
on examples objects handled as dataclasses - Adds base64 ValueFormat to the v3 enum
- Adds a changelog
- Adds a code of conduct
- Updates
PyYAML
dependency to version5.4.1