pyproject.toml

[build-system]
requires = ["setuptools>=45", "wheel", "setuptools-scm"]
build-backend = "setuptools.build_meta"

[project]
name = "rayforce_py"
version = "0.6.2"
description = "Python bindings for RayforceDB"
readme = "README.md"
authors = [{name = "Karim"}]
license = {text = "MIT"}
requires-python = ">=3.11"
dependencies = ["numpy>=2.0.0"]
classifiers = [
    "Development Status :: 4 - Beta",
    "Intended Audience :: Developers",
    "Intended Audience :: Financial and Insurance Industry",
    "Intended Audience :: Information Technology",
    "License :: OSI Approved :: MIT License",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Programming Language :: C"
]

[project.scripts]
rayforce = "rayforce.cli:main"

[project.optional-dependencies]
pandas = ["pandas>=2.0.0"]
polars = ["polars>=0.19.0"]
parquet = ["pyarrow>=10.0.0"]
all = ["pandas>=2.0.0", "polars>=0.19.0", "pyarrow>=10.0.0"]
dev = [
    "pytest>=8.0.0",
    "pytest-cov>=4.0.0",
    "pytest-asyncio>=0.23.0",
    "pytest-timeout>=2.2.0",
    "coverage>=7.0.0",
    "ruff>=0.1.0",
    "mypy>=1.0.0",
]
test-plugins = [
    "pandas>=2.0.0",
    "polars>=0.19.0",
    "pyarrow>=10.0.0",
    "websockets>=12.0",
    "sqlglot>=20.0.0",
]

[tool.cibuildwheel]
build = "cp311-* cp312-* cp313-* cp314-*"
skip = "*-win32 *-manylinux_i686 *-musllinux_*"
archs = ["auto64"]
before-build = "bash {project}/scripts/prepare_build.sh"

test-skip = "*"  # Skip tests for now

[tool.cibuildwheel.environment]
RAYFORCE_GITHUB = "https://github.com/RayforceDB/rayforce.git"

[tool.cibuildwheel.macos]
environment = { MACOSX_DEPLOYMENT_TARGET = "11.0" }

[tool.cibuildwheel.linux]
manylinux-x86_64-image = "manylinux_2_28"
manylinux-aarch64-image = "manylinux_2_28"

before-all = [
    "yum install -y git",
    "yum groupinstall -y 'Development Tools'",
    "yum install -y clang llvm",
]

[tool.ruff]
show-fixes = true
target-version = "py314"
line-length = 100
exclude = [
    ".git",
    ".venv",
    "__pycache__",
    "build",
    "dist",
    "*.egg-info",
    ".mypy_cache",
    ".pytest_cache",
]

[tool.ruff.lint]
select = [
    "E",     # pycodestyle errors
    "W",     # pycodestyle warnings
    "F",     # pyflakes (unused imports, undefined names)
    "I",     # isort (import sorting)
    "N",     # pep8-naming (naming conventions)
    "UP",    # pyupgrade (modernize Python syntax)
    "B",     # flake8-bugbear (common bugs and design problems)
    "C4",    # flake8-comprehensions (better list/dict comprehensions)
    "SIM",   # flake8-simplify (code simplification)
    "PIE",   # flake8-pie (misc improvements)
    "PT",    # flake8-pytest-style (pytest best practices)
    "RET",   # flake8-return (return statement improvements)
    "RUF",   # ruff-specific rules (powerful ruff-only checks)
    "TCH",   # flake8-type-checking (TYPE_CHECKING imports)
    "ARG",   # flake8-unused-arguments
    "ERA",   # eradicate (detect commented-out code)
    "PL",    # pylint (selected useful rules)
    "TRY",   # tryceratops (better exception handling)
    "PERF",  # perflint (performance improvements)
    "FBT",   # flake8-boolean-trap (avoid boolean positional args)
    "A",     # flake8-builtins (shadowing builtins)
    "COM",   # flake8-commas (trailing commas)
    "DTZ",   # flake8-datetimez (timezone-aware datetimes)
    "T10",   # flake8-debugger (remove debugger statements)
    "ISC",   # flake8-implicit-str-concat
    "Q",     # flake8-quotes (consistent quote style)
    "RSE",   # flake8-raise (better raise statements)
    "SLF",   # flake8-self (self/cls usage)
    "SLOT",  # flake8-slots (use __slots__)
    "PGH",   # pygrep-hooks (regex-based rules)
    "FURB",  # refurb (modernize code)
]
ignore = [
    "E501",    # Line too long (handled by formatter)
    "PLR0913", # Too many arguments
    "PLR0912", # Too many branches
    "PLR0915", # Too many statements
    "PLR0911", # Too many return statements
    "PLR2004", # Magic value usage
    "PLC0415",
    "PLW1641",
    "FBT001",
    "COM812",
    "SLF001",  # Private member accessed
    "T201",    # Print statements (might be intentional)
    "TRY003",  # Avoid specifying long messages outside exception class
]
fixable = ["ALL"]
unfixable = []
dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"

[tool.ruff.lint.per-file-ignores]
"tests/**/*.py" = ["E501", "PLR2004", "ERA001"]
"scripts/**/*.py" = ["T201"]
"**/__init__.py" = ["TID252"]

[tool.ruff.lint.isort]
known-first-party = ["rayforce"]
split-on-trailing-comma = true
force-sort-within-sections = true

[tool.ruff.lint.mccabe]
max-complexity = 10

[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "auto"

[tool.pytest.ini_options]
testpaths = ["tests"]
markers = [
    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
    "network: marks tests that require a running rayforce server or network I/O",
    "plugin: marks tests that require optional dependencies (pandas, polars, pyarrow, etc.)",
    "ffi: marks tests that exercise the C FFI layer directly",
    "benchmark: marks benchmark tests (deselect with '-m \"not benchmark\"')",
]
addopts = [
    "--strict-markers",
    "--strict-config",
    "-ra",
    "-m", "not benchmark",
]
filterwarnings = [
    "error",
    "ignore::DeprecationWarning:importlib.*",
]
xfail_strict = true

[tool.coverage.run]
source = ["rayforce"]
omit = [
    "*/tests/*",
    "*/test_*.py",
    "*/__pycache__/*",
    "*/setup.py",
    "*/benchmark/*",
    "*/scripts/*",
    "rayforce/rayforce/*",  # C extension code
    "rayforce/capi/*",  # C API code
    "rayforce/_rayforce_c.pyi",  # Type stubs
]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "raise AssertionError",
    "raise NotImplementedError",
    "if __name__ == .__main__.:",
    "if TYPE_CHECKING:",
    "@abstractmethod",
    "class .*\\bProtocol\\):",
    "@(abc\\.)?abstractmethod",
]
precision = 2
show_missing = true
skip_covered = false
fail_under = 80

[tool.coverage.html]
directory = "htmlcov"