drf-spectacular


Namedrf-spectacular JSON
Version 0.27.0 PyPI version JSON
download
home_pagehttps://github.com/tfranzel/drf-spectacular
SummarySane and flexible OpenAPI 3 schema generation for Django REST framework
upload_time2023-12-12 00:06:27
maintainer
docs_urlNone
authorT. Franzel
requires_python>=3.6
licenseBSD
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ===============
drf-spectacular
===============

|build-status| |codecov| |docs| |pypi-version| |pypi-dl|

Sane and flexible `OpenAPI`_ (`3.0.3`_ & `3.1`_) schema generation for `Django REST framework`_.

This project has 3 goals:
    1. Extract as much schema information from DRF as possible.
    2. Provide flexibility to make the schema usable in the real world (not only toy examples).
    3. Generate a schema that works well with the most popular client generators.

The code is a heavily modified fork of the
`DRF OpenAPI generator <https://github.com/encode/django-rest-framework/blob/master/rest_framework/schemas/openapi.py/>`_,
which is/was lacking all of the below listed features.

Features
    - Serializers modelled as components. (arbitrary nesting and recursion supported)
    - `@extend_schema <https://drf-spectacular.readthedocs.io/en/latest/drf_spectacular.html#drf_spectacular.utils.extend_schema>`_ decorator for customization of APIView, Viewsets, function-based views, and ``@action``
        - additional parameters
        - request/response serializer override (with status codes)
        - polymorphic responses either manually with ``PolymorphicProxySerializer`` helper or via ``rest_polymorphic``'s PolymorphicSerializer)
        - ... and more customization options
    - Authentication support (DRF natives included, easily extendable)
    - Custom serializer class support (easily extendable)
    - ``SerializerMethodField()`` type via type hinting or ``@extend_schema_field``
    - i18n support
    - Tags extraction
    - Request/response/parameter examples
    - Description extraction from ``docstrings``
    - Vendor specification extensions (``x-*``) in info, operations, parameters, components, and security schemes
    - Sane fallbacks
    - Sane ``operation_id`` naming (based on path)
    - Schema serving with ``SpectacularAPIView`` (Redoc and Swagger-UI views are also available)
    - Optional input/output serializer component split
    - Callback operations
    - OpenAPI 3.1 support (via setting ``OAS_VERSION``)
    - Included support for:
        - `django-polymorphic <https://github.com/django-polymorphic/django-polymorphic>`_ / `django-rest-polymorphic <https://github.com/apirobot/django-rest-polymorphic>`_
        - `SimpleJWT <https://github.com/jazzband/djangorestframework-simplejwt>`_
        - `DjangoOAuthToolkit <https://github.com/jazzband/django-oauth-toolkit>`_
        - `djangorestframework-jwt <https://github.com/jpadilla/django-rest-framework-jwt>`_ (tested fork `drf-jwt <https://github.com/Styria-Digital/django-rest-framework-jwt>`_)
        - `dj-rest-auth <https://github.com/iMerica/dj-rest-auth>`_ (maintained fork of `django-rest-auth <https://github.com/Tivix/django-rest-auth>`_)
        - `djangorestframework-camel-case <https://github.com/vbabiy/djangorestframework-camel-case>`_ (via postprocessing hook ``camelize_serializer_fields``)
        - `django-filter <https://github.com/carltongibson/django-filter>`_
        - `drf-nested-routers <https://github.com/alanjds/drf-nested-routers>`_
        - `djangorestframework-recursive <https://github.com/heywbj/django-rest-framework-recursive>`_
        - `djangorestframework-dataclasses <https://github.com/oxan/djangorestframework-dataclasses>`_
        - `django-rest-framework-gis <https://github.com/openwisp/django-rest-framework-gis>`_
        - `Pydantic (>=2.0) <https://github.com/pydantic/pydantic>`_


For more information visit the `documentation <https://drf-spectacular.readthedocs.io/>`_.

