Migrate to uv

Author: evroon

.github/workflows/backend.yml

@@ -27,22 +27,18 @@ jobs:
         with:
           python-version: '3.12'
 
-      - name: Install pipenv
-        run: python3 -m pip install --upgrade pipenv wheel virtualenv
+      - name: Install uv
+        run: python3 -m pip install --upgrade uv wheel virtualenv
         working-directory: backend
 
-      - id: cache-pipenv
+      - id: cache-uv
         uses: actions/cache@v4
         with:
           path: ~/.local/share/virtualenvs
-          key: ${{ runner.os }}-pipenv-${{ hashFiles('**/Pipfile.lock') }}
-
-      - name: Install dependencies
-        run: pipenv install -d
-        working-directory: backend
+          key: ${{ runner.os }}-uv-${{ hashFiles('**/Pipfile.lock') }}
 
       - name: Run tests
-        run: pipenv run pytest --cov --cov-report=xml .
+        run: uv run pytest --cov --cov-report=xml .
         working-directory: backend
         env:
           ENVIRONMENT: CI
@@ -53,21 +49,21 @@ jobs:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
       - name: Run mypy
-        run: pipenv run mypy --version && pipenv run mypy .
+        run: uv run mypy --version && uv run mypy .
         working-directory: backend
 
       - name: Run pylint
-        run: pipenv run pylint bracket tests cli.py
+        run: uv run pylint bracket tests cli.py
         working-directory: backend
 
       - name: Run ruff format
-        run: pipenv run ruff format --check .
+        run: uv run ruff format --check .
         working-directory: backend
 
       - name: Run ruff
-        run: pipenv run ruff check .
+        run: uv run ruff check .
         working-directory: backend
 
       - name: Run vulture
-        run: '! pipenv run vulture |grep "unused function\|unused class\|unused method"'
+        run: '! uv run vulture |grep "unused function\|unused class\|unused method"'
         working-directory: backend

README.md

