build: migrate from poetry to uv (#37)

Author: sdn4z

.github/dependabot.yml

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

.github/workflows/conventional-label.yaml

@@ -1,11 +1,11 @@
 on:
   pull_request_target:
-    types: [ opened, edited ]
+    types: [opened, edited]
 name: conventional-release-labels
 jobs:
   label:
     runs-on: ubuntu-latest
     steps:
       - uses: bcoe/conventional-release-labels@v1
         with:
-          type_labels: '{"feat": "feature", "fix": "fix", "breaking": "breaking", "ci": "CI"}'
+          type_labels: '{"feat": "feature", "fix": "fix", "breaking": "breaking", "ci": "CI", "build": "build", "refactor": "refactor"}'

.github/workflows/lint.yml

@@ -14,22 +14,18 @@ jobs:
     if: "!startsWith(github.event.head_commit.message, 'bump:')"
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python 3.13
-        uses: actions/setup-python@v4
-        with:
-          python-version: "3.13"
 
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install poetry
-          poetry install --with test,lint
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Install the project
+        run: uv sync --locked --extra lint --extra test
 
       - name: Lint
         run: |
-          poetry run ruff format --check src tests eval
-          poetry run ruff check src tests eval 
-          poetry run mypy src tests eval
+          uv run ruff format --check src tests eval
+          uv run ruff check src tests eval 
+          uv run mypy src tests eval
 
   lint-commit:
     runs-on: ubuntu-latest

.github/workflows/security.yml

@@ -29,13 +29,3 @@ jobs:
       - name: Run Semgrep
         run: |
           semgrep scan --config auto
-  twyn:
-    runs-on: ubuntu-latest
-    if: "!startsWith(github.event.head_commit.message, 'bump:')"
-    container:
-      image: elementsinteractive/twyn:v2.8.28
-    steps:
-      - uses: actions/checkout@v4
-      - name: Run Twyn against our dependencies
-        run: |
-          twyn run -vv

.github/workflows/test.yml

@@ -14,17 +14,12 @@ jobs:
     if: "!startsWith(github.event.head_commit.message, 'bump:')"
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: "3.13"
 
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install poetry
-          poetry install --with test
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
 
-      - name: Test with pytest
-        run: |
-          poetry run pytest
+      - name: Install the project
+        run: uv sync --locked --extra test
+
+      - name: Run tests
+        run: uv run pytest tests

.pre-commit-config.yaml

@@ -1,33 +1,33 @@
 default_install_hook_types: [pre-push, pre-commit]
 default_stages:
-  - "push"
+    - "push"
 repos:
--   repo: local
-    hooks:
-    -   id: lint
-        name: Lint Code
-        entry: "just lint"
-        language: system
-        pass_filenames: false
-    -   id: spell-check
-        name: Spell Checking Docs
-        entry: "just spellcheck"
-        language: system
-        pass_filenames: false
-    -   id: lint-commit
-        name: Lint Commits
-        entry: "just lint-commit"
-        language: system
-        pass_filenames: false
-    -   id: poetry-check
-        name: Poetry lock Consistency
-        entry: "poetry lock --check"
-        language: system
-        pass_filenames: false
-    -   id: format-code
-        name: Format Code
-        entry: "just format"
-        language: system
-        files: .*\.py$
-        stages:
-          - "commit"
+    - repo: local
+      hooks:
+          - id: lint
+            name: Lint Code
+            entry: "just lint"
+            language: system
+            pass_filenames: false
+          - id: spell-check
+            name: Spell Checking Docs
+            entry: "just spellcheck"
+            language: system
+            pass_filenames: false
+          - id: lint-commit
+            name: Lint Commits
+            entry: "just lint-commit"
+            language: system
+            pass_filenames: false
+          - id: uv-check
+            name: uv lock Consistency
+            entry: "uv sync --frozen"
+            language: system
+            pass_filenames: false
+          - id: format-code
+            name: Format Code
+            entry: "just format"
+            language: system
+            files: .*\.py$
+            stages:
+                - "commit"

Dockerfile

@@ -8,6 +8,7 @@ ARG USER=lightman
 ARG GROUP=lightman
 ARG WORKDIR=/app
 ARG VENV_PATH=${WORKDIR}/.venv
+ARG BIN_PATH=${VENV_PATH}/bin
 
 WORKDIR ${WORKDIR}
 
@@ -19,52 +20,46 @@ RUN groupadd -g 1001 ${GROUP} && \
 FROM base AS build
 
 # Define stage variables
-ARG POETRY_VERSION=2.1.2
-ARG POETRY_PLUGIN_EXPORT_VERSION=1.9.0
-
-# These should never change, define as ENV
-ENV POETRY_HOME="/opt/poetry"
-ENV PATH="${POETRY_HOME}/bin:${PATH}"
-
-# Create venv and upgrade pip
-RUN python -m venv ${VENV_PATH} && \
-    ${VENV_PATH}/bin/pip install --no-cache-dir --upgrade pip 
-
+ARG UV_VERSION 0.8.0
+# Install curl for uv installation
 RUN apt-get update && apt-get install -y --no-install-recommends \
     curl \
     && rm -rf /var/lib/apt/lists/*
 
-RUN pip install poetry==2.1.2
-RUN poetry self add poetry-plugin-export==${POETRY_PLUGIN_EXPORT_VERSION}
+ADD https://astral.sh/uv/install.sh /uv-installer.sh
 
-# Copy all the needed files, without write permissions
-COPY poetry.lock pyproject.toml ./
+# Run the installer then remove it
+RUN curl -LsSf https://astral.sh/uv/${UV_VERSION}/install.sh | sh
 
-# Export dependencies to requirements.txt (no dev deps)
-RUN poetry export --without-hashes --only main -f requirements.txt > requirements.txt
+# Ensure the installed binary is on the `PATH`
+ENV PATH="/root/.local/bin/:$PATH"
 
-# Create and install dependencies in the virtual env
-RUN ${VENV_PATH}/bin/pip install --no-cache-dir -r requirements.txt
+# Copy dependency files
+COPY uv.lock pyproject.toml ./
 
+# Install dependencies using uv (only dependencies, not the project itself)
+RUN UV_PROJECT_ENVIRONMENT=${VENV_PATH} uv sync --frozen --no-install-project
+RUN ${BIN_PATH}/python -m ensurepip
 # --------------- `final` stage --------------- 
 FROM base AS final
 
 # Set non-root user and group
 USER ${USER}:${GROUP}
 
-# Copy over the virtual environment with all its dependencies and the project installed
-COPY --from=build ${WORKDIR}/requirements.txt requirements.txt
-ENV PATH="${VENV_PATH}/bin:$PATH"
-
-# Copy venv with all its dependencies along with pyproject.toml
+# Copy the virtual environment from build stage 
 COPY --from=build --chown=${USER}:${GROUP} ${VENV_PATH} ${VENV_PATH}
+
+# Set PATH to use the virtual environment
+ENV PATH="${BIN_PATH}:$PATH"
+
+# Copy pyproject.toml for package metadata
 COPY --from=build --chown=${USER}:${GROUP} ${WORKDIR}/pyproject.toml .
 
 COPY README.md README.md
 # Copy source code
 COPY src src
 
-# Install the CLI tool
-RUN $VENV_PATH/bin/pip install --no-cache-dir .
+# Install the CLI tool (dependencies already installed in venv)
+RUN ${BIN_PATH}/pip3 install --no-deps .
 
-ENTRYPOINT [ "lightman" ]
+ENTRYPOINT [ "lightman-ai" ]

justfile

@@ -1,67 +1,39 @@
-
 # VARIABLE DEFINITIONS
 venv := ".venv"
-bin := venv + "/bin"
-python_version := "python3.13"
-run := "poetry run"
-target_dirs := "src tests eval"
-eval_path := "eval/cli.py"
-# SENTINELS
-venv-exists := path_exists(venv)
+python_version :="3.13"
+
 
-# RECIPES
+target_dirs := "src tests"
 
-# Shows list of recipes.
+# ALIASES
+alias t := test
 help:
     just --list --unsorted
 
-# Generate the virtual environment.
-venv:
-    @if ! {{ venv-exists }}; \
-    then \
-    POETRY_VIRTUALENVS_IN_PROJECT=1 poetry env use {{ python_version }}; \
-    poetry install; \
-    fi
+# Cleans all artifacts generated while running this project, including the virtualenv.
+venv: 
+    @uv sync --group test --group lint --group local
+
 
 # Cleans all artifacts generated while running this project, including the virtualenv.
 clean:
     @rm -f .coverage*
     @rm -rf {{ venv }}
 
-# Runs the evaluation script
-eval *args: venv
-    PYTHONPATH=. {{ run }} python {{ eval_path }} {{ args }}
-
-alias t := test
 # Runs the tests with the specified arguments (any path or pytest argument).
-test *test-args='': venv
-    {{ run }} pytest {{ test-args }} --no-cov
+test *test-args='': 
+    uv run pytest {{ test-args }} --no-cov 
 
 # Runs all tests including coverage report.
-test-all: venv
-    {{ run }} pytest
+test-all: 
+    uv run pytest
 
 # Format all code in the project.
-format *files=target_dirs: venv
-    {{ run }} ruff check {{ files }} --fix
-    {{ run }} ruff format {{ files }}
+format:  
+    uv run ruff check {{ target_dirs }} --fix
 
 # Lint all code in the project.
-lint report="false": venv
-    {{ run }} ruff format --check {{ target_dirs }}
-    {{ run }} ruff check {{ target_dirs }} {{ if report == "true" { "--output-format gitlab > tests/gl-code-quality-report.json" } else { "" } }}
-    {{ run }} mypy {{ target_dirs }}
-
-# Runs pre-commit with the given arguments (defaults to install).
-pre-commit *precommit-args="install": venv
-    {{ run }} pre-commit {{ precommit-args }}
-
-# Spellchecks your markdown files.
-spellcheck *codespell-args: venv
-    {{ run }} codespell {{ codespell-args }} **/*.md
-
-# Lints commit messages according to conventional commit rules.
-lint-commit: venv
-    {{ run }} cz check --rev-range main..HEAD
-
+lint: 
+    uv run ruff check {{ target_dirs }}
+    uv run mypy {{ target_dirs }}
 

lgtm.toml

@@ -1,6 +1,6 @@
 technologies = ["Python"]
 categories = ["Correctness", "Quality", "Testing", "Security"]
-exclude = ["*.md", "poetry.lock", "eval/classified_articles.py"]
+exclude = ["*.md", "uv.lock", "eval/classified_articles.py"]
 model = "gemini-2.5-pro-preview-*"
 silent = false
 publish = true