pyproject.toml

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

[project]
name = "socialmapper"
version = "1.1.2"
description = "A Python library for spatial analysis, demographic mapping, and geospatial data processing with a modern API"
readme = "README.md"
requires-python = ">=3.11,<3.14"
license = {file = "LICENSE"}
authors = [
    {name = "mihiarc", email = "mihiarc@example.com"}
]
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Intended Audience :: Science/Research",
    "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 :: Scientific/Engineering :: GIS",
]
keywords = ["gis", "mapping", "demographics", "census", "OpenStreetMap"]
dependencies = [
    "geopandas>=0.14.0",
    "pandas>=2.0.0",
    "numpy>=1.24.0",
    "requests>=2.28.0",
    "shapely>=2.0.0",
    "pyogrio>=0.7.0",  # Implicit geopandas I/O backend
    "pyarrow>=12.0.0", # Implicit parquet backend for data files
    "pyproj>=3.6.0",
    "pydantic>=2.0.0",
    "rich>=13.0.0",
    "matplotlib>=3.7.0",
    "contextily>=1.4.0",
    "diskcache>=5.6.0",
    "routingpy>=1.3.0",
    "geopy>=2.4.0",
]

[project.optional-dependencies]
dev = [
    "pytest>=8.4.1",
    "ty>=0.0.1a10",
    "ruff>=0.12.0",
    "mkdocs>=1.6.1",
    "mkdocs-material-extensions>=1.3.1",
    "build>=1.3.0",
    "twine>=6.1.0",
]
interactive = [
    "folium>=0.17.0",  # Interactive Leaflet maps for HTML export
]

[project.urls]
"Homepage" = "https://github.com/mihiarc/socialmapper"
"Bug Tracker" = "https://github.com/mihiarc/socialmapper/issues"

# Use Python API:
# from socialmapper import SocialMapper, quick_analysis

[tool.hatch.build.targets.wheel]
packages = ["socialmapper"]
include = [
    "socialmapper/data/neighbors/*.parquet",
]

[tool.hatch.build.targets.wheel.shared-data]
"socialmapper/data" = "socialmapper/data"

[tool.ruff]
line-length = 100
target-version = "py311"
fix = true

[tool.ruff.lint]
# Enable comprehensive rule sets for 2025 best practices
select = [
    "E",      # pycodestyle errors
    "W",      # pycodestyle warnings  
    "F",      # Pyflakes
    "I",      # isort (import sorting)
    "N",      # pep8-naming
    "D",      # pydocstyle (docstring conventions)
    "UP",     # pyupgrade (modernize Python syntax)
    "B",      # flake8-bugbear (common bugs)
    "C4",     # flake8-comprehensions (list/dict comprehensions)
    "PIE",    # flake8-pie (misc best practices)
    "PL",     # Pylint
    "RUF",    # Ruff-specific rules
    "SIM",    # flake8-simplify
    "TCH",    # flake8-type-checking (type import optimization)
    "PTH",    # flake8-use-pathlib (prefer pathlib over os.path)
    "FURB",   # refurb (modernize code patterns)
    "PERF",   # Perflint (performance anti-patterns)
    "LOG",    # flake8-logging (logging best practices)
]

ignore = [
    "E501",   # Line too long - handled by formatter
    "D100",   # Missing docstring in public module
    "D104",   # Missing docstring in public package
    "D107",   # Missing docstring in __init__
    "PLR0913", # Too many arguments to function call
    "PLR0912", # Too many branches
    "PLR0915", # Too many statements
    "B008",   # Do not perform function calls in argument defaults (common in FastAPI/typer)
]

# Modern pydocstyle configuration
[tool.ruff.lint.pydocstyle]
convention = "numpy"

# Per-file ignores for common patterns
[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["F401", "F403", "E402"]  # Allow unused imports and import ordering in __init__.py
"tests/*" = ["D", "PLR2004", "S101"]     # Disable docstring and assert rules in tests
"examples/*" = ["D", "T201"]             # Allow print statements in examples
"scripts/*" = ["D", "T201"]              # Allow print statements in scripts

# Import sorting configuration (replaces isort)
[tool.ruff.lint.isort]
known-first-party = ["socialmapper"]
force-single-line = false
split-on-trailing-comma = true

# Modern formatting configuration (replaces Black)
[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "auto"
docstring-code-format = true
docstring-code-line-length = 80

[tool.pytest.ini_options]
markers = [
    "integration: marks tests as integration tests (slower, may use external resources)",
    "slow: marks tests as slow running (may take several seconds)",
    "benchmark: marks tests that measure performance benchmarks",
    "external: marks tests that require external services (network, APIs)",
]
testpaths = ["tests"]
python_files = ["test_*.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
addopts = [
    "--strict-markers",
    "--strict-config",
    "-ra",
]
filterwarnings = [
    "ignore::DeprecationWarning",
    "ignore::PendingDeprecationWarning",
    "ignore::FutureWarning:pandas.*",
    "ignore::UserWarning:geopandas.*",
]

[tool.coverage.run]
source = ["socialmapper"]
omit = [
    "*/tests/*",
    "*/test_*.py",
    "*/__pycache__/*",
    "*/.venv/*",
]

[tool.coverage.report]
precision = 2
show_missing = true
skip_covered = false

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

[tool.coverage.json]
output = "reports/coverage.json"

# ty configuration (ultra-fast Rust-based type checker)
# Note: ty is pre-alpha and configuration is minimal
# Most configuration is done via command-line flags