PyPI · #1393 most downloaded on PyPI

dj-database-url

3.1.27.4M downloads/mojazzband/dj-database-url ↗New releases in your daily digest, changelog included.

Use Database URLs in your Django Application.

Last release 7 months ago
19 Feb 2026
Ships unpredictably
gaps range from 4 weeks to 4.4 years
Nearly every release is documented
notes for 23 of 25 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
25 releases · first in 2012

Release timeline

25 releases since 2012

2012201420162018

Releases

3.1.219 Feb 2026
Bump cryptography from 46.0.3 to 46.0.5 by @dependabot [bot] in #293
What's Changed

Bump cryptography from 46.0.3 to 46.0.5 by @dependabot[bot] in #293

Bump django from 5.2.9 to 5.2.11 by @dependabot[bot] in #294

Bump urllib3 from 2.6.2 to 2.6.3 by @dependabot[bot] in #295

Bump wheel from 0.45.1 to 0.46.2 by @dependabot[bot] in #296

[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in #297

New Contributors

@dependabot[bot] made their first contribution in #293

Full Changelog: v3.1.1...v3.1.2
Open source →

3.1.116 Feb 2026

Add tests directory to source distribution by @yohaann196 in #285

What's Changed

Add tests directory to source distribution by @yohaann196 in #285
Switch linting and formatting from flake8+isort+black to ruff; add typos to pre-commit; fix typos by @akx in #281
Add project URLs to pyproject.toml by @luzfcb in #287
Update .pre-commit-config.yaml to use pinned version numbers. by @mattseymour in #289
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in #291

New Contributors

@yohaann196 made their first contribution in #285
@luzfcb made their first contribution in #287

Full Changelog: v3.1.0...v3.1.1

Open source →

3.1.04 Jan 2026

[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci [bot] in #268

What's Changed

[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in #268
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in #270
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in #276
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in #278
Update license to BSD-3-Clause in setup.py by @GabrielBarrantes in #279
CI: run typechecks only once, not for each Django/Python version by @akx in #274

New Contributors

@GabrielBarrantes made their first contribution in #279
@akx made their first contribution in #274

Full Changelog: v3.0.1...v3.1.0

Open source →

Additional notes2 sources agree

Add support for Django 6.0
Update CI structure.
Migrate to UV for dependency management and builds.
Python >3.10 support.

Open source →

3.0.12 Jul 2025

Re-drop dependency on typing_extensions by @edmorley in #269

What's Changed

Re-drop dependency on typing_extensions by @edmorley in #269

Full Changelog: v3.0.0...v3.0.1

Open source →

Additional notes2 sources agree

Drop dependency on typing_extensions.

Open source →

3.0.02 Jun 2025

Drop dependency on typing_extensions by @edmorley in #257

What's Changed

Drop dependency on typing_extensions by @edmorley in #257
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #259
Fix type errors by @adamchainz in #261
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #262

New Contributors

@edmorley made their first contribution in #257

Full Changelog: v2.3.0...v3.0.0

Open source →

Additional notes2 sources agree

Bumping to version 3; changes to code do break some API compatibility.

Implement a new decorator registry pattern to implement checks on database connection string.
You can now support and implement your own database strings by extending the @register functionality.
Update supported python versions and django versions.

Open source →

2.3.023 Oct 2024

[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #249

What's Changed

[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #249
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #251
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #254
Make config test options not unknown types by @palfrey in #252
Add Python 3.13 and Django 5.1 testing by @palfrey in #255
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #256

Full Changelog: v2.2.0...v2.3.0

Open source →

Additional notes2 sources agree

Remove Python 3.8 support.
Remove Django 3 support.
Add python 3.13 support.
Add Django 5.1 to the testing library.

Open source →

2.2.028 May 2024

Do not leak key loop variable into global namespace by @sobolevn in #226

What's Changed

Do not leak key loop variable into global namespace by @sobolevn in #226
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #223
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #227
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #228
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #229
Add disable_server_side_cursors parameter by @fbinz in #231
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #233
Enhance Query String Parsing for Server-Side Binding in Django 4.2 with psycopg 3.1.8+ Resolves #234 by @truongvan in #235
OPTIONS cannot be None given our code by @palfrey in #232
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #236
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #237
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #238
Update django 5.0 python compatability by @mattseymour in #239
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #241
Allow currentSchema option to be used with custom postgresql backends by @GertBurger in #243
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #242
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #244
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #245
Update README.rst to add postgresql by @boxydog in #247

New Contributors

@fbinz made their first contribution in #231
@truongvan made their first contribution in #235
@GertBurger made their first contribution in #243
@boxydog made their first contribution in #247

Full Changelog: v2.1.0...v2.2.0

Open source →

Additional notes2 sources agree

Add disable_server_side_cursors parameter
Enhance Query String Parsing for Server-Side Binding in Django 4.2 with psycopg 3.1.8+
Update django 5.0 python compatibility by @mattseymour in #239
Improved internals
Improved documentation

Open source →

2.0.027 Apr 2023

setup.py: Fix project_urls parameter name by @mgorny in #212

What's Changed

setup.py: Fix project_urls parameter name by @mgorny in #212
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in #216
Redo as a package to fix mypy issues by @palfrey in #215

New Contributors

@mgorny made their first contribution in #212

Full Changelog: v1.3.0...v2.0.0

Open source →

Additional notes2 sources agree

Update project setup such that we now install it as a package.

Notes: while this does not alter the underlying application code, we are bumping to 2.0 incase there are unforeseen knock-on use-case issues.

Open source →

1.3.028 Mar 2023

Better error on missing schema by @palfrey in #196

What's Changed

Better error on missing schema by @palfrey in #196
Add types by @palfrey in #198
100% test coverage by @palfrey in #202
Avoid duplicating the uses_netloc and schemes lines by @palfrey in #201
isort 5.11.4 is broken by @palfrey in #205
Throw warning if DATABASE_URL isn't set by @palfrey in #199
Fixes #209 - Make conn_max_age optional[int] type by @mattseymour in #210

Full Changelog: v1.2.0...v1.3.0

Open source →

Additional notes2 sources agree

Cosmetic changes to the generation of schemes.
Bump isort version - 5.11.5.
raise a warning message if database_url is not set.
CONN_MAX_AGE fix type - Optional[int].

Open source →

1.2.013 Dec 2022

allow TEST settings to be passed into a db config by @Brodan in https://github.com/jazzband/dj-database-url/pull/116

What's Changed

allow TEST settings to be passed into a db config by @Brodan in https://github.com/jazzband/dj-database-url/pull/116
Support urlencoding/decoding for hostname by @Dresdn in https://github.com/jazzband/dj-database-url/pull/181
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/jazzband/dj-database-url/pull/194
Fixes #195 - config missin conn_health_check parameter

New Contributors

@Brodan made their first contribution in https://github.com/jazzband/dj-database-url/pull/116
@Dresdn made their first contribution in https://github.com/jazzband/dj-database-url/pull/181

Full Changelog: https://github.com/jazzband/dj-database-url/compare/v1.1.0...v1.2.0

Open source →

Additional notes2 sources agree

Add the ability to add test databases.
Improve url parsing and encoding.
Fix missing parameter conn_health_check in check function.

Open source →

1.1.012 Dec 2022

Added support for Timescale and Timescale (GIS) by @lino in https://github.com/jazzband/dj-database-url/pull/174

What's Changed

Added support for Timescale and Timescale (GIS) by @lino in https://github.com/jazzband/dj-database-url/pull/174
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/jazzband/dj-database-url/pull/175
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/jazzband/dj-database-url/pull/177
Fix linter violation by @alexanderGerbik in https://github.com/jazzband/dj-database-url/pull/179
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/jazzband/dj-database-url/pull/182
Support Django 4.1 and remove compatibility code by @adamchainz in https://github.com/jazzband/dj-database-url/pull/183
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/jazzband/dj-database-url/pull/188
Use urlsplit() instead of urlparse() by @adamchainz in https://github.com/jazzband/dj-database-url/pull/184
CHANGELOG: Fix date format by @cfra in https://github.com/jazzband/dj-database-url/pull/192
add support to python 3.11 by @jairhenrique in https://github.com/jazzband/dj-database-url/pull/189
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/jazzband/dj-database-url/pull/193
Improve by @jairhenrique in https://github.com/jazzband/dj-database-url/pull/190
Add ability to set CONN_HEALTH_CHECKS by @adamchainz in https://github.com/jazzband/dj-database-url/pull/185

New Contributors

@lino made their first contribution in https://github.com/jazzband/dj-database-url/pull/174
@alexanderGerbik made their first contribution in https://github.com/jazzband/dj-database-url/pull/179
@adamchainz made their first contribution in https://github.com/jazzband/dj-database-url/pull/183
@cfra made their first contribution in https://github.com/jazzband/dj-database-url/pull/192
@jairhenrique made their first contribution in https://github.com/jazzband/dj-database-url/pull/189

Full Changelog: https://github.com/jazzband/dj-database-url/compare/v1.0.0...v1.1.0

Open source →

Additional notes2 sources agree

Option for connection health checks parameter.
Update supported version python 3.11.
Code changes, various improvements.
Add project links to setup.py.

Open source →

1.0.029 Jul 2022

Initial release since the project was migrated to Jazzband.

We are bumping to version 1.0.0 for a couple of reasons, though none of them are truely breaking API changes.

1.0.0 dignifies a long awaited release of dj-database-url, the first since 2018.
We are dropping support of python2.7 🪦
Supported python versions >=3.7

Thank you for helping to push this project forwards.

Open source →

Additional notes2 sources agree

Initial release of code, dj-database-urls is now part of Jazzband.

Add support for cockroachdb.
Add support for the official MSSQL connector.
Update License to be compatible with Jazzband.
Remove support for Python < 3.5 including Python 2.7
Update source code to Black format.
Update CI using pre-commit

Open source →

0.5.01 Mar 20182 sources agree

Django expects Oracle Ports as strings

Use str port for mssql
Added license
Add mssql to readme
Add mssql support using pyodbc
Fix RST schemas
Django expects Oracle Ports as strings
Fix IPv6 address parsing
Add testing for Python 3.6
Revert "Add setup.cfg for wheel support"
added option of postgis backend to also add path parsing. (test added also)
Support schema definition for redshift
add redshift support
Add testing for Python 3.5
Drop testing for Python 2.6
Fixes issue with unix file paths being turned to lower case
add Redis support
Added SpatiaLite in README.rst

Open source →

0.4.03 Feb 20162 sources agree

Handle search path config in connection url for postgres

Update readme
Fix for python3
Handle search path config in connection url for postgres
Add tox config to ease testing against multiple Python versions
Simplified the querystring parse logic
Cleaned up querystring parsing
supports database options
Added tests for CONN_MAX_AGE
Added documentation for conn_max_age
Add in optional support for CONN_MAX_AGE
Support special characters in user, password and name fields
Add oracle support
Added support for percent-encoded postgres paths
Fixed test_cleardb_parsing test
Enable automated testing with Python 3.4
Add URL schema examples to README
Added support for python mysql-connector

Open source →

0.3.010 Mar 20142 sources agree

Remove travis-ci unsupported python versions (Travis CI supports Python versions 2.6, 2.7, 3.2 and 3.3)

Add .gitignore file
Remove .pyc file
Remove travis-ci unsupported python versions (Travis CI supports Python versions 2.6, 2.7, 3.2 and 3.3)
Fix cleardb test
Add setup.cfg for wheel support
Add trove classifiers for python versions
Replace Python 3.1 with Python 3.3
Add MySQL (GIS) support
Ability to set different engine

Open source →

0.2.217 Jul 20132 sources agree

Added spatialite to uses_netloc too

Added spatialite to uses_netloc too
Added spatialite backend
Replacing tab with spaces
Handling special case of sqlite://:memory:
Empty sqlite path will now use a :memory: database
Fixing test to actually use the result of the parse
Adding in tests to ensure sqlite in-memory databases work
Fixed a too-short title underline
Added :target: attribute to Travis status image in README
Added docs for default argument to config
Add "pgsql" as a PostgreSQL URL scheme.
Add support for blank fields (Django expects '' not None)
fixed url

Open source →

0.2.119 Jun 20122 sources agree

Adding test environment variables

Add python3 support
Adding travis status and tests
Adding test environment variables
Adding test for cleardb
Remove query strings from name
Adding postgres tests
Adding tests
refactor scheme lookup
RedHat's OpenShift platform uses the 'postgresql' scheme
Registered postgis URL scheme
Added postgis:// url scheme
Use get() on os.environ instead of an if.

Open source →