Skip to content

Document multipart form data and image request bodies - #1087

Open
hugosmoreira wants to merge 1 commit into
marshmallow-code:devfrom
hugosmoreira:docs/multipart-form-data-874
Open

hugosmoreira wants to merge 1 commit into
marshmallow-code:devfrom
hugosmoreira:docs/multipart-form-data-874

Conversation

@hugosmoreira

Copy link
Copy Markdown

Closes #874.

Add a complete OpenAPI 3.1 multipart request-body example using the existing dictionary API, including the issue's five properties and a registered Address component. Show how to describe raw PNG bytes separately from a base64-encoded image string. The change is limited to the special-topics documentation and contributor credit.

Validation on Windows: both examples extracted from the documentation passed on Python 3.10, 3.12 and 3.14, including property/reference assertions, specification validation and JSON/YAML round trips. Negative controls detected missing image encoding, a missing Address component and an omitted second spec.path registration. The full suite passed with 636 tests and 6 Marshmallow-version skips on each of those Python versions. All eight pre-commit hooks, a clean Sphinx build with warnings treated as errors, and package build/metadata checks passed.

Linux/macOS, Python 3.11/3.13, alternate Marshmallow configurations and actual HTTP uploads were not tested for this revision.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document form data and images

2 participants