[pull] master from jazzband:master

.pre-commit-config.yaml

@@ -18,6 +18,6 @@ repos:
         args: [--target-version=py38]
 
   - repo: https://github.com/pycqa/flake8
-    rev: '7.2.0'
+    rev: '7.3.0'
     hooks:
       - id: flake8

CHANGELOG.md

@@ -1,9 +1,14 @@
 # CHANGELOG
 
-## Unreleased
-
+## v3.0.1 (2025-07-01)
 * Drop dependency on `typing_extensions`.
 
+## v3.0.0 (2025-05-18)
+> Bumping to version 3; changes to code do break some API compatability.
+* Implement a new decorator registry pattern to impement 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.
+
 ## v2.3.0 (2024-10-23)
 * Remove Python 3.8 support.
 * Remove Django 3 support.

dj_database_url/__init__.py

@@ -1,9 +1,7 @@
 import logging
 import os
 import urllib.parse as urlparse
-from typing import Any, Callable, Dict, List, Optional, Union
-
-from typing_extensions import TypedDict
+from typing import Any, Callable, Dict, List, Optional, TypedDict, Union
 
 DEFAULT_ENV = "DATABASE_URL"
 ENGINE_SCHEMES: Dict[str, "Engine"] = {}
@@ -129,7 +127,7 @@ def config(
     env: str = DEFAULT_ENV,
     default: Optional[str] = None,
     engine: Optional[str] = None,
-    conn_max_age: int = 0,
+    conn_max_age: Optional[int] = 0,
     conn_health_checks: bool = False,
     disable_server_side_cursors: bool = False,
     ssl_require: bool = False,
@@ -160,7 +158,7 @@ def config(
 def parse(
     url: str,
     engine: Optional[str] = None,
-    conn_max_age: int = 0,
+    conn_max_age: Optional[int] = 0,
     conn_health_checks: bool = False,
     disable_server_side_cursors: bool = False,
     ssl_require: bool = False,
@@ -233,7 +231,7 @@ def _parse_value(value: str) -> OptionType:
 
 def _convert_to_settings(
     engine: Optional[str],
-    conn_max_age: int,
+    conn_max_age: Optional[int],
     conn_health_checks: bool,
     disable_server_side_cursors: bool,
     ssl_require: bool,

setup.py

@@ -6,7 +6,7 @@
 
 setup(
     name="dj-database-url",
-    version="2.3.0",
+    version="3.0.1",
     url="https://github.com/jazzband/dj-database-url",
     license="BSD",
     author="Original Author: Kenneth Reitz, Maintained by: JazzBand Community",
@@ -45,5 +45,6 @@
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
         "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
     ],
 )

tests/test_dj_database_url.py

@@ -266,8 +266,8 @@ def test_parse_conn_max_age_setting(self) -> None:
 
         assert url["CONN_MAX_AGE"] == conn_max_age
 
-    def test_config_conn_max_age_setting(self) -> None:
-        conn_max_age = 600
+    def test_config_conn_max_age_setting_none(self) -> None:
+        conn_max_age = None
         with mock.patch.dict(
             os.environ,
             {