Migrate from pip/pip-tools to uv by Simrayz · Pull Request #1788 · Uninett/Argus

Simrayz · 2026-02-17T11:36:58Z

Scope and purpose

Fixes #1787.

Replaces pip, pip-tools, and venv with uv across CI, Docker, tox, and local dev setup.

This pull request

adds/changes/removes a dependency

Contributor Checklist

Added a changelog fragment for towncrier
Added/changed documentation, including updates to the user manual if feature flow or UI is considerably changed
Linted/formatted the code with ruff and djLint, easiest by using pre-commit
The first line of the commit message continues the sentence "If applied, this commit will ...", starts with a capital letter, does not end with punctuation and is 50 characters or less long. See our how-to

github-actions · 2026-02-17T11:39:12Z

Test results

6 files 954 suites 1m 56s ⏱️
729 tests 728 ✅ 1 💤 0 ❌
4 374 runs 4 368 ✅ 6 💤 0 ❌

Results for commit befd09d.

♻️ This comment has been updated with latest results.

codecov · 2026-02-17T11:39:25Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.58%. Comparing base (2b24f29) to head (befd09d).
⚠️ Report is 20 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1788   +/-   ##
=======================================
  Coverage   84.58%   84.58%           
=======================================
  Files         136      136           
  Lines        6630     6630           
=======================================
  Hits         5608     5608           
  Misses       1022     1022

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

hmpf · 2026-02-18T08:43:34Z

 ---------------------

-To generate a secret key to be used in the `cmd.sh` file one can use
+To generate a secret key to be used in the `.env` file one can use


How would I run with multiple sets of environment variables?

I don't use .env today, because I regularly use two different sets of environment variables, and frequently three when testing something.

Fair point :) My reasoning was to try to avoid creating custom "cmd.sh" script files instead of using the uv tooling. I can look into how we can support switching between different environments.

