ruff-sync 0.1.9.dev0__tar.gz → 0.1.9.dev1__tar.gz

{ruff_sync-0.1.9.dev0 → ruff_sync-0.1.9.dev1}/.agents/skills/gh-issues/SKILL.md

@@ -1,16 +1,17 @@
 ---
 name: gh-issues
 description: >-
-  Create, update, comment on, and link GitHub issues using the gh CLI.
-  Use when creating a new issue, adding sub-issues, cross-referencing issues,
-  or posting large structured content (e.g. research docs) to GitHub.
+  Create, update, comment on, and link GitHub issues and pull requests using the gh CLI.
+  Use when creating a new issue or PR, adding sub-issues, cross-referencing issues,
+  checking CI status, or posting large structured content to GitHub.
 ---
 
-# Working with GitHub Issues via the `gh` CLI
+# Working with GitHub Issues and Pull Requests via the `gh` CLI
 
 ## Quick Reference
 
 ```bash
+# Issues
 gh issue list                          # Open issues
 gh issue list --limit 5               # Most recent 5
 gh issue view <number>                 # Read issue body + metadata
@@ -20,6 +21,13 @@ gh issue create --title "..." --body-file /tmp/body.md  # Create from file (pref
 gh issue comment <number> --body "..." # Post a comment
 gh issue edit <number> --title "..."  # Edit issue metadata
 gh issue close <number>               # Close an issue
+
+# Pull Requests
+gh pr list                             # Open PRs
+gh pr view <number_or_branch>          # Read PR details
+gh pr create --title "..." --body "..." # Open PR (or use --body-file)
+gh pr checks                           # Check CI run status on current PR branch
+gh pr diff                             # Review changes in PR
 ```
 
 ---
@@ -174,8 +182,37 @@ as a GitHub issue body.
 
 ---
 
+## Working with Pull Requests via `gh`
+
+### Creating a Pull Request
+
+When opening a PR from a topic branch:
+
+```bash
+# 1. Push topic branch (prefer plain 'git push' if autoSetupRemote is enabled)
+git push
+# Fallback if upstream tracking is unset: git push -u origin HEAD
+
+# 2. Open the PR linking to the relevant issue
+gh pr create \
+  --title "feat(cli): short descriptive summary" \
+  --body $'## Summary\n- Description of changes made\n\nCloses #<issue-number>'
+# Or use --body-file /tmp/pr-body.md for larger PR descriptions
+```
+
+### Reviewing CI and PR Status
+
+```bash
+gh pr view                             # View current PR summary in terminal
+gh pr checks                           # Check CI run / check status
+gh pr diff                             # Review line-by-line diff of the PR
+```
+
+---
+
 ## References
 
