path-sync 0.3.3__py3-none-any.whl → 0.3.5__py3-none-any.whl

path_sync/__init__.py

@@ -3,7 +3,7 @@
 from path_sync import copy
 from path_sync import config
 
-VERSION = "0.3.3"
+VERSION = "0.3.5"
 __all__ = [
     "copy",
     "config",

path_sync/_internal/cmd_copy.py

@@ -8,6 +8,7 @@ from dataclasses import dataclass, field
 from pathlib import Path
 
 import typer
+from pydantic import BaseModel
 
 from path_sync import sections
 from path_sync._internal import git_ops, header
@@ -68,8 +69,7 @@ def capture_sync_log(dest_name: str):
             root_logger.removeHandler(file_handler)
 
 
-@dataclass
-class CopyOptions:
+class CopyOptions(BaseModel):
     dry_run: bool = False
     force_overwrite: bool = False
     no_checkout: bool = False
@@ -237,10 +237,10 @@ def _sync_destination(
 
     # --no-checkout means "I'm already on the right branch"
     # Prompt decline means "skip git operations for this run"
-    if opts.no_checkout:
-        skip_git_ops = False
-    elif opts.dry_run:
+    if opts.dry_run:
         skip_git_ops = True
+    elif opts.no_checkout:
+        skip_git_ops = False
     elif _prompt(f"Switch {dest.name} to {copy_branch}?", opts.no_prompt):
         git_ops.prepare_copy_branch(
             repo=dest_repo,
@@ -312,19 +312,12 @@ def _sync_paths(
     return result
 
 
-def _sync_path(
+def _iter_sync_files(
     mapping: PathMapping,
     src_root: Path,
     dest_root: Path,
-    dest: Destination,
-    config_name: str,
-    dry_run: bool,
-    force_overwrite: bool,
-) -> tuple[int, set[Path]]:
+):
     src_pattern = src_root / mapping.src_path
-    changes = 0
-    synced: set[Path] = set()
-    sync_mode = mapping.sync_mode
 
     if "*" in mapping.src_path:
         glob_prefix = mapping.src_path.split("*")[0].rstrip("/")
@@ -336,53 +329,48 @@ def _sync_path(
             src_path = Path(src_file)
             if src_path.is_file() and not mapping.is_excluded(src_path):
                 rel = src_path.relative_to(src_root / glob_prefix)
-                dest_path = dest_root / dest_base / rel
                 dest_key = str(Path(dest_base) / rel)
-                changes += _copy_file(
-                    src_path,
-                    dest_path,
-                    dest,
-                    dest_key,
-                    config_name,
-                    sync_mode,
-                    dry_run,
-                    force_overwrite,
-                )
-                synced.add(dest_path)
+                yield src_path, dest_key, dest_root / dest_base / rel
     elif src_pattern.is_dir():
         dest_base = mapping.resolved_dest_path()
         for src_file in src_pattern.rglob("*"):
             if src_file.is_file() and not mapping.is_excluded(src_file):
                 rel = src_file.relative_to(src_pattern)
-                dest_path = dest_root / dest_base / rel
                 dest_key = str(Path(dest_base) / rel)
-                changes += _copy_file(
-                    src_file,
-                    dest_path,
-                    dest,
-                    dest_key,
-                    config_name,
-                    sync_mode,
-                    dry_run,
-                    force_overwrite,
-                )
-                synced.add(dest_path)
+                yield src_file, dest_key, dest_root / dest_base / rel
     elif src_pattern.is_file():
         dest_base = mapping.resolved_dest_path()
-        dest_path = dest_root / dest_base
+        yield src_pattern, dest_base, dest_root / dest_base
+    else:
+        logger.warning(f"Source not found: {mapping.src_path}")
+
+
+def _sync_path(
+    mapping: PathMapping,
+    src_root: Path,
+    dest_root: Path,
+    dest: Destination,
+    config_name: str,
+    dry_run: bool,
+    force_overwrite: bool,
+) -> tuple[int, set[Path]]:
+    changes = 0
+    synced: set[Path] = set()
+
+    for src_path, dest_key, dest_path in _iter_sync_files(mapping, src_root, dest_root):
+        if dest.is_skipped(dest_key):
+            continue
         changes += _copy_file(
-            src_pattern,
+            src_path,
             dest_path,
             dest,
-            dest_base,
+            dest_key,
             config_name,
-            sync_mode,
+            mapping.sync_mode,
             dry_run,
             force_overwrite,
         )
         synced.add(dest_path)
-    else:
-        logger.warning(f"Source not found: {mapping.src_path}")
 
     return changes, synced
 

path_sync/_internal/models.py

@@ -121,11 +121,14 @@ class Destination(BaseModel):
     copy_branch: str = ""
     default_branch: str = "main"
     skip_sections: dict[str, list[str]] = Field(default_factory=dict)
+    skip_file_patterns: set[str] = Field(default_factory=set)
 
     def resolved_copy_branch(self, config_name: str) -> str:
-        """Returns branch name, defaulting to sync/{config_name} if not set."""
         return self.copy_branch or f"sync/{config_name}"
 
+    def is_skipped(self, dest_key: str) -> bool:
+        return any(fnmatch.fnmatch(dest_key, pat) for pat in self.skip_file_patterns)
+
 
 class SrcConfig(BaseModel):
     CONFIG_EXT: ClassVar[str] = ".src.yaml"

path_sync/_internal/validation.py

@@ -31,6 +31,7 @@ def validate_no_unauthorized_changes(
     """Find files with unauthorized changes in DO_NOT_EDIT sections.
 
     Returns 'path:section_id' for section changes or 'path' for full-file.
+    Missing sections (user opted out) are warned but not treated as errors.
     """
     repo = git_ops.get_repo(repo_root)
     base_ref = f"origin/{default_branch}"
@@ -55,8 +56,10 @@ def validate_no_unauthorized_changes(
 
         if baseline_has_sections:
             file_skip = skip.get(rel_path, set())
-            changed_ids = sections.compare_sections(baseline_content, current_content, path, file_skip)
-            unauthorized.extend(f"{rel_path}:{sid}" for sid in changed_ids)
+            changes = sections.changed_sections(baseline_content, current_content, path, file_skip)
+            for sid in changes.missing:
+                logger.warning(f"Section '{sid}' removed from {rel_path}, consider updating src.yaml")
+            unauthorized.extend(f"{rel_path}:{sid}" for sid in changes.modified)
         elif current_has_sections:
             unauthorized.append(rel_path)
         else:

path_sync/sections.py

@@ -4,10 +4,11 @@ from pathlib import Path
 
 from zero_3rdparty.sections import (
     Section,
+    SectionChanges,
     get_comment_config,
 )
 from zero_3rdparty.sections import (
-    compare_sections as _compare_sections,
+    changed_sections as _changed_sections,
 )
 from zero_3rdparty.sections import (
     extract_sections as _extract_sections,
@@ -27,7 +28,8 @@ from zero_3rdparty.sections import (
 
 __all__ = [
     "Section",
-    "compare_sections",
+    "SectionChanges",
+    "changed_sections",
     "extract_sections",
     "has_sections",
     "parse_sections",
@@ -59,14 +61,23 @@ def replace_sections(
     src_sections: dict[str, str],
     path: Path,
     skip_sections: list[str] | None = None,
+    *,
+    keep_deleted_sections: bool = False,
 ) -> str:
-    return _replace_sections(dest_content, src_sections, TOOL_NAME, get_comment_config(path), skip_sections)
+    return _replace_sections(
+        dest_content,
+        src_sections,
+        TOOL_NAME,
+        get_comment_config(path),
+        skip_sections,
+        keep_deleted_sections=keep_deleted_sections,
+    )
 
 
-def compare_sections(
+def changed_sections(
     baseline_content: str,
     current_content: str,
     path: Path,
     skip: set[str] | None = None,
-) -> list[str]:
-    return _compare_sections(baseline_content, current_content, TOOL_NAME, get_comment_config(path), skip, str(path))
+) -> SectionChanges:
+    return _changed_sections(baseline_content, current_content, TOOL_NAME, get_comment_config(path), skip, str(path))

{path_sync-0.3.3.dist-info → path_sync-0.3.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: path-sync
-Version: 0.3.3
+Version: 0.3.5
 Summary: Sync files from a source repo to multiple destination repos
 Author-email: EspenAlbert <espen.albert1@gmail.com>
 License-Expression: MIT
@@ -13,11 +13,16 @@ Requires-Dist: gitpython>=3.1.0
 Requires-Dist: pydantic>=2.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: typer>=0.16.0
-Requires-Dist: zero-3rdparty>=0.101.1
+Requires-Dist: zero-3rdparty>=0.102.0
 Description-Content-Type: text/markdown
 
 # path-sync
 
+[![PyPI](https://img.shields.io/pypi/v/path-sync)](https://pypi.org/project/path-sync/)
+[![GitHub](https://img.shields.io/github/license/EspenAlbert/path-sync)](https://github.com/EspenAlbert/path-sync)
+[![codecov](https://codecov.io/gh/EspenAlbert/path-sync/graph/badge.svg)](https://codecov.io/gh/EspenAlbert/path-sync)
+[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://espenalbert.github.io/path-sync/)
+
 Sync files from a source repo to multiple destination repos.
 
 ## Overview
@@ -133,6 +138,26 @@ destinations:
     skip_sections:
       justfile: [coverage]  # keep local coverage recipe
 ```
+
+## Skipping Files per Destination
+
+Use `skip_file_patterns` to exclude files for specific destinations. Patterns match against the **destination path** (after `dest_path` remapping):
+
+```yaml
+paths:
+  - src_path: scripts/
+    dest_path: tools/  # remapped in destination
+destinations:
+  - name: dest1
+    dest_path_relative: ../dest1
+    skip_file_patterns:
+      - "tools/internal/*"   # matches destination path, not src
+      - "*.test.py"
+      - "docs/draft.md"
+```
+
+Patterns use [fnmatch](https://docs.python.org/3/library/fnmatch.html) syntax (`*` matches any characters, `?` matches single character).
+
 ## Config Reference
 
 **Source config** (`.github/{name}.src.yaml`):
@@ -145,6 +170,10 @@ paths:
   - src_path: .cursor/**/*.mdc
   - src_path: templates/justfile
     dest_path: justfile
+  - src_path: scripts/
+    exclude_file_patterns:
+      - "*.pyc"
+      - "test_*.py"
 destinations:
   - name: dest1
     repo_url: https://github.com/user/dest1
@@ -153,6 +182,8 @@ destinations:
     default_branch: main
     skip_sections:
       justfile: [coverage]
+    skip_file_patterns:
+      - "scripts/internal/*"
 ```
 
 | Field | Description |
@@ -160,11 +191,33 @@ destinations:
 | `name` | Config identifier |
 | `src_repo_url` | Source repo URL (auto-detected from git remote) |
 | `schedule` | Cron for scheduled sync workflow |
-| `paths` | Files/globs to sync (`src_path` required, `dest_path` optional) |
+| `paths` | Files/globs to sync (see path options below) |
 | `destinations` | Target repos with sync settings |
 | `header_config` | Comment style per extension (has defaults) |
 | `pr_defaults` | PR title, labels, reviewers, assignees |
 
+**Path options**:
+
+| Field | Description |
+|-------|-------------|
+| `src_path` | Source file, directory, or glob pattern (required) |
+| `dest_path` | Destination path (defaults to `src_path`) |
+| `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`) |
+
+**Destination options**:
+
+| Field | Description |
+|-------|-------------|
+| `name` | Destination identifier (required) |
+| `repo_url` | Repo URL for cloning if not found locally |
+| `dest_path_relative` | Path to destination repo relative to source (required) |
+| `copy_branch` | Branch for sync (defaults to `sync/{config_name}`) |
+| `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) |
+
 ## Header Format
 
 Synced files have a header comment identifying the source config:

{path_sync-0.3.3.dist-info → path_sync-0.3.5.dist-info}/RECORD

@@ -1,21 +1,21 @@
-path_sync/__init__.py,sha256=2ju41FHOI1W8Ewd9lcAf-v3Mp7vRXFeD72hSCyPlOoI,153
+path_sync/__init__.py,sha256=UMITgfcKgKSh0CYFUQ2rtlzNjyI3s329DAQGoxna7HQ,153
 path_sync/__main__.py,sha256=HDj3qgijDcK8k976qsAvKMvUq9fZEJTK-dZldUc5-no,326
 path_sync/config.py,sha256=XYuEK_bjSpAk_nZN0oxpEA-S3t9F6Qn0yznYLoQHIw8,568
 path_sync/copy.py,sha256=BpflW4086XJFSHHK4taYPgXtF07xHB8qrgm8TYqdM4E,120
-path_sync/sections.py,sha256=lUFGO3gqpGr7msztDudUrejmfghrfOPWiOMKBP6YotE,1927
+path_sync/sections.py,sha256=dB0RGUhRWcZj9c1364UULEEnYHMf1LkWUBZ8EayIyKM,2122
 path_sync/_internal/__init__.py,sha256=iPkMhrpiyXBijo2Hp-y_2zEYxAXnHLnStKM0X0HHd4U,56
 path_sync/_internal/cmd_boot.py,sha256=cFomUyPOhNX9fi5_BYL2Sm7O1oq7vntD8b7clQ7mL1E,3104
-path_sync/_internal/cmd_copy.py,sha256=-iqEoAGTA2oBeR8HXbJfzJ0hmnmtq27LBCeSgVbOo9k,18635
+path_sync/_internal/cmd_copy.py,sha256=0iuhq3vlL1bah2EJEvkHZlXqdsOwdkKktt8V7lVjKIY,18241
 path_sync/_internal/cmd_validate.py,sha256=e6m-JZlXAGr0ZRqfLhhrlmjs4w79p2WWnZo4I05PGpo,1798
 path_sync/_internal/file_utils.py,sha256=5C33qzKFQdwChi5YwUWBujj126t0P6dbGSU_5hWExpE,194
 path_sync/_internal/git_ops.py,sha256=rpG_r7VNH1KlBgqM9mz7xop0mpdy76Vs3rzCoxE1dIQ,5895
 path_sync/_internal/header.py,sha256=evgY2q_gfDdEytEt_jyJ7M_KdGzCpfdKBUnoh3v-0Go,2593
-path_sync/_internal/models.py,sha256=okHJkM2NsJ6Xe2HjJw6XqBTnIzCTQGniJRou6wra56g,4459
+path_sync/_internal/models.py,sha256=IA6lb_BFXntcZnn9bWJZYenlnDvk9ddNBA67l5qFrmA,4577
 path_sync/_internal/typer_app.py,sha256=lEGMRXql3Se3VbmwAohvpUaL2cbY-RwhPUq8kL7bPbc,177
-path_sync/_internal/validation.py,sha256=qhEha-pJiM5zkZlr4sj2I4ZqvqcWMEfL4IZu_LGatLI,2226
+path_sync/_internal/validation.py,sha256=23kwtmsiHiYlKbVU8mtwr8J0MqSlnvbuRRR5NQAsJ08,2446
 path_sync/_internal/yaml_utils.py,sha256=yj6Bl54EltjLEcVKaiA5Ahb9byT6OUMh0xIEzTsrvnQ,498
-path_sync-0.3.3.dist-info/METADATA,sha256=E0c9qnwBL5yTRW7XXcH6yvFaHjQiM7ieV_xpEwXiBtI,8231
-path_sync-0.3.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-path_sync-0.3.3.dist-info/entry_points.txt,sha256=jTsL0c-9gP-4_Jt3EPgihtpLcwQR0AFAf1AUpD50AlI,54
-path_sync-0.3.3.dist-info/licenses/LICENSE,sha256=OphKV48tcMv6ep-7j-8T6nycykPT0g8ZlMJ9zbGvdPs,1066
-path_sync-0.3.3.dist-info/RECORD,,
+path_sync-0.3.5.dist-info/METADATA,sha256=3xIOv0AH7FTcmMY76wkjT8z9nN-Nlis1PIC4aJWTLZ8,10430
+path_sync-0.3.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+path_sync-0.3.5.dist-info/entry_points.txt,sha256=jTsL0c-9gP-4_Jt3EPgihtpLcwQR0AFAf1AUpD50AlI,54
+path_sync-0.3.5.dist-info/licenses/LICENSE,sha256=MnHjsc6ccjI5Iiw2R3jLEAApIcrEpLdIcZxkilhSPxc,1069
+path_sync-0.3.5.dist-info/RECORD,,

{path_sync-0.3.3.dist-info → path_sync-0.3.5.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Your Name
+Copyright (c) 2026 Espen Albert
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal