path-sync 0.3.2__py3-none-any.whl → 0.3.4__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.2"
+VERSION = "0.3.4"
 __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
@@ -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

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import fnmatch
 import glob as glob_mod
 from enum import StrEnum
 from pathlib import Path
@@ -39,12 +40,15 @@ class PathMapping(BaseModel):
     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)
 
     def resolved_dest_path(self) -> str:
         return self.dest_path or self.src_path
 
     def is_excluded(self, path: Path) -> bool:
-        return bool(self.exclude_dirs & set(path.parts))
+        if self.exclude_dirs & set(path.parts):
+            return True
+        return any(fnmatch.fnmatch(path.name, pat) for pat in self.exclude_file_patterns)
 
     def expand_dest_paths(self, repo_root: Path) -> list[Path]:
         dest_path = self.resolved_dest_path()
@@ -117,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-0.3.2.dist-info → path_sync-0.3.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: path-sync
-Version: 0.3.2
+Version: 0.3.4
 Summary: Sync files from a source repo to multiple destination repos
 Author-email: EspenAlbert <espen.albert1@gmail.com>
 License-Expression: MIT
@@ -133,6 +133,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 +165,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 +177,8 @@ destinations:
     default_branch: main
     skip_sections:
       justfile: [coverage]
+    skip_file_patterns:
+      - "scripts/internal/*"
 ```
 
 | Field | Description |
@@ -160,11 +186,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.2.dist-info → path_sync-0.3.4.dist-info}/RECORD

@@ -1,21 +1,21 @@
-path_sync/__init__.py,sha256=m7PJh6WLWUKwFydw1lNBUGCWCD--J4Vou2S-WkP_KFg,153
+path_sync/__init__.py,sha256=jOWYUecn-jrXFa3Zq7wW_EzKuqrJN6kQ1E_PY4rPGf4,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/_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=FR5wHZ7co4Bt1t20nnCdl4s05doApxzpkrXzM9xHlQA,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=YLN_fi1n0LaYrpmrllHeJbQH_ryPtER5GGPnVCnkr0o,4274
+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/yaml_utils.py,sha256=yj6Bl54EltjLEcVKaiA5Ahb9byT6OUMh0xIEzTsrvnQ,498
-path_sync-0.3.2.dist-info/METADATA,sha256=rZJuJVeznXEleFmKcYFy0ziIfgic_doPOwhYlV7MGKc,8231
-path_sync-0.3.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-path_sync-0.3.2.dist-info/entry_points.txt,sha256=jTsL0c-9gP-4_Jt3EPgihtpLcwQR0AFAf1AUpD50AlI,54
-path_sync-0.3.2.dist-info/licenses/LICENSE,sha256=OphKV48tcMv6ep-7j-8T6nycykPT0g8ZlMJ9zbGvdPs,1066
-path_sync-0.3.2.dist-info/RECORD,,
+path_sync-0.3.4.dist-info/METADATA,sha256=pNmrWhqEKTMg8c8mG7yuaX4-fsQiA2uBCkgQwVDOiwI,10000
+path_sync-0.3.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+path_sync-0.3.4.dist-info/entry_points.txt,sha256=jTsL0c-9gP-4_Jt3EPgihtpLcwQR0AFAf1AUpD50AlI,54
+path_sync-0.3.4.dist-info/licenses/LICENSE,sha256=MnHjsc6ccjI5Iiw2R3jLEAApIcrEpLdIcZxkilhSPxc,1069
+path_sync-0.3.4.dist-info/RECORD,,

{path_sync-0.3.2.dist-info → path_sync-0.3.4.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