google-drive-model 0.1.0__tar.gz

google_drive_model-0.1.0/PKG-INFO

@@ -0,0 +1,277 @@
+Metadata-Version: 2.4
+Name: google-drive-model
+Version: 0.1.0
+Summary: Pydantic models and a SQLModel-inspired API for Google Drive and Sheets
+Keywords: google-drive,google-sheets,orm,odm,pydantic
+Author: Yotam Manor
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Pydantic :: 2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Dist: google-api-python-client>=2.160.0
+Requires-Dist: google-auth>=2.37.0
+Requires-Dist: google-auth-httplib2>=0.2.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: rich>=13.9.0
+Requires-Dist: typer>=0.15.0
+Requires-Dist: google-auth-oauthlib>=1.2.1 ; extra == 'oauth'
+Requires-Dist: pyyaml>=6.0.2 ; extra == 'yaml'
+Requires-Python: >=3.11
+Project-URL: Changelog, https://github.com/yotammanor/gdm/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://yotammanor.github.io/gdm/
+Project-URL: Issues, https://github.com/yotammanor/gdm/issues
+Project-URL: Repository, https://github.com/yotammanor/gdm
+Provides-Extra: oauth
+Provides-Extra: yaml
+Description-Content-Type: text/markdown
+
+# Google Drive Model
+
+<p align="center">
+  <em>Pydantic models and a SQLModel-inspired session for Google Drive folders and Sheets.</em>
+</p>
+
+<p align="center">
+  <a href="https://github.com/yotammanor/gdm/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/yotammanor/gdm/ci.yml?branch=main&label=CI" alt="CI status"></a>
+  <a href="https://github.com/yotammanor/gdm/blob/main/LICENSE"><img src="https://img.shields.io/github/license/yotammanor/gdm.svg" alt="License: MIT"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.11–3.14-blue.svg" alt="Python 3.11–3.14"></a>
+  <a href="https://pydantic.dev"><img src="https://img.shields.io/badge/Pydantic-v2-3776AB.svg" alt="Pydantic v2"></a>
+  <img src="https://img.shields.io/badge/status-alpha-orange.svg" alt="Development status: alpha">
+</p>
+
+---
+
+**GDM** maps Pydantic models onto **existing Drive folders** and **Google Sheets rows** with a familiar `Session`, `select()`, and `Field()` API—without pretending Drive is a relational database.
+
+Center your app on a **mixed folder** already full of Google Docs, Slides, images, PDFs, shortcuts, and nested subfolders. GDM maps Drive metadata with `Field(drive=...)`, application metadata with `Field(metadata=...)`, and keeps **native bodies lazy** until you call `object.content`.
+
+> **Distribution vs import name:** install **`google-drive-model`**. The PyPI
+> name `gdm` is taken by an unrelated dependency manager. Import and CLI use
+> **`gdm`**:
+>
+> ```python
+> from gdm import GDM, GDMModel, DriveCollection, Session, select
+> ```
+
+**Documentation:** [yotammanor.github.io/gdm](https://yotammanor.github.io/gdm/)
+· [docs source](https://github.com/yotammanor/gdm/tree/main/docs)
+· **Design:** [`docs/design.md`](https://github.com/yotammanor/gdm/blob/main/docs/design.md)
+
+---
+
+## Why GDM?
+
+| You have… | GDM gives you… |
+| --- | --- |
+| A launch folder with Docs, decks, and PNGs | `DriveCollection[T]` over direct children; MIME filters; lazy native content |
+| A team spreadsheet with extra columns | Progressive sheet mapping—bind declared fields, preserve the rest |
+| Scripts that need typed reads/writes | Pydantic validation on every boundary crossing |
+| Multiple apps on one Google account | Root-scoped projects with isolated `.gdm/` metadata |
+
+GDM is **honest about platform limits**: no cross-file transactions, no server-side joins, no row-level security. Drive permissions remain the security boundary.
+
+---
+
+## Installation
+
+Install from PyPI:
+
+```console
+pip install "google-drive-model[oauth]"
+```
+
+To work from source:
+
+```console
+git clone https://github.com/yotammanor/gdm.git
+cd gdm
+uv sync --all-groups --frozen
+```
+
+| Extra | Purpose |
+| --- | --- |
+| `oauth` | Interactive installed-app login (`google-auth-oauthlib`) |
+| `yaml` | YAML codec for opt-in structured file collections |
+
+---
+
+## Quickstart: adopt a Drive folder
+
+### 1. Authenticate and open a project
+
+```console
+gdm auth login
+gdm --project-dir . --apply init --root-id YOUR_ROOT_FOLDER_ID --name my-app --remote
+```
+
+This creates the shared project manifest, registry, and collection metadata area
+under the Drive root. Tokens and local schema/index state stay local.
+
+### 2. Define a collection model
+
+```python
+from gdm import DriveObjectMixin, Field, GDMModel
+
+
+class CampaignAsset(
+    GDMModel,
+    DriveObjectMixin,
+    storage="collection",
+    collection="Campaigns/Launch",
+    mapping="partial",
+):
+    campaign: str | None = Field(default=None, metadata="campaign")
+    approved: bool = Field(default=False, metadata="approved")
+```
+
+`DriveObjectMixin` adds standard read-only Drive fields (`drive_id`, `name`, `mime_type`, …) mapped with `Field(drive=...)`.
+
+### 3. Connect, bind, and use the collection
+
+```python
+from gdm import GDM, select
+
+
+client = GDM.open(root_folder_id="YOUR_ROOT_FOLDER_ID")
+client.bind_collection(
+    CampaignAsset,
+    path="Campaigns/Launch",  # resolved once; immutable folder ID is persisted
+)
+
+assets = client.collection(CampaignAsset)
+images = assets.where_mime("image/*")
+logo = images.get("IMAGE_FILE_ID")
+brief = assets.get("GOOGLE_DOC_FILE_ID")
+
+data = logo.content.download()  # explicit — metadata queries skip bodies
+doc = brief.content.google_doc()  # native Docs API handle
+doc.batch_update([...])
+
+with client.session() as session:
+    approved = session.exec(
+        select(CampaignAsset).where(CampaignAsset.approved == True)  # noqa: E712
+    ).all()
+```
+
+Collection operations are **explicit about safety**: `adopt` vs `move` vs `shortcut`, `detach` vs `trash`, and `delete_permanently` for irreversible removal. `session.delete()` trashes collection members; it never silently purges Drive files.
+
+See the [Drive collections tutorial](https://yotammanor.github.io/gdm/tutorial/collection/) for duplicate names, shortcuts, recursion, and metadata reconciliation.
+
+---
+
+## Sheet tables (second story)
+
+Bind a worksheet without rewriting your team's sheet:
+
+```python
+from gdm import Field, GDMModel
+
+
+class Task(GDMModel, storage="sheet", mapping="partial", source="Tasks/Q1"):
+    id: str | None = Field(default=None, primary_key=True)
+    title: str
+    status: str = "todo"
+```
+
+```python
+from gdm import GDM, ResourceKind, select
+
+
+client = GDM.open(root_folder_id="YOUR_ROOT_FOLDER_ID")
+client.bind(
+    Task,
+    resource_id="YOUR_SPREADSHEET_ID",
+    kind=ResourceKind.SPREADSHEET,
+    worksheet="Tasks",
+)
+with client.session() as session:
+    open_tasks = session.exec(select(Task).where(Task.status == "open").limit(50)).all()
+    session.add(Task(title="Ship docs", status="open"))
+    session.commit()
+```
+
+Foreign keys can reference **Drive file IDs** from collection models. Relationships resolve client-side with `session.prefetch()`—see [Relationships](https://yotammanor.github.io/gdm/storage/relationships/).
+
+---
+
+## CLI
+
+| Command | Purpose |
+| --- | --- |
+| `gdm init` | Local `.gdm/` scaffolding; optional remote project with `--apply --remote` |
+| `gdm explore` | Inventory a folder (metadata only—zero content reads) |
+| `gdm infer collection` | Suggest a collection model from Drive metadata |
+| `gdm infer file` | Infer from a local JSON/text/CSV sample |
+| `gdm adopt` | Bind a folder (dry-run by default) |
+| `gdm doctor` | Metadata reconciliation, drift, scale warnings |
+| `gdm migrate plan/apply/rollback` | Forward, resumable migrations with declared rollback steps |
+| `gdm index rebuild` | Rebuild optional sidecar indexes |
+| `gdm auth login` | Interactive OAuth |
+
+Terminal demo (**actual local CLI recording**, no live OAuth or Drive mutations):
+
+<p align="center">
+  <a href="https://github.com/yotammanor/gdm/blob/main/docs/assets/demo.cast"><img src="https://raw.githubusercontent.com/yotammanor/gdm/main/docs/assets/demo.gif" alt="Recorded GDM CLI demo — open demo.cast to play" width="740"></a>
+</p>
+
+Regenerate the canonical cast (and the GIF when `agg` is installed):
+`bash docs/assets/regenerate-demo.sh`
+
+---
+
+## Architecture at a glance
+
+```text
+Your Pydantic models (GDMModel + Field)
+        │
+        ▼
+   GDM client ──► DriveCollection[T]  (folder-native CRUD, lazy content)
+        │              │
+        │              └──► metadata Sheet under .gdm/collections/
+        ▼
+   Session / select()  ──► expression tree (metadata queries; no body fetch)
+        │
+        ├──► Sheets backend (rows, batchUpdate)
+        └──► Drive backend (files, appProperties routing keys)
+        │
+        ▼
+   Drive .gdm/ metadata (manifest, registry, collection metadata)
+   Local .gdm/ tooling state (schema snapshots, migration checkpoints, indexes)
+```
+
+**Key limitations** (by design):
+
+- `Session.commit()` coordinates writes but is **not** an ACID transaction across files.
+- Metadata queries never download native bodies; content access is explicit via `.content`.
+- Relationships and joins are **client-side** with batched prefetch.
+- Export produces portable views; native Docs/Slides mutation uses their respective APIs.
+- Docs and Slides use atomic revision preconditions. Drive binary and Sheets
+  updates use best-effort conflict checks because those APIs expose no general
+  conditional write precondition.
+
+Full rationale: [`docs/design.md`](https://github.com/yotammanor/gdm/blob/main/docs/design.md).
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/yotammanor/gdm/blob/main/CONTRIBUTING.md), [SECURITY.md](https://github.com/yotammanor/gdm/blob/main/SECURITY.md), and [CODE_OF_CONDUCT.md](https://github.com/yotammanor/gdm/blob/main/CODE_OF_CONDUCT.md).
+
+```console
+uv run pytest
+uv run ruff check .
+uv run mkdocs build --strict
+```
+
+---
+
+## License
+
+MIT © [Yotam Manor](https://github.com/yotammanor)

google_drive_model-0.1.0/README.md

@@ -0,0 +1,243 @@
+# Google Drive Model
+
+<p align="center">
+  <em>Pydantic models and a SQLModel-inspired session for Google Drive folders and Sheets.</em>
+</p>
+
+<p align="center">
+  <a href="https://github.com/yotammanor/gdm/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/yotammanor/gdm/ci.yml?branch=main&label=CI" alt="CI status"></a>
+  <a href="https://github.com/yotammanor/gdm/blob/main/LICENSE"><img src="https://img.shields.io/github/license/yotammanor/gdm.svg" alt="License: MIT"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.11–3.14-blue.svg" alt="Python 3.11–3.14"></a>
+  <a href="https://pydantic.dev"><img src="https://img.shields.io/badge/Pydantic-v2-3776AB.svg" alt="Pydantic v2"></a>
+  <img src="https://img.shields.io/badge/status-alpha-orange.svg" alt="Development status: alpha">
+</p>
+
+---
+
+**GDM** maps Pydantic models onto **existing Drive folders** and **Google Sheets rows** with a familiar `Session`, `select()`, and `Field()` API—without pretending Drive is a relational database.
+
+Center your app on a **mixed folder** already full of Google Docs, Slides, images, PDFs, shortcuts, and nested subfolders. GDM maps Drive metadata with `Field(drive=...)`, application metadata with `Field(metadata=...)`, and keeps **native bodies lazy** until you call `object.content`.
+
+> **Distribution vs import name:** install **`google-drive-model`**. The PyPI
+> name `gdm` is taken by an unrelated dependency manager. Import and CLI use
+> **`gdm`**:
+>
+> ```python
+> from gdm import GDM, GDMModel, DriveCollection, Session, select
+> ```
+
+**Documentation:** [yotammanor.github.io/gdm](https://yotammanor.github.io/gdm/)
+· [docs source](https://github.com/yotammanor/gdm/tree/main/docs)
+· **Design:** [`docs/design.md`](https://github.com/yotammanor/gdm/blob/main/docs/design.md)
+
+---
+
+## Why GDM?
+
+| You have… | GDM gives you… |
+| --- | --- |
+| A launch folder with Docs, decks, and PNGs | `DriveCollection[T]` over direct children; MIME filters; lazy native content |
+| A team spreadsheet with extra columns | Progressive sheet mapping—bind declared fields, preserve the rest |
+| Scripts that need typed reads/writes | Pydantic validation on every boundary crossing |
+| Multiple apps on one Google account | Root-scoped projects with isolated `.gdm/` metadata |
+
+GDM is **honest about platform limits**: no cross-file transactions, no server-side joins, no row-level security. Drive permissions remain the security boundary.
+
+---
+
+## Installation
+
+Install from PyPI:
+
+```console
+pip install "google-drive-model[oauth]"
+```
+
+To work from source:
+
+```console
+git clone https://github.com/yotammanor/gdm.git
+cd gdm
+uv sync --all-groups --frozen
+```
+
+| Extra | Purpose |
+| --- | --- |
+| `oauth` | Interactive installed-app login (`google-auth-oauthlib`) |
+| `yaml` | YAML codec for opt-in structured file collections |
+
+---
+
+## Quickstart: adopt a Drive folder
+
+### 1. Authenticate and open a project
+
+```console
+gdm auth login
+gdm --project-dir . --apply init --root-id YOUR_ROOT_FOLDER_ID --name my-app --remote
+```
+
+This creates the shared project manifest, registry, and collection metadata area
+under the Drive root. Tokens and local schema/index state stay local.
+
+### 2. Define a collection model
+
+```python
+from gdm import DriveObjectMixin, Field, GDMModel
+
+
+class CampaignAsset(
+    GDMModel,
+    DriveObjectMixin,
+    storage="collection",
+    collection="Campaigns/Launch",
+    mapping="partial",
+):
+    campaign: str | None = Field(default=None, metadata="campaign")
+    approved: bool = Field(default=False, metadata="approved")
+```
+
+`DriveObjectMixin` adds standard read-only Drive fields (`drive_id`, `name`, `mime_type`, …) mapped with `Field(drive=...)`.
+
+### 3. Connect, bind, and use the collection
+
+```python
+from gdm import GDM, select
+
+
+client = GDM.open(root_folder_id="YOUR_ROOT_FOLDER_ID")
+client.bind_collection(
+    CampaignAsset,
+    path="Campaigns/Launch",  # resolved once; immutable folder ID is persisted
+)
+
+assets = client.collection(CampaignAsset)
+images = assets.where_mime("image/*")
+logo = images.get("IMAGE_FILE_ID")
+brief = assets.get("GOOGLE_DOC_FILE_ID")
+
+data = logo.content.download()  # explicit — metadata queries skip bodies
+doc = brief.content.google_doc()  # native Docs API handle
+doc.batch_update([...])
+
+with client.session() as session:
+    approved = session.exec(
+        select(CampaignAsset).where(CampaignAsset.approved == True)  # noqa: E712
+    ).all()
+```
+
+Collection operations are **explicit about safety**: `adopt` vs `move` vs `shortcut`, `detach` vs `trash`, and `delete_permanently` for irreversible removal. `session.delete()` trashes collection members; it never silently purges Drive files.
+
+See the [Drive collections tutorial](https://yotammanor.github.io/gdm/tutorial/collection/) for duplicate names, shortcuts, recursion, and metadata reconciliation.
+
+---
+
+## Sheet tables (second story)
+
+Bind a worksheet without rewriting your team's sheet:
+
+```python
+from gdm import Field, GDMModel
+
+
+class Task(GDMModel, storage="sheet", mapping="partial", source="Tasks/Q1"):
+    id: str | None = Field(default=None, primary_key=True)
+    title: str
+    status: str = "todo"
+```
+
+```python
+from gdm import GDM, ResourceKind, select
+
+
+client = GDM.open(root_folder_id="YOUR_ROOT_FOLDER_ID")
+client.bind(
+    Task,
+    resource_id="YOUR_SPREADSHEET_ID",
+    kind=ResourceKind.SPREADSHEET,
+    worksheet="Tasks",
+)
+with client.session() as session:
+    open_tasks = session.exec(select(Task).where(Task.status == "open").limit(50)).all()
+    session.add(Task(title="Ship docs", status="open"))
+    session.commit()
+```
+
+Foreign keys can reference **Drive file IDs** from collection models. Relationships resolve client-side with `session.prefetch()`—see [Relationships](https://yotammanor.github.io/gdm/storage/relationships/).
+
+---
+
+## CLI
+
+| Command | Purpose |
+| --- | --- |
+| `gdm init` | Local `.gdm/` scaffolding; optional remote project with `--apply --remote` |
+| `gdm explore` | Inventory a folder (metadata only—zero content reads) |
+| `gdm infer collection` | Suggest a collection model from Drive metadata |
+| `gdm infer file` | Infer from a local JSON/text/CSV sample |
+| `gdm adopt` | Bind a folder (dry-run by default) |
+| `gdm doctor` | Metadata reconciliation, drift, scale warnings |
+| `gdm migrate plan/apply/rollback` | Forward, resumable migrations with declared rollback steps |
+| `gdm index rebuild` | Rebuild optional sidecar indexes |
+| `gdm auth login` | Interactive OAuth |
+
+Terminal demo (**actual local CLI recording**, no live OAuth or Drive mutations):
+
+<p align="center">
+  <a href="https://github.com/yotammanor/gdm/blob/main/docs/assets/demo.cast"><img src="https://raw.githubusercontent.com/yotammanor/gdm/main/docs/assets/demo.gif" alt="Recorded GDM CLI demo — open demo.cast to play" width="740"></a>
+</p>
+
+Regenerate the canonical cast (and the GIF when `agg` is installed):
+`bash docs/assets/regenerate-demo.sh`
+
+---
+
+## Architecture at a glance
+
+```text
+Your Pydantic models (GDMModel + Field)
+        │
+        ▼
+   GDM client ──► DriveCollection[T]  (folder-native CRUD, lazy content)
+        │              │
+        │              └──► metadata Sheet under .gdm/collections/
+        ▼
+   Session / select()  ──► expression tree (metadata queries; no body fetch)
+        │
+        ├──► Sheets backend (rows, batchUpdate)
+        └──► Drive backend (files, appProperties routing keys)
+        │
+        ▼
+   Drive .gdm/ metadata (manifest, registry, collection metadata)
+   Local .gdm/ tooling state (schema snapshots, migration checkpoints, indexes)
+```
+
+**Key limitations** (by design):
+
+- `Session.commit()` coordinates writes but is **not** an ACID transaction across files.
+- Metadata queries never download native bodies; content access is explicit via `.content`.
+- Relationships and joins are **client-side** with batched prefetch.
+- Export produces portable views; native Docs/Slides mutation uses their respective APIs.
+- Docs and Slides use atomic revision preconditions. Drive binary and Sheets
+  updates use best-effort conflict checks because those APIs expose no general
+  conditional write precondition.
+
+Full rationale: [`docs/design.md`](https://github.com/yotammanor/gdm/blob/main/docs/design.md).
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/yotammanor/gdm/blob/main/CONTRIBUTING.md), [SECURITY.md](https://github.com/yotammanor/gdm/blob/main/SECURITY.md), and [CODE_OF_CONDUCT.md](https://github.com/yotammanor/gdm/blob/main/CODE_OF_CONDUCT.md).
+
+```console
+uv run pytest
+uv run ruff check .
+uv run mkdocs build --strict
+```
+
+---
+
+## License
+
+MIT © [Yotam Manor](https://github.com/yotammanor)

google_drive_model-0.1.0/pyproject.toml

@@ -0,0 +1,164 @@
+[project]
+name = "google-drive-model"
+version = "0.1.0"
+description = "Pydantic models and a SQLModel-inspired API for Google Drive and Sheets"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+keywords = [
+    "google-drive",
+    "google-sheets",
+    "orm",
+    "odm",
+    "pydantic",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: Pydantic :: 2",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+dependencies = [
+    "google-api-python-client>=2.160.0",
+    "google-auth>=2.37.0",
+    "google-auth-httplib2>=0.2.0",
+    "pydantic>=2.10.0",
+    "rich>=13.9.0",
+    "typer>=0.15.0",
+]
+
+[[project.authors]]
+name = "Yotam Manor"
+
+[project.optional-dependencies]
+oauth = ["google-auth-oauthlib>=1.2.1"]
+yaml = ["pyyaml>=6.0.2"]
+
+[project.scripts]
+gdm = "gdm.cli:app"
+
+[project.urls]
+Changelog = "https://github.com/yotammanor/gdm/blob/main/CHANGELOG.md"
+Documentation = "https://yotammanor.github.io/gdm/"
+Issues = "https://github.com/yotammanor/gdm/issues"
+Repository = "https://github.com/yotammanor/gdm"
+
+[build-system]
+requires = ["uv_build>=0.10.6,<0.11.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "google-auth-oauthlib>=1.2.1",
+    "mkdocs-material>=9.6.0",
+    "mkdocstrings[python]>=0.28.0",
+    "pyyaml>=6.0.2",
+    "pytest>=8.3.0",
+    "pytest-cov>=6.0.0",
+    "pytest-mock>=3.14.0",
+    "ruff>=0.11.0",
+    "twine>=6.1.0",
+    "ty>=0.0.1a18",
+]
+
+[tool.uv.build-backend]
+module-name = "gdm"
+
+[tool.pytest.ini_options]
+addopts = [
+    "--strict-config",
+    "--strict-markers",
+    "-ra",
+]
+testpaths = ["tests"]
+markers = ["live: uses a real Google Drive account"]
+
+[tool.coverage.run]
+branch = true
+source = ["gdm"]
+
+[tool.coverage.report]
+exclude_also = [
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+]
+fail_under = 90
+show_missing = true
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+    "A",
+    "ANN",
+    "B",
+    "C4",
+    "E",
+    "F",
+    "I",
+    "N",
+    "PIE",
+    "PT",
+    "RUF",
+    "SIM",
+    "UP",
+]
+ignore = ["ANN401"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "ANN",
+    "SIM117",
+]
+"tests/test_structured_codecs.py" = [
+    "ANN",
+    "SIM117",
+]
+"tests/test_google_api_extra.py" = ["N802"]
+"src/gdm/google_api.py" = [
+    "N802",
+    "N803",
+    "A002",
+]
+"src/gdm/auth.py" = ["N806"]
+"src/gdm/errors.py" = ["N818"]
+"src/gdm/backends/drive.py" = ["N803"]
+"src/gdm/backends/sheets.py" = [
+    "N803",
+    "A002",
+    "N802",
+]
+"src/gdm/permissions.py" = ["N803"]
+"src/gdm/sync.py" = [
+    "N803",
+    "N802",
+]
+"src/gdm/project.py" = ["N803"]
+"src/gdm/fields.py" = ["A002"]
+"src/gdm/collection/metadata.py" = ["N803"]
+"tests/collection_fakes.py" = [
+    "N802",
+    "N803",
+    "SIM102",
+]
+"tests/fakes.py" = [
+    "N802",
+    "N803",
+    "A002",
+    "SIM102",
+    "E501",
+]
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ty.src]
+include = ["src"]