ruff-sync 0.0.4.dev1__tar.gz → 0.0.5.dev2__tar.gz

{ruff_sync-0.0.4.dev1 → ruff_sync-0.0.5.dev2}/.github/workflows/ci.yaml

@@ -88,6 +88,7 @@ jobs:
           ruff-sync --version
           ruff-sync https://github.com/Kilo59/ruff-sync
           ruff-sync check https://github.com/Kilo59/ruff-sync
+          ! ruff-sync check --semantic https://github.com/Kilo59/ruff-sync --path configs/kitchen-sink
 
   publish:
     name: Build and publish to PyPI

{ruff_sync-0.0.4.dev1 → ruff_sync-0.0.5.dev2}/.github/workflows/complexity.yaml

@@ -12,14 +12,13 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          ref: ${{ github.event.pull_request.head.ref }}
       - name: Set up Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
-          python-version: 3.9
+          python-version: "3.10"
       - name: Install Wily
         run: pip install 'wily>=1.25.0'
       - name: Build cache and diff
@@ -33,26 +32,23 @@ jobs:
           DIFF="${DIFF//'%'/'%25'}"
           DIFF="${DIFF//$'\n'/'%0A'}"
           DIFF="${DIFF//$'\r'/'%0D'}"
-          echo "::set-output name=diff::$DIFF"
-      - name: Find current PR
-        uses: jwalton/gh-find-current-pr@v1
-        id: findPr
+          echo "diff=$DIFF" >> "$GITHUB_OUTPUT"
       - name: Add Wily PR Comment
         uses: marocchino/sticky-pull-request-comment@v2
-        if: steps.findPr.outputs.number && steps.wily.outputs.diff != ''
+        if: github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.number && steps.wily.outputs.diff != ''
         with:
           recreate: true
-          number: ${{ steps.findPr.outputs.number }}
+          number: ${{ github.event.pull_request.number }}
           message: |
             ```
             ${{ steps.wily.outputs.diff }}
             ```
       - name: Add Wily PR Comment
         uses: marocchino/sticky-pull-request-comment@v2
-        if: steps.findPr.outputs.number && steps.wily.outputs.diff == ''
+        if: github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.number && steps.wily.outputs.diff == ''
         with:
           recreate: true
-          number: ${{ steps.findPr.outputs.number }}
+          number: ${{ github.event.pull_request.number }}
           message: |
             ```
             Wily: No changes in complexity detected.

{ruff_sync-0.0.4.dev1 → ruff_sync-0.0.5.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ruff-sync
-Version: 0.0.4.dev1
+Version: 0.0.5.dev2
 Summary: Synchronize Ruff linter configuration across projects
 Project-URL: Homepage, https://github.com/Kilo59/ruff-sync
 Project-URL: Documentation, https://github.com/Kilo59/ruff-sync#readme
@@ -26,6 +26,7 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Requires-Python: >=3.10
 Requires-Dist: httpx<1.0.0,>=0.27.0
 Requires-Dist: tomlkit<2.0.0,>=0.12.3
+Requires-Dist: typing-extensions>=4.5.0
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -56,7 +57,6 @@ Description-Content-Type: text/markdown
 - [CI Integration](#ci-integration)
 - [Example Workflow](#example-workflow)
 - [Detailed Check Logic](#detailed-check-logic)
-- [Contributing](#contributing)
 - [Dogfooding](#dogfooding)
 - [License](#license)
 
@@ -130,14 +130,6 @@ With [pip](https://pip.pypa.io/en/stable/):
 pip install ruff-sync
 ```
 
-#### From Source (Bleeding Edge)
-
-If you want the latest development version:
-
-```console
-uv tool install git+https://github.com/Kilo59/ruff-sync
-```
-
 ### Usage
 
 ```console
@@ -198,7 +190,7 @@ exclude = [
 ```
 
 This sets the default upstream and exclusions so you don't need to pass them on the command line every time.
-*Note: Any explicitly provided CLI arguments will override the values in `pyproject.toml`.*
+_Note: Any explicitly provided CLI arguments will override the values in `pyproject.toml`._
 
 ### Advanced Configuration
 
