neo4j · robsdedude · Apr 28, 2025 · Apr 24, 2025 · Apr 25, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,8 @@ See also https://github.com/neo4j/neo4j-python-driver/wiki for a full changelog.
 
 ## NEXT RELEASE
 - Python 3.7, 3.8, and 3.9 support has been dropped.
+- Remove deprecated package alias `neo4j-driver`. Use `pip install neo4j` instead.
+- Remove `setup.py`. Please use a recent enough packaging/build tool that supports `pyproject.toml`
 
 
 ## Version 5.28

diff --git a/bin/check-dist b/bin/check-dist
@@ -13,17 +13,16 @@ then
     exit 1
 else
     source "${ROOT}/bin/dist-functions"
-    for PACKAGE in "neo4j-driver" "neo4j"; do
-        NORMALIZED_PACKAGE="$(normalize_dist_name "$PACKAGE")"
-        if ! (check_file "${DIST}/${NORMALIZED_PACKAGE}-${VERSION}.tar.gz" \
-              || check_file "${DIST}/${PACKAGE}-${VERSION}.tar.gz"); then
-            STATUS=1
-        fi
-        if ! (check_file "${DIST}/${NORMALIZED_PACKAGE}-${VERSION}-py3-none-any.whl" \
-              || check_file "${DIST}/${PACKAGE}-${VERSION}-py3-none-any.whl"); then
-            STATUS=1
-        fi
-    done
+    PACKAGE="neo4j"
+    NORMALIZED_PACKAGE="$(normalize_dist_name "$PACKAGE")"
+    if ! (check_file "${DIST}/${NORMALIZED_PACKAGE}-${VERSION}.tar.gz" \
+          || check_file "${DIST}/${PACKAGE}-${VERSION}.tar.gz"); then
+        STATUS=1
+    fi
+    if ! (check_file "${DIST}/${NORMALIZED_PACKAGE}-${VERSION}-py3-none-any.whl" \
+          || check_file "${DIST}/${PACKAGE}-${VERSION}-py3-none-any.whl"); then
+        STATUS=1
+    fi
 fi
 
 exit ${STATUS}
diff --git a/bin/dist-functions b/bin/dist-functions
@@ -29,16 +29,6 @@ function set_version
     sed -i 's/^version = .*/version = "'$1'"/g' "${SRC}/neo4j/_meta.py"
 }
 
