Merge pull request #135 from codecrafters-io/andy/upgrade-python

andy1li · web-flow · commit 6ebaaf9d6e36 · 2025-10-31T06:23:20.000+08:00
CC-2005: [Interpreter] [Python] Use uv and upgrade to 3.14
diff --git a/compiled_starters/python/.codecrafters/compile.sh b/compiled_starters/python/.codecrafters/compile.sh
@@ -6,4 +6,6 @@
 #
 # Learn more: https://codecrafters.io/program-interface
 
+set -e # Exit on failure
+
 # (This file is empty since Python programs don't use a compile step)
diff --git a/compiled_starters/python/.codecrafters/run.sh b/compiled_starters/python/.codecrafters/run.sh
@@ -6,4 +6,6 @@
 #
 # Learn more: https://codecrafters.io/program-interface
 
-exec pipenv run python3 -m app.main "$@"
+set -e # Exit on failure
+
+exec uv run --quiet -m app.main "$@"
diff --git a/compiled_starters/python/.gitignore b/compiled_starters/python/.gitignore
@@ -94,6 +94,12 @@ ipython_config.py
 #   install all needed dependencies.
 #Pipfile.lock
 
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
@@ -106,8 +112,10 @@ ipython_config.py
 #pdm.lock
 #   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
 #   in version control.
-#   https://pdm.fming.dev/#use-with-ide
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
 .pdm.toml
+.pdm-python
+.pdm-build/
 
 # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
 __pypackages__/
@@ -151,3 +159,16 @@ dmypy.json
 
 # Cython debug symbols
 cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
diff --git a/compiled_starters/python/.python-version b/compiled_starters/python/.python-version
@@ -0,0 +1 @@
+3.14
diff --git a/compiled_starters/python/Pipfile b/compiled_starters/python/Pipfile
diff --git a/compiled_starters/python/Pipfile.lock b/compiled_starters/python/Pipfile.lock
diff --git a/compiled_starters/python/README.md b/compiled_starters/python/README.md
@@ -43,7 +43,7 @@ Time to move on to the next stage!
 
 Note: This section is for stages 2 and beyond.
 
-1. Ensure you have `python (3.13)` installed locally
+1. Ensure you have `uv` installed locally
 2. Run `./your_program.sh` to run your program, which is implemented in
    `app/main.py`.
 3. Commit your changes and run `git push origin master` to submit your solution
diff --git a/compiled_starters/python/codecrafters.yml b/compiled_starters/python/codecrafters.yml
@@ -7,5 +7,5 @@ debug: false
 # Use this to change the Python version used to run your code
 # on Codecrafters.
 #
-# Available versions: python-3.13
-buildpack: python-3.13
+# Available versions: python-3.14
+buildpack: python-3.14
diff --git a/compiled_starters/python/pyproject.toml b/compiled_starters/python/pyproject.toml
@@ -0,0 +1,5 @@
+[project]
+name = "codecrafters-interpreter"
+version = "0.1.0"
+requires-python = ">=3.14"
+dependencies = []
diff --git a/compiled_starters/python/uv.lock b/compiled_starters/python/uv.lock
diff --git a/compiled_starters/python/your_program.sh b/compiled_starters/python/your_program.sh
@@ -12,4 +12,4 @@ set -e # Exit early if any commands fail
 #
 # - Edit this to change how your program runs locally
 # - Edit .codecrafters/run.sh to change how your program runs remotely
-exec pipenv run python3 -m app.main "$@"
+exec uv run --quiet -m app.main "$@"
diff --git a/dockerfiles/python-3.14.Dockerfile b/dockerfiles/python-3.14.Dockerfile
@@ -0,0 +1,18 @@
+# syntax=docker/dockerfile:1.7-labs
+FROM astral/uv:python3.14-alpine
+
+# Ensures the container is re-built if dependency files change
+ENV CODECRAFTERS_DEPENDENCY_FILE_PATHS="pyproject.toml,uv.lock"
+
+# Prevents Python from buffering stdout and stderr
+ENV PYTHONUNBUFFERED=1
+
+ENV PYTHONPATH=/app:$PYTHONPATH
+
+WORKDIR /app
+
+# .git & README.md are unique per-repository. We ignore them on first copy to prevent cache misses
+COPY --exclude=.git --exclude=README.md . /app
+
+# Force environment creation
+RUN uv sync
diff --git a/solutions/python/01-ry8/code/.codecrafters/compile.sh b/solutions/python/01-ry8/code/.codecrafters/compile.sh
@@ -6,4 +6,6 @@
 #
 # Learn more: https://codecrafters.io/program-interface
 
+set -e # Exit on failure
+
 # (This file is empty since Python programs don't use a compile step)
diff --git a/solutions/python/01-ry8/code/.codecrafters/run.sh b/solutions/python/01-ry8/code/.codecrafters/run.sh
@@ -6,4 +6,6 @@
 #
 # Learn more: https://codecrafters.io/program-interface
 
-exec pipenv run python3 -m app.main "$@"
+set -e # Exit on failure
+
+exec uv run --quiet -m app.main "$@"
diff --git a/solutions/python/01-ry8/code/.gitignore b/solutions/python/01-ry8/code/.gitignore
@@ -94,6 +94,12 @@ ipython_config.py
 #   install all needed dependencies.
 #Pipfile.lock
 
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
@@ -106,8 +112,10 @@ ipython_config.py
 #pdm.lock
 #   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
 #   in version control.
-#   https://pdm.fming.dev/#use-with-ide
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
 .pdm.toml
+.pdm-python
+.pdm-build/
 
 # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
 __pypackages__/
