Stabilize the Protocol and implement add't Stores

.github/workflows/publish-py-kv-store-adapter.yml → .github/workflows/publish.yml

@@ -1,4 +1,4 @@
-name: Publish py-kv-store-adapter to PyPI
+name: Publish to PyPI
 
 on:
   release:
@@ -8,26 +8,35 @@ on:
 jobs:
   publish:
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     permissions:
       id-token: write
     environment: pypi
 
+    strategy:
+      matrix:
+        project:
+          - "key-value/key-value-aio"
+    #          - "kv-store-sync"
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
       - name: "Install uv"
         uses: astral-sh/setup-uv@v6
-      
+
       - name: "Install"
         run: uv sync --locked --group dev
+        working-directory: ${{ matrix.project }}
 
       - name: "Test"
         run: uv run pytest tests
-
+        working-directory: ${{ matrix.project }}
+
       - name: "Build"
         run: uv build
+        working-directory: ${{ matrix.project }}
 
       - name: "Publish to PyPi"
         if: github.event_name == 'release' && github.event.action == 'created'
-        run: uv publish -v dist/*
+        run: uv publish -v dist/*

.github/workflows/test.yml

@@ -0,0 +1,116 @@
+name: Run Tests
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  static_analysis:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        project:
+          - "key-value/key-value-aio"
+    #          - "kv-store-sync"
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v6
+
+      - name: "Install"
+        run: uv sync --locked --group dev
+        working-directory: ${{ matrix.project }}
+
+      - name: "Lint"
+        run: uv run ruff check --exit-non-zero-on-fix --fix .
+        working-directory: ${{ matrix.project }}
+
+      - name: "Format"
+        run: uv run ruff format --check . 
+        working-directory: ${{ matrix.project }}
+
+      - name: "Type Check"
+        run: uv run basedpyright .
+        working-directory: ${{ matrix.project }}
+
+  test_quick:
+    needs:
+      - static_analysis
+    timeout-minutes: 10
+    strategy:
+      matrix:
+        python-version: ["3.10"]
+        platform: [ubuntu-latest, macos-latest, windows-latest]
+        project:
+          - "key-value/key-value-aio"
+    #          - "kv-store-sync"
+
+    runs-on: ${{ matrix.platform }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v6
+
+      - name: "Install"
+        run: uv sync --locked --group dev --python ${{ matrix.python-version }}
+        working-directory: ${{ matrix.project }}
+
+      - name: "Test"
+        run: uv run pytest tests .
+        working-directory: ${{ matrix.project }}
+
+      - name: "Build"
+        run: uv build .
+        working-directory: ${{ matrix.project }}
+
+  test_all:
+    needs:
+      - test_quick
+
+    timeout-minutes: 20
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        platform:
+          [
+            #ubuntu-22.04,
+            ubuntu-latest,
+            macos-14,
+            macos-latest,
+            windows-2022,
+            windows-latest,
+          ]
+        project:
+          - "key-value/key-value-aio"
+    #          - "kv-store-sync"
+
+    runs-on: ${{ matrix.platform }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v6
+
+      - name: "Install"
+        run: uv sync --locked --group dev --python ${{ matrix.python-version }}
+        working-directory: ${{ matrix.project }}
+
+      - name: "Test"
+        run: uv run pytest tests .
+        working-directory: ${{ matrix.project }}
+
+      - name: "Build"
+        run: uv build .
+        working-directory: ${{ matrix.project }}

.vscode/launch.json

@@ -26,6 +26,26 @@
             "console": "integratedTerminal",
             "justMyCode": false,
             "envFile": "${workspaceFolder}/.env"
+        },
+        {
+            "name": "Compile Sync Library",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/scripts/build_sync_library.py",
+            "console": "integratedTerminal",
+            "justMyCode": false,
+            "envFile": "${workspaceFolder}/.env",
+            "args": []
+        },
+        {
+            "name": "Compile Sync Library - Single File",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/scripts/build_sync_library.py",
+            "console": "integratedTerminal",
+            "justMyCode": false,
+            "envFile": "${workspaceFolder}/.env",
+            "args": ["${workspaceFolder}/key-value/key-value-aio/src/key_value/aio/stores/memcached/__init__.py"]
         }
     ]
 }

.vscode/settings.json

@@ -1,7 +1,9 @@
 {
-    "python.testing.pytestArgs": [
-        "tests"
-    ],
     "python.testing.unittestEnabled": false,
-    "python.testing.pytestEnabled": true
+    "python.testing.pytestEnabled": true,
+    "python.testing.pytestArgs": [
+        "key-value",
+        "--import-mode=importlib",
+        "-vv",
+    ]
 }

.vscode/tasks.json

@@ -0,0 +1,45 @@
+{
+  // Simple VS Code tasks that call Makefile targets
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Bump version (make)",
+      "type": "shell",
+      "command": "make",
+      "args": [
+        "bump-version",
+        "VERSION=${input:newVersion}"
+      ],
+      "problemMatcher": []
+    },
+    {
+      "label": "Bump version (dry-run) (make)",
+      "type": "shell",
+      "command": "make",
+      "args": [
+        "bump-version-dry",
+        "VERSION=${input:newVersion}"
+      ],
+      "problemMatcher": []
+    },
+    {
+      "label": "Build sync library (make)",
+      "type": "shell",
+      "command": "make",
+      "args": [
+        "build-sync"
+      ],
+      "problemMatcher": []
+    }
+  ],
+  "inputs": [
+    {
+      "id": "newVersion",
+      "type": "promptString",
+      "description": "Enter new version (e.g. 1.2.3)",
+      "default": "0.0.0"
+    }
+  ]
+}
+
+