feat: Migrate package manager to uv

.circleci/config.yml

@@ -1,9 +1,9 @@
 version: 2.1
 
 jobs:
-  test:
+  static-checks:
     docker:
-      - image: cimg/python:3.13.7
+      - image: cimg/python:3.14
     steps:
       - checkout
       - run:
@@ -13,19 +13,45 @@ jobs:
             git submodule update --remote
       - run:
           name: Install deps
-          command: make dev-install
+          command: make install
       - run:
-          name: Linting
+          name: Format Check
           command: make format-check
+      - run:
+          name: Generate OpenAPI schema
+          command: make openapi-generate
+
+  run-tests:
+    parameters:
+      python_version:
+        type: string
+    docker:
+      - image: cimg/python:<< parameters.python_version >>
+    steps:
+      - checkout
+      - run:
+          name: Pull Submodules
+          command: |
+            git submodule init
+            git submodule update --remote
+      - run:
+          name: Install deps
+          command: make install
       - run:
           name: Run tests
           command: make test
+
+  test:
+    docker:
+      - image: cimg/base:stable
+    steps:
       - run:
-          name: Generate OpenAPI schema
-          command: make openapi-generate
+          name: All tests passed
+          command: echo "All matrix tests completed successfully"
+
   build:
     docker:
-      - image: cimg/python:3.13.7
+      - image: cimg/python:3.14
     steps:
       - checkout
       - run:
@@ -35,13 +61,14 @@ jobs:
             git submodule update --remote
       - run:
           name: Install deps
-          command: make install
+          command: make install-base
       - run:
           name: Run migrations
           command: make setup
       - run:
           name: Build database
           command: make build-db
+
   deploy:
     machine:
       image: ubuntu-2204:2024.11.1
@@ -64,10 +91,18 @@ workflows:
   version: 2
   test-and-deploy:
     jobs:
-      - test
+      - static-checks
+      - run-tests:
+          matrix:
+            parameters:
+              python_version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+      - test:
+          requires:
+            - run-tests
       - build
       - deploy:
           requires:
+            - static-checks
             - test
             - build
           filters:
@@ -77,11 +112,20 @@ workflows:
                 - staging
   weekly:
     jobs:
-      - test
+      - static-checks
+      - run-tests:
+          matrix:
+            parameters:
+              python_version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+      - test:
+          requires:
+            - run-tests
       - build
       - deploy:
           requires:
+            - static-checks
             - test
+            - build
     triggers:
       - schedule:
           cron: "0 0 * * 1"

.github/workflows/database.yml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: Lint
         run: |
           set -e
@@ -21,22 +21,37 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.11.19"
+          enable-cache: true
       - name: Generate OpenAPI schema
         run: |
-          make install
+          make install-base
           make openapi-generate
   sqlite:
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           submodules: recursive
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.11.19"
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
       - name: Start pokeapi
         run: |
-          make install
-          make migrate
+          make install-base
+          make setup
           make build-db
           nohup make serve &
           sleep 3
@@ -48,25 +63,23 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           submodules: recursive
-      - name: Build
+      - name: Build and start services
+        run: |
+          docker compose -f docker-compose.yml -f docker-compose-dev.yml up -d --build
+      - name: Run migrations and build database
         run: |
-          docker compose -f docker-compose.yml -f docker-compose-dev.yml up -d
           make docker-migrate
           make docker-build-db
       - name: Dump DB
-        run: docker compose exec -T -u postgres db sh -c "cd /tmp && pg_dump -h localhost -Fc -U ash -N 'hdb_*' pokeapi > pokeapi.dump"
-      - name: Copy dump
-        run: docker compose cp db:/tmp/pokeapi.dump ./
-      - name: Down services
-        run: docker compose -f docker-compose.yml -f docker-compose-dev.yml down -v
-      - name: Start services
-        run: docker compose -f docker-compose.yml -f docker-compose-dev.yml up -d
-      - name: Import database
+        run: docker compose exec -T db pg_dump -U ash -Fc -N 'hdb_*' pokeapi > pokeapi.dump
+      - name: Drop and recreate database
         run: |