@@ -90,7 +90,7 @@ be able to view bracket at http://localhost:3000. You can log in with the follow
 
 To insert dummy rows into the database, run:
 ```bash
-sudo docker exec bracket-backend pipenv run ./cli.py create-dev-db
+sudo docker exec bracket-backend uv run ./cli.py create-dev-db
 ```
 
 See also the [quickstart docs](https://docs.bracketapp.nl/docs/running-bracket/quickstart).
@@ -109,12 +109,12 @@ The frontend doesn't can be configured by environment variables as well, as well
 # Running Bracket in production
 Read the [deployment docs](https://docs.bracketapp.nl/docs/deployment) for how to deploy Bracket and run it in production.
 
-Bracket can be run in Docker or by itself (using `pipenv` and `yarn`).
+Bracket can be run in Docker or by itself (using `uv` and `yarn`).
 
 # Development setup
 Read the [development docs](https://docs.bracketapp.nl/docs/community/development) for how to run Bracket for development.
 
-Prerequisites are `yarn`, `postgresql` and `pipenv` to run the frontend, database and backend.
+Prerequisites are `yarn`, `postgresql` and `uv` to run the frontend, database and backend.
 
 # Translations
 Based on your browser settings, your language should be automatically detected and loaded. For now,

backend/Dockerfile

@@ -2,7 +2,7 @@ FROM python:3.12-alpine3.17
 ARG packages
 RUN apk --update add ${packages} \
     && rm -rf /var/cache/apk/* \
-    && pip3 install --upgrade pip pipenv wheel virtualenv
+    && pip3 install --upgrade pip uv wheel virtualenv
 
 COPY . /app
 WORKDIR /app
@@ -13,16 +13,16 @@ RUN addgroup --system bracket && adduser --system bracket --ingroup bracket \
 USER bracket
 
 RUN set -ex \
-    && pip3 install --upgrade pip pipenv wheel virtualenv \
-    && pipenv install --deploy
+    && pip3 install --upgrade pip uv wheel virtualenv \
+    && uv install --deploy
 
 EXPOSE 8400
 
 HEALTHCHECK --interval=10s --timeout=5s --retries=5 \
     CMD ["wget", "--spider", "http://localhost:8400/ping", "||", "exit", "1"]
 
 CMD [ \
-    "pipenv", \
+    "uv", \
     "run", \
     "gunicorn", \
     "-k", "uvicorn.workers.UvicornWorker", \

backend/Pipfile

@@ -1,3 +1,36 @@
+[project]
+name = "Bracket backend"
+version = "0.0.1"
+requires-python = ">=3.12"
+dependencies = [
+    "aiofiles==24.1.0",
+    "aiohttp==3.12.2",
+    "aiopg==1.4.0",
+    "alembic==1.16.1",
+    "bcrypt==4.3.0",
+    "click==8.2.0",
+    "databases[asyncpg]<=0.8.0",
+    "fastapi==0.116.0",
+    "fastapi-sso==0.18.0",
+    "gunicorn==23.0.0",
+    "heliclockter==2.0.0",
+    "parameterized==0.9.0",
+    "passlib==1.7.4",
+    "pydantic==2.11.1",
+    "pydantic_settings==2.1.0",
+    "pyjwt==2.10.1",
+    "python-dotenv==1.1.0",
+    "python-multipart==0.0.20",
+    "sentry-sdk==2.35.0",
+    "sqlalchemy==1.4.54",
+    "sqlalchemy-stubs==0.4",
+    "starlette==0.46.2",
+    "types-aiofiles==24.1.0.20241221",
+    "types-passlib==1.7.7.20241221",
+    "types-simplejson==3.20.0.20250218",
+    "uvicorn==0.35.0",
+]
+
 [tool.pytest.ini_options]
 addopts = [
     '--junitxml=.junit_report.xml',
@@ -14,10 +47,20 @@ filterwarnings = [
     'ignore:.*The event_loop fixture provided by pytest-asyncio has been redefined.*:DeprecationWarning',
     'ignore:.*Please use `import python_multipart` instead.*:PendingDeprecationWarning',
 ]
-# Enable these once `asyncio_default_test_loop_scope` has been released
-# Then remove the `@pytest.mark.asyncio(loop_scope="session")` calls.
-#asyncio_default_fixture_loop_scope = "session"
-#asyncio_default_test_loop_scope = "session"
+
+[dependency-groups]
+dev = [
+    "aioresponses==0.7.4",
+    "mypy==1.17.0",
+    "pluggy==1.6.0",
+    "pylint==3.3.1",
+    "pytest==8.4.0",
+    "pytest-asyncio==1.1.0",
+    "pytest-cov==6.2.0",
+    "pytest-xdist==3.8.0",
+    "ruff==0.12.2",
+    "vulture==2.14",
+]
 
 [tool.mypy]
     junit_xml = '.junit_report.xml'
@@ -38,13 +81,19 @@ filterwarnings = [
     no_implicit_reexport = true
     show_error_codes = true
 
+[tool.uv]
+package = false
+
+[[tool.uv.index]]
+name = "pypi"
+url = "https://pypi.org/simple"
+
 [tool.pydantic-mypy]
 init_forbid_extra = true
 init_typed = true
 warn_required_dynamic_aliases = true
 warn_untyped_fields = true
 
-# Per-module options:
 [[tool.mypy.overrides]]
 module = ['aioresponses.*']
 disallow_any_explicit = false

backend/pyproject.toml

@@ -35,7 +35,7 @@ The database URL can be specified per environment in the `.env` files (see
 
 ## Running the frontend and backend
 
-To run Bracket (frontend and backend) locally without Docker, one needs `yarn` and `pipenv`.
+To run Bracket (frontend and backend) locally without Docker, one needs `yarn` and `uv`.
 
 The following starts the frontend and backend for local development in the root
 directory of Bracket:
@@ -63,8 +63,8 @@ yarn run dev
 
 ```bash
 cd backend
-pipenv install -d
-pipenv shell
+uv install -d
+uv shell
 ./run.sh
 ```
 

docs/content/community/development.mdx

@@ -46,7 +46,7 @@ job "bracket-backend" {
       config {
         image   = "ghcr.io/evroon/bracket-backend"
         ports   = ["uvicorn"]
-        command = "pipenv"
+        command = "uv"
         args    = [
           "run",
           "uvicorn",

docs/content/deployment/nomad.mdx

@@ -6,7 +6,7 @@ function run_frontend() {
 }
 
 function run_backend() {
-  cd backend && ENVIRONMENT=DEVELOPMENT pipenv run gunicorn \
+  cd backend && ENVIRONMENT=DEVELOPMENT uv run gunicorn \
       -k bracket.uvicorn.RestartableUvicornWorker \
       bracket.app:app \
       --bind localhost:8400 \