vcspull sync - vcspull.cli.sync

Synchronization functionality for vcspull.

class vcspull.cli.sync.SyncPlanConfig

Bases: object

Configuration options for building sync plans.

fetch: bool

offline: bool

__init__(fetch, offline)

Parameters:

• fetch (bool)

• offline (bool)

Return type:

None

vcspull.cli.sync._visible_length(text)

Return the printable length of string stripped of ANSI codes.

Return type:

int

Parameters:

text (str)

class vcspull.cli.sync.PlanProgressPrinter

Bases: object

Render incremental plan progress for human-readable dry runs.

__init__(total, colors, enabled)

Parameters:

• total (int)

• colors (Colors)

• enabled (bool)

Return type:

None

update(summary, processed)

Update the progress line with the latest summary counts.

Return type:

None

Parameters:

• summary (PlanSummary)

• processed (int)

finish()

Ensure the progress line is terminated with a newline.

Return type:

None

vcspull.cli.sync._extract_repo_url(repo)

Extract the primary repository URL from a config dictionary.

Return type:

str | None

Parameters:

repo (ConfigDict)

vcspull.cli.sync._get_repo_path(repo)

Return the resolved filesystem path for a repository entry.

Return type:

Path

Parameters:

repo (ConfigDict)

vcspull.cli.sync.clamp(n, _min, _max)

Clamp a number between a min and max value.

Return type:

int

Parameters:

• n (int)

• _min (int)

• _max (int)

vcspull.cli.sync._maybe_fetch(repo_path, *, config)

Optionally fetch remote refs to provide accurate status.

Return type:

tuple[bool, str | None]

Parameters:

• repo_path (Path)

• config (SyncPlanConfig)

vcspull.cli.sync._determine_plan_action(status, *, config)

Decide which plan action applies to a repository.

Return type:

tuple[PlanAction, str | None]

Parameters:

• status (dict[str, Any])

• config (SyncPlanConfig)

vcspull.cli.sync._update_summary(summary, action)

Update summary counters for the given plan action.

Return type:

None

Parameters:

• summary (PlanSummary)

• action (PlanAction)

vcspull.cli.sync._build_plan_entry(repo, *, config)

Construct a plan entry for a repository configuration.

Return type:

PlanEntry

Parameters:

• repo (ConfigDict)

• config (SyncPlanConfig)

async vcspull.cli.sync._build_plan_result_async(repos, *, config, progress)

Build a plan asynchronously while updating progress output.

Return type:

PlanResult

Parameters:

• repos (list[ConfigDict])

• config (SyncPlanConfig)

• progress (PlanProgressPrinter | None)

vcspull.cli.sync._filter_entries_for_display(entries, *, show_unchanged)

Filter entries based on whether unchanged repos should be rendered.

Return type:

list[PlanEntry]

Parameters:

• entries (list[PlanEntry])

• show_unchanged (bool)

vcspull.cli.sync._format_detail_text(entry, *, colors, include_extras)

Generate the detail text for a plan entry.

Return type:

str

Parameters:

• entry (PlanEntry)

• colors (Colors)

• include_extras (bool)

vcspull.cli.sync._render_plan(formatter, colors, plan, render_options, *, dry_run, total_repos)

Render the plan in human-readable format.

Return type:

None

Parameters:

• formatter (OutputFormatter)

• colors (Colors)

• plan (PlanResult)

• render_options (PlanRenderOptions)

• dry_run (bool)

• total_repos (int)

vcspull.cli.sync._emit_plan_output(formatter, colors, plan, render_options, *, dry_run, total_repos)

Emit plan output for the requested format.

Return type:

None

Parameters:

• formatter (OutputFormatter)

• colors (Colors)

• plan (PlanResult)

• render_options (PlanRenderOptions)

• dry_run (bool)

• total_repos (int)

vcspull.cli.sync.create_sync_subparser(parser)

Create vcspull sync argument subparser.

Return type:

ArgumentParser

Parameters:

parser (ArgumentParser)

vcspull.cli.sync.sync(repo_patterns, config, workspace_root, dry_run, output_json, output_ndjson, color, exit_on_error, show_unchanged, summary_only, long_view, relative_paths, fetch, offline, verbosity, sync_all=False, parser=None, include_worktrees=False)

Entry point for vcspull sync.

Return type:

None

Parameters:

• repo_patterns (list[str])

• config (Path | None)

• workspace_root (str | None)

• dry_run (bool)

• output_json (bool)

• output_ndjson (bool)

• color (str)

• exit_on_error (bool)

• show_unchanged (bool)

• summary_only (bool)

• long_view (bool)

• relative_paths (bool)

• fetch (bool)

• offline (bool)

• verbosity (int)

• sync_all (bool)

• parser (ArgumentParser | None)

• include_worktrees (bool)

vcspull.cli.sync._emit_summary(formatter, colors, summary)

Emit the structured summary event and optional human-readable text.

Return type:

None

Parameters:

• formatter (OutputFormatter)

• colors (Colors)

• summary (dict[str, int])

vcspull.cli.sync.progress_cb(output, timestamp)

CLI Progress callback for command.

Return type:

None

Parameters:

• output (str)

• timestamp (datetime)

vcspull.cli.sync.guess_vcs(url)

Guess the VCS from a URL.

Return type:

Literal['git', 'svn', 'hg'] | None

Parameters:

url (str)

exception vcspull.cli.sync.CouldNotGuessVCSFromURL

Bases: VCSPullException

Raised when no VCS could be guessed from a URL.

__init__(repo_url, *args, **kwargs)

Parameters:

• repo_url (str)

• args (object)

• kwargs (object)

Return type:

None

exception vcspull.cli.sync.SyncFailedError

Bases: VCSPullException

Raised when a sync operation completes but with errors.

__init__(repo_name, errors, *args, **kwargs)

Parameters:

• repo_name (str)

• errors (str)

• args (object)

• kwargs (object)

Return type:

None

vcspull.cli.sync.update_repo(repo_dict, progress_callback=None)

Synchronize a single repository.

Return type:

GitSync | HgSync | SvnSync

Parameters:

• repo_dict (Any)

• progress_callback (Callable[[str, datetime], None] | None)