ruff.toml

exclude = [
	"**/_vendor",
	"setuptools/_distutils",
	"setuptools/config/_validate_pyproject",
]

[lint]
extend-select = [
	"C901",
	"PERF401",
	"W",

	# local
	"ANN2", # missing-return-type-*
	"FA", # flake8-future-annotations
	"F404", # late-future-import
	"I", # isort
	"PYI", # flake8-pyi
	"UP", # pyupgrade
	"TRY",
	"YTT", # flake8-2020
]
ignore = [
	"TRY003", # raise-vanilla-args, avoid multitude of exception classes
	"TRY301", # raise-within-try, it's handy
	"UP015", # redundant-open-modes, explicit is preferred
	"UP030", # temporarily disabled
	"UP031", # temporarily disabled
	"UP032", # temporarily disabled
	"UP038", # Using `X | Y` in `isinstance` call is slower and more verbose https://github.com/astral-sh/ruff/issues/7871
	# Only enforcing return type annotations for public functions
	"ANN202", # missing-return-type-private-function
	"ANN204", # missing-return-type-special-method

	# https://docs.astral.sh/ruff/formatter/#conflicting-lint-rules
	"W191",
	"E111",
	"E114",
	"E117",
	"D206",
	"D300",
	"Q000",
	"Q001",
	"Q002",
	"Q003",
	"COM812",
	"COM819",
	"ISC001",
	"ISC002",
]

[lint.per-file-ignores]
# Only enforcing return type annotations for public modules
"**/tests/**" = ["ANN2"]
"tools/**" = ["ANN2"]
# Suppress nuisance warnings about module-import-not-at-top-of-file (E402) due to workaround for #4476
"setuptools/__init__.py" = ["E402"]
"pkg_resources/__init__.py" = ["E402"]

[lint.isort]
combine-as-imports = true
split-on-trailing-comma = false
# Force Ruff/isort to always import setuptools before distutils in tests as long as distutils_hack is supported
# This also ensures _distutils_hack is imported before distutils
# https://github.com/pypa/setuptools/issues/4137
section-order = ["future", "standard-library", "eager", "third-party", "first-party", "local-folder", "delayed"]
sections.eager = ["_distutils_hack"]
sections.delayed = ["distutils"]

[lint.flake8-annotations]
ignore-fully-untyped = true

[format]
# Enable preview to get hugged parenthesis unwrapping and other nice surprises
# See https://github.com/jaraco/skeleton/pull/133#issuecomment-2239538373
preview = true
# https://docs.astral.sh/ruff/settings/#format_quote-style
quote-style = "preserve"