-- `gh issue --help` — full CLI reference
-- [GitHub CLI manual](https://cli.github.com/manual/gh_issue)
-- [GitHub cross-referencing issues](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#issues-and-pull-requests)
+- `gh issue --help` — full issue CLI reference
+- `gh pr --help` — full PR CLI reference
+- [GitHub CLI manual](https://cli.github.com/manual/)
+- [GitHub cross-referencing issues and PRs](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#issues-and-pull-requests)

ruff_sync-0.1.9.dev1/.agents/workflows/task-lifecycle.md

@@ -0,0 +1,158 @@
+---
+description: Standard step-by-step task lifecycle for AI agents working on ruff-sync
+---
+
+# Agent Task Lifecycle & Git Workflow
+
+Follow this end-to-end lifecycle whenever starting a new feature, bug fix, refactor, or documentation update on `ruff-sync`.
+
+```text
+[1. Context] ➔ [2. Branch] ➔ [3. Test First ➔ Commit `test:`] ➔ [4. Implement & Validate ➔ Commit `feat:`/`fix:`] ➔ [5. Sync Docs/Skills ➔ Commit `docs:`] ➔ [6. Push & PR]
+```
+
+> [!IMPORTANT]
+> **Commit Incrementally & Forward-Only (No Git Surgery)**:
+> - Make focused, atomic commits as you complete each stage of work (`test:`, `feat:`, `fix:`, `docs:`). Do not wait until the very end.
+> - **No need to polish history**: This repository uses **Squash and Merge** when merging PRs to `main`. There is no pressure to maintain an artificially pristine internal commit history.
+> - **Avoid Git Surgery**: Do NOT use `git commit --amend` or `git reset` to rewrite past commits (standard `git rebase` against `main` is fine). Always make new forward-only commits for fixes, follow-ups, or formatting.
+
+---
+
+## 1. Intake & Context Gathering
+
+Before writing any code:
+1. **Read GitHub Issues**: If addressing an issue, inspect the description, labels, and all discussion comments:
+   ```bash
+   gh issue view <issue-number> --comments
+   ```
+2. **Check Architectural Decisions (ADRs)**: Review [`.agents/decisions/README.md`](../decisions/README.md) to understand existing architectural constraints and design patterns.
+3. **Review Specialized Skills**: If working on TOML matching, warnings, Textual TUI, or documentation, review the relevant skill in [`.agents/skills/`](../skills/).
+
+---
+
+## 2. Sync & Branch from Latest `main`
+
+> [!IMPORTANT]
+> **Never make commits directly on `main`** unless explicitly instructed by the user. Always branch off the latest remote `main`.
+
+1. **Verify working directory is clean**:
+   ```bash
+   git status
+   ```
+2. **Switch to `main` and pull latest changes**:
+   ```bash
+   git checkout main && git pull origin main
+   ```
+3. **Create and checkout a descriptive topic branch**:
+   ```bash
+   # Branch naming format: <type>/<issue-number>-<short-description>
+   # Types: feat, fix, docs, refactor, test, chore
+   git checkout -b feat/123-url-validation
+   # or for an unlinked bugfix/task:
+   git checkout -b fix/dotted-keys-proxy-table
+   ```
+
+---
+
+## 3. Test First (TDD & Reproduction) ➔ *Commit Incrementally*
+
+- **Bug Fixes**: Always write a reproduction test that **fails** before applying your fix and **passes** with it.
+  - Edge cases and TOML merge tests go in `tests/test_corner_cases.py` or `tests/test_whitespace.py`.
+  - For full lifecycle sync scenarios, scaffold a fixture triple in `tests/lifecycle_tomls/` using [`add-test-case.md`](add-test-case.md):
+    ```bash
+    uv run invoke new-case --name <case_name> --description "Description of edge case"
+    ```
+- **New Features**: Add unit tests in `tests/test_basic.py` or corresponding test module.
+- **Testing Standards**: Follow [`.agents/TESTING.md`](../TESTING.md):
+  - No `unittest.mock` or `MagicMock` (use DI, `respx`, or `pyfakefs`).
+  - Strict async: decorate async tests with `@pytest.mark.asyncio`.
+  - Terminate test files with `if __name__ == "__main__": pytest.main([__file__, "-vv"])`.
+
+**Incremental Commit for Tests**:
+```bash
+git add tests/
+git commit -m "test: add reproduction case for <issue-or-feature-summary>"
+```
+
+---
+
+## 4. Implement & Validate Quality ➔ *Commit Incrementally*
+
+- **Implement Following Project Conventions**:
+  - **Imports**: Always include `from __future__ import annotations` as the first import. Use `import pathlib` and `import datetime as dt`.
+  - **TOML Operations**: Always use `tomlkit`. Use `.unwrap()` when converting proxy objects to native Python objects.
+  - **Sentinels**: Use `MissingType.SENTINEL` (`MISSING`) from `ruff_sync.constants` to distinguish absent fields from explicitly configured defaults.
+  - **Typing**: Python 3.11 strict typing. Prefer `NamedTuple` for return types and `typing.Protocol` over abstract base classes.
+  - **Warnings**: Follow [`.agents/skills/warnings-control/SKILL.md`](../skills/warnings-control/SKILL.md) for user-facing deprecations and `--strict` validation.
+
+- **Run Mandatory 4-Step Validation Pipeline**:
+  ```bash
+  # 1. Lint and auto-fix
+  uv run ruff check . --fix
+
+  # 2. Format code
+  uv run ruff format .
+
+  # 3. Type check (strict mode)
+  uv run mypy .
+
+  # 4. Run test suite
+  uv run pytest -vv
+  ```
+
+  Optional pre-commit run:
+  ```bash
+  uv run prek run --all-files
+  ```
+
+**Incremental Commit for Implementation**:
+```bash
+git add src/ tests/
+git commit -m "feat(core): implement <feature-description> (#123)"
+# or for a bugfix:
+git commit -m "fix(merge): resolve <bug-description> (#123)"
+```
+
+---
+
+## 5. Synchronize Documentation, Skills, & Assets ➔ *Commit Incrementally*
+
+- **CLI or Config Changes**: If CLI flags, config keys in `[tool.ruff-sync]`, or exit codes change, **update the agent skill** at [`.agents/skills/ruff-sync/`](../skills/ruff-sync/) (which points to `src/ruff_sync/.agents/skills/ruff-sync/`).
+- **User Documentation**: Update relevant pages in `docs/` or `mkdocs.yml` and test the docs build:
+   ```bash
+   uv run invoke docs --build
+   ```
+- **Terminal Recordings / Screenshots**:
+  - If CLI output changed, regenerate VHS GIFs: [`update-recordings.md`](update-recordings.md).
+  - If TUI layouts or screens changed, regenerate SVG screenshots: [`update-screenshots.md`](update-screenshots.md).
+- **Architectural Shift**: If you made a major design decision, document it via the [ADR Skill](../skills/adr/SKILL.md).
+
+**Incremental Commit for Documentation & Assets**:
+```bash
+git add docs/ .agents/ src/ruff_sync/.agents/
+git commit -m "docs: update documentation and agent skills for <feature-name>"
+```
+
+---
+
+## 6. Push & Open Pull Request
+
+1. **Push Topic Branch**:
+   ```bash
+   # Prefer plain 'git push' (works automatically if push.autoSetupRemote is enabled and matches auto-approval prefixes)
+   git push
+   # Fallback if upstream tracking is not configured: git push -u origin HEAD
+   ```
+
+2. **Open Pull Request via `gh` CLI**:
+   ```bash
+   gh pr create \
+     --title "feat: descriptive title" \
+     --body $'## Summary\n- Description of changes\n\nCloses #<issue-number>'
+   # Or use --body-file /tmp/pr-body.md for larger descriptions
+   ```
+
+3. **Verify CI**:
+   ```bash
+   gh pr checks
+   ```

ruff_sync-0.1.9.dev1/.pre-commit-config.yaml

@@ -0,0 +1,56 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-ast # validates Python syntax before committing
+      - id: check-json # validates JSON file structure
+      - id: check-yaml # validates YAML file structure
+        args: ["--unsafe"]
+        exclude: .agents/skills/mkdocs-generation/templates/mkdocs.yml
+      - id: check-toml # validates pyproject.toml and other TOML files
+      - id: check-merge-conflict # blocks files that still have <<< merge conflict markers
+      - id: check-added-large-files # prevents files over 1MB from being committed
+        args: ["--maxkb=1024"]
+      - id: check-case-conflict # catches filename casing issues across Windows/Mac/Linux
+      - id: detect-private-key # blocks accidental commit of SSH keys and API secrets
+      - id: mixed-line-ending # enforces LF line endings for cross-platform consistency
+        args: ["--fix=lf"]
+      - id: end-of-file-fixer # ensures every file ends with a newline
+      - id: trailing-whitespace # removes trailing whitespace from all lines
+      - id: no-commit-to-branch # prevents direct commits to develop and main branches
+        args: [--branch, develop, --branch, main]
+
+  # Ruff: fast Python linter and formatter
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: "v0.16.5"
+    hooks:
+      - id: ruff-check # lints Python code and auto-fixes where possible
+        args: ["--fix"]
+      - id: ruff-format # formats Python code consistently
+
+  # Prettier: opinionated formatter for YAML and JSON
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v4.0.0-alpha.8
+    hooks:
+      - id: prettier
+        types_or: [yaml, json] # formats YAML and JSON files
+        exclude: .agents/skills/mkdocs-generation/templates/mkdocs.yml
+
+  # Actionlint: static analysis for GitHub Actions workflow files
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.12
+    hooks:
+      - id: actionlint
+        exclude: .github/workflows/complexity.yaml
+
+# https://pre-commit.ci/
+ci:
+  autofix_commit_msg: |
+    [pre-commit.ci] auto fixes from pre-commit.com hooks
+
+    for more information, see https://pre-commit.ci
+  autofix_prs: true
+  autoupdate_branch: "main"
+  autoupdate_commit_msg: "[pre-commit.ci] pre-commit autoupdate"
+  autoupdate_schedule: weekly
+  submodules: false

{ruff_sync-0.1.9.dev0 → ruff_sync-0.1.9.dev1}/AGENTS.md

@@ -10,7 +10,24 @@
 
 ## GitHub Context
 
-Use the GitHub CLI (`gh`) to gather extra context about issues, pull requests, and releases before starting work. For detailed workflows on managing issues, see the `gh-issues` skill in `.agents/skills/gh-issues/SKILL.md`.
+Use the GitHub CLI (`gh`) to gather extra context about issues, pull requests, and releases before starting work. For detailed workflows on managing issues and pull requests, see the `gh-issues` skill in `.agents/skills/gh-issues/SKILL.md`.
+
+## Task Lifecycle & Git Workflow
+
+All new tasks, bug fixes, refactors, and features MUST follow the standard lifecycle (see detailed guide in [`.agents/workflows/task-lifecycle.md`](.agents/workflows/task-lifecycle.md)):
+
+1. **Intake Context**: Read relevant issues (`gh issue view <num> --comments`) and ADRs in `.agents/decisions/`.
+2. **Branch from Latest `main`**: **Never commit directly to `main`** unless explicitly instructed.
+   ```bash
+   git checkout main && git pull origin main
+   git checkout -b <type>/<issue-number>-<short-description>
+   ```
+   *Branch types: `feat/`, `fix/`, `docs/`, `refactor/`, `test/`, `chore/`.*
+3. **Test First (TDD)**: For bugfixes, write a reproduction test before fixing the bug. Commit test cases incrementally (`test: ...`).
+4. **Implement & Validate**: Adhere to project conventions (strict typing, DI, `tomlkit`, sentinels). Run the 4-step quality pipeline (`ruff check`, `ruff format`, `mypy`, `pytest`). Commit logical units of implementation incrementally (`feat: ...`, `fix: ...`, `refactor: ...`).
+5. **Sync Documentation & Skills**: Update `.agents/skills/ruff-sync/` and `docs/` if CLI flags, config keys, or behavior change. Commit documentation changes (`docs: ...`).
+6. **Open PR**: Push branch (prefer plain `git push` if upstream tracking / `push.autoSetupRemote` is configured) and open a PR via `gh pr create`. **Do not wait until the very end to make a single giant commit**; keep commit history clean, granular, and incremental.
+7. **No Git Surgery / Commit Amending**: This repository uses **Squash and Merge** on PR merge, so there is no pressure to curate branch history. Do **not** use `git commit --amend` or `git reset` to polish past commits (standard `git rebase` to stay up to date with `main` is fine). Always make forward-only commits for fixes and follow-ups.
 
 ## Agent Skills
 
@@ -21,7 +38,7 @@ Specific workflows, libraries, and tools are documented in `.agents/skills/`. Be
 - **Python** ≥ 3.11 (target version `py311`)
 - **Package Manager**: [uv](https://docs.astral.sh/uv/) — Use `uv run <command>` for all executions to ensure the correct environment.
     - **Note on PATH**: On macOS, `uv` is often installed in `~/.local/bin`. If `uv` is not found, add this to your `PATH`: `export PATH="$PATH:$HOME/.local/bin"`.
-- **Linter / Formatter**: [Ruff](https://docs.astral.sh/ruff/) (`>=0.15.0`)
+- **Linter / Formatter**: [Ruff](https://docs.astral.sh/ruff/) (`>=0.16.5`)
 - **Type Checker**: [mypy](https://mypy-lang.org/) (strict mode)
 - **Test Framework**: [pytest](https://docs.pytest.org/) with `pytest-asyncio`, `respx`, `pyfakefs` (See [Testing Standards](.agents/TESTING.md))
 - **Coverage**: `coverage` + Codecov
@@ -34,9 +51,15 @@ Specific workflows, libraries, and tools are documented in `.agents/skills/`. Be
 ```text
 .agents/               # Agent-specific instructions (Deep Standards)
   TESTING.md           # Mandatory testing patterns and rules
+  DEPENDENCIES.md      # Optional dependencies and lazy loading standard
   workflows/           # Step-by-step guides for common tasks
+    task-lifecycle.md  # Standard end-to-end task lifecycle & git workflow
+    add-test-case.md   # How to add lifecycle TOML fixtures
+    update-recordings.md # How to regenerate VHS CLI animation recordings
+    update-screenshots.md # How to regenerate TUI screenshots
   decisions/           # Internal Architectural Decision Records (ADRs)
     README.md          # Index of all architectural decisions
+  plans/               # Historical and active implementation plans
   skills/
     ruff-sync/         # Symlink to src/ruff_sync/.agents/skills/ruff-sync (for local workspace agent loading)
       SKILL.md
@@ -45,7 +68,7 @@ Specific workflows, libraries, and tools are documented in `.agents/skills/`. Be
         troubleshooting.md
         ci-integration.md
 src/ruff_sync/         # The application source
-  .agents/skills/ruff-sync/ # [NEW] Canonical physical skill source directory (packaged into wheels)
+  .agents/skills/ruff-sync/ # Canonical physical skill source directory (packaged into wheels)
   __init__.py          # Public API
   __main__.py          # CLI entry point (`python -m ruff_sync`)
   cli.py               # CLI argparse definition and orchestration

{ruff_sync-0.1.9.dev0 → ruff_sync-0.1.9.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ruff-sync
-Version: 0.1.9.dev0
+Version: 0.1.9.dev1
 Summary: Synchronize Ruff linter configuration across projects
 Project-URL: Homepage, https://github.com/Kilo59/ruff-sync
 Project-URL: Documentation, https://kilo59.github.io/ruff-sync/

ruff_sync-0.1.9.dev1/configs/data-science-engineering/ruff.toml

@@ -0,0 +1,209 @@
+# ruff-sync Data Science & Engineering Configuration
+# https://github.com/Kilo59/ruff-sync
+#
+# This is a Ruff configuration tailored for Data Science, Machine Learning,
+# and Data Engineering workflows.
+# It enables rules for Jupyter Notebooks, NumPy, Pandas, Airflow, and performance.
+#
+# Usage (direct Ruff config, assuming this file is vendored into your repo):
+#   extend = "configs/data-science-engineering/ruff.toml"
+#
+# Usage (with ruff-sync in pyproject.toml):
+#   [tool.ruff-sync]
+#   path = "configs/data-science-engineering/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"
+
+# Enable Jupyter notebook linting and formatting
+extend-include = ["*.ipynb"]
+extend-exclude = [".ipynb_checkpoints"]
+
+[lint]
+# Enable rules tailored for data science, machine learning, and data engineering.
+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 (NumPy style)
+    # 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-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
+    # https://docs.astral.sh/ruff/rules/#flake8-comprehensions-c4
+    "C4",     # flake8-comprehensions: 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-logging-format-g
+    "G",      # flake8-logging-format: Validate logging format strings
+    # 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-pytest-style-pt
+    "PT",     # flake8-pytest-style: Pytest style checks
+    # https://docs.astral.sh/ruff/rules/#flake8-quotes-q
+    "Q",      # flake8-quotes: Lint for quotes
+    # 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-unused-arguments-arg
+    "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/#pandas-vet-pd
+    "PD",     # pandas-vet: Pandas code checks
+    # https://docs.astral.sh/ruff/rules/#numpy-specific-rules-npy
+    "NPY",    # NumPy-specific rules: NumPy conventions & NumPy 2.0 migration
+    # https://docs.astral.sh/ruff/rules/#airflow-air
+    "AIR",    # Airflow: Airflow best practices (Data Engineering pipelines)
+    # https://docs.astral.sh/ruff/rules/#perflint-perf
+    "PERF",   # Perflint: Performance anti-patterns in loops
+    # 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/#pylint-pl
+    "PL",     # Pylint: Pylint rules
+    # https://docs.astral.sh/ruff/rules/#flynt-fly
+    "FLY",    # flynt: Convert string formatting to f-strings
+    # 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/pytest-fixture-autouse/
+    # "pedantic",                 # Category selector: Pedantic checks (Note: requires `preview = true`)
+    # "pytest-fixture-autouse",   # Codeless rule: Avoid autouse=True in pytest fixtures (Note: requires `preview = true`)
+    # https://docs.astral.sh/ruff/rules/#ruff-specific-rules-ruf
+    "RUF",    # Ruff-specific rules: Rules unique to Ruff
+]
+
+# Preview mode settings:
+# preview = true                # Enable preview rules and fixes across Ruff
+# explicit-preview-rules = true # When preview is enabled, require full rule codes instead of prefixes
+
+# 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"]
+unfixable = []
+
+# Allow unused variables when underscore-prefixed.
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[lint.per-file-ignores]
+# Notebooks often have top-level statements, plots, and exploratory code.
+"*.ipynb" = [
+    "E402",   # Module level import not at top of file
+    "T201",   # print found
+    "D100",   # Missing docstring in public module
+    "D103",   # Missing docstring in public function
+]
+
+[lint.pydocstyle]
+# Use NumPy-style docstrings (standard in Data Science / Scientific Python).
+# Default: "pep257"
+convention = "numpy"
+
+[lint.mccabe]
+# Flag errors (C901) whenever the complexity level exceeds 10.
+# Default: 10
+max-complexity = 10
+
+[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
+
+[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"
+
+# Controls the quote style for nested strings inside interpolated string expressions (Python 3.12+).
+# Can be "alternating" (default) or "preferred".
+nested-string-quote-style = "alternating"