-          docker compose cp ./pokeapi.dump db:/tmp/
-          docker compose exec -T -u postgres db sh -c "cd /tmp && pg_restore -h localhost -U ash -d pokeapi pokeapi.dump"
+          docker compose exec -T db psql -U ash -d postgres -c "DROP DATABASE pokeapi WITH (FORCE);"
+          docker compose exec -T db psql -U ash -d postgres -c "CREATE DATABASE pokeapi;"
+      - name: Import database
+        run: docker compose exec -T db pg_restore -U ash -d pokeapi < pokeapi.dump
       - name: Test data
         run: curl -Ss http://localhost/api/v2/pokemon/1/ | grep -q 'bulbasaur'

.github/workflows/docker-build-and-push.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           submodules: recursive
       - name: Docker meta
@@ -41,7 +41,7 @@ jobs:
           echo "Platforms: ${{ steps.buildx.outputs.platforms }}"
       - name: Build and push
         id: docker_build
-        uses: docker/build-push-action@v6
+        uses: docker/build-push-action@v7
         with:
           context: .
           file: ./Resources/docker/app/Dockerfile

.github/workflows/docker-k8s.yml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           submodules: recursive
       - name: Docker meta
@@ -37,7 +37,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           submodules: recursive
       - name: Docker meta
@@ -104,7 +104,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: Build dev environment
         run: |
           docker compose -f docker-compose.yml -f docker-compose-dev.yml up -d

.github/workflows/release.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           submodules: recursive
       - name: Start pokeapi (docker)
@@ -26,8 +26,8 @@ jobs:
           ls -larth
       - name: Start pokeapi
         run: |
-          make install
-          make migrate
+          make install-base
+          make setup
           make build-db
           nohup make serve &
           sleep 3

.python-version

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

Makefile

@@ -4,51 +4,54 @@ 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
+check-uv:
+	@command -v uv >/dev/null 2>&1 \
+		|| { \
+			echo >&2 "uv is not installed. Install it from: https://docs.astral.sh/uv/getting-started/installation/"; \
+			exit 1; \
+		}
+
+install: check-uv  # Install requirements for local development
+	uv sync --locked --all-extras --dev
 
-dev-install:  # Install developer requirements + base requirements
-	$(PIP) install -r test-requirements.txt
+install-base: check-uv  # Install minimal requirements for runtime/pipeline environments
+	uv sync --locked --no-dev
 
-setup:  # Set up the project database
-	$(PYTHON) manage.py migrate ${local_config}
+setup: check-uv   # Set up the project database
+	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}
+build-db: check-uv  # Build database
+	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}
+serve: check-uv   # Run the project locally
+	uv run manage.py runserver ${local_config}
 
-test:  # Run tests
-	$(PYTHON) manage.py test ${local_config}
+test: check-uv  # Run tests
+	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}
+migrate: check-uv   # Run any outstanding migrations
+	uv run manage.py migrate ${local_config}
 
-make-migrations:  # Create migrations files if schema has changed
-	$(PYTHON) manage.py makemigrations ${local_config}
+make-migrations: check-uv  # Create migrations files if schema has changed
+	uv run manage.py makemigrations ${local_config}
 
-shell:  # Load a shell
-	$(PYTHON) manage.py shell ${local_config}
+shell: check-uv  # Load a shell
+	uv run manage.py shell ${local_config}
 
-openapi-generate:
-	$(PYTHON) manage.py spectacular --color --file openapi.yml ${local_config}
+openapi-generate: check-uv
+	uv run manage.py spectacular --color --file openapi.yml ${local_config}
 
 docker-up:  # (Docker) Create services/volumes/networks
 	docker compose up -d
@@ -86,11 +89,11 @@ docker-prod:
 
 docker-setup: docker-up docker-migrate docker-build-db  # (Docker) Start services, prepare the latest DB schema, populate the DB
 
-format:  # Format the source code
-	black . --extend-exclude '.+/scripts/.+'
+format: check-uv   # Format the source code
+	uv run black . --extend-exclude '.+/scripts/.+'
 
-format-check:  # Check the source code has been formatted
-	black . --check --extend-exclude '.+/scripts/.+'
+format-check: check-uv  # Check the source code has been formatted
+	uv run black . --check --extend-exclude '.+/scripts/.+'
 
 pull:
 	git checkout master

README.md

@@ -37,8 +37,10 @@ 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
     # This will install all the required packages and libraries for using PokeAPI