path-sync 0.3.3__tar.gz → 0.3.4__tar.gz

{path_sync-0.3.3 → path_sync-0.3.4}/.gitignore

@@ -33,6 +33,7 @@ coverage.xml
 # pkg-ext dev mode files
 .groups-dev.yaml
 CHANGELOG-dev.md
+*.api-dev.yaml
 
 # MkDocs build output
 site/

{path_sync-0.3.3 → path_sync-0.3.4}/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

{path_sync-0.3.3 → path_sync-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: path-sync
-Version: 0.3.3
+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.3 → path_sync-0.3.4}/README.md

@@ -115,6 +115,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`):
@@ -127,6 +147,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
@@ -135,6 +159,8 @@ destinations:
     default_branch: main
     skip_sections:
       justfile: [coverage]
+    skip_file_patterns:
+      - "scripts/internal/*"
 ```
 
 | Field | Description |
@@ -142,11 +168,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 → path_sync-0.3.4}/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.4"
 __all__ = [
     "copy",
     "config",

{path_sync-0.3.3 → path_sync-0.3.4}/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-0.3.3 → path_sync-0.3.4}/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-0.3.3 → path_sync-0.3.4}/pyproject.toml

@@ -3,7 +3,7 @@
 # === OK_EDIT: path-sync header ===
 [project]
 name = "path-sync"
-version = "0.3.3"
+version = "0.3.4"
 description = "Sync files from a source repo to multiple destination repos"
 requires-python = ">=3.13"
 license = "MIT"