sqlmodel-object-helpers 0.0.6__tar.gz → 0.0.8__tar.gz

sqlmodel_object_helpers-0.0.8/.git-blame-ignore-revs

@@ -0,0 +1,5 @@
+# Коммиты, которые меняют только форматирование. Включить локально:
+#     git config blame.ignoreRevsFile .git-blame-ignore-revs
+
+# Нормализация переводов строк в LF, 2026-09-08
+118793bd5af93982889c382fb19b6c55aedc5dd8

sqlmodel_object_helpers-0.0.8/.gitattributes

@@ -0,0 +1,16 @@
+# Enforce LF line endings for all text files
+* text=auto eol=lf
+
+# Explicitly mark as text
+*.py text eol=lf
+*.toml text eol=lf
+*.md text eol=lf
+*.txt text eol=lf
+*.json text eol=lf
+*.yaml text eol=lf
+*.yml text eol=lf
+
+# Binary files (no conversion)
+*.png binary
+*.jpg binary
+*.ico binary

{sqlmodel_object_helpers-0.0.6 → sqlmodel_object_helpers-0.0.8}/.gitignore

@@ -21,7 +21,8 @@ htmlcov/
 
 # IDEs
 .idea/
-.vscode/
+.vscode/*
+!.vscode/settings.json
 *.swp
 *.swo
 
@@ -32,3 +33,12 @@ htmlcov/
 Thumbs.db
 Desktop.ini
 .DS_Store
+
+# --- личное окружение разработчика (общий блок ci-templates) ---
+.claude/
+.cursor/
+.windsurf/
+
+# --- кеши инструментов ---
+.uv-cache/
+.ruff_cache/

sqlmodel_object_helpers-0.0.8/.vscode/settings.json

@@ -0,0 +1,81 @@
+{
+  // Общий стандарт python-парка. Настройки редактора.
+  // Источник: devops/ci-templates/standards/vscode-settings.json @ v1.18.0
+  // Кладётся в репозиторий как .vscode/settings.json.
+  //
+  // ЛИЧНОЕ СЮДА НЕ ДОПИСЫВАТЬ. Файл общий, его sha256 сверяет блокирующая
+  // джоба standards_check. Привычки редактора (autofetch, renderWhitespace,
+  // suggest.*, тема) и настройки своих расширений держите в СВОИХ настройках
+  // VS Code: Ctrl+Shift+P -> Preferences: Open User Settings (JSON). Оттуда
+  // они работают сразу во всех репозиториях парка, а не в одном, и никакой
+  // pull их не тронет. Всё прочее в .vscode/ (mcp.json, sftp.json) в git
+  // не едет и никогда не ехало.
+
+  // Главное. Без fromEnvironment расширение берёт СВОЙ встроенный ruff
+  // произвольной версии, и результат у разработчика расходится с CI даже при
+  // одинаковом конфиге. С этой настройкой берётся ruff из .venv проекта,
+  // то есть ровно тот, что запинен в uv.lock и запускается в пайплайне.
+  "ruff.importStrategy": "fromEnvironment",
+
+  // Второе главное. Умолчание расширения — editorFirst: ключи ruff.lint.select,
+  // ruff.lint.ignore и ruff.lineLength из настроек редактора ПЕРЕБИВАЮТ
+  // ruff.toml. standards_check при этом зелёный — он сверяет сам ruff.toml, —
+  // а разработчик локально линтует другим набором правил и форматирует по
+  // другой ширине. filesystemFirst возвращает единственный источник правды.
+  "ruff.configurationPreference": "filesystemFirst",
+
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv",
+
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+      "source.fixAll.ruff": "explicit",
+      "source.organizeImports.ruff": "explicit"
+    },
+    // Линейка совпадает с line-length в ruff.toml.
+    "editor.rulers": [120]
+  },
+
+  // Проверку типов ведёт pyright по общему pyrightconfig.json,
+  // поэтому встроенный анализатор не дублирует его своим режимом.
+  "python.analysis.typeCheckingMode": "off",
+  "python.analysis.autoImportCompletions": true,
+
+  // Файлы общего стандарта редактор держит только на чтение. Закрывает частый
+  // случай: при "[json]": {"editor.formatOnSave": true} открытие и сохранение
+  // pyrightconfig.json переформатирует его и уронит standards_check.
+  // Разовая правка — команда «File: Toggle Active Editor Read-only in Session».
+  "files.readonlyInclude": {
+    "ruff.toml": true,
+    "pyrightconfig.json": true,
+    ".vscode/settings.json": true
+  },
+
+  // Команда работает и на Windows, и на Linux, а один случайный CRLF даёт
+  // diff на весь файл. Со стороны git то же самое делает .gitattributes.
+  "files.eol": "\n",
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true,
+
+  // Вотчер .gitignore не читает вообще, исключения ему нужны свои. У
+  // sro-agent-core [tool.uv] cache-dir = ".uv-cache" держит кеш пакетов
+  // ВНУТРИ репозитория — без этого редактор ходит по распакованным колёсам.
+  "files.watcherExclude": {
+    "**/__pycache__": true,
+    "**/.venv": true,
+    "**/.uv-cache": true,
+    "**/.ruff_cache": true,
+    "**/.pytest_cache": true
+  },
+
+  // Поиск по умолчанию уважает .gitignore, но тот дырявый: .uv-cache закрыт
+  // в 3 репозиториях из 19, .pytest_cache — в 11.
+  "search.exclude": {
+    "**/__pycache__": true,
+    "**/.venv": true,
+    "**/.uv-cache": true,
+    "**/.ruff_cache": true,
+    "**/.pytest_cache": true
+  }
+}