@@ -220,8 +212,11 @@ exclude = [
 branch = "develop"
 
 # A directory prefix to use when looking for a configuration file in a repository. (Default: "")
-# Useful if the upstream pyproject.toml is not at the repository root.
+# Useful if the upstream config is not at the repository root.
 path = "config/ruff"
+
+# The local target directory or file to sync into. (Default: ".")
+to = "."
 ```
 
 ## CI Integration
@@ -268,6 +263,24 @@ git diff pyproject.toml  # review the changes
 git commit -am "sync ruff config from upstream"
 ```
 
+### Curated Examples
+
+While `ruff-sync` is designed to sync from _any_ repository or URL of your choosing, this repository also provides a few curated configurations in the [`configs/`](./configs/) directory that you can use directly.
+
+For example, to sync an exhaustive "kitchen-sink" configuration that explicitly enables all rules and documents them:
+
+```console
+ruff-sync https://github.com/Kilo59/ruff-sync/blob/main/configs/kitchen-sink/ruff.toml
+```
+
+Or configure it using `pyproject.toml` so it's always the default for your local project:
+
+```toml
+[tool.ruff-sync]
+upstream = "https://github.com/Kilo59/ruff-sync"
+path = "configs/kitchen-sink"
+```
+
 ## Bootstrapping a New Project
 
 By default, `ruff-sync` requires an existing configuration file (`pyproject.toml` or `ruff.toml`) to merge into. If you are starting a fresh project and want to initialize it with your organization's Ruff settings, you can use the `--init` flag to scaffold a new file automatically.
@@ -277,8 +290,7 @@ By default, `ruff-sync` requires an existing configuration file (`pyproject.toml
 ruff-sync pull https://github.com/my-org/standards --init
 ```
 
-`ruff-sync` seamlessly supports both `pyproject.toml` and standalone `ruff.toml` (or `.ruff.toml`) files. If your upstream source or your local target is a `ruff.toml`, it will automatically adapt and sync the root configuration rather than looking for a `[tool.ruff]` section.
-
+`ruff-sync` seamlessly supports both `pyproject.toml` and standalone `ruff.toml` (or `.ruff.toml`) files. If your local target is a directory, it will look for configuration files in the following order: `ruff.toml` -> `.ruff.toml` -> `pyproject.toml`. If your upstream source or your local target is a `ruff.toml`, it will automatically adapt and sync the root configuration rather than looking for a `[tool.ruff]` section.
 
 ## Detailed Check Logic
 
@@ -286,9 +298,9 @@ When you run `ruff-sync check`, it follows this process to determine if your pro
 
 ```mermaid
 flowchart TD
-    Start([Start]) --> Local[Read Local pyproject.toml]
-    Local --> Upstream[Download Upstream pyproject.toml]
-    Upstream --> Extract[Extract tool.ruff section]
+    Start([Start]) --> Local[Read Local Configuration]
+    Local --> Upstream[Download Upstream Configuration]
+    Upstream --> Extract[Extract tool.ruff section if needed]
     Extract --> Exclude[Apply Exclusions]
     Exclude --> Merge[Perform in-memory Merge]
 

{ruff_sync-0.0.4.dev1 → ruff_sync-0.0.5.dev2}/README.md

@@ -26,7 +26,6 @@
 - [CI Integration](#ci-integration)
 - [Example Workflow](#example-workflow)
 - [Detailed Check Logic](#detailed-check-logic)
-- [Contributing](#contributing)
 - [Dogfooding](#dogfooding)
 - [License](#license)
 
@@ -100,14 +99,6 @@ With [pip](https://pip.pypa.io/en/stable/):
 pip install ruff-sync
 ```
 
-#### From Source (Bleeding Edge)
-
-If you want the latest development version:
-
-```console
-uv tool install git+https://github.com/Kilo59/ruff-sync
-```
-
 ### Usage
 
 ```console
@@ -168,7 +159,7 @@ exclude = [
 ```
 
 This sets the default upstream and exclusions so you don't need to pass them on the command line every time.
-*Note: Any explicitly provided CLI arguments will override the values in `pyproject.toml`.*
+_Note: Any explicitly provided CLI arguments will override the values in `pyproject.toml`._
 
 ### Advanced Configuration
 
@@ -190,8 +181,11 @@ exclude = [
 branch = "develop"
 
 # A directory prefix to use when looking for a configuration file in a repository. (Default: "")
-# Useful if the upstream pyproject.toml is not at the repository root.
+# Useful if the upstream config is not at the repository root.
 path = "config/ruff"
+
+# The local target directory or file to sync into. (Default: ".")
+to = "."
 ```
 
 ## CI Integration
@@ -238,6 +232,24 @@ git diff pyproject.toml  # review the changes
 git commit -am "sync ruff config from upstream"
 ```
 
+### Curated Examples
+
+While `ruff-sync` is designed to sync from _any_ repository or URL of your choosing, this repository also provides a few curated configurations in the [`configs/`](./configs/) directory that you can use directly.
+
+For example, to sync an exhaustive "kitchen-sink" configuration that explicitly enables all rules and documents them:
+
+```console
+ruff-sync https://github.com/Kilo59/ruff-sync/blob/main/configs/kitchen-sink/ruff.toml
+```
+
+Or configure it using `pyproject.toml` so it's always the default for your local project:
+
+```toml
+[tool.ruff-sync]
+upstream = "https://github.com/Kilo59/ruff-sync"
+path = "configs/kitchen-sink"
+```
+
 ## Bootstrapping a New Project
 
 By default, `ruff-sync` requires an existing configuration file (`pyproject.toml` or `ruff.toml`) to merge into. If you are starting a fresh project and want to initialize it with your organization's Ruff settings, you can use the `--init` flag to scaffold a new file automatically.
@@ -247,8 +259,7 @@ By default, `ruff-sync` requires an existing configuration file (`pyproject.toml
 ruff-sync pull https://github.com/my-org/standards --init
 ```
 
-`ruff-sync` seamlessly supports both `pyproject.toml` and standalone `ruff.toml` (or `.ruff.toml`) files. If your upstream source or your local target is a `ruff.toml`, it will automatically adapt and sync the root configuration rather than looking for a `[tool.ruff]` section.
-
+`ruff-sync` seamlessly supports both `pyproject.toml` and standalone `ruff.toml` (or `.ruff.toml`) files. If your local target is a directory, it will look for configuration files in the following order: `ruff.toml` -> `.ruff.toml` -> `pyproject.toml`. If your upstream source or your local target is a `ruff.toml`, it will automatically adapt and sync the root configuration rather than looking for a `[tool.ruff]` section.
 
 ## Detailed Check Logic
 
@@ -256,9 +267,9 @@ When you run `ruff-sync check`, it follows this process to determine if your pro
 
 ```mermaid
 flowchart TD
-    Start([Start]) --> Local[Read Local pyproject.toml]
-    Local --> Upstream[Download Upstream pyproject.toml]
-    Upstream --> Extract[Extract tool.ruff section]
+    Start([Start]) --> Local[Read Local Configuration]
+    Local --> Upstream[Download Upstream Configuration]
+    Upstream --> Extract[Extract tool.ruff section if needed]
     Extract --> Exclude[Apply Exclusions]
     Exclude --> Merge[Perform in-memory Merge]
 

ruff_sync-0.0.5.dev2/configs/fastapi/ruff.toml

@@ -0,0 +1,150 @@
+# ruff-sync FastAPI Configuration
+# https://github.com/Kilo59/ruff-sync
+#
+# This is a Ruff configuration tailored for FastAPI / Web App development.
+# It enables rules directly relevant to web development and async Python.
+#
+# Usage (direct Ruff config, assuming this file is vendored into your repo):
+#   extend = "configs/fastapi/ruff.toml"
+#
+# Usage (with ruff-sync in pyproject.toml):
+#   [tool.ruff-sync]
+#   path = "configs/fastapi/ruff.toml"
+
+# Same as Black.
+line-length = 88
+indent-width = 4
+
+# Assume Python 3.10. Consumers should override this to match their project's Python version.
+target-version = "py310"
+
+[lint]
+# Enable rules relevant to web development and async Python.
+select = [
+    # https://docs.astral.sh/ruff/rules/#pyflakes-f
+    "F",     # Pyflakes: Essential checks for Python bugs
+    # https://docs.astral.sh/ruff/rules/#error-e
+    "E",     # pycodestyle errors: PEP8 styling
+    # https://docs.astral.sh/ruff/rules/#warning-w
+    "W",     # pycodestyle warnings: PEP8 styling
+    # https://docs.astral.sh/ruff/rules/#mccabe-c90
+    "C90",   # mccabe: Code complexity (cyclomatic complexity)
+    # https://docs.astral.sh/ruff/rules/#isort-i
+    "I",     # isort: Import sorting
+    # https://docs.astral.sh/ruff/rules/#pep8-naming-n
+    "N",     # pep8-naming: Naming conventions
+    # https://docs.astral.sh/ruff/rules/#pydocstyle-d
+    "D",     # pydocstyle: Docstring conventions
+    # https://docs.astral.sh/ruff/rules/#pyupgrade-up
+    "UP",    # pyupgrade: Upgrade syntax for newer Python versions
+    # https://docs.astral.sh/ruff/rules/#flake8-annotations-ann
+    "ANN",   # flake8-annotations: Type annotation checks
+    # https://docs.astral.sh/ruff/rules/#flake8-async-async
+    "ASYNC", # flake8-async: Asynchronous code checks
+    # https://docs.astral.sh/ruff/rules/#flake8-bandit-s
+    "S",     # flake8-bandit: Security testing
+    # https://docs.astral.sh/ruff/rules/#flake8-bugbear-b
+    "B",     # flake8-bugbear: Finding likely bugs and design problems
+    # https://docs.astral.sh/ruff/rules/#flake8-pie-pie
+    "PIE",   # flake8-pie: Misc. lints
+    # https://docs.astral.sh/ruff/rules/#flake8-print-t20
+    "T20",   # flake8-print: Check for Print statements
+    # https://docs.astral.sh/ruff/rules/#flake8-return-ret
+    "RET",   # flake8-return: Check return values
+    # https://docs.astral.sh/ruff/rules/#flake8-simplify-sim
+    "SIM",   # flake8-simplify: Code simplification
+    # https://docs.astral.sh/ruff/rules/#flake8-logging-format-g
+    "G",     # flake8-logging-format: Validate logging format strings
+    # https://docs.astral.sh/ruff/rules/#flake8-quotes-q
+    "Q",     # flake8-quotes: Lint for quotes
+    # https://docs.astral.sh/ruff/rules/#flake8-pytest-style-pt
+    "PT",    # flake8-pytest-style: Pytest style checks
+    # https://docs.astral.sh/ruff/rules/#pylint-pl
+    "PL",    # Pylint: Pylint rules
+]
+
+# Ignore rules that conflict with the Ruff formatter.
+# See: https://docs.astral.sh/ruff/formatter/#conflicting-lint-rules
+ignore = [
+    "W191",  # tab-indentation
+    "E111",  # indentation-with-invalid-multiple
+    "E114",  # indentation-with-invalid-multiple-comment
+    "E117",  # over-indented
+    "D206",  # docstring-tab-indentation
+    "D300",  # triple-single-quotes
+    "Q000",  # bad-quotes-inline-string
+    "Q001",  # bad-quotes-multiline-string
+    "Q002",  # bad-quotes-docstring
+    "Q003",  # avoidable-escaped-quote
+    "Q004",  # unnecessary-escaped-quote
+    "COM812",    # missing-trailing-comma
+    "COM819",    # prohibited-trailing-comma
+    "ISC001",    # single-line-implicit-string-concatenation
+    "ISC002",    # multi-line-implicit-string-concatenation
+]
+
+# Allow autofix for all enabled rules.
+fixable = ["ALL"]
+
+# Allow unused variables when underscore-prefixed.
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[lint.mccabe]
+# Flag errors (C901) whenever the complexity level exceeds 10.
+# Default: 10
+max-complexity = 10
+
+[lint.pydocstyle]
+# Use Google-style docstrings (common in FastAPI projects).
+# Default: "pep257"
+convention = "google"
+
+[lint.flake8-quotes]
+# Use double quotes for inline strings (same as Black).
+# Default: "double"
+inline-quotes = "double"
+# Use double quotes for multiline strings.
+# Default: "double"
+multiline-quotes = "double"
+# Use double quotes for docstrings.
+# Default: "double"
+docstring-quotes = "double"
+# Avoid escaping quotes if the other quote type would save an escape.
+# Default: true
+avoid-escape = true
+
+[lint.flake8-pytest-style]
+# Whether to require parentheses for pytest fixtures.
+# Default: true
+fixture-parentheses = true
+# The type of pytest.mark.parametrize names to use: "tuple", "list", or "csv"
+# Default: "tuple"
+parametrize-names-type = "tuple"
+
+[lint.pylint]
+# The maximum number of arguments allowed for a function.
+# Default: 5
+max-args = 5
+# The maximum number of branches allowed for a function.
+# Default: 12
+max-branches = 12
+
+[lint.pep8-naming]
+# Additional decorators that should be treated as classmethod.
+# Pydantic v1/v2 decorators.
+classmethod-decorators = [
+    "pydantic.validator",
+    "pydantic.root_validator",
+    "pydantic.field_validator",
+    "pydantic.model_validator",
+]
+
+[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"

ruff_sync-0.0.5.dev2/configs/kitchen-sink/ruff.toml

@@ -0,0 +1,262 @@
+# ruff-sync Kitchen Sink Configuration
+# https://github.com/Kilo59/ruff-sync
+#
+# This file enables ALL possible Ruff rules as of Ruff v0.15.5
+# It explicitly lists all rule categories and provides links to their documentation.
+# This serves as a comprehensive reference for what is possible with Ruff.
+
+# Same as Black.
+line-length = 88
+indent-width = 4
+
+# Assume Python 3.10. Consumers should override this to match
+# their project's supported Python version.
+target-version = "py310"
+
+[lint]
+# Enable all rule categories explicitly.
+select = [
+    # https://docs.astral.sh/ruff/rules/#pyflakes-f
+    "F",      # Pyflakes: Essential checks for python bugs
+    # https://docs.astral.sh/ruff/rules/#error-e
+    "E",      # pycodestyle errors: PEP8 styling
+    # https://docs.astral.sh/ruff/rules/#warning-w
+    "W",      # pycodestyle warnings: PEP8 styling
+    # https://docs.astral.sh/ruff/rules/#mccabe-c90
+    "C90",    # mccabe: Code complexity (cyclomatic complexity)
+    # https://docs.astral.sh/ruff/rules/#isort-i
+    "I",      # isort: Import sorting
+    # https://docs.astral.sh/ruff/rules/#pep8-naming-n
+    "N",      # pep8-naming: Naming conventions
+    # https://docs.astral.sh/ruff/rules/#pydocstyle-d
+    "D",      # pydocstyle: Docstring conventions
+    # https://docs.astral.sh/ruff/rules/#pyupgrade-up
+    "UP",     # pyupgrade: Upgrade syntax for newer Python versions
+    # https://docs.astral.sh/ruff/rules/#flake8-2020-ytt
+    "YTT",    # flake8-2020: Checks for sys.version and sys.version_info usage
+    # https://docs.astral.sh/ruff/rules/#flake8-annotations-ann
+    "ANN",    # flake8-annotations: Type annotation checks
+    # https://docs.astral.sh/ruff/rules/#flake8-async-async
+    "ASYNC",  # flake8-async: Asynchronous code checks
+    # https://docs.astral.sh/ruff/rules/#flake8-bandit-s
+    "S",      # flake8-bandit: Security testing
+    # https://docs.astral.sh/ruff/rules/#flake8-blind-except-ble
+    "BLE",    # flake8-blind-except: Checks for blind except: statements
+    # https://docs.astral.sh/ruff/rules/#flake8-boolean-trap-fbt
+    "FBT",    # flake8-boolean-trap: Boolean trap checks
+    # https://docs.astral.sh/ruff/rules/#flake8-bugbear-b
+    "B",      # flake8-bugbear: Finding likely bugs and design problems
+    # https://docs.astral.sh/ruff/rules/#flake8-builtins-a
+    "A",      # flake8-builtins: Check for python builtins being used as variables or parameters
+    # https://docs.astral.sh/ruff/rules/#flake8-commas-com
+    "COM",    # flake8-commas: Trailing commas checks
+    # https://docs.astral.sh/ruff/rules/#flake8-copyright-cpy
+    # "CPY",    # flake8-copyright: Copyright notice checks (Note: requires `preview = true`)
+    # https://docs.astral.sh/ruff/rules/#flake8-comprehensions-c4
+    "C4",     # flake8-comprehensions: Write better list/set/dict comprehensions
+    # https://docs.astral.sh/ruff/rules/#flake8-datetimez-dtz
+    "DTZ",    # flake8-datetimez: Usage of unsafe naive datetime class
+    # https://docs.astral.sh/ruff/rules/#flake8-debugger-t10
+    "T10",    # flake8-debugger: Check for pdb/ipdb imports and set_traces
+    # https://docs.astral.sh/ruff/rules/#flake8-django-dj
+    "DJ",     # flake8-django: Django specific code quality checks
+    # https://docs.astral.sh/ruff/rules/#flake8-errmsg-em
+    "EM",     # flake8-errmsg: Nicer error messages
+    # https://docs.astral.sh/ruff/rules/#flake8-executable-exe
+    "EXE",    # flake8-executable: Executable permissions and shebangs
+    # https://docs.astral.sh/ruff/rules/#flake8-future-annotations-fa
+    "FA",     # flake8-future-annotations: Verify python 3.7+ from __future__ import annotations
+    # https://docs.astral.sh/ruff/rules/#flake8-implicit-str-concat-isc
+    "ISC",    # flake8-implicit-str-concat: Implicit string concatenation checks
+    # https://docs.astral.sh/ruff/rules/#flake8-import-conventions-icn
+    "ICN",    # flake8-import-conventions: Enforce standard naming for standard libraries
+    # https://docs.astral.sh/ruff/rules/#flake8-logging-format-g
+    "G",      # flake8-logging-format: Validate logging format strings
+    # https://docs.astral.sh/ruff/rules/#flake8-no-pep420-inp
+    "INP",    # flake8-no-pep420: Ban PEP-420 implicit namespace packages
+    # https://docs.astral.sh/ruff/rules/#flake8-pie-pie
+    "PIE",    # flake8-pie: Misc. lints
+    # https://docs.astral.sh/ruff/rules/#flake8-print-t20
+    "T20",    # flake8-print: Check for Print statements in python files
+    # https://docs.astral.sh/ruff/rules/#flake8-pyi-pyi
+    "PYI",    # flake8-pyi: Linting for .pyi files
+    # https://docs.astral.sh/ruff/rules/#flake8-pytest-style-pt
+    "PT",     # flake8-pytest-style: Checking common style issues or inconsistencies with pytest
+    # https://docs.astral.sh/ruff/rules/#flake8-quotes-q
+    "Q",      # flake8-quotes: Lint for quotes
+    # https://docs.astral.sh/ruff/rules/#flake8-raise-rse
+    "RSE",    # flake8-raise: Find and correct raise statements
+    # https://docs.astral.sh/ruff/rules/#flake8-return-ret
+    "RET",    # flake8-return: Check return values
+    # https://docs.astral.sh/ruff/rules/#flake8-self-slf
+    "SLF",    # flake8-self: Private member access checks
+    # https://docs.astral.sh/ruff/rules/#flake8-slots-slot
+    "SLOT",   # flake8-slots: Require __slots__ for subclasses of immutable types
+    # https://docs.astral.sh/ruff/rules/#flake8-simplify-sim
+    "SIM",    # flake8-simplify: Code simplification
+    # https://docs.astral.sh/ruff/rules/#flake8-tidy-imports-tid
+    "TID",    # flake8-tidy-imports: Tidy imports
+    # https://docs.astral.sh/ruff/rules/#flake8-type-checking-tc
+    "TC",     # flake8-type-checking: Move imports into type-checking blocks
+    # https://docs.astral.sh/ruff/rules/#flake8-gettext-int
+    "ARG",    # flake8-unused-arguments: Unused argument checks
+    # https://docs.astral.sh/ruff/rules/#flake8-use-pathlib-pth
+    "PTH",    # flake8-use-pathlib: Use pathlib instead of os.path
+    # https://docs.astral.sh/ruff/rules/#flake8-todos-td
+    "TD",     # flake8-todos: TODO comments formatting
+    # https://docs.astral.sh/ruff/rules/#flake8-fixme-fix
+    "FIX",    # flake8-fixme: Check for FIXME, XXX and other developer notes
+    # https://docs.astral.sh/ruff/rules/#eradicate-era
+    "ERA",    # eradicate: Found commented out code
+    # https://docs.astral.sh/ruff/rules/#pandas-vet-pd
+    "PD",     # pandas-vet: Pandas code checks
+    # https://docs.astral.sh/ruff/rules/#pygrep-hooks-pgh
+    "PGH",    # pygrep-hooks: Pygrep hooks
+    # https://docs.astral.sh/ruff/rules/#pylint-pl
+    "PL",     # Pylint: Pylint rules
+    # https://docs.astral.sh/ruff/rules/#tryceratops-try
+    "TRY",    # tryceratops: Prevent Exception Handling AntiPatterns
+    # https://docs.astral.sh/ruff/rules/#flynt-fly
+    "FLY",    # flynt: Convert string formatting to f-strings
+    # https://docs.astral.sh/ruff/rules/#numpy-specific-rules-npy
+    "NPY",    # NumPy-specific rules: NumPy conventions
+    # https://docs.astral.sh/ruff/rules/#airflow-air
+    "AIR",    # Airflow: Airflow best practices
+    # https://docs.astral.sh/ruff/rules/#perflint-perf
+    "PERF",   # Perflint: Performance anti-patterns
+    # https://docs.astral.sh/ruff/rules/#refurb-furb
+    "FURB",   # refurb: Modernize Python code
+    # https://docs.astral.sh/ruff/rules/#flake8-logging-log
+    "LOG",    # flake8-logging: Better logging practices
+    # https://docs.astral.sh/ruff/rules/#pydoclint-doc
+    # "DOC",    # pydoclint: Validate docstrings against function signatures (Note: requires `preview = true`)
+    # https://docs.astral.sh/ruff/rules/#ruff-specific-rules-ruf
+    "RUF"     # Ruff-specific rules: Rules unique to Ruff
+]
+
+# We don't ignore any rules in this config, as it aims to be exhaustive.
+# WARNING: Some of the rules enabled above may be mutually exclusive or
+# conflict with each other (e.g., D212 and D213). You will likely need to
+# remove some rules from the `select` list or add them to the `ignore`
+# list below based on your preferences and project conventions.
+#
+# Below is a list of lint rules that conflict with the Ruff formatter.
+# We ignore these by default so `ruff format` will run without warnings.
+# See: https://docs.astral.sh/ruff/formatter/#conflicting-lint-rules
+ignore = [
+    "W191",   # tab-indentation
+    "E111",   # indentation-with-invalid-multiple
+    "E114",   # indentation-with-invalid-multiple-comment
+    "E117",   # over-indented
+    "D206",   # docstring-tab-indentation
+    "D300",   # triple-single-quotes
+    "Q000",   # bad-quotes-inline-string
+    "Q001",   # bad-quotes-multiline-string
+    "Q002",   # bad-quotes-docstring
+    "Q003",   # avoidable-escaped-quote
+    "Q004",   # unnecessary-escaped-quote
+    "COM812", # missing-trailing-comma
+    "COM819", # prohibited-trailing-comma
+    "ISC001", # single-line-implicit-string-concatenation
+    "ISC002", # multi-line-implicit-string-concatenation
+]
+
+# Allow autofix 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.mccabe]
+# Flag errors (`C901`) whenever the complexity level exceeds 10.
+# Default: 10
+max-complexity = 10
+
+[lint.pydocstyle]
+# Which style to use for docstrings. Can be "google", "numpy", or "pep257".
+# Default: "pep257"
+convention = "pep257"
+
+[lint.flake8-quotes]
+# The style to use for inline strings: "single" or "double"
+# Default: "double"
+inline-quotes = "double"
+# The style to use for multiline strings
+# Default: "double"
+multiline-quotes = "double"
+# The style to use for docstrings
+# Default: "double"
+docstring-quotes = "double"
+# Whether to avoid escaping quotes if the other quote type would save an escape
+# Default: true
+avoid-escape = true
+
+[lint.flake8-tidy-imports]
+# Ban absolute imports from specific modules
+# ban-relative-imports = "all" # Default: "parents"
+
+[lint.isort]
+# How to group imports: "std", "third-party", "first-party", "local-folder".
+# Default: ["future", "standard-library", "third-party", "first-party", "local-folder"]
+# section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"]
+
+[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 = true
+
+# 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"
+
+[lint.flake8-pytest-style]
+# Whether to require parentheses for pytest fixtures.
+# Default: true
+fixture-parentheses = true
+# The type of pytest.mark.parametrize names to use: "tuple", "list", or "csv"
+# Default: "tuple"
+parametrize-names-type = "tuple"
+
+[lint.pylint]
+# The maximum number of arguments allowed for a function.
+# Default: 5
+max-args = 5
+# The maximum return statements allowed for a function.
+# Default: 6
+max-returns = 6
+# The maximum number of branches allowed for a function.
+# Default: 12
+max-branches = 12
+# The maximum number of local variables allowed for a function.
+# Default: 15
+max-locals = 15
+
+[lint.pep8-naming]
+# Additional functions or methods that should be exempt from the lower_case_with_underscores rule.
+# Default: []
+ignore-names = []
+# Additional decorators that should be treated as classmethod.
+# Default: []
+classmethod-decorators = [
+    "pydantic.validator",
+    "pydantic.root_validator",
+]