Skip to main content

A git porcelain to manage bidirectional subtree syncing with foreign git repositories

Project description

== Installation:

To install the python library you can do one of the following:
1.) use easy_install to install from the PyPI registry:
$ sudo easy_install sapling
2.) use pip to install from PyPI
$ sudo pip install sapling
3.) Or you can get the source distribution and run the following from its root:
$ sudo python install

Then to link the porcelain into git-core, do:
$ sudo --install

Get help
$ git sap -h

== Configuration

Sapling (git sap) is configured with a .saplings file at the root of your git repository. Here's
an example .saplings configuration for a scala project with common component and a hack component
that uses it:

common = {
# The logical name of the split - listed by git sap.
'name': 'common',

# The paths that comprise this split. These paths will form the saplings split from and merged
# into your repository when using git sap --split and git sap --merge respectively
'paths': [

hack = {
'name': 'hack',
'paths': [

# This is all git sap looks for - a list of splits named 'splits'. Each split in the list must be
# a dict with the keys shown/described above.
splits = [

== Use

To verify your .saplings is correct, you can view the current splits (assuming .saplings above)
$ git sap

You could split out the common split to a new repo like so:
$ git sap --split common
$ git push sapling_split_common:master

You can merge changes back in from a split branch or repo using standard git tools:
$ git pull master

This will maintain a parallel history of changes to the split which can make for confusing looking
"double commits". An alternative that allows for more controlled imports is to apply patches from
the split onto the mainline using a combination of:
1.) (split branch)$ git format-patch ... \
--ignore-if-in-upstream ..[remote split tracking branch] > /tmp/mbox
2.) (master)$ git am -k ... < /tmp/mbox

== Development:

To run all tests, you can use something like:
$ PYTHONPATH=$PYTHONPATH:. py.test test/*.py -v

== Known Issues:

There is no way currently to do differential splits. Although a split for fixed branch/split config
will always produce the same split branch (identical shas), it will always re-run over the entire
source branch which can take a long time for big branches.

== Roadmap:

+ support differential splitting
+ built in support for patch merging strategy

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sapling-0.0.11.tar.gz (13.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page