License
-------

Provided by `T. Franzel <https://github.com/tfranzel>`_. `Licensed under 3-Clause BSD <https://github.com/tfranzel/drf-spectacular/blob/master/LICENSE>`_.

Requirements
------------

-  Python >= 3.6
-  Django (2.2, 3.2, 4.0, 4.1, 4.2, 5.0)
-  Django REST Framework (3.10.3, 3.11, 3.12, 3.13, 3.14)

Installation
------------

Install using ``pip``\ ...

.. code:: bash

    $ pip install drf-spectacular

then add drf-spectacular to installed apps in ``settings.py``

.. code:: python

    INSTALLED_APPS = [
        # ALL YOUR APPS
        'drf_spectacular',
    ]


and finally register our spectacular AutoSchema with DRF.

.. code:: python

    REST_FRAMEWORK = {
        # YOUR SETTINGS
        'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',
    }

drf-spectacular ships with sane `default settings <https://drf-spectacular.readthedocs.io/en/latest/settings.html>`_
that should work reasonably well out of the box. It is not necessary to
specify any settings, but we recommend to specify at least some metadata.

.. code:: python

    SPECTACULAR_SETTINGS = {
        'TITLE': 'Your Project API',
        'DESCRIPTION': 'Your project description',
        'VERSION': '1.0.0',
        'SERVE_INCLUDE_SCHEMA': False,
        # OTHER SETTINGS
    }

.. _self-contained-ui-installation:

Self-contained UI installation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Certain environments have no direct access to the internet and as such are unable
to retrieve Swagger UI or Redoc from CDNs. `drf-spectacular-sidecar`_ provides
these static files as a separate optional package. Usage is as follows:

.. code:: bash

    $ pip install drf-spectacular[sidecar]

.. code:: python

    INSTALLED_APPS = [
        # ALL YOUR APPS
        'drf_spectacular',
        'drf_spectacular_sidecar',  # required for Django collectstatic discovery
    ]
    SPECTACULAR_SETTINGS = {
        'SWAGGER_UI_DIST': 'SIDECAR',  # shorthand to use the sidecar instead
        'SWAGGER_UI_FAVICON_HREF': 'SIDECAR',
        'REDOC_DIST': 'SIDECAR',
        # OTHER SETTINGS
    }


Release management
^^^^^^^^^^^^^^^^^^

*drf-spectacular* deliberately stays below version *1.x.x* to signal that every
new version may potentially break you. For production we strongly recommend pinning the
version and inspecting a schema diff on update.

With that said, we aim to be extremely defensive w.r.t. breaking API changes. However,
we also acknowledge the fact that even slight schema changes may break your toolchain,
as any existing bug may somehow also be used as a feature.

We define version increments with the following semantics. *y-stream* increments may contain
potentially breaking changes to both API and schema. *z-stream* increments will never break the
API and may only contain schema changes that should have a low chance of breaking you.


Take it for a spin
------------------

Generate your schema with the CLI:

.. code:: bash

    $ ./manage.py spectacular --color --file schema.yml
    $ docker run -p 80:8080 -e SWAGGER_JSON=/schema.yml -v ${PWD}/schema.yml:/schema.yml swaggerapi/swagger-ui

If you also want to validate your schema add the ``--validate`` flag. Or serve your schema directly
from your API. We also provide convenience wrappers for ``swagger-ui`` or ``redoc``.

.. code:: python

    from drf_spectacular.views import SpectacularAPIView, SpectacularRedocView, SpectacularSwaggerView
    urlpatterns = [
        # YOUR PATTERNS
        path('api/schema/', SpectacularAPIView.as_view(), name='schema'),
        # Optional UI:
        path('api/schema/swagger-ui/', SpectacularSwaggerView.as_view(url_name='schema'), name='swagger-ui'),
        path('api/schema/redoc/', SpectacularRedocView.as_view(url_name='schema'), name='redoc'),
    ]

