pyproject.toml

# Package metadata. The version is dynamic: single-sourced from src/seekbar/__init__.py (see [tool.hatch.version]).
[project]
name = "seekbar"
dynamic = ["version"]
description = "Cross-platform file search with native backends"
requires-python = ">=3.14"  # modern syntax only: match/case, PEP 758 except, generics in builtins
license = "MIT"
authors = [{name = "Solganis"}]
# Essentials, not the full PySide6: the app uses only QtCore/QtGui/QtWidgets/QtNetwork, so this drops the
# unused addon modules (WebEngine, Charts, 3D, Multimedia, ...) and keeps the frozen build small.
dependencies = ["PySide6-Essentials>=6.11.1"]

# Console entry point: `seekbar` launches the GUI.
[project.scripts]
seekbar = "seekbar.app:main"

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

# Version single source of truth: read from the package's __version__.
[tool.hatch.version]
path = "src/seekbar/__init__.py"

[tool.hatch.build.targets.wheel]
packages = ["src/seekbar"]

[tool.ruff]
line-length = 120
target-version = "py314"

[tool.ruff.lint]
# Enable every rule, then opt out narrowly: D = no mandatory docstrings; COM812/ISC001 conflict with the formatter.
select = ["ALL"]
ignore = ["D", "COM812", "ISC001"]

[tool.ruff.lint.per-file-ignores]
# scripts are standalone dev tools: not an importable package (INP001) and may print to stdout (T201)
"scripts/**/*.py" = ["INP001", "T201"]
# app.py reveals a file in the OS file manager (explorer/open) with a fixed argv, no shell: subprocess audit N/A
"src/seekbar/app.py" = ["S603", "S607"]
# tests may assert (S101), use magic numbers/private members, be one-file, and skip type/annotation rules
"tests/**/*.py" = ["S101", "PLR2004", "SLF001", "INP001", "ANN", "TC002", "PLW0108", "I001", "FBT"]

[tool.ty.environment]
python-version = "3.14"
# pin the platform so ty resolves the same Windows view on every CI runner (tests reference
# win32-only symbols like _HotkeyFilter; without this, ty fails on the Linux lint runner)
python-platform = "win32"

[tool.pytest.ini_options]
qt_api = "pyside6"
testpaths = ["tests"]

[tool.coverage.run]
branch = true
source = ["seekbar"]
# Platform-specific backends are import-guarded to a single OS, so they are not importable (and cannot reach
# 100%) on the other OSes. Omit them here; each is exercised to full coverage on its own OS in CI.
omit = [
    "*/__main__.py",
    "*/_spotlight.py",
    "*/_locate.py",
    "*/_autostart_macos.py",
    "*/_autostart_linux.py",
    "*/_hotkey_macos.py",
    "*/_hotkey_linux.py",
]

[tool.coverage.report]
show_missing = true
# Non-executable or unreachable-by-design lines that should not count against coverage.
exclude_lines = [
    "pragma: no cover",
    "if TYPE_CHECKING:",
    "if __name__",
]

# Dev/test/build tooling (not shipped): linter, type checker, test stack, packager, assertion and property libs.
[dependency-groups]
dev = [
    "ruff>=0.15.22",
    "ty>=0.0.61",
    "pytest>=9.1.1",
    "pytest-qt>=4.5.0",
    "pytest-cov>=7.1.0",
    "pyinstaller>=6.21.0",
    "assertpy2>=2.17.0",
    "hypothesis>=6.157.0",
]