VCS Synchronizers

This repository contains multiple synchronizers to synchronize multiple VCS repositories (of the same type)., _(*2)

Symmetric vs. Asymmetric synchronisation

Symmetric synchronisation means that each repository is compared and synchronized against each other. If a conflict is detected - two remotes have divergent branches - no repository of the concerned branch is synchronized., _(*3)

Asymmetric synchronisation means that one - the primary - repository is compared and synchronized against all the others repositories. If a conflict is detected - one remote branch is ahead of the primary - the branch in the concerned repository is not synchronized., _(*4)

Working repository

The synchronizers work on a local working repository. But they won't create them for you! This let you keep control of what happened., _(*5)

Here is an example, how you could create the local working repository., _(*6)

use ContaoCommunityAlliance\BuildSystem\Repository\GitRepository;

$path = tempnam(sys_get_temp_dir());
unlink($path);
mkdir($path);

$repository = new GitRepository($path);
$repository->init()->execute();
$repository->remote()->add('github', 'git@github.com:contao-community-alliance/vcs-synchronizer.git')->execute();
$repository->remote()->add('bitbucket', 'git@bitbucket.org:contao-community-alliance/vcs-synchronizer.git')->execute();

GIT Synchronizers

Symmetric branch synchronizer

CLI usage, _(*7)

./bin/git-branches-symmetric-sync -b github -b bitbucket /path/to/repository

PHP usage, _(*8)

use ContaoCommunityAlliance\BuildSystem\VcsSync\Synchronizer\GitSymmetricBranchSynchronizer;

$synchronizer = new GitSymmetricBranchSynchronizer(
    // the working repository
    $repository,
    // the remotes to synchronize
    ['github', 'bitbucket']
);
$synchronizer->setLogger($logger);
$synchronizer->sync();

Asymmetric branch synchronizer

CLI usage, _(*9)

./bin/git-branches-asymmetric-sync -b github -b bitbucket -p github /path/to/repository

PHP usage, _(*10)

use ContaoCommunityAlliance\BuildSystem\VcsSync\Synchronizer\GitAsymmetricBranchSynchronizer;

$synchronizer = new GitAsymmetricBranchSynchronizer(
    // the working repository
    $repository,
    // the remotes to synchronize
    ['github', 'bitbucket'],
    // the primary remote
    'github'
);
$synchronizer->setLogger($logger);
$synchronizer->sync();

Asymmetric tag synchronizer

CLI usage, _(*11)

./bin/git-tags-asymmetric-sync -b github -b bitbucket -p github /path/to/repository

PHP usage, _(*12)

use ContaoCommunityAlliance\BuildSystem\VcsSync\Synchronizer\GitAsymmetricTagSynchronizer;

$synchronizer = new GitAsymmetricTagSynchronizer(
    // the working repository
    $repository,
    // the remotes to synchronize
    ['github', 'bitbucket'],
    // the primary remote
    'github'
);
$synchronizer->setLogger($logger);
$synchronizer->sync();

11/11 2014

dev-develop

Keep multiple VCS repositories in sync.

Sources Download

MIT

library vcs-synchronizer

Keep multiple VCS repositories in sync.

contao-community-alliance/vcs-synchronizer

The README.md