pyproject.toml

# Copyright (c) 2019-2025, NVIDIA CORPORATION.

[tool.mypy]
ignore_missing_imports = true
# If we don't specify this, then mypy will check excluded files if
# they are imported by a checked file.
follow_imports = "skip"
exclude = [
    "cudf/_lib/",
    "cudf/cudf/tests/",
    "custreamz/custreamz/tests/",
    "dask_cudf/dask_cudf/tests/",
 ]

[[tool.mypy.overrides]]
module = ["cudf_polars.*"]
disallow_untyped_defs = true

[tool.codespell]
# note: pre-commit passes explicit lists of files here, which this skip file list doesn't override -
# this is only to allow you to run codespell interactively
skip = "./.git,./.github,./cpp/build,.*egg-info.*,./.mypy_cache,./cpp/tests,./python/cudf/cudf/tests,./java/src/test,./cpp/include/cudf_test/cxxopts.hpp"
# ignore short words, and typename parameters like OffsetT
ignore-regex = "\\b(.{1,4}|[A-Z]\\w*T)\\b"
ignore-words-list = "inout,unparseable,falsy,couldn,Couldn,thirdparty"
builtin = "clear"
quiet-level = 3

[tool.ruff]
line-length = 79
target-version = "py310"

[tool.ruff.lint]
typing-modules = ["cudf._typing"]
select = [
    # pycodestyle Error
    "E",
    # Pyflakes
    "F",
    # pycodestyle Warning
    "W",
    # isort
    "I",
    # no-blank-line-before-function
    "D201",
    # one-blank-line-after-class
    "D204",
    # indent-with-spaces
    "D206",
    # under-indentation
    "D207",
    # over-indentation
    "D208",
    # new-line-after-last-paragraph
    "D209",
    # surrounding-whitespace
    "D210",
    # blank-line-before-class
    "D211",
    # section-not-over-indented
    "D214",
    # section-underline-not-over-indented
    "D215",
    # triple-single-quotes
    "D300",
    # escape-sequence-in-docstring
    "D301",
    # first-line-capitalized
    "D403",
    # capitalize-section-name
    "D405",
    # new-line-after-section-name
    "D406",
    # dashed-underline-after-section
    "D407",
    # section-underline-after-name
    "D408",
    # section-underline-matches-section-length
    "D409",
    # no-blank-line-after-section
    "D410",
    # no-blank-line-before-section
    "D411",
    # blank-lines-between-header-and-content
    "D412",
    # empty-docstring-section
    "D414",
    # overload-with-docstring
    "D418",
    # flake8-type-checking
    "TCH",
    # flake8-future-annotations
    "FA",
    # non-pep585-annotation
    "UP006",
    # non-pep604-annotation
    "UP007",
    # Import from `collections.abc` instead: `Callable`
    "UP035",
    # usage of legacy `np.random` function calls
    "NPY002",
    # Ruff-specific rules
    "RUF",
    # banned-api
    "TID251",
    # flake8-debugger
    "T10",
    # #flake8-print
    "T20"
]
ignore = [
    # whitespace before :
    "E203",
    # line-too-long (due to Copyright header)
    "E501",
    # type-comparison, disabled because we compare types to numpy dtypes
    "E721",
    # String contains ambiguous character
    "RUF001",
    # Parenthesize `a and b` expressions when chaining `and` and `or`
    # together, to make the precedence clear
    "RUF021",
    # Mutable class attributes should be annotated with
    # `typing.ClassVar`
    "RUF012",
]
fixable = ["ALL"]
exclude = [
    "cpp/scripts/gdb-pretty-printers.py",
]

[tool.ruff.lint.flake8-tidy-imports.banned-api]
"numpy.can_cast".msg = "Use find_common_dtype from cudf.utils.dtypes instead"
"numpy.result_type".msg = "Use find_common_dtype from cudf.utils.dtypes instead"
"numpy.issubdtype".msg = "Check the .kind attributes on dtype objects instead"
"pandas.api.types".msg = "Use cudf.api.types instead"

[tool.ruff.lint.per-file-ignores]
# We use "== None" to demonstrate null handling in this notebook
"docs/cudf/source/user_guide/missing-data.ipynb" = ["E711"]
# Lots of pytest implicitly injected attributes in conftest-patch.py
"python/cudf/cudf/pandas/scripts/conftest-patch.py" = ["F821"]
"python/cudf/cudf/pandas/scripts/*" = ["D"]
"python/cudf/cudf_pandas_tests/*" = ["D"]
"ci/*" = ["T201"]
"docs/*" = ["T201"]
"cpp/*" = ["T201"]