Usage
-----

*drf-spectacular* works pretty well out of the box. You might also want to set some metadata for your API.
Just create a ``SPECTACULAR_SETTINGS`` dictionary in your ``settings.py`` and override the defaults.
Have a look at the `available settings <https://drf-spectacular.readthedocs.io/en/latest/settings.html>`_.

The toy examples do not cover your cases? No problem, you can heavily customize how your schema will be rendered.

Customization by using ``@extend_schema``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Most customization cases should be covered by the ``extend_schema`` decorator. We usually get
pretty far with specifying ``OpenApiParameter`` and splitting request/response serializers, but
the sky is the limit.

.. code:: python

    from drf_spectacular.utils import extend_schema, OpenApiParameter, OpenApiExample
    from drf_spectacular.types import OpenApiTypes

    class AlbumViewset(viewset.ModelViewset):
        serializer_class = AlbumSerializer

        @extend_schema(
            request=AlbumCreationSerializer,
            responses={201: AlbumSerializer},
        )
        def create(self, request):
            # your non-standard behaviour
            return super().create(request)

        @extend_schema(
            # extra parameters added to the schema
            parameters=[
                OpenApiParameter(name='artist', description='Filter by artist', required=False, type=str),
                OpenApiParameter(
                    name='release',
                    type=OpenApiTypes.DATE,
                    location=OpenApiParameter.QUERY,
                    description='Filter by release date',
                    examples=[
                        OpenApiExample(
                            'Example 1',
                            summary='short optional summary',
                            description='longer description',
                            value='1993-08-23'
                        ),
                        ...
                    ],
                ),
            ],
            # override default docstring extraction
            description='More descriptive text',
            # provide Authentication class that deviates from the views default
            auth=None,
            # change the auto-generated operation name
            operation_id=None,
            # or even completely override what AutoSchema would generate. Provide raw Open API spec as Dict.
            operation=None,
            # attach request/response examples to the operation.
            examples=[
                OpenApiExample(
                    'Example 1',
                    description='longer description',
                    value=...
                ),
                ...
            ],
        )
        def list(self, request):
            # your non-standard behaviour
            return super().list(request)

        @extend_schema(
            request=AlbumLikeSerializer,
            responses={204: None},
            methods=["POST"]
        )
        @extend_schema(description='Override a specific method', methods=["GET"])
        @action(detail=True, methods=['post', 'get'])
        def set_password(self, request, pk=None):
            # your action behaviour
            ...

More customization
^^^^^^^^^^^^^^^^^^

Still not satisfied? You want more! We still got you covered.
Visit `customization <https://drf-spectacular.readthedocs.io/en/latest/customization.html>`_ for more information.


Testing
-------

Install testing requirements.

.. code:: bash

    $ pip install -r requirements.txt

Run with runtests.

.. code:: bash

    $ ./runtests.py

You can also use the excellent `tox`_ testing tool to run the tests
against all supported versions of Python and Django. Install tox
globally, and then simply run:

.. code:: bash

    $ tox

.. _Django REST framework: https://www.django-rest-framework.org/
.. _OpenAPI: https://swagger.io/
.. _3.0.3: https://spec.openapis.org/oas/v3.0.3
.. _3.1: https://spec.openapis.org/oas/v3.1.0
.. _tox: https://tox.wiki/
.. _drf-spectacular-sidecar: https://github.com/tfranzel/drf-spectacular-sidecar

.. |build-status| image:: https://github.com/tfranzel/drf-spectacular/actions/workflows/ci.yml/badge.svg
   :target: https://github.com/tfranzel/drf-spectacular/actions/workflows/ci.yml
.. |pypi-version| image:: https://img.shields.io/pypi/v/drf-spectacular.svg
   :target: https://pypi.org/project/drf-spectacular/
.. |codecov| image:: https://codecov.io/gh/tfranzel/drf-spectacular/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/tfranzel/drf-spectacular
.. |docs| image:: https://readthedocs.org/projects/drf-spectacular/badge/
   :target: https://drf-spectacular.readthedocs.io/
