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

{ruff_sync-0.0.5.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.5.dev1 → ruff_sync-0.0.5.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ruff-sync
-Version: 0.0.5.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)
 
@@ -190,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
 
@@ -212,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
@@ -262,7 +265,7 @@ 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.
+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:
 
@@ -287,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
 
@@ -296,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.5.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)
 
@@ -160,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
 
@@ -182,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
@@ -232,7 +234,7 @@ 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.
+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:
 
@@ -257,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
 
@@ -266,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.dev1 → ruff_sync-0.0.5.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ruff-sync"
-version = "0.0.5.dev1"
+version = "0.0.5.dev2"
 description = "Synchronize Ruff linter configuration across projects"
 keywords = ["ruff", "linter", "config", "synchronize", "python", "linting", "automation", "tomlkit"]
 authors = [
@@ -26,6 +26,7 @@ classifiers = [
 dependencies = [
     "httpx>=0.27.0,<1.0.0",
     "tomlkit>=0.12.3,<2.0.0",
+    "typing-extensions>=4.5.0",
 ]
 
 [project.urls]
@@ -77,7 +78,13 @@ module = "tests.*"
 disable_error_code = ['type-arg', 'no-untyped-def']
 
 [tool.ruff-sync]
-exclude = ["target-version", "line-length", "lint.per-file-ignores", "lint.ignore"]
+exclude = [
+    "target-version",
+    "line-length",
+    "lint.per-file-ignores",
+    "lint.ignore",
+    "extend-exclude",
+]
 
 [tool.ruff]
 target-version = "py310"

{ruff_sync-0.0.5.dev1 → ruff_sync-0.0.5.dev2}/ruff_sync.py

@@ -4,6 +4,7 @@ import asyncio
 import difflib
 import json
 import logging
+import os
 import pathlib
 import re
 import subprocess
@@ -22,8 +23,9 @@ from httpx import URL
 from tomlkit import TOMLDocument, table
 from tomlkit.items import Table
 from tomlkit.toml_file import TOMLFile
+from typing_extensions import deprecated
 
-__version__ = "0.0.5.dev1"
+__version__ = "0.0.5.dev2"
 
 _DEFAULT_EXCLUDE: Final[set[str]] = {"lint.per-file-ignores"}
 _GITHUB_REPO_PATH_PARTS_COUNT: Final[int] = 2
@@ -59,7 +61,7 @@ class ColoredFormatter(logging.Formatter):
 class Arguments(NamedTuple):
     command: str
     upstream: URL
-    source: pathlib.Path
+    to: pathlib.Path
     exclude: Iterable[str]
     verbose: int
     branch: str = "main"
@@ -68,15 +70,21 @@ class Arguments(NamedTuple):
     diff: bool = True
     init: bool = False
 
+    @property
+    @deprecated("Use 'to' instead")
+    def source(self) -> pathlib.Path:
+        return self.to
+
     @classmethod
     @lru_cache(maxsize=1)
     def fields(cls) -> set[str]:
-        return set(cls._fields)
+        return set(cls._fields) | {"source"}
 
 
 class Config(TypedDict, total=False):
     upstream: str
-    source: str
+    to: str
+    source: str  # Deprecated
     exclude: list[str]
     verbose: int
     branch: str
@@ -101,19 +109,20 @@ def get_config(
             allowed_keys = set(Config.__annotations__.keys())
             for arg, value in config.items():
                 if arg in allowed_keys:
+                    if arg == "source":
+                        LOGGER.warning(
+                            "DeprecationWarning: [tool.ruff-sync] 'source' is deprecated. "
+                            "Use 'to' instead."
+                        )
                     cfg_result[arg] = value
                 else:
                     LOGGER.warning(f"Unknown ruff-sync configuration: {arg}")
+            # Ensure 'to' is populated if 'source' was used
+            if "source" in cfg_result and "to" not in cfg_result:
+                cfg_result["to"] = cfg_result["source"]
     return cast("Config", cfg_result)
 
 
-@lru_cache(maxsize=1)
-def _resolve_source(source: str | pathlib.Path) -> pathlib.Path:
-    if isinstance(source, str):
-        source = pathlib.Path(source)
-    return source.resolve(strict=True)
-
-
 def _get_cli_parser() -> ArgumentParser:
     parser = ArgumentParser(
         prog="ruff-sync",
@@ -148,12 +157,17 @@ def _get_cli_parser() -> ArgumentParser:
         help="The URL to download the pyproject.toml file from."
         " Optional if defined in [tool.ruff-sync].",
     )
+    common_parser.add_argument(
+        "--to",
+        help="The directory or file to sync ruff configuration to. Default: .",
+        required=False,
+    )
+    # Add --source as a deprecated alias
     common_parser.add_argument(
         "--source",
-        type=pathlib.Path,
-        default=".",
-        help="The directory to sync the pyproject.toml file to. Default: .",
+        help="Deprecated alias for --to.",
         required=False,
+        metavar="PATH",
     )
     common_parser.add_argument(
         "--exclude",
@@ -216,9 +230,32 @@ def _get_cli_parser() -> ArgumentParser:
     return parser
 
 
-def _get_target_path(path: str | None) -> str:
+def _resolve_target_path(to: pathlib.Path, upstream_url: str | None = None) -> pathlib.Path:
     """Resolve the target path for configuration files.
 
+    If 'to' is a file, it's used directly.
+    Otherwise, it looks for existing ruff/pyproject.toml in the 'to' directory.
+    If none found, it defaults to pyproject.toml unless the upstream is a ruff.toml.
+    """
+    if to.is_file():
+        return to
+
+    # If it's a directory, look for common config files
+    for filename in ("ruff.toml", ".ruff.toml", "pyproject.toml"):
+        candidate = to / filename
+        if candidate.exists():
+            return candidate
+
+    # If upstream is specified and is a ruff.toml, default to ruff.toml
+    if upstream_url and is_ruff_toml_file(upstream_url):
+        return to / "ruff.toml"
+
+    return to / "pyproject.toml"
+
+
+def _resolve_upstream_target_path(path: str | None) -> str:
+    """Resolve the target path for configuration files in upstream repositories.
+
     If the path indicates a .toml file, it's treated as a direct file path.
     Otherwise, it appends 'pyproject.toml' to the path.
     """
@@ -261,7 +298,7 @@ def _convert_github_url(url: URL, branch: str = "main", path: str = "") -> URL:
     path_parts = [p for p in url.path.split("/") if p]
     if len(path_parts) == _GITHUB_REPO_PATH_PARTS_COUNT:
         org, repo = path_parts
-        target_path = _get_target_path(path)
+        target_path = _resolve_upstream_target_path(path)
         raw_url = url.copy_with(
             host=_GITHUB_RAW_HOST,
             path=str(pathlib.PurePosixPath("/", org, repo, branch, target_path)),
@@ -302,7 +339,7 @@ def _convert_gitlab_url(url: URL, branch: str = "main", path: str = "") -> URL:
         # Avoid empty paths or just a slash
         path_prefix = url.path.rstrip("/")
         if path_prefix:
-            target_path = _get_target_path(path)
+            target_path = _resolve_upstream_target_path(path)
             raw_url = url.copy_with(
                 path=str(pathlib.PurePosixPath(path_prefix, "-", "raw", branch, target_path))
             )
@@ -414,7 +451,7 @@ async def fetch_upstream_config(
                         capture_output=True,
                         text=True,
                     )
-                    target_path = pathlib.Path(_get_target_path(path))
+                    target_path = pathlib.Path(_resolve_upstream_target_path(path))
 
                     # Restore just the pyproject_toml file
                     restore_cmd = [
@@ -674,25 +711,13 @@ def merge_ruff_toml(
     return source
 
 
-def _resolve_target_path(args: Arguments) -> pathlib.Path:
-    if args.source.is_file():
-        return args.source
-    if (args.source / "ruff.toml").exists():
-        return args.source / "ruff.toml"
-    if (args.source / ".ruff.toml").exists():
-        return args.source / ".ruff.toml"
-    if args.upstream and is_ruff_toml_file(str(args.upstream)):
-        return args.source / "ruff.toml"
-    return args.source / "pyproject.toml"
-
-
 async def check(
     args: Arguments,
 ) -> int:
     """Check if the local pyproject.toml / ruff.toml is in sync with the upstream."""
     print("🔍 Checking Ruff sync status...")
 
-    _source_toml_path = _resolve_target_path(args).resolve(strict=False)
+    _source_toml_path = _resolve_target_path(args.to, str(args.upstream)).resolve(strict=False)
     if not _source_toml_path.exists():
         print(
             f"❌ Configuration file {_source_toml_path} does not exist. "
@@ -780,7 +805,7 @@ async def pull(
 ) -> int:
     """Pull the upstream ruff config and apply it to the source."""
     print("🔄 Syncing Ruff...")
-    _source_toml_path = _resolve_target_path(args).resolve(strict=False)
+    _source_toml_path = _resolve_target_path(args.to, str(args.upstream)).resolve(strict=False)
 
     source_toml_file = TOMLFile(_source_toml_path)
     if _source_toml_path.exists():
@@ -888,13 +913,33 @@ def _resolve_path(args: Any, config: Mapping[str, Any]) -> str:
     return ""
 
 
-def _resolve_args(args: Any, config: Mapping[str, Any]) -> tuple[URL, Iterable[str], str, str]:
-    """Resolve upstream, exclude, branch, and path from CLI and config."""
+def _resolve_to(args: Any, config: Mapping[str, Any], initial_to: pathlib.Path) -> pathlib.Path:
+    """Resolve target path from CLI, config, or default."""
+    if args.source:
+        LOGGER.warning("DeprecationWarning: --source is deprecated. Use --to instead.")
+        return pathlib.Path(args.source)
+    if args.to:
+        return pathlib.Path(args.to)
+    if "to" in config:
+        target = pathlib.Path(config["to"])
+        # Resolve relative to the directory where we found the config file
+        base_dir = initial_to.parent if initial_to.is_file() else initial_to
+        resolved = base_dir / target
+        LOGGER.info(f"🎯 Using target path from [tool.ruff-sync]: {resolved}")
+        return resolved
+    return initial_to
+
+
+def _resolve_args(
+    args: Any, config: Mapping[str, Any], initial_to: pathlib.Path
+) -> tuple[URL, pathlib.Path, Iterable[str], str, str]:
+    """Resolve upstream, to, exclude, branch, and path from CLI and config."""
     upstream = _resolve_upstream(args, config)
+    to = _resolve_to(args, config, initial_to)
     exclude = _resolve_exclude(args, config)
     branch = _resolve_branch(args, config)
     path = _resolve_path(args, config)
-    return upstream, exclude, branch, path
+    return upstream, to, exclude, branch, path
 
 
 def main() -> int:
@@ -922,11 +967,15 @@ def main() -> int:
     handler = logging.StreamHandler()
     handler.setFormatter(ColoredFormatter())
     LOGGER.addHandler(handler)
-    LOGGER.propagate = False  # Avoid double logging if root is also configured
+    LOGGER.propagate = "PYTEST_CURRENT_TEST" in os.environ  # Allow capturing in tests
 
-    config: Config = get_config(args.source)
+    # Determine target 'to' from CLI or use default '.'
+    # Defer Path conversion to avoid pyfakefs issues with captured Path class
+    arg_to = args.to or args.source
+    initial_to = pathlib.Path(arg_to) if arg_to else pathlib.Path()
+    config: Config = get_config(initial_to)
 
-    upstream, exclude, branch, path = _resolve_args(args, config)
+    upstream, to_val, exclude, branch, path = _resolve_args(args, config, initial_to)
 
     # Convert non-raw github/gitlab upstream url to the raw equivalent
     upstream = resolve_raw_url(upstream, branch=branch, path=path)
@@ -935,7 +984,7 @@ def main() -> int:
     exec_args = Arguments(
         command=args.command,
         upstream=upstream,
-        source=args.source,
+        to=to_val,
         exclude=exclude,
         verbose=args.verbose,
         branch=branch,

ruff_sync-0.0.5.dev2/tests/conftest.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+import pytest
+
+import ruff_sync
+
+
+@pytest.fixture
+def clear_ruff_sync_caches():
+    """Clear all lru_caches in ruff_sync."""
+    ruff_sync.get_config.cache_clear()
+    ruff_sync.Arguments.fields.cache_clear()