Release v0.2.0

Author: yifanfeng97

.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        version: "latest"
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: uv sync --extra dev
+    
+    - name: Run linting
+      run: |
+        uv run black --check hyperdb/ tests/
+        uv run isort --check-only hyperdb/ tests/
+    
+    - name: Run tests
+      run: uv run pytest tests/ -v
+    
+    - name: Build package
+      run: uv build
+
+  test-windows:
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        version: "latest"
+    
+    - name: Set up Python
+      run: uv python install 3.11
+    
+    - name: Install dependencies
+      run: uv sync --extra dev
+    
+    - name: Run tests
+      run: uv run pytest tests/ -v
+    
+    - name: Build package
+      run: uv build

.github/workflows/release.yml

@@ -0,0 +1,37 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        version: "latest"
+    
+    - name: Set up Python
+      run: uv python install 3.11
+    
+    - name: Install dependencies
+      run: uv sync --extra dev
+    
+    - name: Run tests
+      run: uv run pytest tests/
+    
+    - name: Build package
+      run: uv build
+    
+    - name: Publish to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        uv run pip install twine
+        uv run twine upload dist/*

.gitignore

@@ -171,3 +171,7 @@ cython_debug/
 #.idea/
 
 hyperdb/templates/data.js
+
+# UV package manager
+.venv/
+uv.lock

.python-version

@@ -0,0 +1 @@
+3.11

Makefile

@@ -0,0 +1,61 @@
+.PHONY: help install install-dev test lint format docs docs-serve docs-deploy clean build
+
+# Default target
+help:
+	@echo "Available commands:"
+	@echo "  install      - Install package dependencies"
+	@echo "  install-dev  - Install package with development dependencies"
+	@echo "  test         - Run tests"
+	@echo "  lint         - Run linting checks"
+	@echo "  format       - Format code with black and isort"
+	@echo "  docs         - Build documentation"
+	@echo "  docs-serve   - Serve documentation locally"
+	@echo "  docs-deploy  - Deploy documentation to GitHub Pages"
+	@echo "  clean        - Clean build artifacts"
+	@echo "  build        - Build package"
+
+# Install package
+install:
+	uv sync
+
+# Install with development dependencies
+install-dev:
+	uv sync --extra dev
+
+# Run tests
+test:
+	uv run pytest tests/
+
+# Run linting
+lint:
+	uv run black --check hyperdb/ tests/
+	uv run isort --check-only hyperdb/ tests/
+
+# Format code
+format:
+	uv run black hyperdb/ tests/
+	uv run isort hyperdb/ tests/
+
+# Build documentation
+docs:
+	uv run --extra docs mkdocs build
+
+# Serve documentation locally
+docs-serve:
+	uv run --extra docs mkdocs serve
+
+# Deploy documentation to GitHub Pages
+docs-deploy:
+	uv run --extra docs mkdocs gh-deploy
+
+# Clean build artifacts
+clean:
+	rm -rf dist/
+	rm -rf build/
+	rm -rf *.egg-info/
+	find . -type d -name __pycache__ -exec rm -rf {} +
+	find . -type f -name "*.pyc" -delete
+
+# Build package
+build: clean
+	uv build