pyproject.toml

[build-system]
requires = ["maturin>=1.9.3,<2.0"]
build-backend = "maturin"

[project]
name = "basedpython"
version = "0.0.1a9"
description = "a transpiler for both Python and basedpython"
authors = [{ name = "Astral Software Inc.", email = "hey@astral.sh" }]
readme = "README.md"
requires-python = ">=3.7"
license = "MIT"
license-files = ["LICENSE"]
keywords = [
    "automation",
    "flake8",
    "pycodestyle",
    "pyflakes",
    "pylint",
    "clippy",
]
classifiers = [
    "Development Status :: 1 - Planning",
    "Environment :: Console",
    "Intended Audience :: Developers",
    "Operating System :: OS Independent",
    "Programming Language :: Python",
    "Programming Language :: Python :: 3.7",
    "Programming Language :: Python :: 3.8",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Programming Language :: Python :: 3 :: Only",
    "Programming Language :: Rust",
    "Topic :: Software Development",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Software Development :: Quality Assurance",
    "Topic :: Software Development :: Compilers",
    "Topic :: Software Development :: Build Tools",
    "Topic :: Software Development :: Pre-processors",
    "Topic :: Software Development :: Code Generators",
]

[project.urls]
Repository = "https://github.com/KotlinIsland/basedpython"
Documentation = "https://kotlinisland.github.io/basedpython/"
Changelog = "https://github.com/KotlinIsland/basedpython/blob/main/CHANGELOG.md"


# builds the standalone distribution crate, which produces both the `by`
# (type-checker / transpiler) and `buff` (linter / formatter) binaries. maturin
# packages every bin of the target crate as a console script, so the wheel ships
# both. no python module: a single `python -m basedpython` would be ambiguous
# between the two tools, so they're exposed purely as the `by` and `buff` scripts
[tool.maturin]
bindings = "bin"
manifest-path = "crates/basedpython/Cargo.toml"
strip = true

[dependency-groups]
dev = [
    "prek==0.4.12",
]
docs = [
    "basedpython-pygments",
    "zensical",
]
release = [
    "rooster==0.1.1",
]

[tool.uv.sources]
# the pygments lexer that highlights `by` code blocks in the docs
basedpython-pygments = { path = "python/basedpython-pygments" }

[tool.uv.dependency-groups]
dev = { requires-python = ">=3.12" }
docs = { requires-python = ">=3.12" }
release = { requires-python = ">=3.12" }

[tool.ruff]
target-version = "py38"
extend-exclude = [
    # benchmark programs are measurement inputs, not code. an autofix that
    # rewrites `i = i + 1` or hoists a loop changes what is being measured, and
    # the isort rule alone would put `from __future__ import annotations` at the
    # top of every one of them
    "scripts/native-bench/programs/",
    "crates/ty_vendored/vendor/",
    "crates/ruff/resources/",
    "crates/ruff_linter/resources/",
    "crates/ruff_python_formatter/resources/",
    "crates/ruff_python_parser/resources/",
    "crates/ruff_python_semantic/resources/"
]

[tool.ruff.lint]
select = [
    "E", # pycodestyle (error)
    "F", # pyflakes
    "B", # bugbear
    "B9",
    "C4", # flake8-comprehensions
    "SIM", # flake8-simplify
    "I", # isort
    "UP", # pyupgrade
    "PIE", # flake8-pie
    "PGH", # pygrep-hooks
    "PYI", # flake8-pyi
    "RUF",
    "S602", # flake8-bandit: subprocess-popen-with-shell-equals-true
]

ignore = [
    # only relevant if you run a script with `python -0`,
    # which seems unlikely for any of the scripts in this repo
    "B011",
    # Leave it to the formatter to split long lines and
    # the judgement of all of us.
    "E501"
]

[tool.ruff.lint.per-file-ignores]
# a pygments lexer declares its public api as plain class attributes, and the
# framework reads `tokens` at class-creation time. `ClassVar` annotations would
# be correct at runtime but unique to this lexer among every lexer pygments has
"python/basedpython-pygments/**" = ["RUF012"]

[tool.ruff.lint.isort]
required-imports = ["from __future__ import annotations"]
combine-as-imports = true

[tool.ruff.per-file-target-version]
"crates/ty_python_semantic/mdtest.py" = "py310"
"crates/ty_vendored/ty_extensions/*.pyi" = "py312"

[tool.black]
force-exclude = '''
/(
  | crates/ty_vendored/vendor
  | crates/ruff_linter/resources
  | crates/ruff_python_formatter/resources
  | crates/ruff_python_parser/resources
)/
'''

[tool.rooster]
major_labels = []  # Ruff never uses the major version number
minor_labels = ["breaking"]   # Bump the minor version on breaking changes

ignore_labels = ["internal", "ci", "testing", "ty"]

version_files = [
    "README.md",
    "pyproject.toml",
    # Might become unneeded once Markdown formatting is stabilized.
    "docs/formatter.md",
    "docs/integrations.md",
    "docs/tutorial.md",
    "crates/ruff/Cargo.toml",
    "crates/ruff_linter/Cargo.toml",
    # Note that the value being replaced here needs to be kept in sync with the
    # validation regex in the `violation_metadata` macro.
    { target = "crates/ruff_linter/src/rules/**/*.rs", replace = "NEXT_RUFF_VERSION" },
    "crates/ruff_wasm/Cargo.toml",
    "scripts/benchmarks/pyproject.toml",
]

[tool.rooster.section-labels]
"Breaking changes" = ["breaking"]
"Preview features" = ["preview"]
"Bug fixes" = ["bug"]
"Rule changes" = [
    "diagnostics",
    "docstrings",
    "rule",
    "fixes",
    "isort",
]
"Performance" = ["performance"]
"Formatter" = ["formatter"]
"Server" = ["server"]
"CLI" = ["cli"]
"Configuration" = ["configuration"]
"Documentation" = ["documentation"]
"Other changes" = ["__unknown__"]