pyproject.toml

#
# ============================================================================
# pyproject.toml - Project Configuration & Build Settings
# ============================================================================
#
# This file defines the complete project configuration using PEP 518/660
# standards. It includes: project metadata, dependencies, build system,
# tool configurations (linting, testing, coverage, versioning), and entry points.
#


# ============================================================================
#
# [project] - Core project metadata and dependencies
#
# ============================================================================
[project]

name = "tradedangerous"  # aligned with original setup.py name
# Restrict to a range of python versions. ".python_version" file must meet this requirement.
requires-python = ">=3.10"
dynamic = ["version"]
description = "Trade-Dangerous is a set of powerful trading tools for Elite Dangerous, organized around one of the most powerful trade run optimizers available."
readme = "README.md"
license = "MPL-2.0"
license-files = ["LICENSE"]
keywords = ["trade", "elite", "elite-dangerous"]
authors = [
    { name = "eyeonus", email = "eyeonus@gmail.com" },
	{ name = "Stefan 'Tromador' Morrell" },
	{ name = "Bernd Gollesch" },
    { name = "Oliver 'kfsone' Smith", email = "oliver@kfs.org" },
]
classifiers = [
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Operating System :: OS Independent",
]

# Default dependencies for running the tool itself.
dependencies = [
    "appJar",
    "ijson>=3.1",
    "importlib-metadata>=1",
    "orjson>=3.11.5",
    "requests",
    "rich==13.7.1",
    "sqlalchemy>=2.0,<3.0",
]


# ============================================================================
#
# [dependency-groups] - Optional dependency groups for development and publishing
#
# ============================================================================
[dependency-groups]

# Development: linting, testing, documentation, and release tooling.
# These are not required for running Trade-Dangerous, only for contributors.

dev = [
    "coverage",
    "flake8",
    "pylint",
    "pytest",
    "ruff",
    "tox",
    "tox-gh-actions",
    "tox-uv",
    "uv>=0.9.26",
]


# Publishing: tools for building distributions and uploading to PyPI.

publish = [
    "build",
    "packaging>=20.0",
    "python-semantic-release",
    "twine",
    "wheel",
]


# ============================================================================
#
# [build-system] - PEP 517/518 build system requirements
#
# ============================================================================
[build-system]

requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta"


# ============================================================================
#
# [project.scripts] - Command-line entry points
#
# ============================================================================
[project.scripts]

trade = "trade:main"
tradegui = "tradegui:main"


# ============================================================================
#
# [project.urls] - External links and resources
#
# ============================================================================
[project.urls]

"Homepage"      = "https://github.com/eyeonus/Trade-Dangerous"
"Bug Tracker"   = "https://github.com/eyeonus/Trade-Dangerous/issues"
"Documentation" = "https://github.com/eyeonus/Trade-Dangerous/wiki"
"Source Code"   = "https://github.com/eyeonus/Trade-Dangerous"


# ============================================================================
#
# [project.optional-dependencies] - Extra dependency sets for specific use cases
#
# ============================================================================
[project.optional-dependencies]

build           = ["uv~=0.9.26"]
dev-extras      = ["ipython"]


# ============================================================================
#
# [tool.setuptools] - Packaging and distribution configuration
#
# ============================================================================
[tool.setuptools]
# Configure setuptools behavior for building and packaging the project.

py-modules = ["trade", "tradegui"]


[tool.setuptools.packages.find]
# Discover packages automatically; include tradedangerous and all subpackages.
# Exclude tests from distributed package (see note about test_*.py below).
include = ["tradedangerous", "tradedangerous.*"]
exclude = ["tests", "tests.*"]


[tool.setuptools.package-data]
# Include non-Python assets (templates, type hints, marker files).
tradedangerous = [
    "templates/TradeDangerous.sql",
    "templates/Added.csv",
    "templates/Category.csv",
    "templates/RareItem.csv",
    "templates/database_changes.json",
    "tradeenv.pyi",
    "py.typed",
]


# ============================================================================
#
# [tool.uv] - Python package manager (uv) configuration
#
# ============================================================================
[tool.uv]

# Note: uv is not the primary package manager for this project.
# package = true reserves this possibility
package = true


# ============================================================================
#
# [tool.setuptools.dynamic] - Dynamic project metadata
#
# ============================================================================
[tool.setuptools.dynamic]

# Version is managed automatically by semantic-release via tradedangerous/version.py.
version = { attr = "tradedangerous.version.__version__" }


# ============================================================================
#
# [tool.semantic_release] - Version management and automated releases
#
# ============================================================================
[tool.semantic_release]
# Automatically bump versions, create tags, and commit using semantic versioning.

version_variables = [
    "tradedangerous/version.py:__version__",
]
build_command = "uv build"
commit_message = "python-semantic-release automatic version update"


# ============================================================================
#
# [tool.semantic_release.branches.*] - Branch-specific versioning rules
#
# ============================================================================
[tool.semantic_release.branches.main]

# Main release branch: semantic versions (e.g., 1.2.3) with RC pre-release tokens.
match = "(main|master|release/v1)"
prerelease_token = "rc"
prerelease = false


[tool.semantic_release.branches.dev]

# Development branch: pre-release versions from release-candidate branches (e.g., 1.2.3-dev.1).
# Used for internal testing before publishing stable releases.
match = "rc/*"
prerelease = true
prerelease_token = "dev"