🔧 (workflows): add GitHub Actions for coverage, docs, and tests

Add workflows for test coverage and documentation deployment to automate
CI/CD processes. This ensures consistent testing and documentation updates
on the master branch.

✅ (workflows): refactor publish workflow to include tests

Separate tests into their own workflow and ensure they run before
publishing. This improves reliability by ensuring code is tested
before deployment.

⬆️ (pyproject.toml): update version to 0.1.0 and adjust Python requirement

Bump version to 0.1.0 to reflect new features and improvements.
Adjust Python version requirement to >=3.11 for broader compatibility.

Author: SpaceShaman

.github/workflows/coverage.yml

@@ -0,0 +1,25 @@
+name: Test Coverage
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  coverage:
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Install Python 3.13
+        run: uv python install 3.13
+      - name: Install dependencies
+        run: uv sync
+      - name: Run tests with coverage
+        run: uv run pytest --cov=src --cov-report=xml
+      - name: Upload coverage report to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/docs.yml

@@ -0,0 +1,28 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - master
+
+permissions:
+  contents: write
+
+jobs:
+  docs:
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Configure Git Credentials
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Install Python 3.13
+        run: uv python install 3.13
+      - name: Install dependencies
+        run: uv sync
+      - name: Deploy Documentation
+        run: uv run mkdocs gh-deploy --force

.github/workflows/publish.yml

@@ -1,4 +1,4 @@
-name: "Publish"
+name: Publish
 
 on:
   push:
@@ -7,8 +7,11 @@ on:
       - v*
 
 jobs:
-  run:
-    runs-on: ubuntu-latest
+  tests:
+    uses: ./.github/workflows/tests.yml
+  publish:
+    runs-on: ubuntu-22.04
+    needs: tests
     environment:
       name: pypi
     permissions:

.github/workflows/tests.yml

@@ -0,0 +1,23 @@
+name: Tests
+
+on: [workflow_call, pull_request]
+
+jobs:
+  tests:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Install Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync
+      - name: Run tests
+        run: uv run pytest
+      - name: Run linter

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "socketapi"
-version = "0.0.0"
+version = "0.1.0"
 description = "SocketAPI is a lightweight Python framework for real-time WebSocket APIs, using a single multiplexed connection with endpoint-like actions and channel subscriptions."
 license = "MIT"
 authors = [
@@ -15,7 +15,7 @@ classifiers = [
   "Framework :: Pydantic",
   "Framework :: Pydantic :: 2",
 ]
-requires-python = ">=3.13"
+requires-python = ">=3.11"
 dependencies = [
     "httpx>=0.28.1",
     "pydantic>=2.12.5",