path-sync 0.5.0__tar.gz → 0.6.0__tar.gz

{path_sync-0.5.0 → path_sync-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: path-sync
-Version: 0.5.0
+Version: 0.6.0
 Summary: Sync files from a source repo to multiple destination repos
 Author-email: EspenAlbert <espen.albert1@gmail.com>
 License-Expression: MIT
@@ -77,13 +77,14 @@ By default, prompts before each git operation. See [Usage Scenarios](#usage-scen
 | `-d dest1,dest2` | Filter specific destinations |
 | `--dry-run` | Preview without writing (requires existing repos) |
 | `-y, --no-prompt` | Skip confirmations (for CI) |
-| `--local` | No git ops after sync (no commit/push/PR) |
+| `--skip-commit` | No git ops after sync (no commit/push/PR). Alias: `--local` |
 | `--no-checkout` | Skip branch switching (assumes already on correct branch) |
 | `--checkout-from-default` | Reset to origin/default before sync |
 | `--no-pr` | Push but skip PR creation |
 | `--force-overwrite` | Overwrite files even if header removed (opted out) |
 | `--detailed-exit-code` | Exit 0=no changes, 1=changes, 2=error |
 | `--skip-orphan-cleanup` | Skip deletion of orphaned synced files |
+| `--skip-verify` | Skip verification steps after syncing |
 | `--pr-title` | Override PR title (supports `{name}`, `{dest_name}`) |
 | `--pr-labels` | Comma-separated PR labels |
 | `--pr-reviewers` | Comma-separated PR reviewers |
@@ -106,12 +107,12 @@ Options:
 | Interactive sync | `copy -n cfg` |
 | CI fresh sync | `copy -n cfg --checkout-from-default -y` |
 | Local preview | `copy -n cfg --dry-run` |
-| Local test files | `copy -n cfg --local` |
+| Local test files | `copy -n cfg --skip-commit` |
 | Already on branch | `copy -n cfg --no-checkout` |
 | Push, manual PR | `copy -n cfg --no-pr -y` |
 | Force opted-out | `copy -n cfg --force-overwrite` |
 
-**Interactive prompt behavior**: Declining the checkout prompt syncs files but skips commit/push/PR (same as `--local`). Use `--no-checkout` when you're already on the correct branch and want to proceed with git operations.
+**Interactive prompt behavior**: Each git operation (checkout, commit, push, PR) prompts independently. Use `--no-checkout` to skip the branch switch prompt. Use `--skip-commit` to skip all git operations after sync.
 
 ## Section Markers
 
@@ -139,6 +140,36 @@ destinations:
       justfile: [coverage]  # keep local coverage recipe
 ```
 
+## Wrapping Synced Files
+
+For files without section markers, `wrap_synced_files` automatically wraps content in a `synced` section. This lets destinations add content before/after the synced content.
+
+**Without wrapping** (default):
+```python
+# path-sync copy -n myconfig
+def hello():
+    pass
+```
+
+**With wrapping** (`wrap_synced_files: true`):
+```python
+# path-sync copy -n myconfig
+# === DO_NOT_EDIT: path-sync synced ===
+def hello():
+    pass
+# === OK_EDIT: path-sync synced ===
+```
+
+Destinations can add content outside the section markers. Per-path override via `wrap: false`:
+
+```yaml
+wrap_synced_files: true
+paths:
+  - src_path: templates/base.py     # wrapped
+  - src_path: .editorconfig
+    wrap: false                     # not wrapped
+```
+
 ## Skipping Files per Destination
 
 Use `skip_file_patterns` to exclude files for specific destinations. Patterns match against the **destination path** (after `dest_path` remapping):
@@ -195,6 +226,8 @@ destinations:
 | `destinations` | Target repos with sync settings |
 | `header_config` | Comment style per extension (has defaults) |
 | `pr_defaults` | PR title, labels, reviewers, assignees |
+| `wrap_synced_files` | Wrap synced files in section markers (default: `false`) |
+| `verify` | Verification steps to run after syncing (see [Verify Steps](#verify-steps-in-copy)) |
 
 **Path options**:
 
@@ -205,6 +238,7 @@ destinations:
 | `sync_mode` | `sync` (default), `replace`, or `scaffold` |
 | `exclude_dirs` | Directory names to skip (defaults: `__pycache__`, `.git`, `.venv`, etc.) |
 | `exclude_file_patterns` | Filename patterns to skip, supports globs (`*.pyc`, `test_*.py`) |
+| `wrap` | Override global `wrap_synced_files` for this path (`true`/`false`) |
 
 **Destination options**:
 
@@ -217,6 +251,37 @@ destinations:
 | `default_branch` | Default branch to compare against (defaults to `main`) |
 | `skip_sections` | Map of `{dest_path: [section_ids]}` to preserve locally |
 | `skip_file_patterns` | Patterns to skip for this destination (matches dest path, fnmatch syntax) |
+| `verify` | Per-destination verify config (overrides source-level verify) |
+
+## Verify Steps in Copy
+
+Run verification steps after syncing files. Synced files are committed first, then verify steps run and can make additional commits.
+
+```yaml
+name: myconfig
+verify:
+  on_fail: warn  # default: warn (also: skip, fail)
+  steps:
+    - run: just fmt
+      commit:
+        message: "style: format synced files"
+        add_paths: ["."]
+      on_fail: warn
+    - run: just test
+```
+
+Per-destination override:
+
+```yaml
+destinations:
+  - name: dest1
+    dest_path_relative: ../dest1
+    verify:
+      steps:
+        - run: npm run build
+```
+
+Use `--skip-verify` to disable verification steps.
 
 ## Header Format
 

{path_sync-0.5.0 → path_sync-0.6.0}/README.md

@@ -59,13 +59,14 @@ By default, prompts before each git operation. See [Usage Scenarios](#usage-scen
 | `-d dest1,dest2` | Filter specific destinations |
 | `--dry-run` | Preview without writing (requires existing repos) |
 | `-y, --no-prompt` | Skip confirmations (for CI) |
-| `--local` | No git ops after sync (no commit/push/PR) |
+| `--skip-commit` | No git ops after sync (no commit/push/PR). Alias: `--local` |
 | `--no-checkout` | Skip branch switching (assumes already on correct branch) |
 | `--checkout-from-default` | Reset to origin/default before sync |
 | `--no-pr` | Push but skip PR creation |
 | `--force-overwrite` | Overwrite files even if header removed (opted out) |
 | `--detailed-exit-code` | Exit 0=no changes, 1=changes, 2=error |
 | `--skip-orphan-cleanup` | Skip deletion of orphaned synced files |
+| `--skip-verify` | Skip verification steps after syncing |
 | `--pr-title` | Override PR title (supports `{name}`, `{dest_name}`) |
 | `--pr-labels` | Comma-separated PR labels |
 | `--pr-reviewers` | Comma-separated PR reviewers |
@@ -88,12 +89,12 @@ Options:
 | Interactive sync | `copy -n cfg` |
 | CI fresh sync | `copy -n cfg --checkout-from-default -y` |
 | Local preview | `copy -n cfg --dry-run` |
-| Local test files | `copy -n cfg --local` |
+| Local test files | `copy -n cfg --skip-commit` |
 | Already on branch | `copy -n cfg --no-checkout` |
 | Push, manual PR | `copy -n cfg --no-pr -y` |
 | Force opted-out | `copy -n cfg --force-overwrite` |
 
-**Interactive prompt behavior**: Declining the checkout prompt syncs files but skips commit/push/PR (same as `--local`). Use `--no-checkout` when you're already on the correct branch and want to proceed with git operations.
+**Interactive prompt behavior**: Each git operation (checkout, commit, push, PR) prompts independently. Use `--no-checkout` to skip the branch switch prompt. Use `--skip-commit` to skip all git operations after sync.
 
 ## Section Markers
 
@@ -121,6 +122,36 @@ destinations:
       justfile: [coverage]  # keep local coverage recipe
 ```
 
+## Wrapping Synced Files
+
+For files without section markers, `wrap_synced_files` automatically wraps content in a `synced` section. This lets destinations add content before/after the synced content.
+
+**Without wrapping** (default):
+```python
+# path-sync copy -n myconfig
+def hello():
+    pass
+```
+
+**With wrapping** (`wrap_synced_files: true`):
+```python
+# path-sync copy -n myconfig
+# === DO_NOT_EDIT: path-sync synced ===
+def hello():
+    pass
+# === OK_EDIT: path-sync synced ===
+```
+
+Destinations can add content outside the section markers. Per-path override via `wrap: false`:
+
+```yaml
+wrap_synced_files: true
+paths:
+  - src_path: templates/base.py     # wrapped
+  - src_path: .editorconfig
+    wrap: false                     # not wrapped
+```
+
 ## Skipping Files per Destination
 
 Use `skip_file_patterns` to exclude files for specific destinations. Patterns match against the **destination path** (after `dest_path` remapping):
@@ -177,6 +208,8 @@ destinations:
 | `destinations` | Target repos with sync settings |
 | `header_config` | Comment style per extension (has defaults) |
 | `pr_defaults` | PR title, labels, reviewers, assignees |
+| `wrap_synced_files` | Wrap synced files in section markers (default: `false`) |
+| `verify` | Verification steps to run after syncing (see [Verify Steps](#verify-steps-in-copy)) |
 
 **Path options**:
 
@@ -187,6 +220,7 @@ destinations:
 | `sync_mode` | `sync` (default), `replace`, or `scaffold` |
 | `exclude_dirs` | Directory names to skip (defaults: `__pycache__`, `.git`, `.venv`, etc.) |
 | `exclude_file_patterns` | Filename patterns to skip, supports globs (`*.pyc`, `test_*.py`) |
+| `wrap` | Override global `wrap_synced_files` for this path (`true`/`false`) |
 
 **Destination options**:
 
@@ -199,6 +233,37 @@ destinations:
 | `default_branch` | Default branch to compare against (defaults to `main`) |
 | `skip_sections` | Map of `{dest_path: [section_ids]}` to preserve locally |
 | `skip_file_patterns` | Patterns to skip for this destination (matches dest path, fnmatch syntax) |
+| `verify` | Per-destination verify config (overrides source-level verify) |
+
+## Verify Steps in Copy
+
+Run verification steps after syncing files. Synced files are committed first, then verify steps run and can make additional commits.
+
+```yaml
+name: myconfig
+verify:
+  on_fail: warn  # default: warn (also: skip, fail)
+  steps:
+    - run: just fmt
+      commit:
+        message: "style: format synced files"
+        add_paths: ["."]
+      on_fail: warn
+    - run: just test
+```
+
+Per-destination override:
+
+```yaml
+destinations:
+  - name: dest1
+    dest_path_relative: ../dest1
+    verify:
+      steps:
+        - run: npm run build
+```
+
+Use `--skip-verify` to disable verification steps.
 
 ## Header Format
 

{path_sync-0.5.0 → path_sync-0.6.0}/path_sync/__init__.py

@@ -5,7 +5,7 @@ from path_sync import dep_update
 from path_sync import validate_no_changes
 from path_sync import config
 
-VERSION = "0.5.0"
+VERSION = "0.6.0"
 __all__ = [
     "copy",
     "dep_update",

{path_sync-0.5.0 → path_sync-0.6.0}/path_sync/_internal/cmd_copy.py

@@ -10,7 +10,7 @@ import typer
 from pydantic import BaseModel
 
 from path_sync import sections
-from path_sync._internal import cmd_options, git_ops, header, prompt_utils
+from path_sync._internal import cmd_options, git_ops, header, prompt_utils, verify
 from path_sync._internal.file_utils import ensure_parents_write_text
 from path_sync._internal.log_capture import capture_log
 from path_sync._internal.models import (
@@ -22,6 +22,7 @@ from path_sync._internal.models import (
     resolve_config_path,
 )
 from path_sync._internal.typer_app import app
+from path_sync._internal.verify import StepFailure, VerifyResult, VerifyStatus
 from path_sync._internal.yaml_utils import load_yaml_model
 
 logger = logging.getLogger(__name__)
@@ -47,10 +48,11 @@ class CopyOptions(BaseModel):
     force_overwrite: bool = False
     no_checkout: bool = False
     checkout_from_default: bool = False
-    local: bool = False
+    skip_commit: bool = False
     no_prompt: bool = False
     no_pr: bool = False
     skip_orphan_cleanup: bool = False
+    skip_verify: bool = False
     pr_title: str = ""
     labels: list[str] | None = None
     reviewers: list[str] | None = None
@@ -93,8 +95,9 @@ def copy(
         "--checkout-from-default",
         help="Reset to origin/default before sync (for CI)",
     ),
-    local: bool = typer.Option(
+    skip_commit: bool = typer.Option(
         False,
+        "--skip-commit",
         "--local",
         help="No git operations after sync (no commit/push/PR)",
     ),
@@ -122,6 +125,11 @@ def copy(
         "--skip-orphan-cleanup",
         help="Skip deletion of orphaned synced files",
     ),
+    skip_verify: bool = typer.Option(
+        False,
+        "--skip-verify",
+        help="Skip verification steps after syncing",
+    ),
 ) -> None:
     """Copy files from SRC to DEST repositories."""
     if name and config_path_opt:
@@ -148,10 +156,11 @@ def copy(
         force_overwrite=force_overwrite,
         no_checkout=no_checkout,
         checkout_from_default=checkout_from_default,
-        local=local,
+        skip_commit=skip_commit,
         no_prompt=no_prompt,
         no_pr=no_pr,
         skip_orphan_cleanup=skip_orphan_cleanup,
+        skip_verify=skip_verify,
         pr_title=pr_title or config.pr_defaults.title,
         labels=cmd_options.split_csv(pr_labels) or config.pr_defaults.labels,
         reviewers=cmd_options.split_csv(pr_reviewers) or config.pr_defaults.reviewers,
@@ -196,23 +205,14 @@ def _sync_destination(
     dest_repo = _ensure_dest_repo(dest, dest_root, opts.dry_run)
     copy_branch = dest.resolved_copy_branch(config.name)
 
-    # --no-checkout means "I'm already on the right branch"
-    # Prompt decline means "skip git operations for this run"
-    if opts.dry_run:
-        skip_git_ops = True
-    elif opts.no_checkout:
-        skip_git_ops = False
-    elif prompt_utils.prompt_confirm(f"Switch {dest.name} to {copy_branch}?", opts.no_prompt):
+    # --no-checkout skips branch switching (assumes already on correct branch)
+    if not opts.no_checkout and prompt_utils.prompt_confirm(f"Switch {dest.name} to {copy_branch}?", opts.no_prompt):
         git_ops.prepare_copy_branch(
             repo=dest_repo,
             default_branch=dest.default_branch,
             copy_branch=copy_branch,
             from_default=opts.checkout_from_default,
         )
-        skip_git_ops = False
-    else:
-        skip_git_ops = True
-
     result = _sync_paths(config, dest, src_root, dest_root, opts)
     _print_sync_summary(dest, result)
 
@@ -220,10 +220,29 @@ def _sync_destination(
         logger.info(f"{dest.name}: No changes")
         return 0
 
-    if skip_git_ops:
-        return result.total
+    # --skip-commit and --dry-run skip commit; otherwise prompt
+    should_skip_commit = opts.skip_commit or opts.dry_run
+    if not should_skip_commit and prompt_utils.prompt_confirm(f"Commit changes to {dest.name}?", opts.no_prompt):
+        sync_commit_msg = f"chore: sync {config.name} from {current_sha[:8]}"
+        git_ops.commit_changes(dest_repo, sync_commit_msg)
+
+    verify_result = VerifyResult()
+    effective_verify = dest.resolve_verify(config.verify)
+    if not opts.skip_verify and effective_verify.steps:
+        verify_result = verify.run_verify_steps(
+            dest_repo, dest_root, effective_verify, dry_run=opts.dry_run, skip_commit=opts.skip_commit
+        )
+        verify.log_verify_summary(dest.name, verify_result)
+
+        if verify_result.status == VerifyStatus.FAILED:
+            logger.error(f"{dest.name}: Verification failed, stopping")
+            raise typer.Exit(EXIT_ERROR)
+
+        if verify_result.status == VerifyStatus.SKIPPED:
+            logger.warning(f"{dest.name}: Verification skipped due to failure")
+            return result.total
 
-    _commit_and_pr(config, dest_repo, dest_root, dest, current_sha, src_repo_url, opts, read_log)
+    _push_and_pr(config, dest_repo, dest_root, dest, current_sha, src_repo_url, opts, read_log, verify_result)
     return result.total
 
 
@@ -264,6 +283,7 @@ def _sync_paths(
             config.name,
             opts.dry_run,
             opts.force_overwrite,
+            config.wrap_synced_files,
         )
         result.content_changes += changes
         result.synced_paths.update(paths)
@@ -314,10 +334,12 @@ def _sync_path(
     config_name: str,
     dry_run: bool,
     force_overwrite: bool,
+    wrap_synced_files: bool = False,
 ) -> tuple[int, set[Path]]:
     changes = 0
     synced: set[Path] = set()
 
+    should_wrap = mapping.should_wrap(wrap_synced_files)
     for src_path, dest_key, dest_path in _iter_sync_files(mapping, src_root, dest_root):
         if dest.is_skipped(dest_key):
             continue
@@ -330,6 +352,7 @@ def _sync_path(
             mapping.sync_mode,
             dry_run,
             force_overwrite,
+            should_wrap,
         )
         synced.add(dest_path)
 
@@ -345,6 +368,7 @@ def _copy_file(
     sync_mode: SyncMode,
     dry_run: bool,
     force_overwrite: bool = False,
+    should_wrap: bool = False,
 ) -> int:
     try:
         src_content = header.remove_header(src.read_text())
@@ -358,7 +382,7 @@ def _copy_file(
             return _handle_replace(src_content, dest_path, dry_run)
         case SyncMode.SYNC:
             skip_list = dest.skip_sections.get(dest_key, [])
-            return _handle_sync(src_content, dest_path, skip_list, config_name, dry_run, force_overwrite)
+            return _handle_sync(src_content, dest_path, skip_list, config_name, dry_run, force_overwrite, should_wrap)
 
 
 def _copy_binary_file(src: Path, dest_path: Path, sync_mode: SyncMode, dry_run: bool) -> int:
@@ -402,10 +426,15 @@ def _handle_sync(
     config_name: str,
     dry_run: bool,
     force_overwrite: bool,
+    should_wrap: bool = False,
 ) -> int:
     if sections.has_sections(src_content, dest_path):
         return _handle_sync_sections(src_content, dest_path, skip_list, config_name, dry_run, force_overwrite)
 
+    if should_wrap:
+        wrapped = sections.wrap_in_synced_section(src_content, dest_path)
+        return _handle_sync_sections(wrapped, dest_path, skip_list, config_name, dry_run, force_overwrite)
+
     if dest_path.exists():
         existing = dest_path.read_text()
         has_hdr = header.has_header(existing)
@@ -436,7 +465,7 @@ def _handle_sync_sections(
     dry_run: bool,
     force_overwrite: bool,
 ) -> int:
-    src_sections = sections.extract_sections(src_content, dest_path)
+    src_sections = sections.parse_sections(src_content, dest_path)
 
     if dest_path.exists():
         existing = dest_path.read_text()
@@ -445,6 +474,9 @@ def _handle_sync_sections(
             return 0
         dest_body = header.remove_header(existing)
         new_body = sections.replace_sections(dest_body, src_sections, dest_path, skip_list)
+    elif skip_list:
+        filtered = [s for s in src_sections if s.id not in skip_list]
+        new_body = sections.build_sections_content(filtered, dest_path)
     else:
         new_body = src_content
 
@@ -484,7 +516,7 @@ def _find_files_with_config(dest_root: Path, config_name: str) -> list[Path]:
     return result
 
 
-def _commit_and_pr(
+def _push_and_pr(
     config: SrcConfig,
     repo,
     dest_root: Path,
@@ -493,19 +525,21 @@ def _commit_and_pr(
     src_repo_url: str,
     opts: CopyOptions,
     read_log: Callable[[], str],
+    verify_result: VerifyResult,
 ) -> None:
-    if opts.local:
-        logger.info("Local mode: skipping commit/push/PR")
+    if opts.skip_commit or opts.dry_run:
+        logger.info("Skipping push/PR (--skip-commit or --dry-run)")
         return
 
     copy_branch = dest.resolved_copy_branch(config.name)
 
-    if not prompt_utils.prompt_confirm(f"Commit changes to {dest.name}?", opts.no_prompt):
-        return
-
-    commit_msg = f"chore: sync {config.name} from {sha[:8]}"
-    git_ops.commit_changes(repo, commit_msg)
-    typer.echo(f"  Committed: {commit_msg}", err=True)
+    # Commit any remaining changes from verify steps without their own commit config
+    if git_ops.has_changes(repo):
+        if not prompt_utils.prompt_confirm(f"Commit remaining changes to {dest.name}?", opts.no_prompt):
+            return
+        commit_msg = f"chore: post-sync changes for {config.name}"
+        git_ops.commit_changes(repo, commit_msg)
+        typer.echo(f"  Committed: {commit_msg}", err=True)
 
     if not prompt_utils.prompt_confirm(f"Push {dest.name} to origin?", opts.no_prompt):
         return
@@ -524,6 +558,9 @@ def _commit_and_pr(
         dest_name=dest.name,
     )
 
+    if verify_result.failures:
+        pr_body = _append_verify_warnings(pr_body, verify_result.failures)
+
     title = opts.pr_title.format(name=config.name, dest_name=dest.name)
     pr_url = git_ops.create_or_update_pr(
         dest_root,
@@ -536,3 +573,10 @@ def _commit_and_pr(
     )
     if pr_url:
         typer.echo(f"  Created PR: {pr_url}", err=True)
+
+
+def _append_verify_warnings(body: str, failures: list[StepFailure]) -> str:
+    body += "\n\n---\n## Verification Warnings\n"
+    for f in failures:
+        body += f"\n- `{f.step}` failed (exit code {f.returncode}, strategy: {f.on_fail})"
+    return body

{path_sync-0.5.0 → path_sync-0.6.0}/path_sync/_internal/cmd_dep_update.py

@@ -10,17 +10,16 @@ from pathlib import Path
 import typer
 from git import Repo
 
-from path_sync._internal import cmd_options, git_ops, prompt_utils
+from path_sync._internal import cmd_options, git_ops, prompt_utils, verify
 from path_sync._internal.log_capture import capture_log
-from path_sync._internal.models import Destination, find_repo_root
+from path_sync._internal.models import Destination, OnFailStrategy, find_repo_root
 from path_sync._internal.models_dep import (
     DepConfig,
-    OnFailStrategy,
     UpdateEntry,
-    VerifyConfig,
     resolve_dep_config_path,
 )
 from path_sync._internal.typer_app import app
+from path_sync._internal.verify import StepFailure, VerifyStatus
 from path_sync._internal.yaml_utils import load_yaml_model
 
 logger = logging.getLogger(__name__)
@@ -33,12 +32,9 @@ class Status(StrEnum):
     NO_CHANGES = "no_changes"
     FAILED = "failed"
 
-
-@dataclass
-class StepFailure:
-    step: str
-    returncode: int
-    on_fail: OnFailStrategy
+    @classmethod
+    def from_verify_status(cls, vs: VerifyStatus) -> Status:
+        return cls(vs.value)
 
 
 @dataclass
@@ -163,15 +159,17 @@ def _process_single_repo_inner(
 def _run_updates(updates: list[UpdateEntry], repo_path: Path) -> StepFailure | None:
     try:
         for update in updates:
-            _run_command(update.command, repo_path / update.workdir)
+            verify.run_command(update.command, repo_path / update.workdir)
         return None
     except subprocess.CalledProcessError as e:
         return StepFailure(step=e.cmd, returncode=e.returncode, on_fail=OnFailStrategy.SKIP)
 
 
-def _verify_repo(repo: Repo, repo_path: Path, verify: VerifyConfig, dest: Destination) -> RepoResult:
-    status, failures = _run_verify_steps(repo, repo_path, verify)
-    return RepoResult(dest=dest, repo_path=repo_path, status=status, failures=failures)
+def _verify_repo(repo: Repo, repo_path: Path, fallback_verify: verify.VerifyConfig, dest: Destination) -> RepoResult:
+    effective_verify = dest.resolve_verify(fallback_verify)
+    result = verify.run_verify_steps(repo, repo_path, effective_verify)
+    status = Status.from_verify_status(result.status)
+    return RepoResult(dest=dest, repo_path=repo_path, status=status, failures=result.failures)
 
 
 def _create_prs(config: DepConfig, results: list[RepoResult], opts: DepUpdateOptions) -> None:
@@ -223,46 +221,6 @@ def _ensure_repo(dest: Destination, repo_path: Path, default_branch: str) -> Rep
     return git_ops.clone_repo(dest.repo_url, repo_path)
 
 
-def _run_command(cmd: str, cwd: Path) -> None:
-    logger.info(f"Running: {cmd}")
-    result = subprocess.run(cmd, shell=True, cwd=cwd, capture_output=True, text=True)
-    prefix = cmd.split()[0]
-    for line in result.stdout.strip().splitlines():
-        logger.info(f"[{prefix}] {line}")
-    for line in result.stderr.strip().splitlines():
-        if result.returncode != 0:
-            logger.error(f"[{prefix}] {line}")
-        else:
-            logger.info(f"[{prefix}] {line}")
-    if result.returncode != 0:
-        raise subprocess.CalledProcessError(result.returncode, cmd, output=result.stdout, stderr=result.stderr)
-
-
-def _run_verify_steps(repo: Repo, repo_path: Path, verify: VerifyConfig) -> tuple[Status, list[StepFailure]]:
-    failures: list[StepFailure] = []
-
-    for step in verify.steps:
-        on_fail = step.on_fail or verify.on_fail
-
-        try:
-            _run_command(step.run, repo_path)
-        except subprocess.CalledProcessError as e:
-            failure = StepFailure(step=step.run, returncode=e.returncode, on_fail=on_fail)
-            match on_fail:
-                case OnFailStrategy.FAIL:
-                    return (Status.FAILED, [failure])
-                case OnFailStrategy.SKIP:
-                    return (Status.SKIPPED, [failure])
-                case OnFailStrategy.WARN:
-                    failures.append(failure)
-                    continue
-
-        if step.commit:
-            git_ops.stage_and_commit(repo, step.commit.add_paths, step.commit.message)
-
-    return (Status.WARN if failures else Status.PASSED, failures)
-
-
 def _build_pr_body(log_content: str, failures: list[StepFailure]) -> str:
     body = "Automated dependency update."
 

{path_sync-0.5.0 → path_sync-0.6.0}/path_sync/_internal/models.py

@@ -35,12 +35,38 @@ class SyncMode(StrEnum):
     SCAFFOLD = "scaffold"
 
 
+class OnFailStrategy(StrEnum):
+    SKIP = "skip"
+    FAIL = "fail"
+    WARN = "warn"
+
+
+class CommitConfig(BaseModel):
+    message: str
+    add_paths: list[str] = Field(default_factory=lambda: ["."])
+
+
+class VerifyStep(BaseModel):
+    run: str
+    commit: CommitConfig | None = None
+    on_fail: OnFailStrategy | None = None
+
+
+class VerifyConfig(BaseModel):
+    on_fail: OnFailStrategy = OnFailStrategy.WARN
+    steps: list[VerifyStep] = Field(default_factory=list)
+
+
 class PathMapping(BaseModel):
     src_path: str
     dest_path: str = ""
     sync_mode: SyncMode = SyncMode.SYNC
     exclude_dirs: set[str] = Field(default_factory=_default_exclude_dirs)
     exclude_file_patterns: set[str] = Field(default_factory=set)
+    wrap: bool | None = None
+
+    def should_wrap(self, config_default: bool) -> bool:
+        return self.wrap if self.wrap is not None else config_default
 
     def resolved_dest_path(self) -> str:
         return self.dest_path or self.src_path
@@ -127,6 +153,7 @@ class Destination(BaseModel):
     default_branch: str = "main"
     skip_sections: dict[str, list[str]] = Field(default_factory=dict)
     skip_file_patterns: set[str] = Field(default_factory=set)
+    verify: VerifyConfig | None = None
 
     def resolved_copy_branch(self, config_name: str) -> str:
         return self.copy_branch or f"sync/{config_name}"
@@ -134,6 +161,9 @@ class Destination(BaseModel):
     def is_skipped(self, dest_key: str) -> bool:
         return any(fnmatch.fnmatch(dest_key, pat) for pat in self.skip_file_patterns)
 
+    def resolve_verify(self, fallback: VerifyConfig | None) -> VerifyConfig:
+        return self.verify if self.verify is not None else (fallback or VerifyConfig())
+
 
 class SrcConfig(BaseModel):
     CONFIG_EXT: ClassVar[str] = ".src.yaml"
@@ -146,6 +176,8 @@ class SrcConfig(BaseModel):
     pr_defaults: PRDefaults = Field(default_factory=PRDefaults)
     paths: list[PathMapping] = Field(default_factory=list)
     destinations: list[Destination] = Field(default_factory=list)
+    verify: VerifyConfig | None = None
+    wrap_synced_files: bool = False
 
     def find_destination(self, name: str) -> Destination:
         for dest in self.destinations:

{path_sync-0.5.0 → path_sync-0.6.0}/path_sync/_internal/models_dep.py

@@ -1,37 +1,20 @@
 from __future__ import annotations
 
-from enum import StrEnum
 from pathlib import Path
 from typing import ClassVar
 
 from pydantic import BaseModel, Field
 
-from path_sync._internal.models import Destination, PRFieldsBase, SrcConfig, resolve_config_path
+from path_sync._internal.models import (
+    Destination,
+    PRFieldsBase,
+    SrcConfig,
+    VerifyConfig,
+    resolve_config_path,
+)
 from path_sync._internal.yaml_utils import load_yaml_model
 
 
-class OnFailStrategy(StrEnum):
-    SKIP = "skip"
-    FAIL = "fail"
-    WARN = "warn"
-
-
-class CommitConfig(BaseModel):
-    message: str
-    add_paths: list[str] = Field(default_factory=lambda: ["."])
-
-
-class VerifyStep(BaseModel):
-    run: str
-    commit: CommitConfig | None = None
-    on_fail: OnFailStrategy | None = None
-
-
-class VerifyConfig(BaseModel):
-    on_fail: OnFailStrategy = OnFailStrategy.SKIP
-    steps: list[VerifyStep] = Field(default_factory=list)
-
-
 class UpdateEntry(BaseModel):
     workdir: str = "."
     command: str

path_sync-0.6.0/path_sync/_internal/verify.py

@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+import logging
+import subprocess
+from dataclasses import dataclass, field
+from enum import StrEnum
+from pathlib import Path
+
+from git import Repo
+
+from path_sync._internal import git_ops
+from path_sync._internal.models import OnFailStrategy, VerifyConfig
+
+logger = logging.getLogger(__name__)
+
+
+class VerifyStatus(StrEnum):
+    PASSED = "passed"
+    SKIPPED = "skipped"
+    WARN = "warn"
+    FAILED = "failed"
+
+
+@dataclass
+class StepFailure:
+    step: str
+    returncode: int
+    on_fail: OnFailStrategy
+
+
+@dataclass
+class VerifyResult:
+    status: VerifyStatus = VerifyStatus.PASSED
+    failures: list[StepFailure] = field(default_factory=list)
+
+
+def run_command(cmd: str, cwd: Path, dry_run: bool = False) -> None:
+    if dry_run:
+        logger.info(f"[DRY RUN] Would run: {cmd} from {cwd}")
+        return
+    logger.info(f"Running: {cmd}")
+    result = subprocess.run(cmd, shell=True, cwd=cwd, capture_output=True, text=True)
+    prefix = cmd.split()[0]
+    for line in result.stdout.strip().splitlines():
+        logger.info(f"[{prefix}] {line}")
+    for line in result.stderr.strip().splitlines():
+        if result.returncode != 0:
+            logger.error(f"[{prefix}] {line}")
+        else:
+            logger.info(f"[{prefix}] {line}")
+    if result.returncode != 0:
+        raise subprocess.CalledProcessError(result.returncode, cmd, output=result.stdout, stderr=result.stderr)
+
+
+def run_verify_steps(
+    repo: Repo, repo_path: Path, verify: VerifyConfig, dry_run: bool = False, skip_commit: bool = False
+) -> VerifyResult:
+    if not verify.steps:
+        return VerifyResult()
+
+    failures: list[StepFailure] = []
+
+    for step in verify.steps:
+        on_fail = step.on_fail or verify.on_fail
+
+        try:
+            run_command(step.run, repo_path, dry_run=dry_run)
+        except subprocess.CalledProcessError as e:
+            failure = StepFailure(step=step.run, returncode=e.returncode, on_fail=on_fail)
+            match on_fail:
+                case OnFailStrategy.FAIL:
+                    return VerifyResult(status=VerifyStatus.FAILED, failures=[failure])
+                case OnFailStrategy.SKIP:
+                    return VerifyResult(status=VerifyStatus.SKIPPED, failures=[failure])
+                case OnFailStrategy.WARN:
+                    failures.append(failure)
+                    continue
+
+        if step.commit and not dry_run and not skip_commit:
+            git_ops.stage_and_commit(repo, step.commit.add_paths, step.commit.message)
+
+    status = VerifyStatus.WARN if failures else VerifyStatus.PASSED
+    return VerifyResult(status=status, failures=failures)
+
+
+def log_verify_summary(name: str, result: VerifyResult) -> None:
+    match result.status:
+        case VerifyStatus.PASSED:
+            logger.info(f"Verification passed for {name}")
+        case VerifyStatus.WARN:
+            logger.warning(f"Verification completed with warnings for {name}")
+            for f in result.failures:
+                logger.warning(f"  {f.step} failed (exit {f.returncode})")
+        case VerifyStatus.SKIPPED:
+            logger.warning(f"Verification skipped for {name}")
+        case VerifyStatus.FAILED:
+            logger.error(f"Verification failed for {name}")

{path_sync-0.5.0 → path_sync-0.6.0}/path_sync/dep_update.py

@@ -1,18 +1,18 @@
 # Generated by pkg-ext
 from path_sync._internal.cmd_dep_update import dep_update as _dep_update
-from path_sync._internal.models_dep import CommitConfig as _CommitConfig
+from path_sync._internal.models import CommitConfig as _CommitConfig
+from path_sync._internal.models import OnFailStrategy as _OnFailStrategy
+from path_sync._internal.models import VerifyConfig as _VerifyConfig
+from path_sync._internal.models import VerifyStep as _VerifyStep
 from path_sync._internal.models_dep import DepConfig as _DepConfig
-from path_sync._internal.models_dep import OnFailStrategy as _OnFailStrategy
 from path_sync._internal.models_dep import PRConfig as _PRConfig
 from path_sync._internal.models_dep import UpdateEntry as _UpdateEntry
-from path_sync._internal.models_dep import VerifyConfig as _VerifyConfig
-from path_sync._internal.models_dep import VerifyStep as _VerifyStep
 
 dep_update = _dep_update
 CommitConfig = _CommitConfig
-DepConfig = _DepConfig
 OnFailStrategy = _OnFailStrategy
-PRConfig = _PRConfig
-UpdateEntry = _UpdateEntry
 VerifyConfig = _VerifyConfig
 VerifyStep = _VerifyStep
+DepConfig = _DepConfig
+PRConfig = _PRConfig
+UpdateEntry = _UpdateEntry

{path_sync-0.5.0 → path_sync-0.6.0}/path_sync/sections.py

@@ -5,6 +5,7 @@ from pathlib import Path
 from zero_3rdparty.sections import (
     Section,
     SectionChanges,
+    SectionPart,
     get_comment_config,
 )
 from zero_3rdparty.sections import (
@@ -25,16 +26,22 @@ from zero_3rdparty.sections import (
 from zero_3rdparty.sections import (
     wrap_in_default_section as _wrap_in_default_section,
 )
+from zero_3rdparty.sections import (
+    wrap_section as _wrap_section,
+)
 
 __all__ = [
     "Section",
     "SectionChanges",
+    "SectionPart",
+    "build_sections_content",
     "changed_sections",
     "extract_sections",
     "has_sections",
     "parse_sections",
     "replace_sections",
     "wrap_in_default_section",
+    "wrap_in_synced_section",
 ]
 
 TOOL_NAME = "path-sync"
@@ -52,13 +59,17 @@ def wrap_in_default_section(content: str, path: Path) -> str:
     return _wrap_in_default_section(content, TOOL_NAME, get_comment_config(path))
 
 
+def wrap_in_synced_section(content: str, path: Path) -> str:
+    return _wrap_section(content, "synced", TOOL_NAME, get_comment_config(path))
+
+
 def extract_sections(content: str, path: Path) -> dict[str, str]:
     return _extract_sections(content, TOOL_NAME, get_comment_config(path), str(path))
 
 
 def replace_sections(
     dest_content: str,
-    src_sections: dict[str, str],
+    src_sections: list[Section],
     path: Path,
     skip_sections: list[str] | None = None,
     *,
@@ -81,3 +92,10 @@ def changed_sections(
     skip: set[str] | None = None,
 ) -> SectionChanges:
     return _changed_sections(baseline_content, current_content, TOOL_NAME, get_comment_config(path), skip, str(path))
+
+
+def build_sections_content(section_list: list[Section], path: Path) -> str:
+    """Build file content from a list of Section objects."""
+    config = get_comment_config(path)
+    parts = [_wrap_section(s.content, s.id, TOOL_NAME, config) for s in section_list]
+    return "\n".join(parts)

{path_sync-0.5.0 → path_sync-0.6.0}/pyproject.toml

@@ -2,7 +2,7 @@
 
 [project]
 name = "path-sync"
-version = "0.5.0"
+version = "0.6.0"
 description = "Sync files from a source repo to multiple destination repos"
 requires-python = ">=3.13"
 license = "MIT"