Update documentation and CI/CD workflows for PyPI publishing (#23)

* chores: fix mkdocs to avoid upgrade to version 2.0

* docs: update all the documentation with current implementation

* cicd: add workflow for publishing in pypi

* cicd: add workflow to testability in TestPyPI

* cicd: remove pipy environment to keep zero warnings off in this release

Author: ecarrenolozano

.github/workflows/publish-pypi.yml

@@ -12,9 +12,6 @@ permissions:
 jobs:
     build-and-publish:
         runs-on: ubuntu-latest
-        environment:
-            name: pypi
-            url: https://pypi.org/p/pkg_infra
         steps:
         -   uses: actions/checkout@v4
 

.github/workflows/publish-testpypi.yml

@@ -0,0 +1,34 @@
+name: Publish to TestPyPI
+
+on:
+    workflow_dispatch:
+
+permissions:
+    contents: read
+    id-token: write
+
+jobs:
+    build-and-publish:
+        runs-on: ubuntu-latest
+        steps:
+        -   uses: actions/checkout@v4
+
+        -   uses: actions/setup-python@v5
+            with:
+                python-version: '3.12'
+
+        -   name: Install uv
+            uses: astral-sh/setup-uv@v5
+
+        -   name: Build distributions
+            run: uv build
+
+        -   name: Check package metadata
+            run: |
+                python -m pip install twine
+                twine check dist/*
+
+        -   name: Publish to TestPyPI
+            uses: pypa/gh-action-pypi-publish@release/v1
+            with:
+                repository-url: https://test.pypi.org/legacy/