python-checks 0.3.0__py3-none-any.whl → 0.3.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {python_checks-0.3.0.dist-info → python_checks-0.3.1.dist-info}/METADATA +15 -10
- {python_checks-0.3.0.dist-info → python_checks-0.3.1.dist-info}/RECORD +5 -5
- {python_checks-0.3.0.dist-info → python_checks-0.3.1.dist-info}/WHEEL +0 -0
- {python_checks-0.3.0.dist-info → python_checks-0.3.1.dist-info}/entry_points.txt +0 -0
- {python_checks-0.3.0.dist-info → python_checks-0.3.1.dist-info}/licenses/LICENSE +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: python-checks
|
|
3
|
-
Version: 0.3.
|
|
3
|
+
Version: 0.3.1
|
|
4
4
|
Summary: Проверки архитектурных соглашений проекта
|
|
5
5
|
Author: Armontex
|
|
6
6
|
Author-email: Armontex <windle1337@gmail.com>
|
|
@@ -12,6 +12,11 @@ Requires-Dist: pydantic-settings>=2.15.0,<3
|
|
|
12
12
|
Requires-Dist: rich>=14.0.0,<16.0.0
|
|
13
13
|
Requires-Dist: typer>=0.27.2,<0.28
|
|
14
14
|
Requires-Python: >=3.14
|
|
15
|
+
Project-URL: Homepage, https://github.com/Armontex/py-checks
|
|
16
|
+
Project-URL: Source, https://github.com/Armontex/py-checks
|
|
17
|
+
Project-URL: Issues, https://github.com/Armontex/py-checks/issues
|
|
18
|
+
Project-URL: Changelog, https://github.com/Armontex/py-checks/blob/main/CHANGELOG.md
|
|
19
|
+
Project-URL: Documentation, https://github.com/Armontex/py-checks/blob/main/docs/service.md
|
|
15
20
|
Description-Content-Type: text/markdown
|
|
16
21
|
|
|
17
22
|
<div align="center">
|
|
@@ -24,11 +29,11 @@ Description-Content-Type: text/markdown
|
|
|
24
29
|
|
|
25
30
|
[](https://github.com/Armontex/py-checks/actions/workflows/ci.yml)
|
|
26
31
|
[](https://www.python.org/)
|
|
27
|
-
[](#что-проверяется)
|
|
28
33
|
[](#pre-commit)
|
|
29
34
|
[](https://docs.astral.sh/ruff/)
|
|
30
35
|
[](https://microsoft.github.io/pyright/)
|
|
31
|
-
[](LICENSE)
|
|
36
|
+
[](https://github.com/Armontex/py-checks/blob/main/LICENSE)
|
|
32
37
|
|
|
33
38
|
</div>
|
|
34
39
|
|
|
@@ -60,7 +65,7 @@ src/app/presentation/api/v1/routers/bets.py:22:1: endpoint-declarations: POST /b
|
|
|
60
65
|
- **Правило универсально, таблица — ваша.** Одно правило «этот вызов живёт только здесь» закрывает и границу транзакции, и запрет `float` в домене. Библиотека не содержит ни одного имени вашего проекта.
|
|
61
66
|
- **Отказ объясняет себя.** Сообщение говорит, что не так и чем это заменить, а не «нарушение правила №14».
|
|
62
67
|
- **Исключение стоит одной строки, но требует причины.** `# check-ok: raw-sql: проба живости, формы ORM нет` — пометка без причины сама становится нарушением.
|
|
63
|
-
- **Чужую работу мы не делаем.** Что умеют ruff, pyright и import-linter — остаётся за ними; что и почему туда отдано, записано в [`docs/service.md`](docs/service.md).
|
|
68
|
+
- **Чужую работу мы не делаем.** Что умеют ruff, pyright и import-linter — остаётся за ними; что и почему туда отдано, записано в [`docs/service.md`](https://github.com/Armontex/py-checks/blob/main/docs/service.md).
|
|
64
69
|
|
|
65
70
|
## Установка
|
|
66
71
|
|
|
@@ -107,7 +112,7 @@ py-checks explain determinism # что правило требует и как
|
|
|
107
112
|
|
|
108
113
|
## Что проверяется
|
|
109
114
|
|
|
110
|
-
Двадцать
|
|
115
|
+
Двадцать восемь правил в девяти группах:
|
|
111
116
|
|
|
112
117
|
| Группа | О чём |
|
|
113
118
|
|---|---|
|
|
@@ -122,7 +127,7 @@ py-checks explain determinism # что правило требует и как
|
|
|
122
127
|
| `hygiene` | потолок у зависимости |
|
|
123
128
|
|
|
124
129
|
<details>
|
|
125
|
-
<summary>Все двадцать
|
|
130
|
+
<summary>Все двадцать восемь</summary>
|
|
126
131
|
|
|
127
132
|
| Код | Что падает | Вид |
|
|
128
133
|
|---|---|:-:|
|
|
@@ -159,7 +164,7 @@ py-checks explain determinism # что правило требует и как
|
|
|
159
164
|
|
|
160
165
|
Каждое правило объясняет себя целиком — `py-checks explain <код>` печатает
|
|
161
166
|
докстринг с причиной и список настроек. Заготовка таблиц для типового сервиса
|
|
162
|
-
лежит в [`docs/service.md`](docs/service.md).
|
|
167
|
+
лежит в [`docs/service.md`](https://github.com/Armontex/py-checks/blob/main/docs/service.md).
|
|
163
168
|
|
|
164
169
|
### Три вида правил
|
|
165
170
|
|
|
@@ -179,7 +184,7 @@ text("SELECT 1") # db-ok: raw-sql: проба живости, формы ORM н
|
|
|
179
184
|
|
|
180
185
|
Каноническая форма — `# check-ok: <код>: <причина>`, она снимает ровно одно
|
|
181
186
|
правило. У каждой группы есть своё короткое слово (`# db-ok`, `# type-ok`,
|
|
182
|
-
`# signature-ok`, …): человек помнит группу, а не двадцать
|
|
187
|
+
`# signature-ok`, …): человек помнит группу, а не двадцать восемь кодов.
|
|
183
188
|
|
|
184
189
|
Пометок в строке может стоять несколько — подпись в столбик собирает их на
|
|
185
190
|
последней строке:
|
|
@@ -335,8 +340,8 @@ uv run pytest -q
|
|
|
335
340
|
`tests/projects/<код>__<вариант>/`. Библиотека проверяет сама себя: правило,
|
|
336
341
|
которое не выдерживает свой же репозиторий, до чужого доезжать не должно.
|
|
337
342
|
|
|
338
|
-
Соглашения репозитория — в [`AGENTS.md`](AGENTS.md).
|
|
343
|
+
Соглашения репозитория — в [`AGENTS.md`](https://github.com/Armontex/py-checks/blob/main/AGENTS.md).
|
|
339
344
|
|
|
340
345
|
## Лицензия
|
|
341
346
|
|
|
342
|
-
[MIT](LICENSE) — © 2026 Armontex.
|
|
347
|
+
[MIT](https://github.com/Armontex/py-checks/blob/main/LICENSE) — © 2026 Armontex.
|
|
@@ -94,8 +94,8 @@ py_checks/environment/_settings.py,sha256=Pr0xE05tt7iagffzK11NncTN22QeoZKtxA2zuC
|
|
|
94
94
|
py_checks/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
95
95
|
py_checks/sync/__init__.py,sha256=Kg08BC7arCTqdFk2tO3qm95_jG-X0vxK-GMvVYJEkXc,1041
|
|
96
96
|
py_checks/sync/_sync.py,sha256=KqA65H4zeP6y17LwlRR8svpCuhUdFCY3KIwG3YtuvAk,2254
|
|
97
|
-
python_checks-0.3.
|
|
98
|
-
python_checks-0.3.
|
|
99
|
-
python_checks-0.3.
|
|
100
|
-
python_checks-0.3.
|
|
101
|
-
python_checks-0.3.
|
|
97
|
+
python_checks-0.3.1.dist-info/licenses/LICENSE,sha256=omcAXq_cAQNMI5X3fRdH7UC6W2Zc8AC-G9xIZ2U1xF0,1065
|
|
98
|
+
python_checks-0.3.1.dist-info/WHEEL,sha256=R1d3uUTbmXM1FHXH_itQashbrqrOSVj-hvBCpmkIIGE,81
|
|
99
|
+
python_checks-0.3.1.dist-info/entry_points.txt,sha256=59rS_KMwYdFnQ9HuhkBpKQNKySNAALyneIFO_-cVQvw,1679
|
|
100
|
+
python_checks-0.3.1.dist-info/METADATA,sha256=4L29ylf6LRb_U_YQ9DBVDzGMBb0htYdIEAeusbx6T0A,20322
|
|
101
|
+
python_checks-0.3.1.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|
|
File without changes
|