pyproject.toml

[project]
name = "tailscale"
version = "0.0.0"
description = "Asynchronous Python client for the Tailscale API."
authors = [{ name = "Franck Nijhof", email = "opensource@frenck.dev" }]
maintainers = [{ name = "Franck Nijhof", email = "opensource@frenck.dev" }]
license = "MIT"
requires-python = ">=3.11"
readme = "README.md"
keywords = [
  "api",
  "async",
  "client",
  "home-assistant",
  "mesh-vpn",
  "network",
  "tailnet",
  "tailscale",
  "vpn",
  "wireguard",
]
classifiers = [
  "Development Status :: 5 - Production/Stable",
  "Framework :: AsyncIO",
  "Intended Audience :: Developers",
  "Natural Language :: English",
  "Programming Language :: Python :: 3.11",
  "Programming Language :: Python :: 3.12",
  "Programming Language :: Python :: 3.13",
  "Programming Language :: Python :: 3.14",
  "Programming Language :: Python :: 3",
  "Topic :: Software Development :: Libraries :: Python Modules",
]
dynamic = ["dependencies"]
packages = [{ include = "tailscale", from = "src" }]
dependencies = [
  'aiohttp (>=3.0.0)',
  'mashumaro (>=3.10)',
  'orjson (>=3.9.8)',
  'yarl (>=1.6.0)',
]

[project.optional-dependencies]
cli = ["rich>=14.0.0", "typer>=0.15.1"]

[project.scripts]
tailscale = "tailscale._cli:main"

[tool.poetry]
requires-poetry = '>=2.0'

[project.urls]
homepage = "https://github.com/frenck/python-tailscale"
repository = "https://github.com/frenck/python-tailscale"
documentation = "https://github.com/frenck/python-tailscale"
"Bug Tracker" = "https://github.com/frenck/python-tailscale/issues"
Changelog = "https://github.com/frenck/python-tailscale/releases"

[tool.poetry.group.dev.dependencies]
aioresponses = "0.7.8"
codespell = "2.4.2"
covdefaults = "2.3.0"
coverage = { version = "7.13.5", extras = ["toml"] }
pre-commit-hooks = "6.0.0"
prek = "0.3.9"
pylint = "4.0.5"
pytest = "9.0.3"
pytest-asyncio = "1.3.0"
pytest-cov = "7.1.0"
ruff = "0.15.11"
safety = "3.7.0"
syrupy = "5.1.0"
ty = "0.0.31"
yamllint = "1.38.0"
zizmor = "1.24.1"

[tool.coverage.run]
plugins = ["covdefaults"]
source = ["tailscale"]

[tool.coverage.report]
show_missing = true
fail_under = 95
omit = [
  "src/tailscale/_cli.py",
  "src/tailscale/cli/*",
]

[tool.ty.environment]
python-version = "3.11"

[tool.pylint.MASTER]
ignore = ["cli", "tests"]

[tool.pylint.BASIC]
good-names = ["_", "ex", "fp", "i", "id", "j", "k", "on", "Run", "T"]

[tool.pylint.DESIGN]
max-attributes = 8
max-public-methods = 40

[tool.pylint."MESSAGES CONTROL"]
disable = ["duplicate-code", "format", "unsubscriptable-object"]

[tool.pylint.SIMILARITIES]
ignore-imports = true

[tool.pylint.FORMAT]
max-line-length = 88

[tool.pytest.ini_options]
addopts = "--cov"
asyncio_mode = "auto"

[tool.ruff.lint]
select = ["ALL"]
ignore = [
  "ANN401",  # Opinionated warning on disallowing dynamically typed expressions
  "D203",    # Conflicts with other rules
  "D213",    # Conflicts with other rules
  "D417",    # False positives in some occasions
  "PLR2004", # Just annoying, not really useful

  # Conflicts with the Ruff formatter
  "COM812",
  "ISC001",
]

[tool.ruff.lint.per-file-ignores]
"src/tailscale/cli/**/*.py" = [
  "FBT001",  # Boolean positional args needed for display helpers
  "FBT002",  # Boolean defaults needed for Typer flag options
  "PLR0913", # CLI commands need many params (device_id + auth options)
]
"tests/**/*.py" = [
  "FBT001", # Boolean positional args are idiomatic in parametrized tests
  "FBT002", # Boolean defaults are idiomatic in parametrized tests
]

[tool.ruff.lint.flake8-pytest-style]
mark-parentheses = false
fixture-parentheses = false

[tool.ruff.lint.isort]
known-first-party = ["tailscale"]

[tool.ruff.lint.flake8-type-checking]
runtime-evaluated-base-classes = [
  "mashumaro.mixins.orjson.DataClassORJSONMixin",
]

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

[build-system]
requires = ["poetry-core>=2.0"]
build-backend = "poetry.core.masonry.api"