core/pyproject.toml

[project]
name = "discours-core"
version = "0.9.33"
description = "Core backend for Discours.io platform"
authors = [
    {name = "Tony Rewin", email = "tonyrewin@yandex.ru"}
]
readme = "README.md"
requires-python = ">=3.11,<3.13"
license = {text = "MIT"}
keywords = ["discours", "backend", "api", "graphql", "social-media"]
classifiers = [
    "Development Status :: 4 - Beta",
    "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",
    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
    "Topic :: Software Development :: Libraries :: Python Modules",
]

dependencies = [
    "bcrypt",
    "PyJWT>=2.10",
    "authlib",
    "google-analytics-data",
    "colorlog",
    "psycopg2-binary",
    "httpx",
    "redis[hiredis]",
    "sentry-sdk[starlette,sqlalchemy]",
    # ML packages (CPU-only для предотвращения CUDA)
    "torch",
    "sentence-transformers",
    "transformers",
    "scikit-learn>=1.7.0",
    "starlette",
    "gql",
    "ariadne",
    "granian",
    "sqlalchemy>=2.0.0",
    "orjson",
    "pydantic",
    "types-requests",
    "types-Authlib",
    "types-orjson",
    "types-PyYAML",
    "types-python-dateutil",
    "types-redis",
    "types-PyJWT",
    "muvera",
    "numpy>=2.3.2",
    "faiss-cpu>=1.12.0",
    "pylate>=1.0.0",
]

# https://docs.astral.sh/uv/concepts/dependencies/#development-dependencies
[dependency-groups]
dev = [
    "fakeredis",
    "pytest",
    "pytest-asyncio",
    "pytest-cov",
    "mypy",
    "ruff",
    "playwright",
    "python-dotenv",
]

test = [
    "fakeredis",
    "pytest",
    "pytest-asyncio",
    "pytest-cov",
    "playwright",
]

