0.2.5 • Published 10 years ago

treediff v0.2.5

Weekly downloads
2
License
MIT
Repository
github
Last release
10 years ago

TreeDiff Logo

File tree comparison and synchronization for Node.js!

Installation

$ npm install treediff

Instantiate like so:

var TreeDiff = require('treediff');
var treediff = new TreeDiff();

Features

  • Map: Turn a file tree into universal a JSON structure regardless of its origin
  • Compare: Reveal modifications, addtions and deletions between two file trees
  • Synchronize: Transfer modifications, additions and deletions between two file trees

Methods

.compare(mapA, mapB, callback)

Will compare one file location with another one.

Arguments

  • mapA (Object) - The source to apply changes to
    • type (String) - The type of the map. Default is "local"
    • path (String) - The path to the root folder of the source
  • mapB (Object) - The target to apply changes from
    • type (String) - The type of the map. Default is "local"
    • path (String) - The path to the root folder of the source
  • callback(err, difference) (Function) - The callback that is called when comparison is complete
    • err (Error) - Any error that may occur during comparison
    • difference (Object) - Holds information about which files were added, modified and deleted
      • added (Array) - Files that are to be added to source
      • modified (Array) - Files that are to be modified on source
      • deleted (Array) - Files that are to be deleted on source
      • total (Number) - The total amount of differences

Example

var folderA = {
  type: 'local',
  path: 'path/to/folder-a'
};

var folderB = {
  type: 'local',
  path: 'path/to/folder-b'
};

treediff.compare(folderA, folderB, function(err, differences){
  // ...
});

.sync(mapA, mapB, callback)

Will apply the differences from mapB to mapA.

Arguments

  • mapA (Object) - The source to apply changes to
    • type (String) - The type of the map. Default is "local"
    • path (String) - The path to the root folder of the source
  • mapB (Object) - The target to apply changes from
    • type (String) - The type of the map. Default is "local"
    • path (String) - The path to the root folder of the source
  • callback(err) (Function) - The callback that is called when synchronization is complete
    • err (Error) - Any error that may occur during synchronization

Example

var folderA = {
  type: 'local',
  path: 'path/to/folder-a'
};

var folderB = {
  type: 'local',
  path: 'path/to/folder-b'
};

treediff.sync(folderA, folderB, function(err){
  // ...
});  

.registerFilter(filter)

Adds a filter to exlude entries from the comparison process. The filter will be evaluated for each entry as a glob expression. As an example, **/.DS_Store is applied by default.

Arguments

  • filter (String) - The glob expression string to exclude entries by.

Example

// Exclude entire folder
treediff.registerFilter('**/Folder-to-exclude/**');

// Exclude all MS Word documents
treediff.registerFilter('**/*.docx');
0.2.5

10 years ago

0.2.4

10 years ago

0.2.3

10 years ago

0.2.2

10 years ago

0.2.1

10 years ago

0.2.0

10 years ago

0.1.3

10 years ago

0.1.2

10 years ago

0.1.0

10 years ago

0.0.4

10 years ago

0.0.3

10 years ago

0.0.2

10 years ago

0.0.1

10 years ago