pytest-fsd 0.2.0__tar.gz

pytest_fsd-0.2.0/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.3
+Name: pytest-fsd
+Version: 0.2.0
+Summary: Add your description here
+Author: Lebedev Nikita
+Author-email: Lebedev Nikita <rachet337@gmail.com>
+Requires-Dist: pytest-archon>=0.0.7
+Requires-Dist: tomli>=2.0.1 ; python_full_version < '3.11'
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# pytest-fsd
+
+**FSD Architecture Validation for Python Projects.**
+
+`pytest-fsd` автоматически проверяет архитектуру вашего Python-проекта на соответствие методологии [Feature-Sliced Design](https://feature-sliced.design/).
+
+Использует гибридный подход: динамические проверки через [pytest-archon](https://pypi.org/project/pytest-archon/) + статический AST-анализ + проверка файловой структуры.
+
+## Установка
+
+```bash
+pip install pytest-fsd
+# или
+uv add --dev pytest-fsd
+```
+
+## Использование
+
+### 1. Настройка `pyproject.toml`
+
+```toml
+[tool.pytest_fsd]
+base_path = "src"
+layers = ["app", "windows", "widgets", "features", "entities", "shared"]
+```
+
+### 2. Создание теста
+
+```python
+# tests/test_architecture.py
+from pytest_fsd import validate_fsd_architecture
+
+def test_project_architecture():
+    validate_fsd_architecture()
+```
+
+### 3. Запуск
+
+```bash
+pytest tests/test_architecture.py -vv
+```
+
+## Архитектура библиотеки
+
+Каждое правило — это папка внутри `src/pytest_fsd/rules/<rule_name>/` с:
+
+- `__init__.py` — логика проверки (функция `check(config, project_root) -> List[Violation]`)
+- `README.md` — описание правила, примеры, rationale
+
+```
+src/pytest_fsd/
+  __init__.py           # Фасад: validate_fsd_architecture()
+  config.py             # Чтение [tool.pytest_fsd] из pyproject.toml
+  _lib/                 # Общие утилиты
+    violations.py       # Единый Violation dataclass
+    ast_utils.py        # AST-парсинг импортов
+    fs_utils.py         # Файловые утилиты, константы сегментов
+  rules/
+    forbidden_imports/          # pytest-archon: слои импортируют только нижележащие
+    no_cross_imports/           # pytest-archon: слайсы в одном слое независимы
+    no_public_api_sidestep/     # AST: импорт только через __init__.py слайса
+    no_layer_public_api/        # FS: слоевые папки без __init__.py
+    no_ui_in_app/               # AST: запрет UI-фреймворков в app
+    repetitive_naming/          # FS: файлы не дублируют имя слайса
+    no_segmentless_slices/      # FS: слайс содержит хотя бы один сегмент
+    segments_by_purpose/        # FS: запрет utils/helpers/components/hooks
+    ambiguous_slice_names/      # FS: имена слайсов ≠ имена сегментов shared
+    no_segments_on_sliced_layers/ # FS: в слайсовых слоях не должно быть сегментов напрямую
+    public_api/                 # FS: каждый слайс должен иметь __init__.py
+```
+
+---
+
+## Матрица покрытия правил Steiger
+
+Полный список правил из [Steiger FSD Plugin](https://github.com/feature-sliced/steiger) и их статус в `pytest-fsd`:
+
+| #   | Steiger Rule                                    | pytest-fsd Status      | Описание                                                                               |
+| --- | ----------------------------------------------- | ---------------------- | -------------------------------------------------------------------------------------- |
+| 1   | `forbidden-imports` / `no-higher-level-imports` | ✅ **Полностью**       | Слои импортируют только нижележащие слои                                               |
+| 2   | `no-cross-imports`                              | ✅ **Полностью**       | Слайсы в одном слое независимы друг от друга                                           |
+| 3   | `no-public-api-sidestep`                        | ✅ **Полностью**       | Импорт из чужого слайса только через `__init__.py`                                     |
+| 4   | `public-api`                                    | ✅ **Полностью**       | Каждый слайс и сегмент shared обязан иметь `__init__.py`                               |
+| 5   | `no-layer-public-api`                           | ✅ **Полностью**       | Папки слоев (`features/`, `entities/`) не должны содержать `__init__.py`               |
+| 6   | `segments-by-purpose`                           | ✅ **Полностью**       | Запрет `utils`, `helpers`, `hooks`, `components`, `modals`, `types`, `constants` и др. |
+| 7   | `no-segmentless-slices`                         | ✅ **Полностью**       | Слайс обязан содержать хотя бы один стандартный сегмент                                |
+| 8   | `repetitive-naming`                             | ✅ **Полностью**       | Файлы не дублируют имя слайса (`user/user_model.py` → `user/model.py`)                 |
+| 9   | `no-ui-in-app`                                  | ✅ **Полностью**       | Слой `app` не должен импортировать UI-фреймворки                                       |
+| 10  | `ambiguous-slice-names`                         | ✅ **Полностью**       | Имена слайсов не совпадают с сегментами `shared/`                                      |
+| 11  | `no-segments-on-sliced-layers`                  | ✅ **Полностью**       | В слайсовых слоях нет прямых папок-сегментов                                           |
+| 12  | `inconsistent-naming`                           | 🔶 **Ruff**            | Обеспечивается плагином `N` (pep8-naming) в `Ruff`                                     |
+| 13  | `import-locality`                               | 🔶 **Ruff**            | Обеспечивается плагином `TID` (flake8-tidy-imports) в `Ruff`                           |
+| 14  | `typo-in-layer-name`                            | 🔶 **Конфигурация**    | Покрывается блоком `[tool.pytest_fsd].layers` в `pyproject.toml`                       |
+| 15  | `no-processes`                                  | 🔶 **Конфигурация**    | Слой `processes` deprecated; просто не включайте его в `layers`                        |
+| 16  | `excessive-slicing`                             | ⚡ **Опционально**     | Более 20 слайсов в одном слое (порог: 20)                                              |
+| 17  | `insignificant-slice`                           | 🟡 **Ручная проверка** | Требует анализа графа импортов для определения "незначительных" слайсов                |
+| 18  | `no-file-segments`                              | ⚡ **Опционально**     | Сегмент как файл (`model.py`) вместо папки (`model/`)                                  |
+| 19  | `shared-lib-grouping`                           | ⚡ **Опционально**     | Более 15 файлов в `shared/lib` без группировки                                         |
+| 20  | `no-reserved-folder-names`                      | ⚡ **Опционально**     | Подпапки в сегментах не должны совпадать с именами сегментов                           |
+
+### Легенда
+
+| Статус                     | Значение                                                                                            |
+| -------------------------- | --------------------------------------------------------------------------------------------------- |
+| ✅ **Полностью**           | Правило полностью автоматизировано и выполняется при каждом запуске `pytest`                        |
+| ⚡ **Опционально**         | Правило автоматизировано, но включается через `extra_rules` в `pyproject.toml`                      |
+| 🔶 **Ruff / Конфигурация** | Покрывается внешними инструментами (`Ruff`) или конфигурацией `pyproject.toml`                      |
+| 🟡 **Ручная проверка**     | Требует субъективной оценки или сложного анализа, который лучше производить вручную при code review |
+
+---
+
+## Включение дополнительных правил
+
+Добавьте в `pyproject.toml`:
+
+```toml
+[tool.pytest_fsd]
+base_path = "src"
+layers = ["app", "windows", "widgets", "features", "entities", "shared"]
+extra_rules = [
+    "excessive-slicing",       # ≤ 20 слайсов на слой
+    "shared-lib-grouping",     # ≤ 15 файлов в shared/lib
+    "no-file-segments",        # Сегменты должны быть папками, не файлами
+    "no-reserved-folder-names" # Подпапки сегментов не могут называться ui/model/api/lib/config
+]
+```
+
+Каждое правило подробно описано в `src/pytest_fsd/rules/<rule_name>/README.md`.
+
+---
+
+## Настройка Ruff для смежных правил
+
+Для полного покрытия FSD-правил, которые Steiger проверяет на уровне линтинга (и которые `pytest-fsd` не дублирует), добавьте в `pyproject.toml`:
+
+```toml
+[tool.ruff.lint]
+select = ["N", "TID"]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "parents"
+```
+
+| Ruff Plugin                 | Steiger Rule          | Что проверяет                                   |
+| --------------------------- | --------------------- | ----------------------------------------------- |
+| `N` (pep8-naming)           | `inconsistent-naming` | `snake_case` для модулей, переменных, функций   |
+| `TID` (flake8-tidy-imports) | `import-locality`     | Запрет relative imports из родительских пакетов |
+
+Подробные описания и примеры конфигурации: `src/pytest_fsd/rules/inconsistent_naming/README.md` и `src/pytest_fsd/rules/import_locality/README.md`.
+
+## Известные ограничения (Known Limitations)
+
+- **`TYPE_CHECKING` импорты**: Правила, использующие `pytest-archon` (например, `forbidden-imports` и `no-cross-imports`), работают на базе динамического анализа графа импортов в рантайме. Импорты, находящиеся внутри блоков `if TYPE_CHECKING:`, не выполняются при загрузке модуля и, следовательно, **не видны для этих правил**.
+- **Относительные импорты**: В модуле `ast_utils.py` добавлена поддержка относительных путей для проверки `no-public-api-sidestep`, однако `Ruff` (плагин `TID`) всё равно лучше справляется с контролем относительных импортов за пределами слайсов.
+- **Динамический `__all__`**: Правило `no-public-api-sidestep` использует статический AST-анализ для извлечения `__all__` из файла `__init__.py`. Если список экспортов формируется динамически (например, `__all__ = a + b`), статический анализатор не сможет его прочитать, и инструмент может выдать ложноположительные нарушения. Экспорты в `__all__` должны быть заданы как явный список или кортеж.
+- **Минимальная версия Python**: Библиотека поддерживает Python **3.8+**. Для Python `<3.11` используется обратная совместимость через пакет `tomli`, а на Python `3.11+` — встроенный `tomllib`.
+
+## Лицензия
+
+MIT

pytest_fsd-0.2.0/README.md

@@ -0,0 +1,160 @@
+# pytest-fsd
+
+**FSD Architecture Validation for Python Projects.**
+
+`pytest-fsd` автоматически проверяет архитектуру вашего Python-проекта на соответствие методологии [Feature-Sliced Design](https://feature-sliced.design/).
+
+Использует гибридный подход: динамические проверки через [pytest-archon](https://pypi.org/project/pytest-archon/) + статический AST-анализ + проверка файловой структуры.
+
+## Установка
+
+```bash
+pip install pytest-fsd
+# или
+uv add --dev pytest-fsd
+```
+
+## Использование
+
+### 1. Настройка `pyproject.toml`
+
+```toml
+[tool.pytest_fsd]
+base_path = "src"
+layers = ["app", "windows", "widgets", "features", "entities", "shared"]
+```
+
+### 2. Создание теста
+
+```python
+# tests/test_architecture.py
+from pytest_fsd import validate_fsd_architecture
+
+def test_project_architecture():
+    validate_fsd_architecture()
+```
+
+### 3. Запуск
+
+```bash
+pytest tests/test_architecture.py -vv
+```
+
+## Архитектура библиотеки
+
+Каждое правило — это папка внутри `src/pytest_fsd/rules/<rule_name>/` с:
+
+- `__init__.py` — логика проверки (функция `check(config, project_root) -> List[Violation]`)
+- `README.md` — описание правила, примеры, rationale
+
+```
+src/pytest_fsd/
+  __init__.py           # Фасад: validate_fsd_architecture()
+  config.py             # Чтение [tool.pytest_fsd] из pyproject.toml
+  _lib/                 # Общие утилиты
+    violations.py       # Единый Violation dataclass
+    ast_utils.py        # AST-парсинг импортов
+    fs_utils.py         # Файловые утилиты, константы сегментов
+  rules/
+    forbidden_imports/          # pytest-archon: слои импортируют только нижележащие
+    no_cross_imports/           # pytest-archon: слайсы в одном слое независимы
+    no_public_api_sidestep/     # AST: импорт только через __init__.py слайса
+    no_layer_public_api/        # FS: слоевые папки без __init__.py
+    no_ui_in_app/               # AST: запрет UI-фреймворков в app
+    repetitive_naming/          # FS: файлы не дублируют имя слайса
+    no_segmentless_slices/      # FS: слайс содержит хотя бы один сегмент
+    segments_by_purpose/        # FS: запрет utils/helpers/components/hooks
+    ambiguous_slice_names/      # FS: имена слайсов ≠ имена сегментов shared
+    no_segments_on_sliced_layers/ # FS: в слайсовых слоях не должно быть сегментов напрямую
+    public_api/                 # FS: каждый слайс должен иметь __init__.py
+```
+
+---
+
+## Матрица покрытия правил Steiger
+
+Полный список правил из [Steiger FSD Plugin](https://github.com/feature-sliced/steiger) и их статус в `pytest-fsd`:
+
+| #   | Steiger Rule                                    | pytest-fsd Status      | Описание                                                                               |
+| --- | ----------------------------------------------- | ---------------------- | -------------------------------------------------------------------------------------- |
+| 1   | `forbidden-imports` / `no-higher-level-imports` | ✅ **Полностью**       | Слои импортируют только нижележащие слои                                               |
+| 2   | `no-cross-imports`                              | ✅ **Полностью**       | Слайсы в одном слое независимы друг от друга                                           |
+| 3   | `no-public-api-sidestep`                        | ✅ **Полностью**       | Импорт из чужого слайса только через `__init__.py`                                     |
+| 4   | `public-api`                                    | ✅ **Полностью**       | Каждый слайс и сегмент shared обязан иметь `__init__.py`                               |
+| 5   | `no-layer-public-api`                           | ✅ **Полностью**       | Папки слоев (`features/`, `entities/`) не должны содержать `__init__.py`               |
+| 6   | `segments-by-purpose`                           | ✅ **Полностью**       | Запрет `utils`, `helpers`, `hooks`, `components`, `modals`, `types`, `constants` и др. |
+| 7   | `no-segmentless-slices`                         | ✅ **Полностью**       | Слайс обязан содержать хотя бы один стандартный сегмент                                |
+| 8   | `repetitive-naming`                             | ✅ **Полностью**       | Файлы не дублируют имя слайса (`user/user_model.py` → `user/model.py`)                 |
+| 9   | `no-ui-in-app`                                  | ✅ **Полностью**       | Слой `app` не должен импортировать UI-фреймворки                                       |
+| 10  | `ambiguous-slice-names`                         | ✅ **Полностью**       | Имена слайсов не совпадают с сегментами `shared/`                                      |
+| 11  | `no-segments-on-sliced-layers`                  | ✅ **Полностью**       | В слайсовых слоях нет прямых папок-сегментов                                           |
+| 12  | `inconsistent-naming`                           | 🔶 **Ruff**            | Обеспечивается плагином `N` (pep8-naming) в `Ruff`                                     |
+| 13  | `import-locality`                               | 🔶 **Ruff**            | Обеспечивается плагином `TID` (flake8-tidy-imports) в `Ruff`                           |
+| 14  | `typo-in-layer-name`                            | 🔶 **Конфигурация**    | Покрывается блоком `[tool.pytest_fsd].layers` в `pyproject.toml`                       |
+| 15  | `no-processes`                                  | 🔶 **Конфигурация**    | Слой `processes` deprecated; просто не включайте его в `layers`                        |
+| 16  | `excessive-slicing`                             | ⚡ **Опционально**     | Более 20 слайсов в одном слое (порог: 20)                                              |
+| 17  | `insignificant-slice`                           | 🟡 **Ручная проверка** | Требует анализа графа импортов для определения "незначительных" слайсов                |
+| 18  | `no-file-segments`                              | ⚡ **Опционально**     | Сегмент как файл (`model.py`) вместо папки (`model/`)                                  |
+| 19  | `shared-lib-grouping`                           | ⚡ **Опционально**     | Более 15 файлов в `shared/lib` без группировки                                         |
+| 20  | `no-reserved-folder-names`                      | ⚡ **Опционально**     | Подпапки в сегментах не должны совпадать с именами сегментов                           |
+
+### Легенда
+
+| Статус                     | Значение                                                                                            |
+| -------------------------- | --------------------------------------------------------------------------------------------------- |
+| ✅ **Полностью**           | Правило полностью автоматизировано и выполняется при каждом запуске `pytest`                        |
+| ⚡ **Опционально**         | Правило автоматизировано, но включается через `extra_rules` в `pyproject.toml`                      |
+| 🔶 **Ruff / Конфигурация** | Покрывается внешними инструментами (`Ruff`) или конфигурацией `pyproject.toml`                      |
+| 🟡 **Ручная проверка**     | Требует субъективной оценки или сложного анализа, который лучше производить вручную при code review |
+
+---
+
+## Включение дополнительных правил
+
+Добавьте в `pyproject.toml`:
+
+```toml
+[tool.pytest_fsd]
+base_path = "src"
+layers = ["app", "windows", "widgets", "features", "entities", "shared"]
+extra_rules = [
+    "excessive-slicing",       # ≤ 20 слайсов на слой
+    "shared-lib-grouping",     # ≤ 15 файлов в shared/lib
+    "no-file-segments",        # Сегменты должны быть папками, не файлами
+    "no-reserved-folder-names" # Подпапки сегментов не могут называться ui/model/api/lib/config
+]
+```
+
+Каждое правило подробно описано в `src/pytest_fsd/rules/<rule_name>/README.md`.
+
+---
+
+## Настройка Ruff для смежных правил
+
+Для полного покрытия FSD-правил, которые Steiger проверяет на уровне линтинга (и которые `pytest-fsd` не дублирует), добавьте в `pyproject.toml`:
+
+```toml
+[tool.ruff.lint]
+select = ["N", "TID"]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "parents"
+```
+
+| Ruff Plugin                 | Steiger Rule          | Что проверяет                                   |
+| --------------------------- | --------------------- | ----------------------------------------------- |
+| `N` (pep8-naming)           | `inconsistent-naming` | `snake_case` для модулей, переменных, функций   |
+| `TID` (flake8-tidy-imports) | `import-locality`     | Запрет relative imports из родительских пакетов |
+
+Подробные описания и примеры конфигурации: `src/pytest_fsd/rules/inconsistent_naming/README.md` и `src/pytest_fsd/rules/import_locality/README.md`.
+
+## Известные ограничения (Known Limitations)
+
+- **`TYPE_CHECKING` импорты**: Правила, использующие `pytest-archon` (например, `forbidden-imports` и `no-cross-imports`), работают на базе динамического анализа графа импортов в рантайме. Импорты, находящиеся внутри блоков `if TYPE_CHECKING:`, не выполняются при загрузке модуля и, следовательно, **не видны для этих правил**.
+- **Относительные импорты**: В модуле `ast_utils.py` добавлена поддержка относительных путей для проверки `no-public-api-sidestep`, однако `Ruff` (плагин `TID`) всё равно лучше справляется с контролем относительных импортов за пределами слайсов.
+- **Динамический `__all__`**: Правило `no-public-api-sidestep` использует статический AST-анализ для извлечения `__all__` из файла `__init__.py`. Если список экспортов формируется динамически (например, `__all__ = a + b`), статический анализатор не сможет его прочитать, и инструмент может выдать ложноположительные нарушения. Экспорты в `__all__` должны быть заданы как явный список или кортеж.
+- **Минимальная версия Python**: Библиотека поддерживает Python **3.8+**. Для Python `<3.11` используется обратная совместимость через пакет `tomli`, а на Python `3.11+` — встроенный `tomllib`.
+
+## Лицензия
+
+MIT

pytest_fsd-0.2.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "pytest-fsd"
+version = "0.2.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "Lebedev Nikita", email = "rachet337@gmail.com" }
+]
+requires-python = ">=3.8"
+dependencies = [
+    "pytest-archon>=0.0.7",
+    "tomli>=2.0.1; python_version < '3.11'",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.5,<9",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+
+[build-system]
+requires = ["uv_build>=0.9.27,<0.10.0"]
+build-backend = "uv_build"

pytest_fsd-0.2.0/src/pytest_fsd/__init__.py

@@ -0,0 +1,84 @@
+# src/pytest_fsd/__init__.py
+"""
+pytest-fsd: FSD Architecture Validation for Python Projects.
+
+Provides validate_fsd_architecture() — a single facade function
+that runs all FSD rules configured in pyproject.toml.
+"""
+
+from typing import List
+
+from ._lib.violations import Violation
+from .config import load_config
+from .rules import (
+    ambiguous_slice_names,
+    forbidden_imports,
+    no_cross_imports,
+    no_layer_public_api,
+    no_public_api_sidestep,
+    no_segmentless_slices,
+    no_segments_on_sliced_layers,
+    no_ui_in_app,
+    public_api,
+    repetitive_naming,
+    segments_by_purpose,
+    unknown_folders_in_root,
+)
+from .rules import (
+    excessive_slicing,
+    no_file_segments,
+    no_reserved_folder_names,
+    shared_lib_grouping,
+)
+
+# Базовые правила — всегда активны
+CORE_RULES = [
+    forbidden_imports,
+    no_cross_imports,
+    no_public_api_sidestep,
+    no_layer_public_api,
+    no_ui_in_app,
+    repetitive_naming,
+    no_segmentless_slices,
+    segments_by_purpose,
+    ambiguous_slice_names,
+    no_segments_on_sliced_layers,
+    public_api,
+    unknown_folders_in_root,
+]
+
+# Дополнительные правила — включаются через extra_rules в pyproject.toml
+EXTRA_RULES = {
+    "excessive-slicing": excessive_slicing,
+    "shared-lib-grouping": shared_lib_grouping,
+    "no-file-segments": no_file_segments,
+    "no-reserved-folder-names": no_reserved_folder_names,
+}
+
+
+def validate_fsd_architecture(project_root: str = ".") -> None:
+    """
+    Validate the project architecture against FSD rules.
+
+    Reads configuration from pyproject.toml -> [tool.pytest_fsd].
+    Runs all core rules + any extra_rules specified in config.
+    Raises AssertionError if any violations are found.
+    """
+    config = load_config(project_root)
+    all_violations: List[Violation] = []
+
+    # Запускаем базовые правила
+    for rule_module in CORE_RULES:
+        all_violations.extend(rule_module.check(config, project_root))
+
+    # Запускаем дополнительные правила, если они включены в конфиге
+    for extra_rule_name in config.extra_rules:
+        rule_module = EXTRA_RULES.get(extra_rule_name)
+        if rule_module is not None:
+            all_violations.extend(rule_module.check(config, project_root))
+
+    if all_violations:
+        error_msg = "FSD Architecture Validation failed:\n"
+        for v in all_violations:
+            error_msg += v.format() + "\n"
+        raise AssertionError(error_msg)

pytest_fsd-0.2.0/src/pytest_fsd/_lib/__init__.py

@@ -0,0 +1 @@
+"""Shared utilities for pytest-fsd rules."""

pytest_fsd-0.2.0/src/pytest_fsd/_lib/ast_utils.py

@@ -0,0 +1,54 @@
+# src/pytest_fsd/_lib/ast_utils.py
+"""Shared AST parsing utilities used by multiple rules."""
+
+import ast
+from typing import List, Tuple, Optional
+
+
+def get_imports_from_file(
+    filepath: str,
+) -> List[Tuple[int, Optional[str], int, List[str]]]:
+    """Return list of (line_number, full_module_path, level, imported_names).
+
+    Level represents relative imports:
+    0 = absolute import (e.g. `import foo` or `from foo import bar`)
+    1 = current directory (`from . import bar` -> module=None, level=1)
+    2 = parent directory (`from ..foo import bar` -> module='foo', level=2)
+    """
+    imports = []
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            tree = ast.parse(f.read(), filename=filepath)
+    except Exception:
+        return []
+
+    for node in ast.walk(tree):
+        if isinstance(node, ast.Import):
+            for alias in node.names:
+                imports.append((node.lineno, alias.name, 0, [alias.name]))
+        elif isinstance(node, ast.ImportFrom):
+            names = [alias.name for alias in node.names]
+            imports.append((node.lineno, node.module, node.level, names))
+
+    return imports
+
+
+def get_exported_names(filepath: str) -> Optional[List[str]]:
+    """Return the list of names exported in __all__ if defined, or None if not defined."""
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            tree = ast.parse(f.read(), filename=filepath)
+    except Exception:
+        return None
+
+    for node in tree.body:
+        if isinstance(node, ast.Assign):
+            for target in node.targets:
+                if isinstance(target, ast.Name) and target.id == "__all__":
+                    if isinstance(node.value, (ast.List, ast.Tuple)):
+                        return [
+                            elt.value
+                            for elt in node.value.elts
+                            if getattr(elt, "value", None) is not None
+                        ]
+    return None

pytest_fsd-0.2.0/src/pytest_fsd/_lib/fs_utils.py

@@ -0,0 +1,31 @@
+# src/pytest_fsd/_lib/fs_utils.py
+"""Shared filesystem utilities used by multiple rules."""
+
+import os
+from typing import List
+
+from ..config import FsdConfig
+
+# Стандартные сегменты FSD для Python-проектов
+STANDARD_SEGMENTS = ("ui", "model", "api", "lib", "config")
+
+
+def get_sliced_layers(config: FsdConfig) -> List[str]:
+    """Return layers that contain slices (excluding app and shared)."""
+    return [
+        layer_name
+        for layer_name in config.layers
+        if layer_name not in ("app", "shared")
+    ]
+
+
+def get_slices(layer: str, base_path: str) -> List[str]:
+    """Return list of slice directory names inside a given layer."""
+    path = os.path.join(base_path, layer)
+    if not os.path.isdir(path):
+        return []
+    return [
+        d
+        for d in os.listdir(path)
+        if os.path.isdir(os.path.join(path, d)) and not d.startswith("_")
+    ]

pytest_fsd-0.2.0/src/pytest_fsd/_lib/violations.py

@@ -0,0 +1,22 @@
+# src/pytest_fsd/_lib/violations.py
+"""Unified violation dataclass for all FSD rules."""
+
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class Violation:
+    """Represents a single FSD architecture violation."""
+
+    rule: str
+    file_path: str
+    message: str
+    line_number: Optional[int] = None
+
+    def format(self) -> str:
+        """Format the violation as a human-readable string."""
+        location = self.file_path
+        if self.line_number is not None:
+            location += f":{self.line_number}"
+        return f" - [{self.rule}] {location} -> {self.message}"

pytest_fsd-0.2.0/src/pytest_fsd/config.py

@@ -0,0 +1,62 @@
+import os
+
+from dataclasses import dataclass, field
+from typing import List
+
+try:
+    import tomllib
+except ModuleNotFoundError:
+    import tomli as tomllib
+
+
+@dataclass
+class FsdConfig:
+    """Configuration for pytest-fsd, read from [tool.pytest_fsd] in pyproject.toml."""
+
+    base_path: str = "src"
+    layers: List[str] = field(
+        default_factory=lambda: [
+            "app",
+            "pages",
+            "widgets",
+            "features",
+            "entities",
+            "shared",
+        ]
+    )
+    ignore_paths: List[str] = field(default_factory=list)
+    extra_rules: List[str] = field(default_factory=list)
+
+
+# Доступные дополнительные правила
+AVAILABLE_EXTRA_RULES = {
+    "excessive-slicing",
+    "shared-lib-grouping",
+    "no-file-segments",
+    "no-reserved-folder-names",
+}
+
+
+def load_config(root_dir: str) -> FsdConfig:
+    """Загружает настройки [tool.pytest_fsd] из pyproject.toml."""
+    pyproject_path = os.path.join(root_dir, "pyproject.toml")
+
+    if not os.path.exists(pyproject_path):
+        return FsdConfig()
+
+    with open(pyproject_path, "rb") as f:
+        data = tomllib.load(f)
+
+    tool_config = data.get("tool", {}).get("pytest_fsd", {})
+
+    config = FsdConfig()
+    if "base_path" in tool_config:
+        config.base_path = tool_config["base_path"]
+    if "layers" in tool_config:
+        config.layers = tool_config["layers"]
+    if "ignore_paths" in tool_config:
+        config.ignore_paths = tool_config["ignore_paths"]
+    if "extra_rules" in tool_config:
+        config.extra_rules = tool_config["extra_rules"]
+
+    return config

pytest_fsd-0.2.0/src/pytest_fsd/rules/__init__.py

@@ -0,0 +1 @@
+"""Rules registry for pytest-fsd."""

pytest_fsd-0.2.0/src/pytest_fsd/rules/ambiguous_slice_names/README.md

@@ -0,0 +1,29 @@
+# `ambiguous-slice-names`
+
+Forbid slice names that match segment names in the `shared` layer. For example, if `shared/i18n` exists, having `features/i18n` is confusing.
+
+## Examples
+
+✅ Pass:
+
+```
+📂 shared/
+  📂 ui/
+  📂 i18n/
+📂 features/
+  📂 auth/          # OK: "auth" is not a shared segment
+```
+
+❌ Fail:
+
+```
+📂 shared/
+  📂 ui/
+  📂 i18n/
+📂 features/
+  📂 i18n/          # ❌ same name as shared/i18n
+```
+
+## Rationale
+
+When there is a segment in `shared` with the same name as a slice in another layer, it becomes ambiguous where new code should be written and obscures the search for existing code.