Update the default Python version from 3.12 to 3.13 (#299)

Previously if an app did not specify a Python version (e.g. via a `.python-version` file), then the buildpack would default to the latest Python 3.12 release. Now the buildpack will use the latest Python 3.13 release. Apps that aren't compatible with Python 3.13 will now need to request Python 3.12 explicitly by creating a `.python-version` file containing: `3.12` Note: Unlike in the classic Python buildpack, this change will affect existing apps too, since the CNB does not perform version pinning (due to the UX and app to app consistency issues it causes). Users are strongly advised to never rely on the default version, and instead set an explicit major Python version using a `.python-version` file. See: https://docs.python.org/3.13/whatsnew/3.13.html GUS-W-14846979.
heroku · Dec 6, 2024 · a427f65 · a427f65
1 parent 59d93ae
commit a427f65
Show file tree

Hide file tree

Showing 11 changed files with 46 additions and 49 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Updated the default Python version from 3.12 to 3.13. ([#299](https://github.com/heroku/buildpacks-python/pull/299))
+
 ## [0.19.2] - 2024-12-04
 
 ### Changed

diff --git a/src/python_version.rs b/src/python_version.rs
@@ -9,11 +9,11 @@ use std::path::Path;
 /// The Python version that will be installed if the project does not specify an explicit version.
 pub(crate) const DEFAULT_PYTHON_VERSION: RequestedPythonVersion = RequestedPythonVersion {
     major: 3,
-    minor: 12,
+    minor: 13,
     patch: None,
     origin: PythonVersionOrigin::BuildpackDefault,
 };
-pub(crate) const DEFAULT_PYTHON_FULL_VERSION: PythonVersion = LATEST_PYTHON_3_12;
+pub(crate) const DEFAULT_PYTHON_FULL_VERSION: PythonVersion = LATEST_PYTHON_3_13;
 
 pub(crate) const LATEST_PYTHON_3_8: PythonVersion = PythonVersion::new(3, 8, 20);
 pub(crate) const LATEST_PYTHON_3_9: PythonVersion = PythonVersion::new(3, 9, 21);
@@ -270,7 +270,7 @@ mod tests {
                 .unwrap(),
             RequestedPythonVersion {
                 major: 3,
-                minor: 12,
+                minor: 13,
                 patch: None,
                 origin: PythonVersionOrigin::BuildpackDefault
             }

diff --git a/tests/fixtures/poetry_basic/.python-version b/tests/fixtures/poetry_basic/.python-version
@@ -0,0 +1 @@
+3.13
diff --git a/tests/fixtures/poetry_basic/poetry.lock b/tests/fixtures/poetry_basic/poetry.lock
diff --git a/tests/fixtures/poetry_basic/pyproject.toml b/tests/fixtures/poetry_basic/pyproject.toml
@@ -2,7 +2,7 @@
 package-mode = false
 
 [tool.poetry.dependencies]
-python = "^3.12"
+python = "^3.13"
 typing-extensions = "*"
 
 # This group shouldn't be installed due to us passing `--only main`.

diff --git a/tests/fixtures/poetry_editable_git_compiled/poetry.lock b/tests/fixtures/poetry_editable_git_compiled/poetry.lock
diff --git a/tests/fixtures/poetry_editable_git_compiled/pyproject.toml b/tests/fixtures/poetry_editable_git_compiled/pyproject.toml
@@ -2,7 +2,7 @@
 package-mode = false
 
 [tool.poetry.dependencies]
-python = "^3.12"
+python = "^3.13"
 
 # This requirement uses a VCS URL and `develop = true` in order to test that:
 #  - Git from the stack image can be found (ie: the system PATH has been correctly propagated to Poetry).

diff --git a/tests/fixtures/poetry_outdated_lockfile/poetry.lock b/tests/fixtures/poetry_outdated_lockfile/poetry.lock
diff --git a/tests/fixtures/poetry_outdated_lockfile/pyproject.toml b/tests/fixtures/poetry_outdated_lockfile/pyproject.toml
@@ -2,7 +2,7 @@
 package-mode = false
 
 [tool.poetry.dependencies]
-python = "^3.12"
+python = "^3.13"
 
 # This dependency isn't in the lockfile.
 typing-extensions = "*"
diff --git a/tests/pip_test.rs b/tests/pip_test.rs
@@ -39,7 +39,7 @@ fn pip_basic_install_and_cache_reuse() {
                 Successfully installed typing-extensions-4.12.2
                 
                 ## Testing buildpack ##
-                CPATH=/layers/heroku_python/venv/include:/layers/heroku_python/python/include/python3.12:/layers/heroku_python/python/include
+                CPATH=/layers/heroku_python/venv/include:/layers/heroku_python/python/include/python3.13:/layers/heroku_python/python/include
                 LANG=C.UTF-8
                 LD_LIBRARY_PATH=/layers/heroku_python/venv/lib:/layers/heroku_python/python/lib:/layers/heroku_python/pip/lib
                 LIBRARY_PATH=/layers/heroku_python/venv/lib:/layers/heroku_python/python/lib:/layers/heroku_python/pip/lib
@@ -55,16 +55,16 @@ fn pip_basic_install_and_cache_reuse() {
                 VIRTUAL_ENV=/layers/heroku_python/venv
                 
                 ['',
-                 '/layers/heroku_python/python/lib/python312.zip',
-                 '/layers/heroku_python/python/lib/python3.12',
-                 '/layers/heroku_python/python/lib/python3.12/lib-dynload',
-                 '/layers/heroku_python/venv/lib/python3.12/site-packages']
+                 '/layers/heroku_python/python/lib/python313.zip',
+                 '/layers/heroku_python/python/lib/python3.13',
+                 '/layers/heroku_python/python/lib/python3.13/lib-dynload',
+                 '/layers/heroku_python/venv/lib/python3.13/site-packages']
                 
-                pip {PIP_VERSION} from /layers/heroku_python/pip/lib/python3.12/site-packages/pip (python 3.12)
+                pip {PIP_VERSION} from /layers/heroku_python/pip/lib/python3.13/site-packages/pip (python 3.13)
                 Package           Version
                 ----------------- -------
                 typing_extensions 4.12.2
-                <module 'typing_extensions' from '/layers/heroku_python/venv/lib/python3.12/site-packages/typing_extensions.py'>
+                <module 'typing_extensions' from '/layers/heroku_python/venv/lib/python3.13/site-packages/typing_extensions.py'>
             "}
         );
 

diff --git a/tests/poetry_test.rs b/tests/poetry_test.rs
@@ -19,9 +19,7 @@ fn poetry_basic_install_and_cache_reuse() {
             context.pack_stdout,
             &formatdoc! {"
                 [Determining Python version]
-                No Python version specified, using the current default of Python {DEFAULT_PYTHON_VERSION}.
-                We recommend setting an explicit version. In the root of your app create
-                a '.python-version' file, containing a Python version like '{DEFAULT_PYTHON_VERSION}'.
+                Using Python version {DEFAULT_PYTHON_VERSION} specified in .python-version
                 
                 [Installing Python]
                 Installing Python {DEFAULT_PYTHON_FULL_VERSION}
@@ -39,7 +37,7 @@ fn poetry_basic_install_and_cache_reuse() {
                   - Installing typing-extensions (4.12.2)
                 
                 ## Testing buildpack ##
-                CPATH=/layers/heroku_python/venv/include:/layers/heroku_python/python/include/python3.12:/layers/heroku_python/python/include
+                CPATH=/layers/heroku_python/venv/include:/layers/heroku_python/python/include/python3.13:/layers/heroku_python/python/include
                 LANG=C.UTF-8
                 LD_LIBRARY_PATH=/layers/heroku_python/venv/lib:/layers/heroku_python/python/lib:/layers/heroku_python/poetry/lib
                 LIBRARY_PATH=/layers/heroku_python/venv/lib:/layers/heroku_python/python/lib:/layers/heroku_python/poetry/lib
@@ -52,14 +50,14 @@ fn poetry_basic_install_and_cache_reuse() {
                 VIRTUAL_ENV=/layers/heroku_python/venv
                 
                 ['',
-                 '/layers/heroku_python/python/lib/python312.zip',
-                 '/layers/heroku_python/python/lib/python3.12',
-                 '/layers/heroku_python/python/lib/python3.12/lib-dynload',
-                 '/layers/heroku_python/venv/lib/python3.12/site-packages']
+                 '/layers/heroku_python/python/lib/python313.zip',
+                 '/layers/heroku_python/python/lib/python3.13',
+                 '/layers/heroku_python/python/lib/python3.13/lib-dynload',
+                 '/layers/heroku_python/venv/lib/python3.13/site-packages']
                 
                 Poetry (version {POETRY_VERSION})
                 typing-extensions 4.12.2 Backported and Experimental Type Hints for Python ...
-                <module 'typing_extensions' from '/layers/heroku_python/venv/lib/python3.12/site-packages/typing_extensions.py'>
+                <module 'typing_extensions' from '/layers/heroku_python/venv/lib/python3.13/site-packages/typing_extensions.py'>
             "}
         );
 
@@ -94,9 +92,7 @@ fn poetry_basic_install_and_cache_reuse() {
                 rebuild_context.pack_stdout,
                 &formatdoc! {"
                     [Determining Python version]
-                    No Python version specified, using the current default of Python {DEFAULT_PYTHON_VERSION}.
-                    We recommend setting an explicit version. In the root of your app create
-                    a '.python-version' file, containing a Python version like '{DEFAULT_PYTHON_VERSION}'.
+                    Using Python version {DEFAULT_PYTHON_VERSION} specified in .python-version
                     
                     [Installing Python]
                     Using cached Python {DEFAULT_PYTHON_FULL_VERSION}
@@ -129,9 +125,7 @@ fn poetry_cache_invalidation_package_manager_changed() {
                 rebuild_context.pack_stdout,
                 &formatdoc! {"
                     [Determining Python version]
-                    No Python version specified, using the current default of Python {DEFAULT_PYTHON_VERSION}.
-                    We recommend setting an explicit version. In the root of your app create
-                    a '.python-version' file, containing a Python version like '{DEFAULT_PYTHON_VERSION}'.
+                    Using Python version {DEFAULT_PYTHON_VERSION} specified in .python-version
                     
                     [Installing Python]
                     Using cached Python {DEFAULT_PYTHON_FULL_VERSION}
@@ -160,7 +154,7 @@ fn poetry_cache_invalidation_package_manager_changed() {
 fn poetry_cache_previous_buildpack_version() {
     let mut config = default_build_config("tests/fixtures/poetry_basic");
     config.buildpacks([BuildpackReference::Other(
-        "docker://docker.io/heroku/buildpack-python:0.17.0".to_string(),
+        "docker://docker.io/heroku/buildpack-python:0.19.0".to_string(),
     )]);
     let rebuild_config = default_build_config("tests/fixtures/poetry_basic");
 
@@ -171,13 +165,11 @@ fn poetry_cache_previous_buildpack_version() {
                 rebuild_context.pack_stdout,
                 &formatdoc! {"
                     [Determining Python version]
-                    No Python version specified, using the current default of Python {DEFAULT_PYTHON_VERSION}.
-                    We recommend setting an explicit version. In the root of your app create
-                    a '.python-version' file, containing a Python version like '{DEFAULT_PYTHON_VERSION}'.
+                    Using Python version {DEFAULT_PYTHON_VERSION} specified in .python-version
                     
                     [Installing Python]
-                    Discarding cached Python 3.12.5 since:
-                     - The Python version has changed from 3.12.5 to {DEFAULT_PYTHON_FULL_VERSION}
+                    Discarding cached Python 3.13.0 since:
+                     - The Python version has changed from 3.13.0 to {DEFAULT_PYTHON_FULL_VERSION}
                     Installing Python {DEFAULT_PYTHON_FULL_VERSION}
                     
                     [Installing Poetry]