voluptuous-openapi
Convert voluptuous schemas to OpenAPI Schema object
Decision gist · record as of 2026-08-14
Yes, if you use Voluptuous for validation and need OpenAPI documentation. The package is actively maintained, has no security issues, and low install friction. It solves a real problem—keeping validation and documentation in sync—with a clean, extensible design. Skip it if you don't use Voluptuous or don't need OpenAPI output.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Low friction: pure Python wheel with a single runtime dependency (voluptuous).
- Last release 49 days ago with active maintenance status and no known vulnerabilities.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions.
last release 2026-06-26 (49 days) · last repo commit 2026-07-29 · 1 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 631,329 downloads/mo, #5,659 on PyPI
Alternatives
Verify before relying
pip install voluptuous-openapi
from voluptuous_openapi import convert
import voluptuous as vol
schema = vol.Schema({vol.Required('name'): str})
openapi_schema = convert(schema)- Whether custom serializers handle all common Voluptuous validators or only a subset.
- Performance characteristics when converting large or deeply nested schemas.
- Compatibility with specific Voluptuous versions beyond the runtime dependency declaration.
What it is and what it does
Voluptuous OpenAPI bridges validation and API documentation by translating Voluptuous schemas—which define input validation rules—into OpenAPI 3.0 Schema objects. This eliminates the need to maintain separate schema definitions for validation and documentation; a single Voluptuous schema can drive both runtime validation and OpenAPI spec generation. The package maps Voluptuous validators (like Length, Range, Coerce) to their OpenAPI equivalents (minLength, minimum, type), preserving field descriptions and required/optional status.
The conversion is straightforward for standard validators but extensible: you can provide a custom serializer function to handle domain-specific validators that the package doesn't recognize natively. The library is lightweight, depending only on Voluptuous itself, and is actively maintained with no known security issues.
Use it for
- Generate OpenAPI documentation automatically from Voluptuous validation schemas in FastAPI or Flask applications.
- Maintain a single source of truth for input validation and API contract documentation.
- Extend API documentation tooling to projects already using Voluptuous for request/response validation.
- Convert custom Voluptuous validators to OpenAPI constraints using a custom serializer function.
- Reduce manual schema duplication when building REST APIs with strict validation requirements.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use Voluptuous for validation and need OpenAPI documentation.
The package is actively maintained, has no security issues, and low install friction. It solves a real problem—keeping validation and documentation in sync—with a clean, extensible design. Skip it if you don't use Voluptuous or don't need OpenAPI output.
Install
voluptuous-openapi on PyPI
Before you install
Low friction: pure Python wheel with a single runtime dependency (voluptuous). Last release 49 days ago with active maintenance status and no known vulnerabilities.
Requires Python 3.9 or later.
License in practice
Apache-2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions.
Quickstart
pip install voluptuous-openapi
from voluptuous_openapi import convert
import voluptuous as vol
schema = vol.Schema({vol.Required('name'): str})
openapi_schema = convert(schema)
Verify before relying
- Whether custom serializers handle all common Voluptuous validators or only a subset.
- Performance characteristics when converting large or deeply nested schemas.
- Compatibility with specific Voluptuous versions beyond the runtime dependency declaration.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagevoluptuous |
| Maintenance | Actively maintained 49 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 631,329 / month, #5,659 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: voluptuous_openapi-0.4.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “voluptuous to openapi conversion”
- voluptuous-openapiConverts Voluptuous validation schemas into OpenAPI 3.0 Schema…
- voluptuous-serializeConverts Voluptuous schema objects into JSON-serializable…
- openapi-codecConverts between OpenAPI/Swagger schemas and Core API's internal…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also voluptuous-serialize · voluptuous · openapi-schema-validator · apispec-oneofschema · drf-spectacular · jsonschema-pydantic · jsonschema-pydantic-converter · apispec · openapi-schema-pydantic