chore: migrate from poetry to uv

Convert pyproject.toml to PEP 621 with hatchling backend and PEP 735
dependency groups, replace poetry commands in noxfile and CI workflows
with uv equivalents, swap poetry.lock for uv.lock, and update install
docs to recommend uv add.

https://claude.ai/code/session_01YcFhUy7dEUad35PR1tQT8S

Author: claude

.github/workflows/docs.yaml

@@ -12,21 +12,21 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: '3.10'
 
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
-
       - name: Install dependencies
         run: |
-          poetry install --only docs
+          uv sync --only-group docs
 
       - name: Build documentation
         run: |
-          poetry run mkdocs build
+          uv run mkdocs build
 
       - name: Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v3

.github/workflows/pipeline.yaml

@@ -13,20 +13,20 @@ jobs:
         with:
           lfs: true
           ref: ${{ github.ref_name }}
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: "3.10"
       - name: Install dependencies
-        run: poetry install
+        run: uv sync --all-groups
 
       - name: Install nox dependencies
-        run: poetry run nox -s install
+        run: uv run nox -s install
 
       - name: Run linting
-        run: poetry run nox -s linting
+        run: uv run nox -s linting
 
   tests:
     needs: [linting]
@@ -37,10 +37,8 @@ jobs:
         with:
           lfs: true
           ref: ${{ github.ref_name }}
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
-        with:
-          version: 1.3.2
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
       - name: Install graphviz
         run: |
             sudo apt update
@@ -50,12 +48,12 @@ jobs:
         with:
           python-version: "3.10"
       - name: Install dependencies
-        run: poetry install
+        run: uv sync --all-groups
 
       - name: Install nox dependencies
-        run: poetry run nox -s install
+        run: uv run nox -s install
       - name: Run tests
-        run: poetry run nox -s tests
+        run: uv run nox -s tests
 
   create-revision-and-tag:
     if: startsWith(github.ref, 'refs/heads/main')
@@ -68,14 +66,18 @@ jobs:
           token: ${{ secrets.ACCESS_TOKEN }}
           ref: ${{ github.ref_name }}
 
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
 
       - name: Determine Versioning Strategy
         run: |
           echo "Bumping minor version"
-          poetry version minor
-          echo "NEW_VERSION=$(poetry version -s)" >> $GITHUB_ENV
+          uv version --bump minor
+          echo "NEW_VERSION=$(uv version --short)" >> $GITHUB_ENV
       - name: Commit changes
         uses: stefanzweifel/git-auto-commit-action@v5
         with:
@@ -98,16 +100,20 @@ jobs:
           token: ${{ secrets.ACCESS_TOKEN }}
           ref: ${{ github.ref_name }}
 
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
 
       - name: Determine Current Version
         run: |
           echo "NEW_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV
 
       - name: Build source and wheel archives
         id: build
-        run: poetry build
+        run: uv build
       - name: Get Commit Messages Since Last Tag
         id: commit_messages
         run: |
@@ -139,4 +145,4 @@ jobs:
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           password: ${{ secrets.PYPI_API_TOKEN }}
-          repository_url: https://upload.pypi.org/legacy/
+          repository_url: https://upload.pypi.org/legacy/

docs_src/getting_started/installation.py

@@ -37,8 +37,8 @@
                 content="""ifctrano is a python package that can be installed using pip."""
             ),
             DisplayObject(language="bash", object="pip install ifctrano"),
-            CleanedText(content="""ifctrano can also be used using poetry."""),
-            DisplayObject(language="bash", object="poetry add ifctrano"),
+            CleanedText(content="""ifctrano can also be used using uv."""),
+            DisplayObject(language="bash", object="uv add ifctrano"),
             CleanedText(
                 content="""To check the installation, run the following command in the terminal."""
             ),

noxfile.py

@@ -6,37 +6,35 @@
 
 @nox.session(python=["3.10"])
 def install(session: Session) -> None:
-    groups = ["main", "dev", "docs"]
     session.run(
-        "poetry",
-        "install",
-        "--no-root",
-        "--sync",
-        f"--only={','.join(groups)}",
+        "uv",
+        "sync",
+        "--all-groups",
         external=True,
     )
 
 
 @nox.session(python=["3.10"])
 def linting(session: Session) -> None:
-    session.run("poetry", "run", "black", ".")
-    session.run("poetry", "run", "mypy")
+    session.run("uv", "run", "black", ".", external=True)
+    session.run("uv", "run", "mypy", external=True)
     session.run(
-        "poetry",
+        "uv",
         "run",
         "ruff",
         "check",
         "--fix",
         "--show-fixes",
         "--exit-non-zero-on-fix",
+        external=True,
     )
 
 
 @nox.session(python=["3.10"])
 def tests(session: Session) -> None:
-    session.run("poetry", "run", "pytest", "-m", "not large")
+    session.run("uv", "run", "pytest", "-m", "not large", external=True)
 
 
 @nox.session(python=["3.10"])
 def integration(session: Session) -> None:
-    session.run("poetry", "run", "pytest", "-m", "integration")
+    session.run("uv", "run", "pytest", "-m", "integration", external=True)