Home

Awesome

base-fs-conflicts NPM version NPM downloads Build Status

Detect potential file system conflicts and if necessary prompt the user before overwriting files.

Install

Install with npm:

$ npm install --save base-fs-conflicts

Attribution

Some of the logic in this plugin, in particular lib/diffs.js, is based on the conflicter code in yeoman-generator, Copyright (c) 2015, Google, licensed under BSD-2-Clause.

Usage

The following code should work with any base application, including verb, assemble, and generate.

var path = require('path');
var Base = require('base');
var fs = require('base-fs');
var conflicts = require('base-fs-conflicts');
var base = new Base();

// register the `conflicts` and `fs` plugins
base.use(conflicts());
base.use(fs());

// pass the same `dest` to both `.dest()` and `.conflicts()`
var dest = 'fixtures/dist';

base.src('fixtures/*.txt')
  .pipe(base.conflicts(dest)) // adds a `.conflicts()` method
  .pipe(base.dest(dest));

Example

If a file conflict is detected, you'll see something like this in the terminal:

<img width="570" alt="screen shot 2016-03-17 at 8 05 53 pm" src="https://cloud.githubusercontent.com/assets/383994/13864890/d9f67420-ec7b-11e5-973d-47462989d773.png">

API

  1. The existing file's contents is compared with file.contents on the vinyl file
  2. If the contents of both are identical, no action is taken
  3. If the contents differ, the user is prompted for action
  4. If no conflicting file exists, the vinyl file is written to the file system

Params

Example

app.src('foo/*.js')
  .pipe(app.conflicts('foo'))
  .pipe(app.dest('foo'));

Related projects

You might also be interested in these projects:

Contributing

This document was generated by verb-readme-generator (a verb generator), please don't edit directly. Any changes to the readme must be made in .verb.md. See Building Docs.

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue. Or visit the verb-readme-generator project to submit bug reports or pull requests for the readme layout template.

Building docs

Generate readme and API documentation with verb:

$ npm install -g verb verb-readme-generator && verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.


This file was generated by verb, v0.9.0, on July 26, 2016.