Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Domain-driven e-commerce for Django
Python JavaScript CSS HTML XSLT Makefile Other
branch: master

Fix depth for CategoryFactory

Treebeard gives a depth of 1 to a root category, at least for the
MP_Node class we're using. As our factory tries to imitate treebeard, we
should do the same.

This was spotted because it caused a bug in some category munging tests
that I was working on for a client.
latest commit 5c8462c885
@maikhoepfel maikhoepfel authored
Failed to load latest commit information.
.tx Correct path for transifex
docs misstype
sites Use a regular settings file for tests
src/oscar Fix depth for CategoryFactory
tests Remove unused test code
.coveragerc Ignore migrations for coverage reports
.gitignore Updated .gitignore
.mailmap Update .mailmap for 0.6.1 release
.travis.yml Update travis from Django 1.7.4 to 1.7.7
CHANGELOG.rst Update links to Oscar repo
CONTRIBUTING.rst Remove execturable bit on CONTRIBUTING file.
LICENSE Use a year range in the license Fix path in MANIFEST file (prepend `src`)
Makefile Drop South usage and references
README.rst Eliminate Garmsby and FP Sports from the list. Fix path error in
requirements.txt Drop South usage and references
requirements_demo.txt Warn when using pysolr < 3.1
requirements_migrations.txt Resurrect requirements_vagrant.txt as requirements_migrations.txt
requirements_us.txt Add US-specific demo site Use a regular settings file for tests
setup.cfg Make test configuration pytest compatible Require atleast Django 1.7.7 in the requirements
tox.ini Stop running tests against Django 1.6 Transifex: Don't push translation


Domain-driven e-commerce for Django

Oscar is an e-commerce framework for Django designed for building domain-driven sites. It is structured such that any part of the core functionality can be customised to suit the needs of your project. This allows a wide range of e-commerce requirements to be handled, from large-scale B2C sites to complex B2B sites rich in domain-specific business logic.


Further reading:

Continuous integration status: Coverage

PyPI status:

Docs status:

Documentation Status

Core team:



These are screenshots from the 'sandbox' example site that ships with Oscar. It sports a simple design built with Twitter's Bootstrap and provides a good starting point for rapidly building elegant e-commerce sites.

The sandbox site is also available to browse at Dashboard users can be created using this gateway page.

The sandbox site can be set-up locally in 5 commands. Want to make changes? Check out the contributing guidelines.


Oscar also ships with a demo site, which is a reference build of an Oscar project. It integrates with Oscar's stores, PayPal and Datacash extensions.

The demo site is also available to browse at


The following extensions are stable and ready for use:

The following are community-written extensions:

Let us know if you're writing a new one!


Oscar is released under the permissive New BSD license (see summary).

Case studies

Oscar is still in active development but is used in production by a range of companies, from large multinationals to small, boutique stores:

Selected Tangent projects:


Many more on the way. If you use Oscar in production, please let us know.

Looking for commercial support?

If you are interested in having an Oscar project built for you, or for development of an existing Oscar site, Tangent can help. Please get in touch via or via the Tangent Snowball site.

Something went wrong with that request. Please try again.