{"categories":[{"label":"Application Frameworks","url":"https://skillfed.io/packages/category/software-development-libraries-application-frameworks/4"}],"enrichment":{"capability":"Extends apispec to generate OpenAPI 3.0+ documentation for Marshmallow OneOfSchema schemas, mapping polymorphic types to discriminator-based schema references.","skillfed_tags":["openapi-generation","schema-validation"],"use_cases":["Document REST APIs with polymorphic request or response bodies where the type is determined by a discriminator field.","Generate OpenAPI specs for services using Marshmallow OneOfSchema for type-safe serialization of union types.","Enable API client generators to produce correct deserialization code for discriminator-based polymorphic types.","Validate and document complex data models with multiple schema variants in a single endpoint.","Integrate Marshmallow schema definitions directly into OpenAPI documentation without manual discriminator mapping."],"what_it_does":"apispec-oneofschema is a plugin for apispec that bridges Marshmallow's OneOfSchema polymorphic type system with OpenAPI 3.0+ documentation. It automatically generates discriminator-based schema definitions in your OpenAPI spec, mapping polymorphic types to their corresponding schemas with proper references.\n\nWhen you register a OneOfSchema with apispec using this plugin, it produces OpenAPI components that include a discriminator object with a propertyName and a mapping of type values to schema references. This lets API consumers understand which schema variant applies based on a discriminator field in the JSON payload, and it enables code generation tools to handle polymorphic responses correctly.","worth_installing":"Yes, if you use Marshmallow OneOfSchema and need to generate OpenAPI 3.0+ documentation. The plugin fills a specific gap\u2014apispec does not natively handle OneOfSchema discriminators\u2014and has no known vulnerabilities. The aging maintenance status is a minor concern but not a blocker for a stable, focused tool. Install if this matches your stack; skip if you don't use OneOfSchema or target earlier OpenAPI versions."},"id":"apispec-oneofschema","links":{"html":"https://skillfed.io/packages/apispec-oneofschema","md":"https://skillfed.io/packages/apispec-oneofschema.md","pypi":"https://pypi.org/project/apispec-oneofschema/"},"maintenance":{"status":"aging"},"meta":{"latest_release":"2025-07-28","license_spdx":null,"license_treatment":"permissive","name":"apispec-oneofschema","python_support":"unspecified","summary":"Plugin for apispec providing support for Marshmallow-OneOfSchema schemas"},"popularity":{"monthly_downloads":237688,"position":8954,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"3.0.2"}