refactor: add tools, CI, fix to conform to ruff/pyright

Author: DeflateAwning

.github/workflows/ci.yml

@@ -0,0 +1,77 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "master"]
+  pull_request:
+    branches: ["main", "master"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        os: ["ubuntu-latest", "macos-latest", "windows-latest"]
+        python-version: ["3.11", "3.12", "3.13"]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install all dependencies
+        run: uv sync --all-extras
+
+      - name: Run linting
+        run: |
+          uv run ruff format --check .
+          uv run ruff check .
+
+      - name: Run type checking
+        run: uv run pyright .
+
+      # Linux (Ubuntu)
+      - name: Install MDBTools on Ubuntu
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y mdbtools
+
+      # macOS (Homebrew)
+      - name: Install MDBTools on macOS
+        if: runner.os == 'macOS'
+        run: |
+          brew update
+          brew install mdbtools
+
+      # Windows (MSYS2 + build from source)
+      - name: Install MDBTools on Windows
+        if: runner.os == 'Windows'
+        shell: bash
+        run: |
+          choco install -y msys2
+          C:\tools\msys64\usr\bin\bash -lc "
+            pacman -Sy --noconfirm git base-devel mingw-w64-x86_64-toolchain automake autoconf libtool flex bison
+            git clone https://github.com/mdbtools/mdbtools.git
+            cd mdbtools
+            autoreconf -i -f
+            ./configure --host=x86_64-w64-mingw32 --disable-shared --enable-static
+            make -j$(nproc)
+            make install
+          "
+
+      - name: Run tests
+        run: uv run pytest tests/

.gitignore

@@ -1,3 +1,6 @@
+.venv
+.ruff_cache
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]

.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+    "[python]": {
+        "editor.formatOnSave": true
+    },
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

pyproject.toml

@@ -1,27 +1,17 @@
 [project]
 name = "polars_access_mdbtools"
 version = "0.0.2"
-authors = [
-  { name="DeflateAwesome" },
-]
+authors = [{ name = "DeflateAwning" }]
 description = "A library for reading tables from an Access database into Polars dataframes, using mdbtools"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.11"
 classifiers = [
   "Programming Language :: Python :: 3",
   "License :: OSI Approved :: MIT License",
   "Operating System :: OS Independent",
 ]
-dependencies = [
-  "polars >= 0.20",
-]
-keywords = [
-  "polars",
-  "mdbtools",
-  "access",
-  "database",
-  "dataframe",
-]
+dependencies = ["polars>=0.20"]
+keywords = ["polars", "mdbtools", "access", "database", "dataframe"]
 
 [project.urls]
 Homepage = "https://github.com/DeflateAwning/polars_access_mdbtools"
@@ -31,3 +21,16 @@ License = "https://github.com/DeflateAwning/polars_access_mdbtools/blob/main/LIC
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = ["pyright>=1.1.406", "pytest>=8.4.2", "ruff>=0.14.1"]
+
+[tool.pyright]
+typeCheckingMode = "strict"
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+  "FIX002",
+  "TD003", # Needs issue link.
+]