Replace `pip` with `uv` #579

benmezger · 2025-08-30T10:19:48Z

I've been using UV in archweb to handle dependencies and venv management a little easier. Given that, I am opening a PR with the changes I made, in case you want to migrate from pip to UV.

I will take care of the infrastructure PR, so if one wants to merge this, it's better to wait for the infra PR.

benmezger · 2025-08-30T10:20:31Z

requirements_prod.txt

This has been moved to a UV dependency group instead.

Is that UV specific or an accepted Python PEP?

Looks like it was left out of scope when PEP-0621 was proposed. Poetry and UV move dependencies into groups, a default one that is always installed, along with optional groups of dependencies that we can install.

uv sync installs dependencies + dev dependencies
uv sync --no-dev install project dependencies without any development
uv sync --group prod installs dependencies + prod dependencies
etc.

This makes it easy for us to manage different scope of dependencies within the project

Digging through UV's documentation a little more, dependencies are specified using Python dependency specification, and it follows PEP-621 standard, but it seems the dependency grouping spec is mainly UV-specific from what I understood.

.gitlab-ci.yml

jelly

Cool, I'll have to give this a test spin. I am not entirely sure if I'll like uv (never used it before).

This also calls for us switching to dependabot, but not sure if that can bump the uv version in the github actions workflow.

jelly · 2025-08-30T10:35:44Z

.python-version

@@ -0,0 +1 @@
+3.13.0


Can't this be part of pyproject.toml?

It can. uv creates this by default, given some Python toolings read this file. I will remove this and keep it in pyproject.toml, then update workflow to revert to its original version selection.

