ruff.toml

# Let's exclude some whole directories until we are ready to format them individually
extend-exclude = [
    "lib/appsync_helper_pkg",
    "lib/get_config_pkg",
    "lib/idp_common_pkg/idp_common/bedrock",
    "lib/idp_common_pkg/idp_common/config",
    "lib/idp_common_pkg/idp_common/image",
    "lib/idp_common_pkg/idp_common/metrics",
    "lib/idp_common_pkg/idp_common/s3",
    "lib/idp_common_pkg/idp_common/utils",
    "notebooks",
    "options",
    "patterns",
    "src",
    "scripts",
]

# Exclude a variety of commonly ignored directories.
exclude = [
    ".bzr",
    ".direnv",
    ".eggs",
    ".git",
    ".git-rewrite",
    ".hg",
    ".ipynb_checkpoints",
    ".mypy_cache",
    ".nox",
    ".pants.d",
    ".pyenv",
    ".pytest_cache",
    ".pytype",
    ".ruff_cache",
    ".svn",
    ".tox",
    ".venv",
    ".vscode",
    "__pypackages__",
    "_build",
    "buck-out",
    "build",
    "dist",
    "node_modules",
    "site-packages",
    "venv",
]

# Same as Black.
line-length = 88
indent-width = 4

# Assume Python 3.12
target-version = "py312"

[lint]
# Enable Pyflakes (`F`) and a subset of the pycodestyle (`E`)  codes by default.
# Unlike Flake8, Ruff doesn't enable pycodestyle warnings (`W`) or
# McCabe complexity (`C901`) by default.
select = ["E4", "E7", "E9", "F"]
ignore = []
# Note: if you're using Ruff to organize imports in VS Code and also expect to run Ruff from the command line, you'll want to enable Ruff's isort rules by adding "I" to your extend-select.
# TID251: enforce banned-api rules (prevents direct imports from idp_sdk._core)
extend-select = ["I", "TID251"]

# Allow fix for all enabled rules (when `--fix`) is provided.
fixable = ["ALL"]
unfixable = []

# Allow unused variables when underscore-prefixed.
dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"

[lint.flake8-tidy-imports.banned-api]
"idp_sdk._core" = {msg = "This is a private internal module. Use IDPClient from idp_sdk instead."}

[lint.per-file-ignores]
# Let's ignore some annoying rules in notebooks
"notebooks/*" = ["F401"]
# Internal SDK implementation files are allowed to import from _core
"lib/idp_sdk/idp_sdk/**" = ["TID251"]
# Lambda tools that need direct _core access
"src/lambda/**" = ["TID251"]
# Tests mock _core internals directly
"lib/idp_cli_pkg/tests/**" = ["TID251"]
"lib/idp_sdk/tests/**" = ["TID251"]

[format]
# Like Black, use double quotes for strings.
quote-style = "double"

# Like Black, indent with spaces, rather than tabs.
indent-style = "space"

# Like Black, respect magic trailing commas.
skip-magic-trailing-comma = false

# Like Black, automatically detect the appropriate line ending.
line-ending = "auto"

# Enable auto-formatting of code examples in docstrings. Markdown,
# reStructuredText code/literal blocks and doctests are all supported.
#
# This is currently disabled by default, but it is planned for this
# to be opt-out in the future.
docstring-code-format = false

# Set the line length limit used when formatting code snippets in
# docstrings.
#
# This only has an effect when the `docstring-code-format` setting is
# enabled.
docstring-code-line-length = "dynamic"