Metadata-Version: 2.1
Name: django-oscar-api
Version: 3.2.4
Summary: REST API module for django-oscar
Home-page: https://github.com/django-oscar/django-oscar-api
Author: Lars van de Kerkhof, Martijn Jacobs
Author-email: lars@permanentmarkers.nl, martijn@devopsconsulting.nl
License: BSD
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.7
License-File: LICENSE
Requires-Dist: setuptools
Requires-Dist: django-oscar (>=3.2)
Requires-Dist: Django (>=3.2)
Requires-Dist: djangorestframework (>=3.9)
Provides-Extra: dev
Requires-Dist: coverage ; extra == 'dev'
Requires-Dist: mock ; extra == 'dev'
Requires-Dist: twine ; extra == 'dev'
Requires-Dist: wheel ; extra == 'dev'
Requires-Dist: easy-thumbnails ; extra == 'dev'
Provides-Extra: lint
Requires-Dist: pylint ; extra == 'lint'
Requires-Dist: pylint-django ; extra == 'lint'
Requires-Dist: black (>=23.1.0) ; extra == 'lint'

================
Django Oscar API
================

This package provides a RESTful API for `django-oscar`_.

.. _`django-oscar`: https://github.com/django-oscar/django-oscar

.. image:: https://travis-ci.org/django-oscar/django-oscar-api.svg?branch=master
    :target: https://travis-ci.org/django-oscar/django-oscar-api

.. image:: https://codecov.io/github/django-oscar/django-oscar-api/coverage.svg?branch=master
    :alt: Coverage
    :target: http://codecov.io/github/django-oscar/django-oscar-api?branch=master

.. image:: https://readthedocs.org/projects/django-oscar-api/badge/
   :alt: Documentation Status
   :target: https://django-oscar-api.readthedocs.io/

.. image:: https://badge.fury.io/py/django-oscar-api.svg
   :alt: Latest PyPi release
   :target: https://pypi.python.org/pypi/django-oscar-api

Usage
=====

To use the Oscar API application in an Oscar E-commerce site, follow these
steps:

1. Install the ``django-oscar-api`` package (``pip install django-oscar-api``).

2. Add ``rest_framework`` and ``oscarapi`` to ``INSTALLED_APPS``

    .. code-block:: python

       INSTALLED_APPS = [
        ...
        'rest_framework',
        'oscarapi',
       ]

3. Add the application's urls to your urlconf

   .. code-block:: python

      from django.urls import include

      urlpatterns = (
          # all the things you already have
          path("api/", include("oscarapi.urls")),
      )

4. Apply migrations::

    python manage.py migrate


See the Documentation_ for more information and the Changelog_ for release notes.

.. _Documentation: https://django-oscar-api.readthedocs.io
.. _Changelog: https://django-oscar-api.readthedocs.io/en/latest/changelog.html

