# Lint all Python files in current directory
ruff check .

# Lint and auto-fix issues
ruff check --fix .

# Format Python files (like Black)
ruff format .

# Check formatting without modifying files
ruff format --check .

# Show diff of what would change
ruff format --diff .

# Lint specific file
ruff check path/to/file.py

# Watch mode for continuous linting
ruff check --watch .

# Show rule explanations
ruff rule <RULE_CODE>

# Select specific rules
ruff check --select E,F,W .

# Ignore specific rules
ruff check --ignore E501 .

# Target Python version
ruff check --target-version py311 .

# Output format options
ruff check --output-format=json .
ruff check --output-format=github .

# Show statistics
ruff check --statistics .

# Run only pyupgrade rules
ruff check --select UP .

# Common UP rules:
# UP001: Remove unnecessary encoding in open()
# UP003: Use {} instead of type()
# UP004: Remove useless object inheritance
# UP005: Replace deprecated unittest assertions
# UP006: Use type instead of Type for builtins
# UP007: Use X | Y for union types
# UP008: Use super() without arguments
# UP009: Remove unnecessary UTF-8 encoding declarations
# UP010: Remove unnecessary __future__ imports
# UP015: Remove unnecessary mode='r' in open()
# UP018: Use native str/bytes/int instead of literals
# UP032: Use f-strings instead of .format()
# UP034: Remove extraneous parentheses
# UP035: Replace deprecated imports
# UP036: Remove outdated version blocks
# UP037: Remove quotes from type annotations

[tool.ruff]
# Target Python version
target-version = "py311"

# Line length (default 88, like Black)
line-length = 88

# Exclude patterns
exclude = [
    ".git",
    ".venv",
    "__pycache__",
    "build",
    "dist",
]

[tool.ruff.lint]
# Enable these rule sets
select = [
    "E",    # pycodestyle errors
    "W",    # pycodestyle warnings
    "F",    # Pyflakes
    "UP",   # pyupgrade
    "I",    # isort
    "B",    # flake8-bugbear
    "C4",   # flake8-comprehensions
    "SIM",  # flake8-simplify
]

# Ignore specific rules
ignore = [
    "E501",  # line too long (handled by formatter)
]

# Allow autofix for all rules
fixable = ["ALL"]

[tool.ruff.lint.isort]
# Known first-party imports
known-first-party = ["mypackage"]

[tool.ruff.format]
# Use double quotes (like Black)
quote-style = "double"

# Indent with spaces
indent-style = "space"

# Respect magic trailing commas
skip-magic-trailing-comma = false

# Check what would be upgraded
ruff check --select UP --diff .

# Apply all pyupgrade fixes
ruff check --select UP --fix .

# Check and fix all issues
ruff check --fix .
ruff format .

# Fail on any issues (good for CI)
ruff check .
ruff format --check .

# GitHub Actions output format
ruff check --output-format=github .

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.8.0
    hooks:
      - id: ruff
        args: [--fix]
      - id: ruff-format