Use UV package manager

Context:

- Far more modern, easier environment management
- I have tested all makefile commands work

Author: phalt

.circleci/config.yml

@@ -13,7 +13,7 @@ jobs:
             git submodule update --remote
       - run:
           name: Install deps
-          command: make dev-install
+          command: make install
       - run:
           name: Linting
           command: make format-check

.python-version

@@ -0,0 +1 @@
+3.14

Makefile

@@ -4,51 +4,44 @@ docker_config = --settings=config.docker-compose
 gql_compose_config = -f docker-compose.yml -f Resources/compose/docker-compose-prod-graphql.yml
 gqlv1beta_compose_config = -f docker-compose.yml -f Resources/compose/docker-compose-prod-graphql.yml -f Resources/compose/docker-compose-prod-graphql-v1beta.yml
 
-# Auto-detect Python and pip commands
-PYTHON := $(shell which python3 2>/dev/null || which python 2>/dev/null || echo python3)
-PIP := $(shell which pip3 2>/dev/null || which pip 2>/dev/null || echo pip3)
-
 .PHONY: help
 .SILENT:
 
 help:
 	@grep -E '^[a-zA-Z_-]+:.*?# .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?# "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
 
 install:  # Install base requirements to run project
-	$(PIP) install -r requirements.txt
-
-dev-install:  # Install developer requirements + base requirements
-	$(PIP) install -r test-requirements.txt
+	uv sync
 
 setup:  # Set up the project database
-	$(PYTHON) manage.py migrate ${local_config}
+	uv run manage.py migrate ${local_config}
 
 build-db:  # Build database
-	echo "from data.v2.build import build_all; build_all()" | $(PYTHON) manage.py shell ${local_config}
+	echo "from data.v2.build import build_all; build_all()" | uv run manage.py shell ${local_config}
 
 wipe-sqlite-db:  # Delete's the project database
 	rm -rf db.sqlite3
 
 serve:  # Run the project locally
-	$(PYTHON) manage.py runserver ${local_config}
+	uv run manage.py runserver ${local_config}
 
 test:  # Run tests
-	$(PYTHON) manage.py test ${local_config}
+	uv run manage.py test ${local_config}
 
 clean:  # Remove any pyc files
 	find . -type f -name '*.pyc' -delete
 
 migrate:  # Run any outstanding migrations
-	$(PYTHON) manage.py migrate ${local_config}
+	uv run manage.py migrate ${local_config}
 
 make-migrations:  # Create migrations files if schema has changed
-	$(PYTHON) manage.py makemigrations ${local_config}
+	uv run manage.py makemigrations ${local_config}
 
 shell:  # Load a shell
-	$(PYTHON) manage.py shell ${local_config}
+	uv run manage.py shell ${local_config}
 
 openapi-generate:
-	$(PYTHON) manage.py spectacular --color --file openapi.yml ${local_config}
+	uv run manage.py spectacular --color --file openapi.yml ${local_config}
 
 docker-up:  # (Docker) Create services/volumes/networks
 	docker compose up -d

README.md

@@ -37,7 +37,9 @@ A RESTful API for Pokémon - [pokeapi.co](https://pokeapi.co)
 
 - Download this source code into a working directory, be sure to use the flag `--recurse-submodules` to clone also our submodules.
 
-- Install the requirements using pip:
+- Install [uv](https://docs.astral.sh/uv/getting-started/installation/) for Python environment management.
+
+- Install the requirements using the Makefile commands:
 
     ```sh
     make install

pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "pokeapi"
+version = "0.1.0"
+description = "The Pokemon API"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "coverage==7.13.1",
+    "django==5.2.10",
+    "django-cachalot==2.8.0",
+    "django-cors-headers==4.9.0",
+    "django-redis==6.0.0",
+    "djangorestframework==3.16.1",
+    "drf-spectacular==0.29.0",
+    "gunicorn==23.0.0",
+    "psycopg==3.3.2",
+    "ruff>=0.14.14",
+    "ty>=0.0.14",
+]