hmpf · 2026-02-18T08:45:43Z

 dev = [
    "django-debug-toolbar",
    "coverage",
    "django-extensions",
    "ruff",
    "djlint",
    "ipython",
    "pre-commit",
+    "pydotplus",
    "python-dotenv",
    "towncrier",
+    "unittest-xml-reporting",
    "werkzeug",
    "tox>=4",
    "build",  # for debugging builds/installs


It will probably be possible to switch to dependency groups instead, at least for dev.

hmpf · 2026-02-18T08:47:51Z

-We recommend using virtualenv or virtualenvwrapper to create
-a place to stash Argus' dependencies.


I will still need to be able to use virtualenvwrapper because I need to switch between different sets of dependencies...

Updated the text to mention this as an option.

hmpf · 2026-02-18T08:49:17Z

+    uv pip compile --no-strip-extras --output-file requirements-django52.txt {posargs} pyproject.toml requirements/django52.txt constraints.txt
+    uv pip compile --no-strip-extras --output-file requirements-django60.txt {posargs} pyproject.toml requirements/django60.txt constraints.txt


Phew! Multiple lock-files are important, oh yes.

Simrayz · 2026-02-20T10:20:13Z

I've pushed changes addressing your comments:

"Some of the rules" wording in makefile-rules docs
Removed prescriptive .env file reference in management-commands docs
Re-added mention of virtualenv/virtualenvwrapper as alternatives

I also added create-env and set-env Makefile rules to support switching between multiple environment configurations:

make create-env dev      # copy template -> .env.dev
make create-env test     # copy template -> .env.test
make set-env dev         # symlink .env.dev -> .env
make set-env             # list available environments

This should give a similar workflow to having multiple cmd.sh files.

lunkwill42

I support any initiative to move to the uv toolchain 👍

I'm not going to argue with how @hmpf wants to handle multiple sets of environment variables within Argus (in my head, this bit is specific to each developer).

What I do want to argue is that we should move also Argus' pyproject.toml to use proper dependency groups, rather than use project.optional-dependencies, since none of the dependencies listed in our project.optional-dependencies section are actually optional runtime dependencies. But that's a separate issue.

hmpf · 2026-02-25T13:48:48Z


    - name: Lint HTML
-      run: djlint --lint .
+      run: uvx djlint --lint .


.. is HTML linting happening twice?

No, the linting jobs run on separate runners, which requires setup for both

hmpf · 2026-02-25T13:50:41Z

+    - name: Set up uv
+      uses: astral-sh/setup-uv@v6


Uv is set up twice, once here to run HTML lint, then again after python is installed for everything else.

UV had to be setup twice as it was used in two different jobs, but I moved the linting job into the format workflow, as it naturally belongs with linting anyways.

hmpf · 2026-02-25T13:53:22Z


 .. note:: The development settings file assumes that the optional development
-   dependencies are installed. You can get them via ``pip install argus-server[dev]``.
+   dependencies are installed. You can get them via ``uv sync --extra dev``.


Won't this remove things in the venv that is not in the pyproject.toml/lock-file?

You're right, I changed it to use pip install again, as that will install what's defined in pyproject.toml

sonarqubecloud · 2026-03-02T10:13:16Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

Simrayz added dependencies Run `tox -r` before testing locally, dependencies have changed DevEx documentation Improvements or additions to documentation labels Feb 17, 2026

Simrayz self-assigned this Feb 17, 2026

Simrayz added the nonews No news fragment is necessary for this PR (e.g. refactoring, cleanups, workflow/development changes) label Feb 17, 2026

Simrayz force-pushed the chore/use-uv-for-environment-management branch from a4172e5 to 66a9689 Compare February 17, 2026 11:44

Simrayz removed the nonews No news fragment is necessary for this PR (e.g. refactoring, cleanups, workflow/development changes) label Feb 17, 2026

Simrayz force-pushed the chore/use-uv-for-environment-management branch 2 times, most recently from 421d983 to 5354f74 Compare February 17, 2026 11:48

hmpf reviewed Feb 18, 2026

View reviewed changes

Comment thread docs/development/makefile-rules.rst Outdated

Simrayz force-pushed the chore/use-uv-for-environment-management branch from c71412f to d77b0a0 Compare February 20, 2026 10:23

lunkwill42 approved these changes Feb 23, 2026

View reviewed changes

Simrayz marked this pull request as ready for review February 24, 2026 08:43

hmpf reviewed Feb 25, 2026

View reviewed changes

hmpf requested changes Feb 25, 2026

View reviewed changes

Simrayz force-pushed the chore/use-uv-for-environment-management branch from f898faf to a6779e7 Compare March 2, 2026 09:28

Simen Abelsen added 6 commits March 2, 2026 11:05

Use uv for tox and CI pipelines

201470f

Use uv in Dockerfiles and entrypoint

37c82b0

Improve local development setup with uv

08261c7

Address PR review comments on documentation

4b40b32

Add create-env and set-env Makefile rules

a1de8c9

Address remaining PR review feedback from hmpf

b5f8f4e

Move djlint lint check from python.yml to format.yml

befd09d

Simrayz requested a review from hmpf March 2, 2026 10:12

Simrayz force-pushed the chore/use-uv-for-environment-management branch from a1d322b to befd09d Compare March 2, 2026 10:12

hmpf added this to Argus development, public Mar 5, 2026

github-project-automation Bot moved this to 📋 Backlog in Argus development, public Mar 5, 2026

hmpf added the rc-next Prioritized candidate for next release label Mar 5, 2026

github-project-automation Bot moved this from 📋 Backlog to ♻ Changes requested in Argus development, public Mar 5, 2026

		We recommend using virtualenv or virtualenvwrapper to create
		a place to stash Argus' dependencies.

		uv pip compile --no-strip-extras --output-file requirements-django52.txt {posargs} pyproject.toml requirements/django52.txt constraints.txt
		uv pip compile --no-strip-extras --output-file requirements-django60.txt {posargs} pyproject.toml requirements/django60.txt constraints.txt

Conversation

Simrayz commented Feb 17, 2026

Scope and purpose

This pull request

Contributor Checklist

Uh oh!

github-actions Bot commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test results

Uh oh!

codecov Bot commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

hmpf Feb 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

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!

Simrayz commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

sonarqubecloud Bot commented Mar 2, 2026

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions Bot commented Feb 17, 2026 •

edited

Loading

codecov Bot commented Feb 17, 2026 •

edited

Loading

hmpf Feb 18, 2026 •

edited

Loading

Simrayz commented Feb 20, 2026 •

edited

Loading