refactor: replace requirements.txt with Poetry for dependency management

- Add pyproject.toml with Poetry configuration
- Update GitHub Actions workflow to use Poetry
- Remove requirements.txt in favor of Poetry
- Add caching for Poetry dependencies in CI

Poetry provides better dependency resolution and lock file support,
ensuring consistent builds across environments.

Author: jonathanirvin-ast

.github/workflows/deploy.yml

@@ -28,14 +28,30 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: '3.11'
-          cache: 'pip'
+
+      - name: Install Poetry
+        uses: snok/install-poetry@v1
+        with:
+          virtualenvs-create: true
+          virtualenvs-in-project: true
+          installer-parallel: true
+
+      - name: Load cached venv
+        id: cached-poetry-dependencies
+        uses: actions/cache@v4
+        with:
+          path: .venv
+          key: venv-${{ runner.os }}-${{ steps.setup-python.outputs.python-version }}-${{ hashFiles('**/poetry.lock') }}
 
       - name: Install dependencies
-        run: |
-          pip install -r requirements.txt
+        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
+        run: poetry install --no-interaction --no-root
+
+      - name: Install project
+        run: poetry install --no-interaction
 
       - name: Build site
-        run: mkdocs build
+        run: poetry run mkdocs build
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

pyproject.toml

@@ -0,0 +1,21 @@
+[tool.poetry]
+name = "valdris"
+version = "1.0.0"
+description = "Valdris D&D Campaign World Documentation"
+authors = ["Offending Commit <offendingcommit@gmail.com>"]
+readme = "README.md"
+license = "CC-BY-SA-4.0"
+
+[tool.poetry.dependencies]
+python = "^3.11"
+mkdocs = "^1.6.0"
+mkdocs-material = "^9.5.18"
+mkdocs-awesome-pages-plugin = "^2.9.2"
+pymdown-extensions = "^10.7.1"
+mkdocs-material-extensions = "^1.3.1"
+
+[tool.poetry.group.dev.dependencies]
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"