Use poetry in mkdocs workflow (#27)

* Use poetry

* Add poetry run

* Useless change

* Fix workflow

Author: AdrienVannson

.github/workflows/documentation.yml

@@ -14,15 +14,36 @@ jobs:
         run: |
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
-      - uses: actions/setup-python@v5
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
         with:
           python-version: 3.12
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
-      - uses: actions/cache@v4
+
+      - name: Install poetry
+        shell: bash
+        run: |
+          python -m pip install poetry
+          echo "$HOME/.poetry/bin" >> $GITHUB_PATH
+
+      - name: Configure poetry
+        shell: bash
+        run: poetry config virtualenvs.in-project true
+
+      - name: Set up cache
+        uses: actions/cache@v3
+        id: cache
         with:
-          key: mkdocs-material-${{ env.cache_id }}
-          path: .cache
-          restore-keys: |
-            mkdocs-material-
-      - run: pip install mkdocs-material mkdocstrings[python]
-      - run: mkdocs gh-deploy --force
+          path: .venv
+          key: venv-documentation-${{ hashFiles('**/poetry.lock') }}
+      
+      - name: Ensure cache is healthy
+        if: steps.cache.outputs.cache-hit == 'true'
+        shell: bash
+        run: poetry run pip --version >/dev/null 2>&1 || rm -rf .venv
+
+      - name: Install dependencies
+        shell: bash
+        run: poetry install
+
+      - run: poetry run mkdocs gh-deploy --force

docs/index.md

@@ -7,6 +7,7 @@ betterproto is a protobuf compiler and interpreter. It improves the experience o
 Protobuf and gRPC in Python, by generating readable, understandable, and idiomatic
 Python code, using modern language features.
 
+
 ## Features
 
 - Generated messages are both binary & JSON serializable