django-utils-six

2.0 · maintenance · verified Thu Apr 16

django-utils-six is a Python library (version 2.0) designed to provide forward compatibility for `django.utils.six` in Django 3.0 and later versions. `django.utils.six` was a Python 2/3 compatibility module bundled with Django, but it was removed in Django 3.0. This library fills that gap, allowing older third-party applications that still depend on `from django.utils import six` to function correctly without modification in Django 3+ environments. It is a niche compatibility layer with infrequent releases.

Common errors

```
ImportError: cannot import name 'six' from 'django.utils'
```
cause A project or one of its dependencies is attempting to import `six` from `django.utils`, but this module was removed in Django 3.0.

fix Install `django-utils-six` using `pip install django-utils-six`. This provides the `six` module at the `django.utils` path, allowing the problematic import to resolve.
```
AttributeError: module 'six' has no attribute 'string_types'
```
cause While `django-utils-six` makes `django.utils.six` importable, an older or incompatible dependency might be expecting specific `six` features or an older version of `six` that is not fully satisfied, or the global `six` package might be interfering.

fix Ensure `django-utils-six` is the only installed package providing `django.utils.six`. If the issue persists, update the problematic third-party package to a version that doesn't rely on `django.utils.six` or fully refactor the code to use standard Python 3 constructs instead of `six`.

Warnings

breaking Django 3.0 and later versions removed `django.utils.six`. Projects or third-party applications attempting to import `django.utils.six` will raise an `ImportError`.
Fix: Install `django-utils-six` to restore the `django.utils.six` path, or upgrade affected third-party packages to versions compatible with Django 3+, or refactor custom code to remove `six` usage for Python 3-only projects.
deprecated The underlying `six` library, and thus `django-utils-six`, is primarily for Python 2/3 compatibility. With Python 2 end-of-life, `six` is largely unnecessary for new Python 3-only projects.
Fix: For new projects targeting Python 3 exclusively, avoid `six` and refactor code to use native Python 3 features (e.g., `str` instead of `six.text_type`). For older projects, use this library as a temporary bridge while migrating away from `six`.
gotcha This library is a temporary solution for legacy dependencies. Relying on `django-utils-six` long-term is not ideal; the recommended approach is to ensure all dependencies are compatible with modern Django and Python versions that do not require `six`.
Fix: Prioritize updating or replacing third-party packages that depend on `django.utils.six`. If maintaining custom code, refactor `six` imports and usage to directly use `import six` (if necessary) or Python 3 constructs.

Install

pip install django-utils-six Install latest version

Imports

six
wrong:
```
from django.utils import six
```
correct:
```
from django_utils_six import six
```
`django.utils.six` was removed in Django 3.0. This library makes the 'wrong' import work for older third-party dependencies. For new code, consider directly importing `six` (if installed) or using native Python 3 features.

Quickstart

Install django-utils-six. This package automatically makes `django.utils.six` available, allowing third-party libraries that rely on this deprecated import to function on Django 3+ without modification. There is no typical direct code usage; its primary role is passive compatibility.

pip install django-utils-six

view raw JSON →