openapi as optional feature

Author: n2ygk

CHANGELOG.md

@@ -13,7 +13,11 @@ any parts of the framework not mentioned in the documentation should generally b
 ### Added
 
 * Added support for serializing nested serializers as attribute json value introducing setting `JSON_API_SERIALIZE_NESTED_SERIALIZERS_AS_ATTRIBUTE`
-* Add support openapi schema and for `generateschema` management command.
+* Add optional support for [openapi](https://www.openapis.org/) schema generation. Enable with:
+  ```
+  pip install djangorestframework-jsonapi['openapi']
+  ```
+
 
 ### Fixed
 

README.rst

@@ -106,6 +106,7 @@ From PyPI
     $ # for optional package integrations
     $ pip install djangorestframework-jsonapi['django-filter']
     $ pip install djangorestframework-jsonapi['django-polymorphic']
+    $ pip install djangorestframework-jsonapi['openapi']
 
 
 From Source

docs/getting-started.md

@@ -65,6 +65,7 @@ From PyPI
     # for optional package integrations
     pip install djangorestframework-jsonapi['django-filter']
     pip install djangorestframework-jsonapi['django-polymorphic']
+    pip install djangorestframework-jsonapi['openapi']
 
 From Source
 

docs/usage.md

@@ -986,6 +986,8 @@ initializer:
 ```python
 from rest_framework_json_api.schemas.openapi import AutoSchema
 
+TODO: resolve this with upstream changes:
+
 openapi_schema = {
     'info': {
         'version': '1.0',

setup.py

@@ -95,7 +95,8 @@ def get_package_data(package):
     ],
     extras_require={
         'django-polymorphic': ['django-polymorphic>=2.0'],
-        'django-filter': ['django-filter>=2.0']
+        'django-filter': ['django-filter>=2.0'],
+        'openapi': ['pyyaml>=5.3', 'uritemplate>=3.0.1']
     },
     setup_requires=wheel,
     python_requires=">=3.5",