Modernize Python workflow for 3.13 and uv

.github/dependabot.yml

@@ -1,6 +1,6 @@
 version: 2
 updates:
-  - package-ecosystem: "pip"
+  - package-ecosystem: "uv"
     directory: "/"
     schedule:
       interval: "monthly"

.github/workflows/docs.yml

@@ -6,30 +6,33 @@ on:
     - main
   workflow_dispatch:
 
+  pull_request:
+
+permissions:
+  contents: read
+
 jobs:
   build:
     name: Build
     runs-on: ubuntu-latest
     steps:
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
-      - id: setup-python
-        name: Setup Python
-        uses: actions/setup-python@v5
+      - id: install-uv
+        name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
         with:
-          python-version: '3.11'
-          cache: 'pipenv'
-
-      - id: install-pipenv
-        name: Install pipenv
-        run: curl https://raw.githubusercontent.com/pypa/pipenv/master/get-pipenv.py | python
-        shell: bash
-
+          version: "0.11.29"
+          enable-cache: true
+
+      - id: install-python
+        name: Install Python
+        run: uv python install 3.13
       - id: install-python-dependencies
         name: Install Python dependencies
-        run: pipenv sync --dev
+        run: uv sync --all-groups --locked
         shell: bash
 
       - id: build-sphinx-documentation
@@ -73,4 +76,4 @@ jobs:
           dir: ./docs/
           should-cache: false
           use-accelerate-endpoint: false
-          public: true
+          public: true

.github/workflows/test.yaml

@@ -5,30 +5,32 @@ on:
   pull_request:
   workflow_dispatch:
 
+
+permissions:
+  contents: read
+
 jobs:
   build:
     name: Build
     runs-on: ubuntu-latest
     steps:
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
-      - id: setup-python
-        name: Setup Python
-        uses: actions/setup-python@v5
+      - id: install-uv
+        name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
         with:
-          python-version: '3.11'
-          cache: 'pipenv'
-
-      - id: install-pipenv
-        name: Install pipenv
-        run: curl https://raw.githubusercontent.com/pypa/pipenv/master/get-pipenv.py | python
-        shell: bash
-
+          version: "0.11.29"
+          enable-cache: true
+
+      - id: install-python
+        name: Install Python
+        run: uv python install 3.13
       - id: install-python-dependencies
         name: Install Python dependencies
-        run: pipenv sync --dev
+        run: uv sync --all-groups --locked
         shell: bash
 
       - id: build-sphinx-documentation
@@ -38,7 +40,7 @@ jobs:
 
       - id: upload-release-candidate
         name: Upload release candidate
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: release-candidate
           path: ./docs/_build/

.gitignore

@@ -76,7 +76,6 @@ target/
 .ipynb_checkpoints
 
 # pyenv
-.python-version
 
 # celery beat schedule file
 celerybeat-schedule

.python-version

@@ -0,0 +1 @@
+3.13

CONTRIBUTING.md

@@ -16,10 +16,10 @@ Change into the project directory:
 cd first-python-notebook
 ```
 
-Install the dependencies using pipenv:
+Install the dependencies using uv:
 
 ```bash
-pipenv install
+uv sync --all-groups
 ```
 
 ## Contributing

Makefile

@@ -59,8 +59,8 @@ endef
 # Python helpers
 #
 
-PIPENV := pipenv run
-PYTHON := python -W ignore -m
+UV := uv run
+PYTHON := $(UV) python -W ignore -m
 
 #
 # Commands
@@ -70,15 +70,15 @@ serve: ## Test the site
 	$(call banner,  🧪 Serving test site 🧪)
 	@rm -rf docs/_build
 	@rm -rf docs/jupyter_execute
-	@cd docs && $(PIPENV) make livehtml
+	@cd docs && $(UV) make livehtml
 
 
 build: ## Build a release candidate
 	$(call banner,🏗️ Building release candidate 🏗️)
-	@cd docs && pipenv run sphinx-build -b html src _build
+	@cd docs && uv run sphinx-build -b html src _build
 	@mkdir -p docs/_build/_extra/
 	@mkdir _dist/
-	@pipenv run jupyter lite build --contents ./jupyterlite/ --output-dir=./_dist/
+	@uv run jupyter lite build --contents ./jupyterlite/ --output-dir=./_dist/
 	@mv ./_dist/* docs/_build/_extra/
 
 #
@@ -87,7 +87,7 @@ build: ## Build a release candidate
 
 format: ## automatically format Python code with black
 	$(call banner,       🪥 Cleaning code 🪥)
-	@$(PIPENV) black .
+	@$(UV) black .
 
 
 help: ## Show this help. Example: make help