initial commit

.github/workflows/docs-publish.yml

@@ -0,0 +1,50 @@
+name: Documentation publish
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          activate-environment: "false"
+          enable-cache: "auto"
+          cache-dependency-glob: |
+            **/pyproject.toml
+            **/uv.lock
+          restore-cache: "true"
+          save-cache: "true"
+      - name: Install dependencies
+        run: uv sync --all-groups
+      - name: Install Sphinx
+        run: uv pip install sphinx sphinx-rtd-theme sphinx-autodoc-typehints
+      - name: Build documentation
+        run: uv run sphinx-build -b html docs/source docs/_build/html
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/pylint.yml

@@ -0,0 +1,33 @@
+name: Pylint
+
+on: [push, pull_request]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          activate-environment: "true"
+          enable-cache: "auto"
+          cache-dependency-glob: |
+            **/pyproject.toml
+            **/uv.lock
+          restore-cache: "true"
+          save-cache: "true"
+      - name: Install project dependencies
+        run: |
+          uv sync --all-groups
+      - name: Install pylint
+        run: |
+          uv pip install pylint
+      - name: Lint code with pylint
+        run: |
+          uv run pylint src/snakia

.github/workflows/pypi-publish.yml

@@ -0,0 +1,59 @@
+name: PyPi publish
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv with all available options
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          activate-environment: "false"
+          enable-cache: "auto"
+          cache-dependency-glob: |
+            **/pyproject.toml
+            **/uv.lock
+          restore-cache: "true"
+          save-cache: "true"
+      - run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+
+    environment:
+      name: pypi
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/