JSPM

  • Created
  • Published
  • Downloads 2677808
  • Score
    100M100P100Q209268F

Vinyl adapter for the file system

Package Exports

  • vinyl-fs
  • vinyl-fs/lib/dest
  • vinyl-fs/lib/dest/writeContents
  • vinyl-fs/lib/src
  • vinyl-fs/lib/src/getContents

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vinyl-fs) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

vinyl-fs NPM version Build Status Coveralls Status Dependency Status

Information

Packagevinyl-fs
Description Vinyl adapter for the file system
Node Version >= 0.10

Usage

var es = require('event-stream');
var fs = require('vinyl-fs');

var log = function(file, cb) {
  console.log(file.path);
  cb(null, file);
};

fs.src(["./js/**/*.js", "!./js/vendor/*.js"])
  .pipe(es.map(log))
  .pipe(fs.dest("./output"));

API

src(globs[, opt])

  • Takes a glob string or an array of glob strings as the first argument.
  • Possible options for the second argument:
    • buffer - true or false if you want to buffer the file.
      • Default value is true
      • false will make file.contents a paused Stream
    • read - true or false if you want the file to be read or not. Useful for stuff like rming files.
      • Default value is true
      • false will disable writing the file to disk via .dest()
    • Any glob-related options are documented in glob-stream and node-glob
  • Returns a Readable/Writable stream.
  • On write the stream will simply pass items through.
  • This stream emits matching vinyl File objects

watch(globs[, opt, cb])

This is just glob-watcher

  • Takes a glob string or an array of glob strings as the first argument.
  • Possible options for the second argument:
    • Any options are passed to gaze
  • Returns an EventEmitter
    • 'changed' event is emitted on each file change
  • Optionally calls the callback on each change event

dest(folder[, opt])

  • Takes a folder path as the first argument.
  • Possible options for the second argument:
    • cwd - Specify the working directory the folder is relative to. Default is process.cwd()
    • mode - Specify the mode the files should be created with. Default is the mode of the input file (file.stat.mode)
  • Returns a Readable/Writable stream.
  • On write the stream will save the vinyl File to disk at the folder/cwd specified.
  • After writing the file to disk it will be emitted from the stream so you can keep piping these around