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

[project]
name = "cepis"
dynamic = ["version"]
description = "Python client for the public CEP API at cep.is"
readme = "README.md"
license = "ISC"
license-files = ["LICENSE"]
requires-python = ">=3.9"
authors = [{ name = "Murilo Ijanc", email = "murilo@ijanc.org" }]
keywords = ["cep", "correios", "dne", "endereco", "brasil", "viacep"]
classifiers = [
  "Development Status :: 4 - Beta",
  "Intended Audience :: Developers",
  "Natural Language :: Portuguese (Brazilian)",
  "Programming Language :: Python :: 3",
  "Programming Language :: Python :: 3 :: Only",
  "Topic :: Software Development :: Libraries",
  "Typing :: Typed",
]
dependencies = []

[project.urls]
Homepage = "https://cep.is"
Source = "https://git.cep.is/python.git"

[tool.hatch.version]
path = "src/cepis/__init__.py"

[tool.hatch.build.targets.wheel]
packages = ["src/cepis"]

[tool.ruff]
line-length = 100
target-version = "py39"
src = ["src", "tests"]

[tool.ruff.lint]
select = ["E", "F", "W", "I", "N", "UP", "B", "SIM", "RUF"]
# N818 exige que exceções terminem em "Error" — convenção do inglês. A API
# pública desta biblioteca é em português de propósito (veja o README), então
# a regra brigaria com `CEPNaoEncontrado` sem apontar defeito nenhum.
ignore = ["N818"]
# O travessão é pontuação legítima em português e aparece na prosa das
# docstrings. Sem isto, RUF002 pede para trocá-lo por hífen e estraga o texto.
allowed-confusables = ["–", "—"]

[tool.ruff.lint.per-file-ignores]
# Os testes exercitam propositalmente caminhos de erro e casos-limite.
"tests/*" = ["B017"]