lint = [
    "ruff",
    "mypy",
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[tool.hatch.build.targets.wheel]
packages = ["."]
include = [
    "auth/**/*",
    "cache/**/*", 
    "orm/**/*",
    "resolvers/**/*",
    "services/**/*",
    "utils/**/*",
    "schema/**/*",
    "*.py",
]
exclude = [
    "tests/**/*",
    "panel/**/*",
    "venv/**/*",
    ".venv/**/*",
    "*.md",
    "*.yml",
    "*.yaml",
    ".git/**/*",
]

[tool.ruff]
line-length = 120  # Максимальная длина строки кода
fix = true         # Автоматическое исправление ошибок где возможно
exclude = ["tests/**/*.py"]

[tool.ruff.lint]
# Включаем автоматическое исправление для всех правил, которые поддерживают это
fixable = ["ALL"]
unfixable = []

# Выбранные правила для проверки кода
select = [
    "E",      # pycodestyle errors - ошибки стиля кода
    "W",      # pycodestyle warnings - предупреждения стиля кода
    "F",      # pyflakes - неиспользуемые импорты, переменные и синтаксические ошибки
    "I",      # isort - сортировка и группировка импортов
    "N",      # pep8-naming - соглашения именования PEP 8
    "UP",     # pyupgrade - обновление синтаксиса до современного Python
    "YTT",    # flake8-2020 - проверки для Python 2020+
    "ANN",    # flake8-annotations - проверка аннотаций типов
    "S",      # bandit - проверки безопасности
    "BLE",    # flake8-blind-except - избегание слепых except блоков
    "FBT",    # flake8-boolean-trap - избегание boolean параметров
    "B",      # flake8-bugbear - обнаружение вероятных багов
    "A",      # flake8-builtins - избегание переопределения встроенных функций
    "C4",     # flake8-comprehensions - улучшение list/dict/set comprehensions
    "DTZ",    # flake8-datetimez - правильная работа с часовыми поясами
    "T10",    # flake8-debugger - обнаружение отладочных вызовов
    "DJ",     # flake8-django - специфичные для Django проверки
    "EM",     # flake8-errmsg - правильное форматирование сообщений об ошибках
    "EXE",    # flake8-executable - проверка исполняемых файлов
    "FA",     # flake8-future-annotations - использование future annotations
    "ISC",    # flake8-implicit-str-concat - неявная конкатенация строк
    "ICN",    # flake8-import-conventions - соглашения импортов
    "G",      # flake8-logging-format - форматирование логирования
    "INP",    # flake8-no-pep420 - проверка __init__.py файлов
    "PIE",    # flake8-pie - разнообразные улучшения кода
    "T20",    # flake8-print - избегание print statements
    "PYI",    # flake8-pyi - проверки для .pyi файлов
    "PT",     # flake8-pytest-style - стиль pytest тестов
    "Q",      # flake8-quotes - единообразие кавычек
    "RSE",    # flake8-raise - правильное использование raise
    "RET",    # flake8-return - правильное использование return
    "SLF",    # flake8-self - избегание доступа к приватным членам
    "SLOT",   # flake8-slots - использование __slots__
    "SIM",    # flake8-simplify - упрощение кода
    "TID",    # flake8-tidy-imports - организация импортов
    "INT",    # flake8-gettext - интернационализация
    "ARG",    # flake8-unused-arguments - неиспользуемые аргументы
    "PTH",    # flake8-use-pathlib - использование pathlib вместо os.path
    "TD",     # flake8-todos - проверка TODO комментариев
    "PD",     # pandas-vet - лучшие практики pandas
    "PGH",    # pygrep-hooks - общие проверки с помощью grep
    "PL",     # pylint - расширенные проверки качества кода
    "TRY",    # tryceratops - улучшение обработки исключений
    "FLY",    # flynt - преобразование в f-strings
    "NPY",    # numpy specific rules - правила для numpy
    "AIR",    # airflow - правила для Apache Airflow
    "PERF",   # perflint - проверки производительности
    "FURB",   # refurb - рефакторинг предложения
    "LOG",    # flake8-logging - правильное логирование
    "RUF",    # ruff specific rules - специфичные правила ruff
]

# Игнорируемые правила (в основном конфликтующие с форматтером)
ignore = [
    "S603",   # subprocess calls - разрешаем в коде вызовы subprocess
    "S607",   # partial executable path - разрешаем в коде частичные пути к исполняемым файлам
    "S608",   # subprocess-without-shell - разрешаем в коде вызовы subprocess без shell
    "COM812", # trailing-comma-missing - конфликтует с форматтером
    "COM819", # trailing-comma-prohibited -
    "ISC001", # single-line-implicit-string-concatenation -
    "ISC002", # multi-line-implicit-string-concatenation -
    "Q000",   # bad-quotes-inline-string -
    "Q001",   # bad-quotes-multiline-string -
    "Q002",   # bad-quotes-docstring -
    "Q003",   # avoidable-escaped-quote -
    "W191",   # tab-indentation -
    "E111",   # indentation-with-invalid-multiple -
    "E114",   # indentation-with-invalid-multiple-comment -
    "E117",   # over-indented -
    "EM101",  # exception can use f-string
    "D206",   # indent-with-spaces -
    "D300",   # triple-single-quotes -
    "E501",   # line-too-long - используем line-length вместо этого правила
    "G004",   # f-strings в логах разрешены
    "FA100",  # from __future__ import annotations не нужно для Python 3.13+
    "FA102",  # PEP 604 union синтаксис доступен в Python 3.13+
    "BLE001", # blind except - разрешаем в коде общие except блоки
    "TRY301", # Abstract `raise` to an inner function - иногда удобнее
    "TRY300", # return/break в try блоке - иногда удобнее
    "ARG001", # неиспользуемые аргументы - часто нужны для совместимости API
    "PLR0911", #
    "PLR0913", # too many arguments - иногда неизбежно
    "PLR0912", # too many branches - иногда неизбежно
    "PLR0915", # too many statements - иногда неизбежно
    "PLR0911", # too many return statements - иногда неизбежно для обработки различных case'ов
    "FBT001",  # boolean positional arguments - иногда удобно для API совместимости
    "FBT002",  # boolean default arguments - иногда удобно для API совместимости
    "PERF203", # try-except in loop - иногда нужно для обработки отдельных элементов
    # Игнорируем некоторые строгие правила для удобства разработки
    "ANN001", # Missing type annotation for `self` - иногда нужно
    "ANN002", # Missing type annotation for `args`
    "ANN003", # Missing type annotation for `*args` - иногда нужно
    "ANN202", # Missing return type annotation for private function `wrapper` - иногда нужно
    "ANN401", # Dynamically typed expressions (Any) - иногда нужно
    "S101",   # assert statements - нужно в тестах
    "T201",   # print statements - нужно для отладки
    "TRY003", # Avoid specifying long messages outside the exception class - иногда допустимо
    "PLR2004", # Magic values - иногда допустимо
    "RUF001", # ambiguous unicode characters - для кириллицы
    "RUF002", #
    "RUF003", #
    "RUF006", #
    "TD002",  # TODO без автора - не критично
    "TD003",  # TODO без ссылки на issue - не критично
    "SLF001", # _private members access
    "F821",   # use Set as type
    "UP006",  # use Set as type
    "UP035",  # use Set as type
    "PERF401", # list comprehension - иногда нужно
    "PLC0415", # импорты не в начале файла - иногда нужно
    "ANN201", # Missing return type annotation for private function `wrapper` - иногда нужно
]

# Настройки для отдельных директорий
[tool.ruff.lint.per-file-ignores]
# Тесты - более мягкие правила
"tests/**/*.py" = [
    "S101",    # assert statements - нормально в тестах
    "PLR2004", # magic values - нормально в тестах
    "ANN",     # type annotations - не обязательно в тестах
    "EXE001",  # shebang without executable - нормально для тестовых скриптов
    "PTH100",  # os.path usage - допустимо в тестах
    "PTH120",  # os.path.dirname - допустимо в тестах
    "BLE001",  # blind except - допустимо в тестах
    "T201",    # print statements - нормально в тестах
    "F841",    # unused variables - нормально в тестах
    "ARG001",  # unused arguments - нормально в тестах
    "DTZ005",  # datetime without tz - допустимо в тестах
]

# Утилиты - более мягкие правила для аннотаций
"utils/**/*.py" = [
    "T201",    # print statements - иногда нужно в утилитах
    "A001",    # builtin shadowing - иногда нужно
    "F841",    # unused variables - иногда остаются при рефакторинге
    "RET503",  # missing return - иногда допустимо
    "ARG001",  # unused arguments - иногда для совместимости API
]

# Настройки приложения
"settings.py" = [
    "S105",    # possible hardcoded password - "Authorization" это название заголовка HTTP
]

# Тестовые файлы в корне
"test_*.py" = [
    "S106",    # hardcoded password - нормально в тестах
    "S603",    # subprocess calls - нормально в тестах
    "S607",    # partial executable path - нормально в тестах
    "BLE001",  # blind except - допустимо в тестах
    "ANN",     # type annotations - не обязательно в тестах
    "T201",    # print statements - нормально в тестах
    "INP001",  # missing __init__.py - нормально для скриптов
]

[tool.ruff.lint.isort]
# Настройки для сортировки импортов
known-first-party = ["auth", "cache", "orm", "resolvers", "services", "utils", "schema", "settings"]
section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"]

[tool.pytest.ini_options]
# Конфигурация pytest
pythonpath = ["."]
testpaths = ["tests"]
python_files = ["test_*.py", "*_test.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
addopts = [
    "-ra",         # Показывать краткую сводку всех результатов тестов
    "--strict-markers",  # Требовать регистрации всех маркеров
    "--tb=short",  # Короткий traceback
    "-v",          # Verbose output
    "--asyncio-mode=auto",  # Автоматическое обнаружение async тестов
    "--disable-warnings",  # Отключаем предупреждения для чистоты вывода
    # "--cov=services,utils,orm,resolvers",  # Измерять покрытие для папок
    # "--cov-report=term-missing",  # Показывать непокрытые строки
    # "--cov-report=html",  # Генерировать HTML отчет
    # "--cov-fail-under=90",  # Ошибка если покрытие меньше 90%
]
markers = [
    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
    "integration: marks tests as integration tests",
    "unit: marks tests as unit tests",
    "e2e: marks tests as end-to-end tests",
    "browser: marks tests that require browser automation",
    "api: marks tests that test API endpoints",
    "db: marks tests that require database",
    "redis: marks tests that require Redis",
    "auth: marks tests that test authentication",
    "skip_ci: marks tests to skip in CI environment",
]
# Настройки для pytest-asyncio
asyncio_mode = "auto"  # Автоматическое обнаружение async тестов
asyncio_default_fixture_loop_scope = "function"  # Область видимости event loop для фикстур

# Настройки для Playwright
playwright_browser = "chromium"  # Используем Chromium для тестов
playwright_headless = true  # В CI используем headless режим
playwright_timeout = 30000  # Таймаут для Playwright операций

[tool.coverage.run]
# Конфигурация покрытия тестами
source = ["services", "utils", "orm", "resolvers"]
omit = [
    "main.py",
    "dev.py",
    "tests/*",
    "*/test_*.py",
    "*/__pycache__/*",
    "*/migrations/*",
    
    "*/venv/*",
    "*/.venv/*",
    "*/env/*",
    "*/build/*",
    "*/dist/*",
    "*/node_modules/*",
    "*/panel/*",
    "*/schema/*",
]

[tool.coverage.report]
# Настройки отчета покрытия
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "if self.debug:",
    "if settings.DEBUG",
    "raise AssertionError",
    "raise NotImplementedError",
    "if 0:",
    "if __name__ == .__main__.:",
    "class .*\\bProtocol\\):",
    "@(abc\\.)?abstractmethod",
]

[tool.mypy]
# Конфигурация mypy
python_version = "3.11"
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
disallow_incomplete_defs = true
check_untyped_defs = true
disallow_untyped_decorators = true
no_implicit_optional = true
warn_redundant_casts = true
warn_unused_ignores = true
warn_no_return = true
warn_unreachable = true
strict_equality = true

# Игнорируем некоторые файлы
exclude = [
    "venv/",
    ".venv/",
    "tests/"
]

# Настройки для конкретных модулей
[[tool.mypy.overrides]]
module = [
    "tests.*",
]
ignore_missing_imports = true
disallow_untyped_defs = false

[tool.ruff.format]
# Настройки форматирования
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "auto"