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.
- Add support for passing custom Jinja2 templates as an argument, by @sindrehan.
- Added support for using the current working directory (CWD) as an option when handling OpenAPI links, by @joewlambeth.
- Update objects to the OpenAPI Specification v3.1, by @tyzhnenko.
- Add docstrings to all
v3classes. - Upgrade the
v3.OpenAPIclass from OpenAPI version3.0.3to3.1.0.
- Fix bug in
MARKDOWNview forservers(displaying twice thedescriptioninstead ofdescriptionandurl). - Fix bug happening when a
path itemincludes properties that are not of kindoperation item(Neoteroi/mkdocs-plugins#5). - Add support for handling
parametersdefined onpath items(common parameters for all operation under a certain path). Refer to thePath Itemspecification. - Fix bug happening when a parameter has a non-str
nameproperty. - Add Python 3.13 to the build matrix.
- Add additionalProperties to Schema object, by @tyzhnenko.
- Upgrade package MarkupSafe to 3.0.1, by @stollero.
- Remove Python 3.8 from the build matrix (EOF at the end of 2024).
- Adds support for Python 3.12.
- Adds
MarkupSafeamong required dependencies (and not optional). - Adds support for latest function
model_dumpin Pydantic 2 (for examples defined using Pydantic models). - Upgrades development dependencies.
- Fix bug with missing items entry #36 by @mh7d and @mh-at-fujitsu
- 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
h2element - 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 haveautoescapeenabled withJinjacan do so setting an environment variable:SELECT_AUTOESCAPE=1. (bug report).
- Fixes #22
- Fixes #18
- Workflow maintenance
- Changes how
httpxversion is pinned (<1)
- Adds support for OpenAPI specification files split into multiple files Neoteroi/mkdocs-plugins#5
- Adds support for
externalDocsandtagsroot 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
componentsNeoteroi/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.typedfile - Add
Python 3.10to the GitHub Workflow
- Applies
isortand enforcesisortandblackchecks in CI pipeline - Adds support for examples defined using any class declaring a
dictcallable method, thus includingpydanticmodels - 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 forYAMLformat - Adds
partial-timeValueFormat fortime(see https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)
- Corrects a bug forcing
camelCaseon examples objects handled as dataclasses - Adds base64 ValueFormat to the v3 enum
- Adds a changelog
- Adds a code of conduct
- Updates
PyYAMLdependency to version5.4.1