base-fs-conflicts

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

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:

API

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

Params

dest {String}: The same desination directory passed to app.dest()
returns {String}

Example

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

Related projects

You might also be interested in these projects:

assemble: Get the rocks out of your socks! Assemble makes you fast at creating web projects… more | homepage
generate: Command line tool and developer framework for scaffolding out new GitHub projects. Generate offers the… more | homepage
templates: System for creating and managing template collections, and rendering templates with any node.js template engine… more | homepage
verb: Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used… more | homepage

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

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

Current Tags

0.1.9 ... latest (8 years ago)