.. |pypi-dl| image:: https://img.shields.io/pypi/dm/drf-spectacular
   :target: https://pypi.org/project/drf-spectacular/

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/tfranzel/drf-spectacular",
    "name": "drf-spectacular",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "",
    "author": "T. Franzel",
    "author_email": "tfranzel@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/53/c1/550dd00343b9b4ed1542c4e62ca384b1f6c10cd49f69ca0c9ddb8a17d062/drf-spectacular-0.27.0.tar.gz",
    "platform": null,
    "description": "===============\ndrf-spectacular\n===============\n\n|build-status| |codecov| |docs| |pypi-version| |pypi-dl|\n\nSane and flexible `OpenAPI`_ (`3.0.3`_ & `3.1`_) schema generation for `Django REST framework`_.\n\nThis project has 3 goals:\n    1. Extract as much schema information from DRF as possible.\n    2. Provide flexibility to make the schema usable in the real world (not only toy examples).\n    3. Generate a schema that works well with the most popular client generators.\n\nThe code is a heavily modified fork of the\n`DRF OpenAPI generator <https://github.com/encode/django-rest-framework/blob/master/rest_framework/schemas/openapi.py/>`_,\nwhich is/was lacking all of the below listed features.\n\nFeatures\n    - Serializers modelled as components. (arbitrary nesting and recursion supported)\n    - `@extend_schema <https://drf-spectacular.readthedocs.io/en/latest/drf_spectacular.html#drf_spectacular.utils.extend_schema>`_ decorator for customization of APIView, Viewsets, function-based views, and ``@action``\n        - additional parameters\n        - request/response serializer override (with status codes)\n        - polymorphic responses either manually with ``PolymorphicProxySerializer`` helper or via ``rest_polymorphic``'s PolymorphicSerializer)\n        - ... and more customization options\n    - Authentication support (DRF natives included, easily extendable)\n    - Custom serializer class support (easily extendable)\n    - ``SerializerMethodField()`` type via type hinting or ``@extend_schema_field``\n    - i18n support\n    - Tags extraction\n    - Request/response/parameter examples\n    - Description extraction from ``docstrings``\n    - Vendor specification extensions (``x-*``) in info, operations, parameters, components, and security schemes\n    - Sane fallbacks\n    - Sane ``operation_id`` naming (based on path)\n    - Schema serving with ``SpectacularAPIView`` (Redoc and Swagger-UI views are also available)\n    - Optional input/output serializer component split\n    - Callback operations\n    - OpenAPI 3.1 support (via setting ``OAS_VERSION``)\n    - Included support for:\n        - `django-polymorphic <https://github.com/django-polymorphic/django-polymorphic>`_ / `django-rest-polymorphic <https://github.com/apirobot/django-rest-polymorphic>`_\n        - `SimpleJWT <https://github.com/jazzband/djangorestframework-simplejwt>`_\n        - `DjangoOAuthToolkit <https://github.com/jazzband/django-oauth-toolkit>`_\n        - `djangorestframework-jwt <https://github.com/jpadilla/django-rest-framework-jwt>`_ (tested fork `drf-jwt <https://github.com/Styria-Digital/django-rest-framework-jwt>`_)\n        - `dj-rest-auth <https://github.com/iMerica/dj-rest-auth>`_ (maintained fork of `django-rest-auth <https://github.com/Tivix/django-rest-auth>`_)\n        - `djangorestframework-camel-case <https://github.com/vbabiy/djangorestframework-camel-case>`_ (via postprocessing hook ``camelize_serializer_fields``)\n        - `django-filter <https://github.com/carltongibson/django-filter>`_\n        - `drf-nested-routers <https://github.com/alanjds/drf-nested-routers>`_\n        - `djangorestframework-recursive <https://github.com/heywbj/django-rest-framework-recursive>`_\n        - `djangorestframework-dataclasses <https://github.com/oxan/djangorestframework-dataclasses>`_\n        - `django-rest-framework-gis <https://github.com/openwisp/django-rest-framework-gis>`_\n        - `Pydantic (>=2.0) <https://github.com/pydantic/pydantic>`_\n\n\nFor more information visit the `documentation <https://drf-spectacular.readthedocs.io/>`_.\n\nLicense\n-------\n\nProvided by `T. Franzel <https://github.com/tfranzel>`_. `Licensed under 3-Clause BSD <https://github.com/tfranzel/drf-spectacular/blob/master/LICENSE>`_.\n\nRequirements\n------------\n\n-  Python >= 3.6\n-  Django (2.2, 3.2, 4.0, 4.1, 4.2, 5.0)\n-  Django REST Framework (3.10.3, 3.11, 3.12, 3.13, 3.14)\n\nInstallation\n------------\n\nInstall using ``pip``\\ ...\n\n.. code:: bash\n\n    $ pip install drf-spectacular\n\nthen add drf-spectacular to installed apps in ``settings.py``\n\n.. code:: python\n\n    INSTALLED_APPS = [\n        # ALL YOUR APPS\n        'drf_spectacular',\n    ]\n\n\nand finally register our spectacular AutoSchema with DRF.\n\n.. code:: python\n\n    REST_FRAMEWORK = {\n        # YOUR SETTINGS\n        'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',\n    }\n\ndrf-spectacular ships with sane `default settings <https://drf-spectacular.readthedocs.io/en/latest/settings.html>`_\nthat should work reasonably well out of the box. It is not necessary to\nspecify any settings, but we recommend to specify at least some metadata.\n\n.. code:: python\n\n    SPECTACULAR_SETTINGS = {\n        'TITLE': 'Your Project API',\n        'DESCRIPTION': 'Your project description',\n        'VERSION': '1.0.0',\n        'SERVE_INCLUDE_SCHEMA': False,\n        # OTHER SETTINGS\n    }\n\n.. _self-contained-ui-installation:\n\nSelf-contained UI installation\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nCertain environments have no direct access to the internet and as such are unable\nto retrieve Swagger UI or Redoc from CDNs. `drf-spectacular-sidecar`_ provides\nthese static files as a separate optional package. Usage is as follows:\n\n.. code:: bash\n\n    $ pip install drf-spectacular[sidecar]\n\n.. code:: python\n\n    INSTALLED_APPS = [\n        # ALL YOUR APPS\n        'drf_spectacular',\n        'drf_spectacular_sidecar',  # required for Django collectstatic discovery\n    ]\n    SPECTACULAR_SETTINGS = {\n        'SWAGGER_UI_DIST': 'SIDECAR',  # shorthand to use the sidecar instead\n        'SWAGGER_UI_FAVICON_HREF': 'SIDECAR',\n        'REDOC_DIST': 'SIDECAR',\n        # OTHER SETTINGS\n    }\n\n\nRelease management\n^^^^^^^^^^^^^^^^^^\n\n*drf-spectacular* deliberately stays below version *1.x.x* to signal that every\nnew version may potentially break you. For production we strongly recommend pinning the\nversion and inspecting a schema diff on update.\n\nWith that said, we aim to be extremely defensive w.r.t. breaking API changes. However,\nwe also acknowledge the fact that even slight schema changes may break your toolchain,\nas any existing bug may somehow also be used as a feature.\n\nWe define version increments with the following semantics. *y-stream* increments may contain\npotentially breaking changes to both API and schema. *z-stream* increments will never break the\nAPI and may only contain schema changes that should have a low chance of breaking you.\n\n\nTake it for a spin\n------------------\n\nGenerate your schema with the CLI:\n\n.. code:: bash\n\n    $ ./manage.py spectacular --color --file schema.yml\n    $ docker run -p 80:8080 -e SWAGGER_JSON=/schema.yml -v ${PWD}/schema.yml:/schema.yml swaggerapi/swagger-ui\n\nIf you also want to validate your schema add the ``--validate`` flag. Or serve your schema directly\nfrom your API. We also provide convenience wrappers for ``swagger-ui`` or ``redoc``.\n\n.. code:: python\n\n    from drf_spectacular.views import SpectacularAPIView, SpectacularRedocView, SpectacularSwaggerView\n    urlpatterns = [\n        # YOUR PATTERNS\n        path('api/schema/', SpectacularAPIView.as_view(), name='schema'),\n        # Optional UI:\n        path('api/schema/swagger-ui/', SpectacularSwaggerView.as_view(url_name='schema'), name='swagger-ui'),\n        path('api/schema/redoc/', SpectacularRedocView.as_view(url_name='schema'), name='redoc'),\n    ]\n\nUsage\n-----\n\n*drf-spectacular* works pretty well out of the box. You might also want to set some metadata for your API.\nJust create a ``SPECTACULAR_SETTINGS`` dictionary in your ``settings.py`` and override the defaults.\nHave a look at the `available settings <https://drf-spectacular.readthedocs.io/en/latest/settings.html>`_.\n\nThe toy examples do not cover your cases? No problem, you can heavily customize how your schema will be rendered.\n\nCustomization by using ``@extend_schema``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nMost customization cases should be covered by the ``extend_schema`` decorator. We usually get\npretty far with specifying ``OpenApiParameter`` and splitting request/response serializers, but\nthe sky is the limit.\n\n.. code:: python\n\n    from drf_spectacular.utils import extend_schema, OpenApiParameter, OpenApiExample\n    from drf_spectacular.types import OpenApiTypes\n\n    class AlbumViewset(viewset.ModelViewset):\n        serializer_class = AlbumSerializer\n\n        @extend_schema(\n            request=AlbumCreationSerializer,\n            responses={201: AlbumSerializer},\n        )\n        def create(self, request):\n            # your non-standard behaviour\n            return super().create(request)\n\n        @extend_schema(\n            # extra parameters added to the schema\n            parameters=[\n                OpenApiParameter(name='artist', description='Filter by artist', required=False, type=str),\n                OpenApiParameter(\n                    name='release',\n                    type=OpenApiTypes.DATE,\n                    location=OpenApiParameter.QUERY,\n                    description='Filter by release date',\n                    examples=[\n                        OpenApiExample(\n                            'Example 1',\n                            summary='short optional summary',\n                            description='longer description',\n                            value='1993-08-23'\n                        ),\n                        ...\n                    ],\n                ),\n            ],\n            # override default docstring extraction\n            description='More descriptive text',\n            # provide Authentication class that deviates from the views default\n            auth=None,\n            # change the auto-generated operation name\n            operation_id=None,\n            # or even completely override what AutoSchema would generate. Provide raw Open API spec as Dict.\n            operation=None,\n            # attach request/response examples to the operation.\n            examples=[\n                OpenApiExample(\n                    'Example 1',\n                    description='longer description',\n                    value=...\n                ),\n                ...\n            ],\n        )\n        def list(self, request):\n            # your non-standard behaviour\n            return super().list(request)\n\n        @extend_schema(\n            request=AlbumLikeSerializer,\n            responses={204: None},\n            methods=[\"POST\"]\n        )\n        @extend_schema(description='Override a specific method', methods=[\"GET\"])\n        @action(detail=True, methods=['post', 'get'])\n        def set_password(self, request, pk=None):\n            # your action behaviour\n            ...\n\nMore customization\n^^^^^^^^^^^^^^^^^^\n\nStill not satisfied? You want more! We still got you covered.\nVisit `customization <https://drf-spectacular.readthedocs.io/en/latest/customization.html>`_ for more information.\n\n\nTesting\n-------\n\nInstall testing requirements.\n\n.. code:: bash\n\n    $ pip install -r requirements.txt\n\nRun with runtests.\n\n.. code:: bash\n\n    $ ./runtests.py\n\nYou can also use the excellent `tox`_ testing tool to run the tests\nagainst all supported versions of Python and Django. Install tox\nglobally, and then simply run:\n\n.. code:: bash\n\n    $ tox\n\n.. _Django REST framework: https://www.django-rest-framework.org/\n.. _OpenAPI: https://swagger.io/\n.. _3.0.3: https://spec.openapis.org/oas/v3.0.3\n.. _3.1: https://spec.openapis.org/oas/v3.1.0\n.. _tox: https://tox.wiki/\n.. _drf-spectacular-sidecar: https://github.com/tfranzel/drf-spectacular-sidecar\n\n.. |build-status| image:: https://github.com/tfranzel/drf-spectacular/actions/workflows/ci.yml/badge.svg\n   :target: https://github.com/tfranzel/drf-spectacular/actions/workflows/ci.yml\n.. |pypi-version| image:: https://img.shields.io/pypi/v/drf-spectacular.svg\n   :target: https://pypi.org/project/drf-spectacular/\n.. |codecov| image:: https://codecov.io/gh/tfranzel/drf-spectacular/branch/master/graph/badge.svg\n   :target: https://codecov.io/gh/tfranzel/drf-spectacular\n.. |docs| image:: https://readthedocs.org/projects/drf-spectacular/badge/\n   :target: https://drf-spectacular.readthedocs.io/\n.. |pypi-dl| image:: https://img.shields.io/pypi/dm/drf-spectacular\n   :target: https://pypi.org/project/drf-spectacular/\n",
    "bugtrack_url": null,
    "license": "BSD",
    "summary": "Sane and flexible OpenAPI 3 schema generation for Django REST framework",
    "version": "0.27.0",
    "project_urls": {
        "Documentation": "https://drf-spectacular.readthedocs.io",
        "Homepage": "https://github.com/tfranzel/drf-spectacular",
        "Source": "https://github.com/tfranzel/drf-spectacular"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3089b284c24bb807410aebfccafb3b491c673b8e926cf8eb27eca58f01973fb5",
                "md5": "e1698ee7337da485f57c2c3188b3058a",
                "sha256": "6ab2d20674244e8c940c2883f744b43c34fc68c70ea3aefa802f574108c9699b"
            },
            "downloads": -1,
            "filename": "drf_spectacular-0.27.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e1698ee7337da485f57c2c3188b3058a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 101047,
            "upload_time": "2023-12-12T00:06:24",
            "upload_time_iso_8601": "2023-12-12T00:06:24.895125Z",
            "url": "https://files.pythonhosted.org/packages/30/89/b284c24bb807410aebfccafb3b491c673b8e926cf8eb27eca58f01973fb5/drf_spectacular-0.27.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "53c1550dd00343b9b4ed1542c4e62ca384b1f6c10cd49f69ca0c9ddb8a17d062",
                "md5": "fe30cb370bd83db1e7d5fe13054a6d3a",
                "sha256": "18d7ae74b2b5d533fd31f1c591ebaa5cce1447e0976ced927401e3163040dea9"
            },
            "downloads": -1,
            "filename": "drf-spectacular-0.27.0.tar.gz",
            "has_sig": false,
            "md5_digest": "fe30cb370bd83db1e7d5fe13054a6d3a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 230289,
            "upload_time": "2023-12-12T00:06:27",
            "upload_time_iso_8601": "2023-12-12T00:06:27.640264Z",
            "url": "https://files.pythonhosted.org/packages/53/c1/550dd00343b9b4ed1542c4e62ca384b1f6c10cd49f69ca0c9ddb8a17d062/drf-spectacular-0.27.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-12-12 00:06:27",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "tfranzel",
    "github_project": "drf-spectacular",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "drf-spectacular"
}
        
Elapsed time: 0.15339s