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 ;-)

jelly · 2025-08-30T10:38:04Z

main/storage.py

 from django.core.files.base import ContentFile
 from django.utils.encoding import smart_str

-import cssmin


ruff check . is happy for me, why is the uv used ruff not?

Could it be that you are running a different version of ruff? We are installing the latest in the CI:

archweb/.github/workflows/main.yml

Line 19 in 59229f2

pip install -r requirements.txt && pip install -r requirements_test.txt && pip install ruff

This is one of the benefits of managing dependencies with uv, since we are now locking a particular version and making sure we always run that version, without having a separate requirements for each group.

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 ;-)

benmezger added 8 commits August 30, 2025 11:37

Replace pip with uv

ef1ed5c

Migrate Ruff settings

456eca8

Refactor Github action to use Ruff

ee8b5ea

Apply ruff check changes

985c4f5

Ensure Makefile runs with UV

617ffad

Add SMTP group

cf73476

Update README

56e3f32

Update Gitlab CI configuration

990f824

benmezger commented Aug 30, 2025

View reviewed changes

.gitlab-ci.yml Show resolved Hide resolved

jelly reviewed Aug 30, 2025

View reviewed changes

Remove .python-version and use toml instead

6634c9b

jelly reviewed Sep 1, 2025

View reviewed changes

		@@ -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!

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!

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!

Uh oh!

Replace `pip` with `uv` #579

Replace `pip` with `uv` #579

benmezger commented Aug 30, 2025 •

edited

Loading

benmezger commented Aug 31, 2025 •

edited

Loading