django-oscar

library4.1pypypi✓ verified 80d ago

A domain-driven e-commerce framework for Django (current version 4.1). Designed for extensible, modular e-commerce sites. Release cadence: irregular, major versions every 1-2 years.

web-framework database payments auth-security

pip install django-oscar

package ↗homepage ↗

INSTALL

IMPORT

SIG · DJANGO-OSCAR

django-oscar

web-frameworkpythonv4.1

Install

12.6s avg

Import

—

Disk

247MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v4.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 279.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 12.6s · import 0.000s · 280MB

247MB installed

● package 247MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

get_version

✓ from oscar import get_version

✗ from oscar import OscarConfig

VERSION

✓ from oscar import VERSION

INSTALLED_APPS

✓ from oscar import INSTALLED_APPS

Initialize Oscar in a Django project (requires existing Django project with django-oscar installed). See official docs for full setup.

import os os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings') import django django.setup() from oscar import OscarConfig OscarConfig.default_app_config = 'oscar.apps.OscarConfig' # For a full project, use `oscar startproject myproject`

Debug

Known issues

breakingOscar 4.x dropped support for Django < 3.2 and Python < 3.8.

fix

Upgrade Django to >=3.2 and Python >=3.8.

affects: <4.0

breakingOscar 4.x removed the old 'oscar.apps.OscarConfig' direct module path; use 'oscar.OscarConfig'.

fix

Change INSTALLED_APPS from 'oscar.apps.OscarConfig' to 'oscar.OscarConfig'.

affects: <4.0

gotchaOscar uses its own user model and registration. Custom user models must conform to Oscar's expectations or use the `oscar.core.loading` utilities.

fix

Use `from oscar.core.loading import get_user_model` instead of Django's default.

affects: all

deprecatedThe dashboard feature is being gradually replaced with newer admin interfaces. Some dashboard views may become deprecated in future releases.

fix

Monitor Oscar changelog and consider using external admin packages.

affects: >=4.0

Upgrade

Version history

4.1latest on PyPI · released Oct 29, 2025

Audit

Dependencies

djangorequiredRequired runtime dependency

django-oscar-apioptionalREST API extension (optional)

sorl-thumbnailoptionalImage thumbnail support (optional but commonly used)

Agent activity

33 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/django-oscar/ ↗

homepagehttps://django-oscar.readthedocs.io ↗