git merge driver specific for Salesforce.com Metadata
Last updated 12 days ago by jayree .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install sfdx-md-merge-driver 
SYNC missed versions from official npm registry.


oclif Version CircleCI Appveyor CI Codecov Downloads/week License

This is a git merge driver specific for Salesforce.com Metadata (Profiles, Permission Sets, Custom Labels).

The merge is done based on the nodes of the files, checking if any node changed in both the local copy and the branch we're trying to merge, and automatically merging whenever there is no conflict.

In the case of a node being modified in our local workspace and in the branch we try to merge, both nodes are marked with a conflict that specifies from which change the node comes, so it makes it easier to identify and resolve the conflict.

Automatic Setup (recommended)

To start using it right away:

$ npx sfdx-md-merge-driver install --global

Or install it locally, per-project:

$ cd /path/to/git/repository
$ npx sfdx-md-merge-driver install

...And you're good to go!


$ npx sfdx-md-merge-driver install
$ git merge my-conflicting-branch
Conflicts Found: 2
Conflicts Found: 0
CONFLICT (content): Merge conflict in force-app/main/default/profiles/Admin.profile-meta.xml
Auto-merging force-app/main/default/profiles/Standard.profile-meta.xml
Automatic merge failed; fix conflicts and then commit the result.

Install as Dependency

To avoid regular npx installs, consider installing the driver:

$ npm install -g sfdx-md-merge-driver
$ sfdx-md-merge-driver COMMAND
running command...
$ sfdx-md-merge-driver (-v|--version|version)
sfdx-md-merge-driver/0.1.4 darwin-x64 node-v12.16.1
$ sfdx-md-merge-driver --help [COMMAND]
  $ sfdx-md-merge-driver COMMAND


To remove an installed merge driver, use sfdx-md-merge-driver uninstall:

$ npx sfdx-md-merge-driver uninstall [--global] [--driver-name=sfdx-md-merge-driver]

Or remove the package:

$ npm uninstall -g sfdx-md-merge-driver


sfdx-md-merge-driver help [COMMAND]

display help for sfdx-md-merge-driver

  $ sfdx-md-merge-driver help [COMMAND]

  COMMAND  command to show help for

  --all  see all commands in CLI

See code: @oclif/plugin-help

sfdx-md-merge-driver install

Set up the merge driver in the current git repository.

  $ sfdx-md-merge-driver install

  -d, --driver=driver
      [default: npx sfdx-md-merge-driver merge %O %A %B %P] string to install as the driver in the git configuration

  -g, --global
      install to your user-level git configuration

  -h, --help
      show CLI help

  -n, --name=name
      [default: sfdx-md-merge-driver] String to use as the merge driver name in your configuration.

  -t, --files=*.profile|*.profile-meta.xml|*.permissionset|*.permissionset-meta.xml|*.labels|*.labels-meta.xml
      [default: *.profile,*.profile-meta.xml,*.permissionset,*.permissionset-meta.xml,*.labels,*.labels-meta.xml] 
      Filenames that will trigger this driver.

See code: src/commands/install.ts

sfdx-md-merge-driver merge %O %A %B [%P]

Check for conflicts and merge them if possible.

  $ sfdx-md-merge-driver merge %O %A %B [%P]

  %O  ancestor’s version
  %A  current version
  %B  other branches' version
  %P  pathname in which the merged result will be stored

  -h, --help  show CLI help

See code: src/commands/merge.ts

sfdx-md-merge-driver uninstall

Remove a previously configured driver

  $ sfdx-md-merge-driver uninstall

  -g, --global     install to your user-level git configuration
  -h, --help       show CLI help
  -n, --name=name  [default: sfdx-md-merge-driver] String to use as the merge driver name in your configuration.

See code: src/commands/uninstall.ts


Written by jayree

Based on code from Amguerrero's repository sfdc_merge and forks from Dhanielk and KevinGossentCap.

Node.js Installer framework based on code from Zkat's repository npm-merge-driver

Current Tags

  • 0.1.5                                ...           latest (12 days ago)

6 Versions

  • 0.1.5                                ...           12 days ago
  • 0.1.4                                ...           4 months ago
  • 0.1.3                                ...           4 months ago
  • 0.1.2                                ...           4 months ago
  • 0.1.1                                ...           6 months ago
  • 0.1.0                                ...           6 months ago
Maintainers (1)
Today 0
This Week 0
This Month 11
Last Day 0
Last Week 0
Last Month 5
Dependencies (8)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |