README update with Django usage

Author: p1c2u

README.rst

@@ -1,3 +1,4 @@
+************
 openapi-core
 ************
 
@@ -15,13 +16,13 @@ openapi-core
      :target: https://pypi.python.org/pypi/openapi-core
 
 About
-=====
+#####
 
 Openapi-core is a Python library that adds client-side and server-side support
 for the `OpenAPI Specification v3.0.0 <https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md>`__.
 
 Installation
-============
+############
 
 Recommended way (via pip):
 
@@ -37,7 +38,7 @@ Alternatively you can download the code and install from the repository:
 
 
 Usage
-=====
+#####
 
 Firstly create your specification:
 
@@ -47,6 +48,9 @@ Firstly create your specification:
 
    spec = create_spec(spec_dict)
 
+Request
+*******
+
 Now you can use it to validate requests
 
 .. code-block:: python
@@ -83,14 +87,61 @@ or use shortcuts for simple validation
    validated_params = validate_parameters(spec, request)
    validated_body = validate_body(spec, request)
 
-Request object should be instance of OpenAPIRequest class. You can use FlaskOpenAPIRequest a Flask/Werkzeug request factory:
+Request object should be instance of OpenAPIRequest class (See `Integrations`_).
+
+Response
+********
+
+You can also validate responses
+
+.. code-block:: python
+
+   from openapi_core.shortcuts import ResponseValidator
+
+   validator = ResponseValidator(spec)
+   result = validator.validate(request, response)
+
+   # raise errors if response invalid
+   result.raise_for_errors()
+
+   # get list of errors
+   errors = result.errors
+
+and unmarshal response data from validation result
+
+.. code-block:: python
+
+   # get headers
+   validated_headers = result.headers
+
+   # get data
+   validated_data = result.data
+
+or use shortcuts for simple validation
+
+.. code-block:: python
+
+   from openapi_core import validate_data
+
+   validated_data = validate_data(spec, request, response)
+
+Response object should be instance of OpenAPIResponse class (See `Integrations`_).
+
+
+Integrations
+############
+
+Django
+******
+
+You can use DjangoOpenAPIRequest a Django request factory:
 
 .. code-block:: python
 
    from openapi_core.shortcuts import RequestValidator
-   from openapi_core.contrib.flask import FlaskOpenAPIRequest
+   from openapi_core.contrib.django import DjangoOpenAPIRequest
 
-   openapi_request = FlaskOpenAPIRequest(flask_request)
+   openapi_request = DjangoOpenAPIRequest(django_request)
    validator = RequestValidator(spec)
    result = validator.validate(openapi_request)
 
@@ -101,44 +152,58 @@ or simply specify request factory for shortcuts
    from openapi_core import validate_parameters, validate_body
 
    validated_params = validate_parameters(
-       spec, request, request_factory=FlaskOpenAPIRequest)
+       spec, request, request_factory=DjangoOpenAPIRequest)
    validated_body = validate_body(
-       spec, request, request_factory=FlaskOpenAPIRequest)
+       spec, request, request_factory=DjangoOpenAPIRequest)
 
-You can also validate responses
+You can use DjangoOpenAPIResponse as a Django response factory:
 
 .. code-block:: python
 
    from openapi_core.shortcuts import ResponseValidator
+   from openapi_core.contrib.django import DjangoOpenAPIResponse
 
+   openapi_response = DjangoOpenAPIResponse(django_response)
    validator = ResponseValidator(spec)
-   result = validator.validate(request, response)
+   result = validator.validate(openapi_request, openapi_response)
 
-   # raise errors if response invalid
-   result.raise_for_errors()
+or simply specify response factory for shortcuts
 
-   # get list of errors
-   errors = result.errors
+.. code-block:: python
 
-and unmarshal response data from validation result
+   from openapi_core import validate_parameters, validate_body
+
+   validated_data = validate_data(
+       spec, request, response,
+       request_factory=DjangoOpenAPIRequest,
+       response_factory=DjangoOpenAPIResponse)
+
+Flask
+*****
+
+You can use FlaskOpenAPIRequest a Flask/Werkzeug request factory:
 
 .. code-block:: python
 
-   # get headers
-   validated_headers = result.headers
+   from openapi_core.shortcuts import RequestValidator
+   from openapi_core.contrib.flask import FlaskOpenAPIRequest
 
-   # get data
-   validated_data = result.data
+   openapi_request = FlaskOpenAPIRequest(flask_request)
+   validator = RequestValidator(spec)
+   result = validator.validate(openapi_request)
 
-or use shortcuts for simple validation
+or simply specify request factory for shortcuts
 
 .. code-block:: python
 
-   from openapi_core import validate_data
+   from openapi_core import validate_parameters, validate_body
 
-   validated_data = validate_data(spec, request, response)
+   validated_params = validate_parameters(
+       spec, request, request_factory=FlaskOpenAPIRequest)
+   validated_body = validate_body(
+       spec, request, request_factory=FlaskOpenAPIRequest)
 
-Response object should be instance of OpenAPIResponse class. You can use FlaskOpenAPIResponse a Flask/Werkzeug response factory:
+You can use FlaskOpenAPIResponse as a Flask/Werkzeug response factory:
 
 .. code-block:: python
 
@@ -160,7 +225,12 @@ or simply specify response factory for shortcuts
        request_factory=FlaskOpenAPIRequest,
        response_factory=FlaskOpenAPIResponse)
 
+Pyramid
+*******
+
+See `pyramid_openapi3  <https://github.com/niteoweb/pyramid_openapi3>`_ project.
+
 Related projects
-================
+################
 * `openapi-spec-validator <https://github.com/p1c2u/openapi-spec-validator>`__
 * `pyramid_openapi3 <https://github.com/niteoweb/pyramid_openapi3>`__