NAME

repomatic sync-dep-sources - Swap git-tracked dependencies to their released versions

SYNOPSIS

repomatic sync-dep-sources [OPTIONS]

DESCRIPTION

Swap git-tracked dependencies back to their released versions.

Manages one idiom: a [tool.uv.sources] entry tracking a git branch,
paired with a .dev version floor naming the awaited release (like
'mango>=2.1.0.dev0'). Once a stable release satisfying the floor ships
on PyPI, the swap:


  - drops the [tool.uv.sources] override


  - tightens the .dev floor to its base release


  - freezes the adopted release through the exclude-newer cooldown


    (an exclude-newer-package entry the ordinary sync-uv-lock lifecycle


    prunes once it ages out)


  - re-locks and verifies the adopted version landed

Overrides outside the idiom (path or workspace sources, rev/tag pins,
floor-less branch tracks) are never touched. A resolution conflict or a
lock landing on an unexpected version restores the project untouched.

OPTIONS

--lockfile FILE: Path to the uv.lock file.
--table / --no-table: Print a summary table of updated packages.
--release-notes / --no-release-notes: Fetch release notes from GitHub (markdown, appended after the table).
--held-back / --no-held-back: Report newer releases withheld by the exclude-newer cooldown (runs a second uv resolution).
--output FILE: Write a markdown report (table + release notes) to this file.
--output-format [markdown|github-actions]: Format for --output. github-actions produces format for PR template consumption in workflows.
--help / -h: Show this message and exit.

ENVIRONMENT

SYNC_DEP_SOURCES_LOCKFILE: Path to the uv.lock file.
SYNC_DEP_SOURCES_TABLE: Print a summary table of updated packages.
SYNC_DEP_SOURCES_RELEASE_NOTES: Fetch release notes from GitHub (markdown, appended after the table).
SYNC_DEP_SOURCES_HELD_BACK: Report newer releases withheld by the exclude-newer cooldown (runs a second uv resolution).
SYNC_DEP_SOURCES_OUTPUT: Write a markdown report (table + release notes) to this file.
SYNC_DEP_SOURCES_OUTPUT_FORMAT: Format for --output. github-actions produces format for PR template consumption in workflows.
SYNC_DEP_SOURCES__CLICK_DEFAULT_HELP: Show this message and exit.

EXIT STATUS

0: Success.
1: A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2: A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

EXAMPLES

Swap whatever is ready and show changes

repomatic sync\-dep\-sources

CI: write markdown report as a GitHub Actions step output

repomatic sync\-dep\-sources \-\-no\-table \-\-release\-notes \-\-output "$GITHUB_OUTPUT" \-\-output\-format github\-actions

AUTHORS

Kevin Deldycke