path-sync 0.4.1__py3-none-any.whl → 0.6.0__py3-none-any.whl

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/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/validate_no_changes.py

@@ -0,0 +1,4 @@
+# Generated by pkg-ext
+from path_sync._internal.cmd_validate import validate_no_changes as _validate_no_changes
+
+validate_no_changes = _validate_no_changes

{path_sync-0.4.1.dist-info → path_sync-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: path-sync
-Version: 0.4.1
+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
 
@@ -314,6 +379,109 @@ Add as repository secret: `GH_PAT`
 | `GraphQL: Resource not accessible` | Use GH_PAT, not GITHUB_TOKEN |
 | `HTTP 422: Required status check` | Exclude `sync/*` from branch protection |
 
+## Dependency Updates
+
+The `dep-update` command runs dependency updates across multiple repositories. It clones repos, runs update commands, verifies changes, and creates PRs.
+
+### Quick Start
+
+```bash
+# Create config at .github/myconfig.dep.yaml (see example below)
+# Then run:
+path-sync dep-update -n myconfig
+
+# Preview without creating PRs
+path-sync dep-update -n myconfig --dry-run
+
+# Filter specific destinations
+path-sync dep-update -n myconfig -d repo1,repo2
+```
+
+### Dep Config Reference
+
+**Config file**: `.github/{name}.dep.yaml`
+
+```yaml
+name: uv-deps
+from_config: python-template  # references .github/python-template.src.yaml for destinations
+exclude_destinations:
+  - path-sync  # skip self
+
+updates:
+  - command: uv lock --upgrade
+  - workdir: packages/sub  # optional subdirectory
+    command: uv lock --upgrade
+
+verify:
+  on_fail: skip  # default strategy: skip, fail, warn
+  steps:
+    - run: uv sync
+    - run: just fmt
+      commit:
+        message: "chore: format after update"
+        add_paths: [".", "!uv.lock"]  # ! prefix excludes
+      on_fail: warn
+    - run: just test
+
+pr:
+  branch: deps/uv-lock-update
+  title: "chore(deps): update uv.lock"
+  labels: [dependencies]
+  reviewers: []  # optional
+  assignees: []  # optional
+  auto_merge: true
+```
+
+| Field | Description |
+|-------|-------------|
+| `from_config` | Source config name for destination list |
+| `include_destinations` | Only process these destinations |
+| `exclude_destinations` | Skip these destinations |
+| `updates` | Commands to run (in order) |
+| `verify.on_fail` | Default failure strategy: `skip`, `fail`, `warn` |
+| `verify.steps` | Verification commands with optional commit/on_fail |
+| `pr.auto_merge` | Enable GitHub auto-merge after PR creation |
+
+### CLI Flags
+
+| Flag | Description |
+|------|-------------|
+| `-n, --name` | Config name (required) |
+| `-d, --dest` | Filter destinations (comma-separated) |
+| `--work-dir` | Clone directory for repos without `dest_path_relative` |
+| `--dry-run` | Preview without creating PRs |
+| `--skip-verify` | Skip verification steps |
+| `--pr-reviewers` | Override PR reviewers (comma-separated) |
+| `--pr-assignees` | Override PR assignees (comma-separated) |
+
+### Failure Strategies
+
+- **skip**: Skip PR for this repo, continue with others (default)
+- **fail**: Stop all processing immediately
+- **warn**: Create PR anyway with warning in body
+
+Per-step `on_fail` overrides the verify-level default.
+
+### GitHub Actions
+
+```yaml
+name: dep-update
+on:
+  schedule:
+    - cron: "0 6 * * 1"  # Weekly Monday
+  workflow_dispatch:
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uvx path-sync dep-update -n myconfig
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT }}
+```
+
 ## Alternatives Considered
 
 | Tool | Why Not |

path_sync-0.6.0.dist-info/RECORD

@@ -0,0 +1,29 @@
+path_sync/__init__.py,sha256=cUWYc7YQIT-32_mOxRYyTBCiZlI5ZPf_6H0nCyMOQuM,273
+path_sync/__main__.py,sha256=zAjlCOVF1duQi_RSVWbncfmnjoqaik9YPl2jf5mfcR0,342
+path_sync/config.py,sha256=XYuEK_bjSpAk_nZN0oxpEA-S3t9F6Qn0yznYLoQHIw8,568
+path_sync/copy.py,sha256=fsTKQtSuphNw7fHGpK5E56JGLYcalslr5MHnY0bn-NU,188
+path_sync/dep_update.py,sha256=Lzj09StST253rXnsh9XpGDgc1Y_vhYvLO2-fAU3huxM,788
+path_sync/sections.py,sha256=SsTeOa3Ep2WuzyO6ckfnxs-Gzv70r3mmnz296_ZPZZA,2726
+path_sync/validate_no_changes.py,sha256=QJtjSsFoqqMT9jeSgZXgq4gGUxDjIn5GUqhOixjhDlg,156
+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=r1gymDP-I-rUdfbMglHElmJ4WjtmzqRCVtwJq0TbUXE,19601
+path_sync/_internal/cmd_dep_update.py,sha256=JQmaUKkg9gbfvPKNvpov_b6OI788hpAlU86AMJGJ5tU,8172
+path_sync/_internal/cmd_options.py,sha256=0GZKaBtZ8ae3yKdkAJrfWFHvu--BZvhLI4Gl8s_dJes,617
+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=Xme_kuIVqCekj6YxWLWxvQu693wPcYHycAIiB_4l_Ow,7500
+path_sync/_internal/header.py,sha256=evgY2q_gfDdEytEt_jyJ7M_KdGzCpfdKBUnoh3v-0Go,2593
+path_sync/_internal/log_capture.py,sha256=IlCX4BBwWvA_FPIRn_8XyeOGE5sLp-kawlIk7vFQMK4,1187
+path_sync/_internal/models.py,sha256=x5tgebVWdfgNhc8ngsPnbPm4mlW_Qa7iOx1cHTLmOdw,5585
+path_sync/_internal/models_dep.py,sha256=WIhgrKexDNKrVvPusC2z-LL0bG9Lf3VcByRK5DvR_jM,1526
+path_sync/_internal/prompt_utils.py,sha256=YChOxsoP11-r7D2k6G_kMrvzbvF0sk9sEPynrhkPkVc,703
+path_sync/_internal/typer_app.py,sha256=lEGMRXql3Se3VbmwAohvpUaL2cbY-RwhPUq8kL7bPbc,177
+path_sync/_internal/validation.py,sha256=23kwtmsiHiYlKbVU8mtwr8J0MqSlnvbuRRR5NQAsJ08,2446
+path_sync/_internal/verify.py,sha256=_5-utNI4s5uERnT5V4uaaM8_k_zeVofFjXvgbl0gZE0,3244
+path_sync/_internal/yaml_utils.py,sha256=yj6Bl54EltjLEcVKaiA5Ahb9byT6OUMh0xIEzTsrvnQ,498
+path_sync-0.6.0.dist-info/METADATA,sha256=6QKbnrMopkcJIG9Bjc8l-jTO-6c1uHwlCz2sZKnSAa4,15020
+path_sync-0.6.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+path_sync-0.6.0.dist-info/entry_points.txt,sha256=jTsL0c-9gP-4_Jt3EPgihtpLcwQR0AFAf1AUpD50AlI,54
+path_sync-0.6.0.dist-info/licenses/LICENSE,sha256=MnHjsc6ccjI5Iiw2R3jLEAApIcrEpLdIcZxkilhSPxc,1069
+path_sync-0.6.0.dist-info/RECORD,,

path_sync-0.4.1.dist-info/RECORD

@@ -1,24 +0,0 @@
-path_sync/__init__.py,sha256=OHLo0rlS3tquOhUn2sHNgEfAYvtsJaQmT1MYmM94Nuk,204
-path_sync/__main__.py,sha256=zAjlCOVF1duQi_RSVWbncfmnjoqaik9YPl2jf5mfcR0,342
-path_sync/config.py,sha256=XYuEK_bjSpAk_nZN0oxpEA-S3t9F6Qn0yznYLoQHIw8,568
-path_sync/copy.py,sha256=BpflW4086XJFSHHK4taYPgXtF07xHB8qrgm8TYqdM4E,120
-path_sync/dep_update.py,sha256=UjjoUIIaZyGwTYmDo3OWQDdpY1zZ4dbdXGwy4xLDuRc,804
-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=0iuhq3vlL1bah2EJEvkHZlXqdsOwdkKktt8V7lVjKIY,18241
-path_sync/_internal/cmd_dep_update.py,sha256=7mKs-ZdPoAfl3L2Q57345lPtOFtua5taF8dYAe0U1d8,8315
-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=OJ82-TUUqlFGSCcaeya9J-x8_10aG5iu55SZew_dzbk,7085
-path_sync/_internal/header.py,sha256=evgY2q_gfDdEytEt_jyJ7M_KdGzCpfdKBUnoh3v-0Go,2593
-path_sync/_internal/models.py,sha256=IA6lb_BFXntcZnn9bWJZYenlnDvk9ddNBA67l5qFrmA,4577
-path_sync/_internal/models_dep.py,sha256=KKgcOEUgWPa_speyp_XgwBQDp8L1hS24WN1C4SMMG-w,2014
-path_sync/_internal/typer_app.py,sha256=lEGMRXql3Se3VbmwAohvpUaL2cbY-RwhPUq8kL7bPbc,177
-path_sync/_internal/validation.py,sha256=23kwtmsiHiYlKbVU8mtwr8J0MqSlnvbuRRR5NQAsJ08,2446
-path_sync/_internal/yaml_utils.py,sha256=yj6Bl54EltjLEcVKaiA5Ahb9byT6OUMh0xIEzTsrvnQ,498
-path_sync-0.4.1.dist-info/METADATA,sha256=1nIEtOCDLLRoti_7s-OK0x-rHPWtNZqTJd350laIHTw,10430
-path_sync-0.4.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-path_sync-0.4.1.dist-info/entry_points.txt,sha256=jTsL0c-9gP-4_Jt3EPgihtpLcwQR0AFAf1AUpD50AlI,54
-path_sync-0.4.1.dist-info/licenses/LICENSE,sha256=MnHjsc6ccjI5Iiw2R3jLEAApIcrEpLdIcZxkilhSPxc,1069
-path_sync-0.4.1.dist-info/RECORD,,