dev: migrate to uv (#584)

Author: onerandomusername

.dockerignore

@@ -5,5 +5,6 @@
 !alembic.ini
 !monty/
 !pyproject.toml
-!poetry.lock
+!uv.lock
 !LICENSE
+!LICENSE_THIRD_PARTY

.github/workflows/lint_test_build.yaml

@@ -30,6 +30,7 @@ jobs:
         env:
           RUFF_OUTPUT_FORMAT: "github"
 
+
   build:
     if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     name: Build & Push

.pre-commit-config.yaml

@@ -22,6 +22,11 @@ repos:
       - id: python-check-blanket-noqa
       - id: python-use-type-annotations
 
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.8.19
+    hooks:
+      - id: uv-lock
+
   - repo: https://github.com/PyCQA/isort
     rev: 6.0.1
     hooks:

CONTRIBUTING.md

@@ -37,7 +37,7 @@ The general workflow can be summarized as follows:
 
 1. Fork + clone the repository.
 1. Initialize the development environment:
-    `poetry install && poetry run prek install`.
+    `uv sync --all-groups && uv run pre-commit install`.
 1. Create a new branch.
 1. Commit your changes, update documentation if required.
 1. Push the branch to your fork, and
@@ -62,7 +62,7 @@ developer at any time.
 - docker
     - docker compose
 - python 3.10
-- poetry
+- uv
 
 Additionally, a postgresql database is required to develop Monty, but this is
 included in the developer
@@ -104,12 +104,12 @@ GITHUB_TOKEN=...
 TLDR:
 
 ```sh
-poetry install
-poetry run prek install
+uv sync --all-groups
+uv run prek install
 ```
 
-If you don't already have poetry installed, check the
-[poetry documentation](https://python-poetry.org/), or use a tool like pipx or
+If you don't already have uv installed, check the
+[uv documentation](https://docs.astral.sh/uv/), or use a tool like pipx or
 uvx.
 
 Make sure you install prek, as it will lint every commit before its

Dockerfile

@@ -1,32 +1,38 @@
 FROM python:3.10-slim
+COPY --from=ghcr.io/astral-sh/uv:0.8.19 /uv /uvx /bin/
+WORKDIR /app
 
-# Set pip to have cleaner logs and no saved cache
-ENV PIP_NO_CACHE_DIR=false
+# Enable bytecode compilation
+ENV UV_COMPILE_BYTECODE=1
 
-# Create the working directory
-WORKDIR /bot
+# Copy from the cache instead of linking since it's a mounted volume
+ENV UV_LINK_MODE=copy
 
-# Install project dependencies
+# Ensure installed tools can be executed out of the box
+ENV UV_TOOL_BIN_DIR=/usr/local/bin
+
+# Set SHA build argument
+ARG git_sha="main"
+ENV GIT_SHA=$git_sha
 
 # as we have a git dep, install git
 RUN apt update && apt install git -y
 
-RUN pip install poetry==2.1.4 poetry-plugin-export==1.9.0
 
-# export requirements after copying req files
-COPY pyproject.toml poetry.lock ./
-RUN poetry export --without-hashes > requirements.txt
-RUN pip uninstall poetry -y
-RUN pip install -Ur requirements.txt
+# Install the project's dependencies using the lockfile and settings
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --locked --no-install-project --no-dev
 
-# Set SHA build argument
-ARG git_sha="main"
-ENV GIT_SHA=$git_sha
+# Then, add the rest of the project source code and install it
+# Installing separately from its dependencies allows optimal layer caching
+COPY . /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev
 
-# Copy the source code in next to last to optimize rebuilding the image
-COPY . .
+# Place executables in the environment at the front of the path
+ENV PATH="/app/.venv/bin:$PATH"
 
-# install the package using pep 517
-RUN pip install . --no-deps
 
 ENTRYPOINT ["python3", "-m", "monty"]

docs/.readthedocs.yaml

@@ -11,9 +11,15 @@ build:
   tools:
     python: "3.10"
   jobs:
-    post_install:
-      - pip install poetry
-      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH poetry install --with docs
+    create_environment:
+      - asdf plugin add uv
+      - asdf install uv 0.8.19
+      - asdf global uv 0.8.19
+      - UV_PROJECT_ENVIRONMENT=$READTHEDOCS_VIRTUALENV_PATH uv sync --no-default-groups --group docs
+    install:
+      - "true"
+
+
 
 mkdocs:
   configuration: mkdocs.yaml

docs/future-plans.md

@@ -27,11 +27,6 @@ contributing.
 ### Dependencies
 
 - Drop some of the additional markdown parsers
-- Look into switching to uv from poetry
-
-### Documentation
-
-- Add an autodoc of all app commands to the documentation website.
 
 ### GitHub Parsing
 
@@ -55,3 +50,5 @@ contributing.
 
 - Rewrite the developer-side feature view command
 - Add contributing documentation
+- Migrate to uv
+- Add an autodoc of all app commands to the documentation website.

poetry.lock

@@ -1,13 +1,14 @@
 [build-system]
-requires = ["poetry-core>=2.0.0,<3"]
-build-backend = "poetry.core.masonry.api"
+requires = ["flit_core >=3.11,<4"]
+build-backend = "flit_core.buildapi"
 
 [project]
-authors = [{ name = "aru", email = "genericusername414@gmail.com" }]
-license = { text = "MIT" }
-requires-python = ">=3.10, <4"
+authors = [{ name = "aru", email = "me@arielle.codes" }]
+license = "MIT"
+license-files = ["LICENSE", "LICENSE_THIRD_PARTY"]
+requires-python = ">=3.10"
 name = "monty"
-version = "1.0.0"
+version = "0.0.1"
 description = "Helpful bot for python, github, and discord things."
 dependencies = [
     "aiodns~=3.4",
@@ -40,39 +41,38 @@ dependencies = [
     "readme-renderer[md] (>=44.0,<45.0)",
 ]
 
-[project.optional-dependencies]
-fakeredis = ["fakeredis<3.0.0,>=2.29.0"]
-dev = ["fakeredis<3.0.0,>=2.29.0", "watchfiles<2.0.0,>=1.0.5"]
-
-[tool.poetry.group.dev.dependencies]
-black = "^25.9.0"
-ruff = "==0.13.1"
-isort = "==6.0.1"
-prek = ">=0.2.1,<0.3"
-taskipy = "^1.14.1"
-python-dotenv = "^1.1.0"
-pyright = "==1.1.405"
-msgpack-types = "^0.5.0"
-mdformat = "^0.7.22"
-mdformat-ruff = "^0.1.3"
-mdformat-beautysh = "^0.1.1"
-mdformat-gfm = "^0.4.1"
-mdformat-gfm-alerts = "^2.0.0"
-mdformat-mkdocs = "^4.4.1"
-mdformat-pyproject = "^0.0.2"
-mdformat-simple-breaks = "^0.0.1"
-mdformat-tables = "^1.0.0"
-mdformat-frontmatter = "^2.0.8"
-
-
-[tool.poetry.group.docs.dependencies]
-mkdocs = "^1.6.1"
-mkdocs-material = {version = "^9.6.20", extras = ["imaging"]}
-mkdocs-git-revision-date-localized-plugin = "^1.4.7"
-markdown-gfm-admonition = "^0.1.1"
-
-[tool.poetry.requires-plugins]
-poetry-plugin-export = ">=1.9,<2"
+[dependency-groups]
+dev = [
+    "fakeredis<3.0.0,>=2.29.0",
+    "watchfiles<2.0.0,>=1.0.5",
+    "python-dotenv<2.0.0,>=1.1.0",
+]
+tools = [
+    "black<26.0.0,>=25.9.0",
+    "isort==6.0.1",
+    "poethepoet>=0.37.0",
+    "prek>=0.2.1,<0.3",
+    "ruff==0.13.1",
+]
+typing = ["pyright==1.1.405", "msgpack-types<1.0.0,>=0.5.0"]
+docs = [
+    "mkdocs<2.0.0,>=1.6.1",
+    "mkdocs-material[imaging]<10.0.0,>=9.6.20",
+    "mkdocs-git-revision-date-localized-plugin<2.0.0,>=1.4.7",
+    "markdown-gfm-admonition<1.0.0,>=0.1.1",
+]
+mdformat = [
+    "mdformat<1.0.0,>=0.7.22",
+    "mdformat-ruff<1.0.0,>=0.1.3",
+    "mdformat-beautysh<1.0.0,>=0.1.1",
+    "mdformat-gfm<1.0.0,>=0.4.1",
+    "mdformat-gfm-alerts<3.0.0,>=2.0.0",
+    "mdformat-mkdocs<5.0.0,>=4.4.1",
+    "mdformat-pyproject<1.0.0,>=0.0.2",
+    "mdformat-simple-breaks<1.0.0,>=0.0.1",
+    "mdformat-tables<2.0.0,>=1.0.0",
+    "mdformat-frontmatter<3.0.0,>=2.0.8",
+]
 
 [tool.black]
 line-length = 120
@@ -170,14 +170,11 @@ ignore = [
 [tool.ruff.lint.mccabe]
 max-complexity = 20
 
-[tool.taskipy.tasks]
-export = 'poetry export --without-hashes -o requirements.txt'
-start = "python -m monty"
-lint = "prek run --all-files"
-prek = "prek install"
+[tool.poe.tasks]
+lint = { cmd = "prek run --all-files", help = "Lint the source code" }
+prek = { cmd = "prek install", help = "Install the git pre-commit hooks" }
 pyright = { cmd = "dotenv -f task.env run -- pyright", help = "Run pyright" }
-html = "coverage html"
-report = "coverage report"
+sync = { cmd = "uv sync --all-groups --all-extras", help = "Sync all groups and extras to a local environment" }
 
 [tool.pyright]
 typeCheckingMode = "basic"