{sqlmodel_object_helpers-0.0.6 → sqlmodel_object_helpers-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: sqlmodel-object-helpers
-Version: 0.0.6
+Version: 0.0.8
 Summary: Generic async query helpers for SQLModel: filtering, eager loading, pagination
 Project-URL: Homepage, https://github.com/itstandart/sqlmodel-object-helpers
 Project-URL: Repository, https://github.com/itstandart/sqlmodel-object-helpers
@@ -22,13 +22,10 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.14
 Requires-Dist: pydantic>=2.12
-Requires-Dist: sqlalchemy>=2.0.46
+Requires-Dist: sqlalchemy[asyncio]>=2.0.46
 Requires-Dist: sqlmodel>=0.0.22
 Provides-Extra: dev
-Requires-Dist: aiosqlite>=0.20; extra == 'dev'
 Requires-Dist: mypy>=1.13.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
 Requires-Dist: ruff>=0.8.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
@@ -295,7 +292,7 @@ result = await soh.get_objects(
 users = await soh.get_objects(
     session, User,
     filters={"is_active": {soh.Operator.EQ: True}, "role": {soh.Operator.EQ: "admin"}},
-    logical_operator="OR",
+    logical_operator=soh.LogicalOperator.OR,
 )
 
 # Relationship filters (dot-notation)
@@ -523,6 +520,8 @@ Used by `get_objects`. Nested dicts are auto-flattened via `flatten_filters`:
 
 `Operator` is a `StrEnum` — each member equals its string value (`Operator.EQ == "eq"`), so string keys still work but enum members provide type safety and autocompletion.
 
+`logical_operator` of `get_objects`, `count_objects`, `update_objects` and `delete_objects` takes `soh.LogicalOperator.AND` (default) or `soh.LogicalOperator.OR`; the strings `"AND"`/`"OR"` in any case still work. Any other value raises `InvalidFilterError`, even with `suspend_error=True`.
+
 Multiple operators can be combined on a single field: `{"age": {soh.Operator.GE: 18, soh.Operator.LE: 65}}`.
 
 ### Typed Filter Models
@@ -569,6 +568,15 @@ Each date part accepts ISO (`2026-04-01`, `2026-04-01T00:00:00Z`) and display fo
 - `FilterDatetimeRange` — produces UTC-aware datetimes
 - `FilterNaiveDatetimeRange` — produces naive (timezone-unaware) datetimes
 
+#### Datetime columns and SQLModel ≥0.0.45
+
+Since SQLModel 0.0.45 a bare `datetime` field (no `sa_type` / `sa_column`) becomes `UTCDateTime` — `TIMESTAMP WITH TIME ZONE` that rejects naive values and returns UTC-aware ones. soh works on both sides of this change:
+
+- Filter such columns with `FilterDatetime`, `FilterDatetimeRange`, `TimeFilter` or aware `datetime` values. A naive value is rejected by SQLModel and surfaces as `soh.DatabaseError`.
+- `FilterNaiveDatetime` / `FilterNaiveDatetimeRange` are for columns declared explicitly as naive: `sa_type=DateTime` or `sa_column=Column(DateTime())`.
+- `build_dynamic_meta` reports `UTCDateTime` columns as `datetime`.
+- SQLModel does not migrate existing database columns. Over an existing `timestamp` column a bare `datetime` field reads values as UTC and, when the PostgreSQL session `TimeZone` is not UTC, writes them shifted by its offset. To keep the current behaviour of a bare `datetime` field, declare its database type explicitly: `sa_column=Column(DateTime())` for `timestamp`, `sa_column=Column(DateTime(timezone=True))` for `timestamptz`.
+
 ## Eager Loading
 
 The library automatically selects the optimal loading strategy:
@@ -666,8 +674,11 @@ Physical column types are mapped automatically. Unknown types fall back to `stri
 | `Integer`, `BigInteger`, `SmallInteger` | `integer` |
 | `Numeric`, `Float` | `float` |
 | `String`, `Text`, `Enum`, `Interval`, `ARRAY`, `Uuid` | `string` |
+| Unmapped `TypeDecorator` (e.g. SQLModel `UTCDateTime`) | type of its `impl` |
 | Any other type | `string` (fallback) |
 
+`Interval` is a `TypeDecorator` over `DateTime`, but its own entry wins, so it stays `string`.
+
 ### Label precedence (per physical column)
 
 1. `pg_description` — DBA edit via `COMMENT ON COLUMN` (supports per-role `||` overrides)
@@ -783,6 +794,7 @@ Endpoints can be migrated one at a time. Three strategies per endpoint:
 ### Operators
 
 - `soh.Operator` -- StrEnum of operator names
+- `soh.LogicalOperator` -- StrEnum `AND`/`OR` for the `logical_operator` argument
 - `soh.SUPPORTED_OPERATORS` -- Dict mapping operator names to SQLAlchemy lambdas
 - `soh.SPECIAL_OPERATORS` -- Frozenset of operators with extended handling (`{"exists"}`)
 
@@ -837,8 +849,8 @@ Endpoints can be migrated one at a time. Three strategies per endpoint:
 ## Development
 
 ```bash
-pip install -e ".[dev]"
-pytest tests/
+uv sync
+uv run pytest tests/
 ```
 
 ### Syncing with Remote
@@ -882,6 +894,15 @@ This project follows [Semantic Versioning](https://semver.org/) (MAJOR.MINOR.PAT
 
 ## Changelog
 
+### 0.0.8 — 2026-10-09
+
+- **SQLModel ≥0.0.45 support** — `build_dynamic_meta` maps an unmapped `TypeDecorator` by its `impl`, so bare `datetime` fields (`UTCDateTime` in SQLModel ≥0.0.45) stay `datetime` instead of falling back to `string`. `Interval` stays `string`. Tested on SQLModel 0.0.42 and 0.0.48. The `sqlmodel>=0.0.22` lower bound is unchanged.
+- Dependency is now `sqlalchemy[asyncio]` — the package imports `sqlalchemy.ext.asyncio`, and SQLAlchemy 2.1 (allowed by SQLModel 0.0.48) no longer installs `greenlet` by default.
+- **LogicalOperator** — `StrEnum` for `logical_operator`. An unknown value now raises `InvalidFilterError`; before, anything except `"AND"` silently meant OR. Plain strings `"AND"`/`"OR"` keep working.
+- Typing: `get_object` / `get_objects` overloads narrow the return type by `columns`, `pagination` and `suspend_error`; the package and tests are clean under the fleet `pyright` config.
+- Test dependencies moved to `[dependency-groups] dev` — `uv sync` installs them.
+- Docs: [Datetime columns and SQLModel ≥0.0.45](#datetime-columns-and-sqlmodel-0045).
+
 ### 0.0.6
 
 - **build_dynamic_meta** / **load_pg_comments** / **configure_meta_cache_ttl** / **invalidate_meta_cache** — dynamic UI metadata reader. Builds `TableMeta` and `list[ColumnMeta]` from a SQLModel class by reading PostgreSQL `pg_description` (TTL-cached, default 60s) with fallback to `Column(comment=...)` defaults from the model. Supports per-role label/row_link overrides via extended `||` comment format. For physical columns the label precedence is `pg_description` > `Column(comment=...)` model default. For virtual columns (paths with `.` traversing relationships) and full overrides — pass a fully-specified `ColumnMeta` instance directly in the `columns` list (used as-is, no derivation). Lookup `lookup_dict`/`lookup_path` are derived from FK on `*_lkp` tables by `{schema}_{base}` convention. Type derived from SA column type. DBAs can edit labels via `COMMENT ON COLUMN/TABLE` SQL — frontend reflects changes within cache TTL without redeploy. No sync block, no schema migrations introduced; the application's `db.py` is not touched.

{sqlmodel_object_helpers-0.0.6 → sqlmodel_object_helpers-0.0.8}/README.md

@@ -261,7 +261,7 @@ result = await soh.get_objects(
 users = await soh.get_objects(
     session, User,
     filters={"is_active": {soh.Operator.EQ: True}, "role": {soh.Operator.EQ: "admin"}},
-    logical_operator="OR",
+    logical_operator=soh.LogicalOperator.OR,
 )
 
 # Relationship filters (dot-notation)
@@ -489,6 +489,8 @@ Used by `get_objects`. Nested dicts are auto-flattened via `flatten_filters`:
 
 `Operator` is a `StrEnum` — each member equals its string value (`Operator.EQ == "eq"`), so string keys still work but enum members provide type safety and autocompletion.
 
+`logical_operator` of `get_objects`, `count_objects`, `update_objects` and `delete_objects` takes `soh.LogicalOperator.AND` (default) or `soh.LogicalOperator.OR`; the strings `"AND"`/`"OR"` in any case still work. Any other value raises `InvalidFilterError`, even with `suspend_error=True`.
+
 Multiple operators can be combined on a single field: `{"age": {soh.Operator.GE: 18, soh.Operator.LE: 65}}`.
 
 ### Typed Filter Models
@@ -535,6 +537,15 @@ Each date part accepts ISO (`2026-04-01`, `2026-04-01T00:00:00Z`) and display fo
 - `FilterDatetimeRange` — produces UTC-aware datetimes
 - `FilterNaiveDatetimeRange` — produces naive (timezone-unaware) datetimes
 
+#### Datetime columns and SQLModel ≥0.0.45
+
+Since SQLModel 0.0.45 a bare `datetime` field (no `sa_type` / `sa_column`) becomes `UTCDateTime` — `TIMESTAMP WITH TIME ZONE` that rejects naive values and returns UTC-aware ones. soh works on both sides of this change:
+
+- Filter such columns with `FilterDatetime`, `FilterDatetimeRange`, `TimeFilter` or aware `datetime` values. A naive value is rejected by SQLModel and surfaces as `soh.DatabaseError`.
+- `FilterNaiveDatetime` / `FilterNaiveDatetimeRange` are for columns declared explicitly as naive: `sa_type=DateTime` or `sa_column=Column(DateTime())`.
+- `build_dynamic_meta` reports `UTCDateTime` columns as `datetime`.
+- SQLModel does not migrate existing database columns. Over an existing `timestamp` column a bare `datetime` field reads values as UTC and, when the PostgreSQL session `TimeZone` is not UTC, writes them shifted by its offset. To keep the current behaviour of a bare `datetime` field, declare its database type explicitly: `sa_column=Column(DateTime())` for `timestamp`, `sa_column=Column(DateTime(timezone=True))` for `timestamptz`.
+
 ## Eager Loading
 
 The library automatically selects the optimal loading strategy:
@@ -632,8 +643,11 @@ Physical column types are mapped automatically. Unknown types fall back to `stri
 | `Integer`, `BigInteger`, `SmallInteger` | `integer` |
 | `Numeric`, `Float` | `float` |
 | `String`, `Text`, `Enum`, `Interval`, `ARRAY`, `Uuid` | `string` |
+| Unmapped `TypeDecorator` (e.g. SQLModel `UTCDateTime`) | type of its `impl` |
 | Any other type | `string` (fallback) |
 
+`Interval` is a `TypeDecorator` over `DateTime`, but its own entry wins, so it stays `string`.
+
 ### Label precedence (per physical column)
 
 1. `pg_description` — DBA edit via `COMMENT ON COLUMN` (supports per-role `||` overrides)
@@ -749,6 +763,7 @@ Endpoints can be migrated one at a time. Three strategies per endpoint:
 ### Operators
 
 - `soh.Operator` -- StrEnum of operator names
+- `soh.LogicalOperator` -- StrEnum `AND`/`OR` for the `logical_operator` argument
 - `soh.SUPPORTED_OPERATORS` -- Dict mapping operator names to SQLAlchemy lambdas
 - `soh.SPECIAL_OPERATORS` -- Frozenset of operators with extended handling (`{"exists"}`)
 
@@ -803,8 +818,8 @@ Endpoints can be migrated one at a time. Three strategies per endpoint:
 ## Development
 
 ```bash
-pip install -e ".[dev]"
-pytest tests/
+uv sync
+uv run pytest tests/
 ```
 
 ### Syncing with Remote
@@ -848,6 +863,15 @@ This project follows [Semantic Versioning](https://semver.org/) (MAJOR.MINOR.PAT
 
 ## Changelog
 
+### 0.0.8 — 2026-10-09
+
+- **SQLModel ≥0.0.45 support** — `build_dynamic_meta` maps an unmapped `TypeDecorator` by its `impl`, so bare `datetime` fields (`UTCDateTime` in SQLModel ≥0.0.45) stay `datetime` instead of falling back to `string`. `Interval` stays `string`. Tested on SQLModel 0.0.42 and 0.0.48. The `sqlmodel>=0.0.22` lower bound is unchanged.
+- Dependency is now `sqlalchemy[asyncio]` — the package imports `sqlalchemy.ext.asyncio`, and SQLAlchemy 2.1 (allowed by SQLModel 0.0.48) no longer installs `greenlet` by default.
+- **LogicalOperator** — `StrEnum` for `logical_operator`. An unknown value now raises `InvalidFilterError`; before, anything except `"AND"` silently meant OR. Plain strings `"AND"`/`"OR"` keep working.
+- Typing: `get_object` / `get_objects` overloads narrow the return type by `columns`, `pagination` and `suspend_error`; the package and tests are clean under the fleet `pyright` config.
+- Test dependencies moved to `[dependency-groups] dev` — `uv sync` installs them.
+- Docs: [Datetime columns and SQLModel ≥0.0.45](#datetime-columns-and-sqlmodel-0045).
+
 ### 0.0.6
 
 - **build_dynamic_meta** / **load_pg_comments** / **configure_meta_cache_ttl** / **invalidate_meta_cache** — dynamic UI metadata reader. Builds `TableMeta` and `list[ColumnMeta]` from a SQLModel class by reading PostgreSQL `pg_description` (TTL-cached, default 60s) with fallback to `Column(comment=...)` defaults from the model. Supports per-role label/row_link overrides via extended `||` comment format. For physical columns the label precedence is `pg_description` > `Column(comment=...)` model default. For virtual columns (paths with `.` traversing relationships) and full overrides — pass a fully-specified `ColumnMeta` instance directly in the `columns` list (used as-is, no derivation). Lookup `lookup_dict`/`lookup_path` are derived from FK on `*_lkp` tables by `{schema}_{base}` convention. Type derived from SA column type. DBAs can edit labels via `COMMENT ON COLUMN/TABLE` SQL — frontend reflects changes within cache TTL without redeploy. No sync block, no schema migrations introduced; the application's `db.py` is not touched.

{sqlmodel_object_helpers-0.0.6 → sqlmodel_object_helpers-0.0.8}/pyproject.toml

@@ -27,7 +27,7 @@ classifiers = [
 ]
 dependencies = [
     "sqlmodel>=0.0.22",
-    "sqlalchemy>=2.0.46",
+    "sqlalchemy[asyncio]>=2.0.46",
     "pydantic>=2.12",
 ]
 
@@ -39,20 +39,10 @@ Issues = "https://github.com/itstandart/sqlmodel-object-helpers/issues"
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.0",
-    "pytest-asyncio>=0.21",
-    "aiosqlite>=0.20",
     "ruff>=0.8.0",
     "mypy>=1.13.0",
 ]
 
-[tool.ruff]
-target-version = "py314"
-line-length = 120
-
-[tool.ruff.lint]
-select = ["E", "F", "W", "I", "UP", "B", "SIM", "PTH"]
-
 [tool.mypy]
 python_version = "3.14"
 strict = true
@@ -62,3 +52,13 @@ path = "src/sqlmodel_object_helpers/__init__.py"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/sqlmodel_object_helpers"]
+
+[dependency-groups]
+dev = [
+    "ruff==0.16.10",
+    "pyright==1.1.414",
+    "tzdata==2026.5",
+    "pytest==9.1.1",
+    "pytest-asyncio==1.4.0",
+    "aiosqlite==0.22.1",
+]

sqlmodel_object_helpers-0.0.8/pyrightconfig.json

@@ -0,0 +1,38 @@
+{
+  // Общий стандарт python-парка. Проверка типов.
+  // Источник: devops/ci-templates/standards/pyrightconfig.json @ v1.11.0
+  //
+  // Файл одинаков во всех репозиториях и правится ТОЛЬКО в devops/ci-templates.
+  // Джоба standards_check сверяет его sha256 и упадёт на любой локальной правке.
+  //
+  // Локальное исключение — комментарий рядом с кодом:
+  //     value = obj.attr  # pyright: ignore[reportAttributeAccessIssue]  причина
+  // Если исключение общее для парка — оно едет сюда, а не в проект.
+
+  // Без этих двух ключей pyright не находит виртуальное окружение uv и считает
+  // ненайденным КАЖДЫЙ сторонний импорт: на канарейке это давало 32 ложных
+  // reportMissingImports из 47 ошибок.
+  "venvPath": ".",
+  "venv": ".venv",
+
+  // pythonVersion намеренно не задан: pyright берёт версию из интерпретатора
+  // в .venv, то есть из requires-python конкретного репозитория.
+
+  // standard — текущий режим pyright по умолчанию. На парке практически
+  // не отличается от устаревшего basic (16 против 17 ошибок на канарейке),
+  // а strict нереалистичен (297 на той же канарейке).
+  "typeCheckingMode": "standard",
+
+  // "**/.*" — это умолчание самого pyright, и его обязательно повторить здесь:
+  // задавая свой exclude, мы умолчание ЗАМЕНЯЕМ, а не дополняем. Без этой
+  // строки pyright заходит в скрытые каталоги, и у sro-agent-core, где
+  // [tool.uv] cache-dir = ".uv-cache" держит кеш пакетов ВНУТРИ репозитория,
+  // он анализировал ещё и распакованные колёса: джоба упиралась в потолок
+  // раннера 600 с и не заканчивалась вовсе (пайплайны #8517 и #8518).
+  // Сюда же попадают .venv, .git, .ruff_cache, .pytest_cache.
+  "exclude": [
+    "**/.*",
+    "**/node_modules",
+    "**/__pycache__"
+  ]
+}

sqlmodel_object_helpers-0.0.8/ruff.toml

@@ -0,0 +1,129 @@
+# Общий стандарт python-парка. Линтер и форматтер.
+# Источник: devops/ci-templates/standards/ruff.toml @ v1.25.0
+#
+# Файл одинаков во всех репозиториях и правится ТОЛЬКО в devops/ci-templates.
+# Джоба standards_check сверяет его sha256 и упадёт на любой локальной правке.
+#
+# Локальное исключение — noqa рядом с кодом и с причиной:
+#     result = query.all()  # noqa: S608  имя колонки только из whitelist
+#     # ruff: noqa: UP037   в шапке файла — на весь файл
+# Правило PGH004 не даст поставить noqa без кодов, RUF100 снимет протухшие.
+# Если исключение общее для парка — оно едет сюда, а не в проект.
+
+line-length = 120
+
+# target-version намеренно не задан: ruff берёт его из project.requires-python
+# в pyproject.toml каждого репозитория (проверено — работает и когда конфиг
+# лежит в отдельном ruff.toml). Так один общий файл остаётся корректным и для
+# библиотеки, объявляющей поддержку более старого Python.
+
+[lint]
+select = [
+    # pycodestyle + pyflakes — база
+    "E", "W", "F",
+    # сортировка импортов
+    "I",
+    # современный синтаксис под target-version
+    "UP",
+    # типовые дефекты и упрощения
+    "B", "SIM", "RET", "C4", "PIE", "PERF", "FURB",
+    # сложность функций, порог в [lint.mccabe]
+    "C901",
+    # pathlib вместо os.path
+    "PTH",
+    # безопасность (bandit)
+    "S",
+    # datetime без таймзоны
+    "DTZ",
+    # логирование
+    "LOG", "G",
+    # забытый print/pprint
+    "T20",
+    # корректность async
+    "ASYNC",
+    # except без типа
+    "BLE",
+    "INT", "YTT",
+    # RUF100 — протухшие noqa
+    "RUF",
+    # PGH004 — noqa обязан быть с кодами
+    "PGH",
+]
+
+ignore = [
+    # --- Конфликтуют с ruff format, держать выключенными ---
+    # (длину строки контролирует форматтер, отступы и табы — тоже)
+    "E501", "W191", "E101",
+
+    # --- Кириллица ---
+    # RUF001-003 считают кириллические буквы «двусмысленными» из-за похожих
+    # латинских. Для русскоязычного кода это сплошной шум: 2542 находки из 4690
+    # по парку на момент введения стандарта.
+    "RUF001", "RUF002", "RUF003",
+
+    # --- Порядок импортов ---
+    # settings и логгер поднимаются до импорта приложения — это осознанный
+    # порядок инициализации, а не небрежность.
+    "E402",
+]
+
+[lint.mccabe]
+# C901 — единственное измерение, которого в стандарте не было: ветвистость
+# функции ruff до сих пор не мерил вовсе, и её замечал только человек на ревью.
+#
+# Порог 15, а не дефолтные 10. На 10 в exam-crm-core 70 функций, в
+# sro-agent-core 17 — это фон, а не список к работе. На 15 остаётся 32 и 4,
+# и это ровно те места, куда никто не хочет лезть: migrate_fias_addresses (46),
+# recalculate_payments_new_with_session (45), set_block (44), get_objects (42)
+# в легаси-монолите exam-crm и sa_core_compiler.compile (21) в ядре sro-agent.
+#
+# Правило неблокирующее: ruff_lint идёт с allow_failure, а Code Quality в MR
+# показывает находки только на изменённых строках. То есть порог сторожит
+# НОВЫЕ сложные функции, а не требует переписать легаси. Понижать по мере
+# разбора, отдельными релизами.
+#
+# В per-file-ignores для тестов C901 не нужен: на пороге 15 в **/tests/**
+# обоих ядер ноль находок (проверено до введения правила).
+max-complexity = 15
+
+[lint.per-file-ignores]
+# Шаблон именно **/tests/**, а не tests/**: у exam-crm-core тесты лежат
+# в app/tests/, и корневой шаблон бы их не поймал.
+"**/tests/**" = [
+    # assert — это и есть тест
+    "S101",
+    # white-box-доступ к приватным атрибутам проверяемого объекта
+    "SLF001",
+    # магические значения в ожиданиях
+    "PLR2004",
+    # неиспользуемые аргументы фикстур и фейков, реализующих Protocol
+    "ARG",
+    # ленивые импорты внутри фикстур
+    "PLC0415",
+    # составные assert
+    "PT018",
+    # тестовым пакетам __init__.py не нужен
+    "INP001",
+    # пароли и токены в фикстурах — синтетика
+    "S105", "S106",
+    # naive datetime в ожиданиях
+    "DTZ001",
+    # __enter__ у тест-дублей возвращает self
+    "PYI034",
+    # bool-параметры в parametrize
+    "FBT001", "FBT002",
+    # закомментированный код в ожидаемых значениях
+    "ERA001",
+    # диагностический print
+    "T20",
+    # широкий except в проверках устойчивости
+    "BLE001",
+]
+
+[format]
+# ruff format умеет форматировать python-блоки внутри markdown, и по умолчанию
+# это включено. В парке 36 файлов .md с такими блоками (17 в exam-crm-core,
+# 11 в sro-agent-core): формат переписал бы примеры в документации, а
+# ruff format --check краснел бы на сокращённых и псевдокодовых сниппетах.
+# Стандарт касается кода, а не документации.
+exclude = ["*.md"]

{sqlmodel_object_helpers-0.0.6 → sqlmodel_object_helpers-0.0.8}/src/sqlmodel_object_helpers/__init__.py

@@ -1,6 +1,6 @@
 """sqlmodel-object-helpers — reusable query helpers for SQLModel projects."""
 
-__version__ = "0.0.6"
+__version__ = "0.0.8"
 
 from .constants import QueryHelperSettings, settings
 from .dynamic_meta import (
@@ -29,7 +29,7 @@ from .mutations import (
     update_object,
     update_objects,
 )
-from .operators import SPECIAL_OPERATORS, SUPPORTED_OPERATORS, Operator
+from .operators import SPECIAL_OPERATORS, SUPPORTED_OPERATORS, LogicalOperator, Operator
 from .query import count_objects, exists_object, get_object, get_objects, get_projection
 from .session import auto_session, configure, create_session_dependency
 from .types.columns import BoolLabels, ColumnMeta, ColumnType, TableMeta
@@ -61,28 +61,14 @@ from .types.pagination import (
 from .types.projections import ColumnSpec
 
 __all__ = [
-    "add_object",
-    "add_objects",
-    "auto_session",
-    "build_dynamic_meta",
-    "build_filter",
-    "build_flat_filter",
-    "build_load_chain",
-    "build_load_options",
-    "check_for_related_records",
+    "SPECIAL_OPERATORS",
+    "SUPPORTED_OPERATORS",
     "BoolLabels",
     "ColumnEntry",
     "ColumnMeta",
     "ColumnSpec",
     "ColumnType",
-    "configure",
-    "configure_meta_cache_ttl",
-    "count_objects",
-    "create_session_dependency",
     "DatabaseError",
-    "delete_object",
-    "delete_objects",
-    "exists_object",
     "FilterBool",
     "FilterDate",
     "FilterDatetime",
@@ -93,16 +79,11 @@ __all__ = [
     "FilterNaiveDatetimeRange",
     "FilterStr",
     "FilterTimedelta",
-    "flatten_filters",
-    "get_object",
-    "get_objects",
-    "get_projection",
     "GetAllPagination",
-    "invalidate_meta_cache",
     "InvalidFilterError",
     "InvalidLoadPathError",
-    "load_pg_comments",
     "LogicalFilter",
+    "LogicalOperator",
     "LookupMeta",
     "LookupResponse",
     "MutationError",
@@ -115,12 +96,32 @@ __all__ = [
     "PaginationR",
     "QueryError",
     "QueryHelperSettings",
-    "settings",
-    "SPECIAL_OPERATORS",
-    "SUPPORTED_OPERATORS",
     "TableMeta",
     "TimeFilter",
+    "UTCDatetime",
+    "add_object",
+    "add_objects",
+    "auto_session",
+    "build_dynamic_meta",
+    "build_filter",
+    "build_flat_filter",
+    "build_load_chain",
+    "build_load_options",
+    "check_for_related_records",
+    "configure",
+    "configure_meta_cache_ttl",
+    "count_objects",
+    "create_session_dependency",
+    "delete_object",
+    "delete_objects",
+    "exists_object",
+    "flatten_filters",
+    "get_object",
+    "get_objects",
+    "get_projection",
+    "invalidate_meta_cache",
+    "load_pg_comments",
+    "settings",
     "update_object",
     "update_objects",
-    "UTCDatetime",
 ]