Addressed in 6634c9b (#579)

jelly · 2025-08-30T10:36:29Z

requirements_prod.txt

Is that UV specific or an accepted Python PEP?

jelly · 2025-08-30T10:37:00Z

pyproject.toml

    "pytest>=8.4.1",
    "pytest-cov>=6.2.1",
    "pytest-django>=4.11.1",
+    "ruff>=0.12.11",


venv managed ruff :(

This will still be in venv. uv will only install this when we install dev dependencies (enabled by default). Before, we had to install this separately with pip.

Right, but I prefer system linters ;-)

main/storage.py

jelly · 2025-08-30T10:39:06Z

Makefile


 lint:
-	flake8 --extend-exclude "*/migrations/,local_settings.py" devel main mirrors news packages releng templates todolists visualize *.py
+	uv run flake8 --extend-exclude "*/migrations/,local_settings.py" devel main mirrors news packages releng templates todolists visualize *.py


should re-evaluate if ruff already has the formatting rules, or ugh ruff format I guess.

ruff actually replaces flake8, so we can technically get rid of this and have one tool to handle formatting/linting.

"replaces", not entirely most of the E1 rules are not yet implemented and if implemented are preview rules.

Anyway, this will be handled in a follow up by moving to ruff format

.gitlab-ci.yml

benmezger · 2025-08-30T14:40:50Z

This also calls for us switching to dependabot, but not sure if that can bump the uv version in the github actions workflow.

@jelly it can:

version: 2
enable-beta-ecosystems: true
updates:
  - package-ecosystem: "uv"
    directory: "/"
    schedule:
      interval: "daily"

lahwaacz · 2025-08-31T16:58:52Z

On August 30, 2025 2:41:12 PM UTC, Ben Mezger ***@***.***> wrote: benmezger left a comment (archlinux/archweb#579) > This also calls for us switching to dependabot, but not sure if that can bump the uv version in the github actions workflow. @jelly it [can](https://github.blog/changelog/2025-03-13-dependabot-version-updates-now-support-uv-in-general-availability/): ```yaml version: 2 enable-beta-ecosystems: true updates: - package-ecosystem: "uv" directory: "/" schedule: interval: "daily" ```

Can dependabot run on gitlab though?

benmezger · 2025-08-31T17:24:09Z

@lahwaacz I think Arch's Gitlab uses renovate, but I don't think it supports uv yet. But it seems Gitlab does support Dependabot.

lahwaacz · 2025-08-31T19:08:40Z

@benmezger renovate should already support uv: renovatebot/renovate#34494

jelly · 2025-09-01T08:11:39Z

.github/workflows/main.yml

+      uses: actions/setup-python@v5
      with:
-        python-version: 3.13
+        python-version: "3.13.0"


renovatebot/renovate#34494

jelly · 2025-09-01T09:15:27Z

Makefile


 lint:
-	flake8 --extend-exclude "*/migrations/,local_settings.py" devel main mirrors news packages releng templates todolists visualize *.py
+	uv run flake8 --extend-exclude "*/migrations/,local_settings.py" devel main mirrors news packages releng templates todolists visualize *.py


"replaces", not entirely most of the E1 rules are not yet implemented and if implemented are preview rules.

jelly · 2025-09-01T09:15:43Z

Makefile


 lint:
-	flake8 --extend-exclude "*/migrations/,local_settings.py" devel main mirrors news packages releng templates todolists visualize *.py
+	uv run flake8 --extend-exclude "*/migrations/,local_settings.py" devel main mirrors news packages releng templates todolists visualize *.py


Anyway, this will be handled in a follow up by moving to ruff format

jelly · 2025-09-01T09:39:54Z

mirrors/utils.py

    desc = cursor.description
    return [
-        dict(zip([col[0] for col in desc], row))
+        dict(zip([col[0] for col in desc], row, strict=False))


This seems to be a place where strict=True seems fine to use.

jelly · 2025-09-01T09:40:04Z

pyproject.toml

+[project]
+name = "archweb"
+version = "0.1.0"
+description = "Archlinux website code"


Arch Linux ;-)

jelly · 2025-09-01T09:40:29Z

pyproject.toml

    "pytest>=8.4.1",
    "pytest-cov>=6.2.1",
    "pytest-django>=4.11.1",
+    "ruff>=0.12.11",


Right, but I prefer system linters ;-)

Copilot

Pull request overview

This PR migrates the archweb project from pip to uv for dependency management, consolidating dependencies into a single pyproject.toml file and modernizing the development workflow.

Key Changes:

Replaced pip-based dependency files with uv's pyproject.toml and lock file
Updated all CI/CD workflows and documentation to use uv commands
Reorganized dependencies into logical groups (dev, prod, smtp)

Reviewed changes

Copilot reviewed 9 out of 11 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
pyproject.toml	Added project metadata and consolidated all dependencies with proper dependency groups for dev, prod, and smtp
uv.lock	Generated lock file containing all dependency metadata and version hashes
requirements.txt	Removed legacy pip requirements file
requirements_prod.txt	Removed legacy production requirements file
requirements_test.txt	Removed legacy test requirements file
README.md	Updated installation and usage instructions to use uv commands instead of pip
Makefile	Updated all commands to use `uv run` prefix
.gitlab-ci.yml	Migrated CI pipeline from pip to uv
.github/workflows/main.yml	Updated GitHub Actions workflow to use uv with setup-uv action
main/storage.py	Reordered imports (cssmin moved before jsmin)
devel/migrations/0012_alter_userprofile_social_alter_userprofile_time_zone.py	Auto-generated Django migration file

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-06T17:59:10Z

README.md


-        ./manage.py runserver
-
+        uv ./manage.py runserver


The command is missing the "run" keyword. It should be "uv run ./manage.py runserver" instead of "uv ./manage.py runserver".

Suggested change

uv ./manage.py runserver

uv run ./manage.py runserver

Copilot · 2026-01-06T17:59:11Z

README.md

-use virtualenv and pip to handle these. But if you insist on (Arch Linux)
-packages, you will probably want the following:
+You can look at the packages `archweb` uses by looking at the `pyproject.toml` file;
+it is best to use `uv` to handle these. If you insist on (Archlinux) packages, you


The spelling of "Archlinux" should be "Arch Linux" (with a space) for consistency with how it appears elsewhere in the documentation and the official project naming.

Suggested change

it is best to use `uv` to handle these. If you insist on (Archlinux) packages, you

it is best to use `uv` to handle these. If you insist on (Arch Linux) packages, you

benmezger commented Aug 30, 2025

View reviewed changes

.gitlab-ci.yml Show resolved Hide resolved

jelly reviewed Aug 30, 2025

View reviewed changes

jelly reviewed Sep 1, 2025

View reviewed changes

benmezger added 2 commits January 6, 2026 18:16

Replace pip with uv

cacc968

Migrate Ruff settings

2d847c7

Copilot AI review requested due to automatic review settings January 6, 2026 17:55

jelly force-pushed the replace-pip-uv branch from 6634c9b to b5aac63 Compare January 6, 2026 17:55

Copilot started reviewing on behalf of jelly January 6, 2026 17:56 View session

Copilot AI reviewed Jan 6, 2026

View reviewed changes

Apply ruff check changes

a99a57f

jelly force-pushed the replace-pip-uv branch from b5aac63 to 79cd598 Compare January 6, 2026 18:10

benmezger and others added 6 commits January 6, 2026 19:13

Refactor Github action to use Ruff

e6e4cb1

Ensure Makefile runs with UV

b589de1

Add SMTP group

8fed39a

Update README

7975f12

Update Gitlab CI configuration

c3f95d8

devel: update migration from django-countries 8.x

429b6b8

jelly force-pushed the replace-pip-uv branch from 79cd598 to 429b6b8 Compare January 6, 2026 19:00

	it is best to use `uv` to handle these. If you insist on (Archlinux) packages, you
	it is best to use `uv` to handle these. If you insist on (Arch Linux) packages, you

		@@ -0,0 +1 @@
		3.13.0

Uh oh!

Replace pip with uv #579

Are you sure you want to change the base?

Replace pip with uv #579

Uh oh!

Conversation

benmezger commented Aug 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jelly left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

benmezger commented Aug 30, 2025

Uh oh!

lahwaacz commented Aug 31, 2025 via email

Uh oh!

benmezger commented Aug 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lahwaacz commented Aug 31, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 6, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Replace `pip` with `uv` #579

Replace `pip` with `uv` #579

benmezger commented Aug 30, 2025 •

edited

Loading

benmezger commented Aug 31, 2025 •

edited

Loading