feat: N+1 elimination via select_related, async support, and docs overhaul

.github/workflows/ci.yml

@@ -1,42 +1,65 @@
-# This workflow will install Python dependencies, run tests and lint with a single version of Python
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
-
-name: Test Package
+name: CI
 
 on:
-  push:
-    branches: [ "master" ]
   pull_request:
+  push:
+  workflow_dispatch:
 
-permissions:
-  contents: read
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  MAIN_PYTHON_VERSION: "3.14"
 
 jobs:
-  build:
+  linting:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: ${{ env.MAIN_PYTHON_VERSION }}
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+      - name: Install dev dependencies
+        run: uv sync --only-group dev
+      - name: Run pre-commit
+        run: uv run pre-commit run -a
+
+  test:
+    runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
-        os: [ubuntu-latest]
-        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
-    runs-on: ${{ matrix.os }}
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        mongodb-version: ["4.4", "5.0", "6.0", "7.0", "8.0", "8.3"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+      - name: Start MongoDB ${{ matrix.mongodb-version }}
+        uses: supercharge/mongodb-github-action@1.12.1
+        with:
+          mongodb-version: ${{ matrix.mongodb-version }}
+      - name: Install test dependencies
+        run: uv sync --only-group test
+      - name: Run tests
+        run: |
+          uv run tox -e py$(echo "${{ matrix.python-version }}" | tr -d .)
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [linting, test]
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python ${{ matrix.python }}
-      uses: actions/setup-python@v3
-      with:
-        python-version: ${{ matrix.python }}
-    - name: Install dependencies
-      run: |
-        python -m pip install poetry
-        poetry config virtualenvs.create false
-        poetry install --with dev
-    - name: Lint with ruff
-      run: make lint
-    - name: Start MongoDB
-      uses: supercharge/mongodb-github-action@1.12.1
-      with:
-        mongodb-replica-set: test-rs
-    - name: Run Tests
-      run: make test
-    - name: Build Package
-      run: |
-        poetry build
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: ${{ env.MAIN_PYTHON_VERSION }}
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+      - name: Build wheel
+        run: uv build

.github/workflows/publish.yml

@@ -1,64 +1,20 @@
-name: Publish to PyPI
+name: Publish
 
 on:
   release:
     types: [published]
 
-permissions:
-  contents: read
-
 jobs:
-  build:
-    strategy:
-      matrix:
-        os: [ubuntu-latest]
-        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
-    runs-on: ${{ matrix.os }}
-    steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python ${{ matrix.python }}
-      uses: actions/setup-python@v3
-      with:
-        python-version: ${{ matrix.python }}
-    - name: Install dependencies
-      run: |
-        python -m pip install poetry
-        poetry config virtualenvs.create false
-        poetry install --with dev
-    - name: Lint
-      run: |
-        make lint
-    - name: Start MongoDB
-      uses: supercharge/mongodb-github-action@1.12.1
-      with:
-        mongodb-replica-set: test-rs
-    - name: Run Tests
-      run: make test
-    - name: Build Package
-      run: |
-        poetry build
-
   publish:
-    needs: build
     runs-on: ubuntu-latest
     permissions:
-      # IMPORTANT: this permission is mandatory for trusted publishing
       id-token: write
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python
-      uses: actions/setup-python@v3
-      with:
-        python-version: '3.x'
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install poetry
-    - name: Build package
-      run: |
-        poetry build
-    - name: Build package
-      run: |
-        poetry build
-    - name: Publish package distributions to PyPI
-      uses: pypa/gh-action-pypi-publish@release/v1
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.14"
+      - name: Build
+        run: uv build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -11,4 +11,5 @@ htmlcov/
 *.swo
 *.swp
 venv/
+.venv/
 .vscode/

.pre-commit-config.yaml

@@ -0,0 +1,6 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.10
+    hooks:
+      - id: ruff
+        args: [--fix]

Makefile

@@ -11,25 +11,23 @@ clean:
 	@find . -name "__pycache__" -delete
 
 lint:
-	@ruff check graphene_mongo
-	@ruff format . --check
+	@uv run ruff check graphene_mongo
+	@uv run ruff format . --check
 
 test: clean
-	pytest graphene_mongo/tests --cov=graphene_mongo --cov-report=html --cov-report=term
+	uv run pytest tests --cov=graphene_mongo --cov-report=html --cov-report=term
 
 register-pypitest:
 	#python setup.py register -r pypitest
 
 deploy-pypitest: clean
-	poetry build
-	#poetry publish --repository testpypi
+	uv build
 	twine upload --repository testpypi dist/*
 
 register:
 	#python setup.py register -r pypi
 
 deploy: clean
-	poetry build
+	uv build
 	twine upload dist/*
-	#poetry publish