You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
rdrew 1440706ce3 fixed gulp 6 years ago
..
lib fixed gulp 6 years ago
node_modules fixed gulp 6 years ago
LICENSE fixed gulp 6 years ago
README.md fixed gulp 6 years ago
index.js fixed gulp 6 years ago
package.json fixed gulp 6 years ago

README.md

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 map = require('map-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(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:
    • cwd - Specify the working directory the folder is relative to. Default is process.cwd()
    • base - Specify the folder relative to the cwd. Default is where the glob begins. This is used to determine the file names when saving in .dest()
    • 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.
  • First argument can also be a function that takes in a file and returns a folder path.
  • 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
  • The file will be modified after being written to this stream
    • cwd, base, and path will be overwritten to match the folder
    • stat.mode will be overwritten if you used a mode parameter
    • contents will have it's position reset to the beginning if it is a stream