-function get_deprecated {
-    cd "${SRC}"
-    python -c "from neo4j._meta import deprecated_package; print(deprecated_package)"
-    cd - > /dev/null
-}
-
-function set_deprecated {
-    sed -i 's/^deprecated_package = .*/deprecated_package = '$1'/g' "${SRC}/neo4j/_meta.py"
-}
-
 # distribution normalization according to PEP 625 https://peps.python.org/pep-0625/
 function normalize_dist_name
 {
@@ -62,45 +52,38 @@ function check_file
 function set_metadata_and_setup
 {
     PACKAGE="$1"; shift
-    DEPRECATED="$1"; shift
     VERSION="$1"; shift
 
     cd "${ROOT}"
 
     # Capture original package metadata
     ORIGINAL_PACKAGE=$(get_package)
     ORIGINAL_VERSION=$(get_version)
-    ORIGINAL_DEPRECATED=$(get_deprecated)
-    echo "Source code originally configured for package ${ORIGINAL_PACKAGE}/${ORIGINAL_VERSION}/deprecated=${ORIGINAL_DEPRECATED}"
+    echo "Source code originally configured for package ${ORIGINAL_PACKAGE}/${ORIGINAL_VERSION}"
     echo "----------------------------------------"
     grep "package\s\+=" "${SRC}/neo4j/_meta.py"
     grep "version\s\+=" "${SRC}/neo4j/_meta.py"
-    grep "deprecated_package\s\+=" "${SRC}/neo4j/_meta.py"
     echo "----------------------------------------"
 
     function cleanup() {
       # Reset to original package metadata
       set_package "${ORIGINAL_PACKAGE}"
       set_version "${ORIGINAL_VERSION}"
-      set_deprecated "${ORIGINAL_DEPRECATED}"
-      echo "Source code reconfigured back to original package ${ORIGINAL_PACKAGE}/${ORIGINAL_VERSION}/deprecated=${ORIGINAL_DEPRECATED}"
+      echo "Source code reconfigured back to original package ${ORIGINAL_PACKAGE}/${ORIGINAL_VERSION}"
       echo "----------------------------------------"
       grep "package\s\+=" "${SRC}/neo4j/_meta.py"
       grep "version\s\+=" "${SRC}/neo4j/_meta.py"
-      grep "deprecated_package\s\+=" "${SRC}/neo4j/_meta.py"
       echo "----------------------------------------"
     }
     trap cleanup EXIT
 
     # Temporarily override package metadata
     set_package "${PACKAGE}"
     set_version "${VERSION}"
-    set_deprecated "${DEPRECATED}"
-    echo "Source code reconfigured for package ${PACKAGE}/${VERSION}/deprecated=${DEPRECATED}"
+    echo "Source code reconfigured for package ${PACKAGE}/${VERSION}"
     echo "----------------------------------------"
     grep "package\s\+=" "${SRC}/neo4j/_meta.py"
     grep "version\s\+=" "${SRC}/neo4j/_meta.py"
-    grep "deprecated_package\s\+=" "${SRC}/neo4j/_meta.py"
     echo "----------------------------------------"
 
     # Create source distribution
@@ -121,6 +104,5 @@ function setup
 {
     ARGS="$*"
     rm -rf ${DIST} 2> /dev/null
-    set_metadata_and_setup "neo4j-driver" "True" ${ARGS}  # Legacy package; can be removed in 2.0
-    set_metadata_and_setup "neo4j" "False" ${ARGS}
+    set_metadata_and_setup "neo4j" ${ARGS}
 }
diff --git a/bin/release b/bin/release
@@ -20,28 +20,27 @@ then
 fi
 
 source "${ROOT}/bin/dist-functions"
-for PACKAGE in "neo4j-driver" "neo4j"; do
-    NORMALIZED_PACKAGE="$(normalize_dist_name "$PACKAGE")"
+PACKAGE="neo4j"
+NORMALIZED_PACKAGE="$(normalize_dist_name "$PACKAGE")"
 
-    if check_file "${DIST}/${NORMALIZED_PACKAGE}-${VERSION}.tar.gz"
-    then
-        TWINE_ARGS="${TWINE_ARGS} ${DIST}/${NORMALIZED_PACKAGE}-${VERSION}.tar.gz"
-    elif check_file "${DIST}/${PACKAGE}-${VERSION}.tar.gz"; then
-        TWINE_ARGS="${TWINE_ARGS} ${DIST}/${PACKAGE}-${VERSION}.tar.gz"
-    else
-        echo "Source distribution file for ${PACKAGE} not found"
-        exit 1
-    fi
+if check_file "${DIST}/${NORMALIZED_PACKAGE}-${VERSION}.tar.gz"
+then
+    TWINE_ARGS="${TWINE_ARGS} ${DIST}/${NORMALIZED_PACKAGE}-${VERSION}.tar.gz"
+elif check_file "${DIST}/${PACKAGE}-${VERSION}.tar.gz"; then
+    TWINE_ARGS="${TWINE_ARGS} ${DIST}/${PACKAGE}-${VERSION}.tar.gz"
+else
+    echo "Source distribution file for ${PACKAGE} not found"
+    exit 1
+fi
 
-    if check_file "${DIST}/${NORMALIZED_PACKAGE}-${VERSION}-py3-none-any.whl"
-    then
-        TWINE_ARGS="${TWINE_ARGS} ${DIST}/${NORMALIZED_PACKAGE}-${VERSION}-py3-none-any.whl"
-    elif check_file "${DIST}/${PACKAGE}-${VERSION}-py3-none-any.whl"; then
-        TWINE_ARGS="${TWINE_ARGS} ${DIST}/${PACKAGE}-${VERSION}-py3-none-any.whl"
-    else
-        echo "Wheel distribution file for ${PACKAGE} not found"
-        exit 1
-    fi
-done
+if check_file "${DIST}/${NORMALIZED_PACKAGE}-${VERSION}-py3-none-any.whl"
+then
+    TWINE_ARGS="${TWINE_ARGS} ${DIST}/${NORMALIZED_PACKAGE}-${VERSION}-py3-none-any.whl"
+elif check_file "${DIST}/${PACKAGE}-${VERSION}-py3-none-any.whl"; then
+    TWINE_ARGS="${TWINE_ARGS} ${DIST}/${PACKAGE}-${VERSION}-py3-none-any.whl"
+else
+    echo "Wheel distribution file for ${PACKAGE} not found"
+    exit 1
+fi
 
 twine upload ${TWINE_ARGS}
diff --git a/pyproject.toml b/pyproject.toml
@@ -17,8 +17,7 @@
 name = "neo4j"
 description = "Neo4j Bolt driver for Python"
 license = {text = "Apache License, Version 2.0"}
-#TODO: 6.0 - static readme
-#readme = "README.rst"
+readme = "README.rst"
 authors = [
     {name = "Neo4j, Inc.", email = "drivers@neo4j.com"},
 ]
@@ -39,7 +38,7 @@ classifiers = [
     "Topic :: Software Development",
     "Typing :: Typed",
 ]
-dynamic = ["version", "readme"]
+dynamic = ["version"]
 
 [project.urls]
 Homepage = "https://neo4j.com/"
@@ -63,8 +62,6 @@ pyarrow = ["pyarrow >= 1.0.0"]
 [build-system]
 requires = [
     "setuptools == 75.6.0",
-    # TODO: 6.0 - can be removed once `setup.py` is simplified
-    "tomlkit == 0.12.5",  # dropped support (at least CI testing) for Python 3.7 in 0.13.0
 ]
 build-backend = "setuptools.build_meta"
 

diff --git a/setup.py b/setup.py
diff --git a/src/neo4j/__init__.py b/src/neo4j/__init__.py
@@ -47,7 +47,6 @@
 )
 from ._data import Record
 from ._meta import (
-    deprecated_package as _deprecated_package,
     deprecation_warn as _deprecation_warn,
     ExperimentalWarning,
     get_user_agent,
@@ -227,12 +226,3 @@ def __getattr__(name) -> _t.Any:
 
 def __dir__() -> list[str]:
     return __all__
-
-
-if _deprecated_package:
-    _deprecation_warn(
-        "The neo4j driver was installed under the package name `noe4j-driver` "
-        "which is deprecated and will stop receiving updates starting with "
-        "version 6.0.0. Please install `neo4j` instead (which is an alias, "
-        "i.e., a drop-in replacement). See https://pypi.org/project/neo4j/ ."
-    )
diff --git a/src/neo4j/_meta.py b/src/neo4j/_meta.py
@@ -34,7 +34,6 @@
 # Can be automatically overridden in builds
 package = "neo4j"
 version = "5.28.dev0"
-deprecated_package = False
 
 
 def _compute_bolt_agent() -> dict[str, str]: