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

[project]
name = "pythonnative"
version = "0.48.0"
description = "Cross-platform native UI toolkit for Android and iOS"
authors = [
  { name = "Owen Carey" }
]
readme = "README.md"
# The host interpreter must match the embedded runtime (app.python_version)
# for device builds, and the embedded runtimes are 3.13 and 3.14: CPython
# gained official iOS support (PEP 730) and Android support (PEP 738) in
# 3.13, which is what makes binary wheels from PyPI installable at all.
requires-python = ">=3.13"
license = { file = "LICENSE" }
classifiers = [
  "Development Status :: 2 - Pre-Alpha",
  "Intended Audience :: Developers",
  "License :: OSI Approved :: MIT License",
  "Programming Language :: Python :: 3",
  "Programming Language :: Python :: 3 :: Only",
  "Programming Language :: Python :: 3.13",
  "Programming Language :: Python :: 3.14",
  "Topic :: Software Development :: User Interfaces",
]
dependencies = []

[project.optional-dependencies]
build = [
  "Pillow>=10.0",
]

# Contributor tooling, not published as package extras (PEP 735). Install
# with `uv sync --group dev` or `--group docs`; `uv sync` alone gets `dev`.
[dependency-groups]
dev = [
  "black>=24.0",
  "ruff>=0.5",
  "mypy>=1.10",
  "pytest>=8.0",
  "pytest-asyncio>=0.23",
  "PyYAML>=6.0",
  "Pillow>=10.0",
  # `pn deps` and `pn run ios` shell out to `sys.executable -m pip` to
  # resolve and vendor the app's [requirements].packages for the device
  # platform tags (project/deps.py), and the test suite exercises that
  # path. `uv sync` does not seed pip the way `uv venv --seed` did.
  "pip>=24.0",
  "websockets>=15",
]
docs = [
  "mkdocs>=1.5",
  "mkdocs-material[imaging]>=9.5",
  "mkdocstrings[python]>=0.24",
  "mkdocs-autorefs>=1.0",
  "pymdown-extensions>=10.7",
]

[project.scripts]
pn = "pythonnative.cli.pn:main"

[project.entry-points.pytest11]
pythonnative = "pythonnative.testing.pytest_plugin"

[project.urls]
Homepage = "https://github.com/pythonnative/pythonnative"
Repository = "https://github.com/pythonnative/pythonnative"
Issues = "https://github.com/pythonnative/pythonnative/issues"
Documentation = "https://pythonnative.com/"


[tool.setuptools.packages.find]
where = ["src"]

[tool.setuptools]
license-files = ["LICENSE*"]

# Include template directories and the browser preview's page assets inside
# the package so importlib.resources can find them
[tool.setuptools.package-data]
pythonnative = [
  "py.typed",
  "templates/**", "native/**", "sdk/templates/**",
  "devserver/static/**",
  "icons/_lucide.json", "icons/LICENSE-lucide.txt",
]

[tool.setuptools.exclude-package-data]
pythonnative = [
  "**/build/**", "**/.build/**", "**/.gradle/**",
  "**/.cxx/**", "**/.swiftpm/**", "**/.kotlin/**",
  "**/__pycache__/**", "**/.DS_Store",
]

[tool.ruff]
target-version = "py313"
line-length = 120
extend-exclude = [
  "templates",
  "docs",
]

[tool.ruff.lint]
# Docstring (D) rules use the Google convention; see [tool.ruff.lint.pydocstyle].
# Selectively enabled so tests/examples/templates aren't penalized.
select = ["E", "F", "I", "D"]
# D107 (missing __init__ docstring): mkdocstrings is configured to merge
#   __init__ into the class docstring, so the class docstring is the source of truth.
# D105 (magic method docstring): most are self-explanatory (__repr__, __eq__, etc.).
# D203/D213: conflict with Google convention defaults; ruff auto-suppresses
#   these via `convention = "google"`, but we list them defensively.
ignore = ["D107", "D105", "D203", "D213"]

[tool.ruff.lint.per-file-ignores]
"tests/**/*.py" = ["D"]
"examples/**/*.py" = ["D"]
"src/pythonnative/templates/**/*.py" = ["D"]
"setup.py" = ["D"]
"conftest.py" = ["D"]
# Platform handler subclasses implement the ViewHandler ABC defined in
# native_views/base.py, which carries the canonical docstrings for the
# protocol. The concrete classes are internal (registered by name in
# NativeViewRegistry, never imported by users), so requiring per-method
# docstrings would only add boilerplate that repeats the ABC.
"src/pythonnative/native_views/android.py" = ["D101", "D102"]
"src/pythonnative/native_views/ios.py" = ["D101", "D102"]
# ios.py embeds a LaunchScreen storyboard as an XML string literal whose
# lines exceed the limit; the XML must stay on single lines for Xcode.
"src/pythonnative/project/ios.py" = ["E501"]

[tool.ruff.lint.pydocstyle]
convention = "google"

[tool.black]
line-length = 120
target-version = ['py313']

#  Semantic Release 

[tool.semantic_release]
# PSR stamps the new version into pyproject.toml before running this, so
# `--upgrade-package` re-syncs only this project's own version in the lock
# (never dependency upgrades), and the staged uv.lock lands in the release
# commit. The release workflow builds distributions from that tagged commit
# using the same cibuildwheel matrix as PR CI.
build_command = """
uv lock --upgrade-package pythonnative
git add uv.lock
"""
version_toml = ["pyproject.toml:project.version"]
version_variables = ["src/pythonnative/__init__.py:__version__"]
commit_message = "chore(release): v{version}"
tag_format = "v{version}"
major_on_zero = false

[tool.semantic_release.branches.main]
match = "main"
prerelease = false

[tool.semantic_release.changelog]
changelog_file = "CHANGELOG.md"
exclude_commit_patterns = [
    "^chore\\(release\\):",
]

[tool.semantic_release.commit_parser_options]
allowed_tags = [
    "build", "chore", "ci", "docs", "feat", "fix",
    "perf", "refactor", "revert", "style", "test",
]
minor_tags = ["feat"]
patch_tags = ["fix", "perf"]