@@ -151,3 +159,16 @@ dmypy.json
 
 # Cython debug symbols
 cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
diff --git a/solutions/python/01-ry8/code/.python-version b/solutions/python/01-ry8/code/.python-version
@@ -0,0 +1 @@
+3.14
diff --git a/solutions/python/01-ry8/code/Pipfile b/solutions/python/01-ry8/code/Pipfile
diff --git a/solutions/python/01-ry8/code/Pipfile.lock b/solutions/python/01-ry8/code/Pipfile.lock
diff --git a/solutions/python/01-ry8/code/README.md b/solutions/python/01-ry8/code/README.md
@@ -43,7 +43,7 @@ Time to move on to the next stage!
 
 Note: This section is for stages 2 and beyond.
 
-1. Ensure you have `python (3.13)` installed locally
+1. Ensure you have `uv` installed locally
 2. Run `./your_program.sh` to run your program, which is implemented in
    `app/main.py`.
 3. Commit your changes and run `git push origin master` to submit your solution
diff --git a/solutions/python/01-ry8/code/codecrafters.yml b/solutions/python/01-ry8/code/codecrafters.yml
@@ -7,5 +7,5 @@ debug: false
 # Use this to change the Python version used to run your code
 # on Codecrafters.
 #
-# Available versions: python-3.13
-buildpack: python-3.13
+# Available versions: python-3.14
+buildpack: python-3.14
diff --git a/solutions/python/01-ry8/code/pyproject.toml b/solutions/python/01-ry8/code/pyproject.toml
@@ -0,0 +1,5 @@
+[project]
+name = "codecrafters-interpreter"
+version = "0.1.0"
+requires-python = ">=3.14"
+dependencies = []
diff --git a/solutions/python/01-ry8/code/uv.lock b/solutions/python/01-ry8/code/uv.lock
diff --git a/solutions/python/01-ry8/code/your_program.sh b/solutions/python/01-ry8/code/your_program.sh
@@ -12,4 +12,4 @@ set -e # Exit early if any commands fail
 #
 # - Edit this to change how your program runs locally
 # - Edit .codecrafters/run.sh to change how your program runs remotely
-exec pipenv run python3 -m app.main "$@"
+exec uv run --quiet -m app.main "$@"
diff --git a/starter_templates/python/code/.codecrafters/compile.sh b/starter_templates/python/code/.codecrafters/compile.sh
@@ -6,4 +6,6 @@
 #
 # Learn more: https://codecrafters.io/program-interface
 
+set -e # Exit on failure
+
 # (This file is empty since Python programs don't use a compile step)
diff --git a/starter_templates/python/code/.codecrafters/run.sh b/starter_templates/python/code/.codecrafters/run.sh
@@ -6,4 +6,6 @@
 #
 # Learn more: https://codecrafters.io/program-interface
 
-exec pipenv run python3 -m app.main "$@"
+set -e # Exit on failure
+
+exec uv run --quiet -m app.main "$@"
diff --git a/starter_templates/python/code/.gitignore b/starter_templates/python/code/.gitignore
@@ -94,6 +94,12 @@ ipython_config.py
 #   install all needed dependencies.
 #Pipfile.lock
 
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
@@ -106,8 +112,10 @@ ipython_config.py
 #pdm.lock
 #   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
 #   in version control.
-#   https://pdm.fming.dev/#use-with-ide
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
 .pdm.toml
+.pdm-python
+.pdm-build/
 
 # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
 __pypackages__/
@@ -151,3 +159,16 @@ dmypy.json
 
 # Cython debug symbols
 cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
diff --git a/starter_templates/python/code/.python-version b/starter_templates/python/code/.python-version
@@ -0,0 +1 @@
+3.14
diff --git a/starter_templates/python/code/Pipfile b/starter_templates/python/code/Pipfile
diff --git a/starter_templates/python/code/Pipfile.lock b/starter_templates/python/code/Pipfile.lock
diff --git a/starter_templates/python/code/pyproject.toml b/starter_templates/python/code/pyproject.toml
@@ -0,0 +1,5 @@
+[project]
+name = "codecrafters-interpreter"
+version = "0.1.0"
+requires-python = ">=3.14"
+dependencies = []
diff --git a/starter_templates/python/code/uv.lock b/starter_templates/python/code/uv.lock
diff --git a/starter_templates/python/config.yml b/starter_templates/python/config.yml

Original file line number	Diff line number	Diff line change
`@@ -6,4 +6,6 @@`
`6`	`6`	`#`
`7`	`7`	`# Learn more: https://codecrafters.io/program-interface`
`8`	`8`
	`9`	`+set -e # Exit on failure`
	`10`	`+`
`9`	`11`	`# (This file is empty since Python programs don't use a compile step)`
Original file line number	Diff line number	Diff line change
`@@ -6,4 +6,6 @@`
`6`	`6`	`#`
`7`	`7`	`# Learn more: https://codecrafters.io/program-interface`
`8`	`8`
`9`		`-exec pipenv run python3 -m app.main "$@"`
	`9`	`+set -e # Exit on failure`
	`10`	`+`
	`11`	`+exec uv run --quiet -m app.main "$@"`
Original file line number	Diff line number	Diff line change
`@@ -7,5 +7,5 @@ debug: false`
`7`	`7`	`# Use this to change the Python version used to run your code`
`8`	`8`	`# on Codecrafters.`
`9`	`9`	`#`
`10`		`-# Available versions: python-3.13`
`11`		`-buildpack: python-3.13`
	`10`	`+# Available versions: python-3.14`
	`11`	`+buildpack: python-3.14`