Vinyl adapter for the file system.
Vinyl is a very simple metadata object that describes a file. When you think of a file, two attributes come to mind: path and contents. These are the main attributes on a Vinyl object. A file does not necessarily represent something on your computer’s file system. You have files on S3, FTP, Dropbox, Box, CloudThingly.io and other services. Vinyl can be used to describe files from all of these sources.
While Vinyl provides a clean way to describe a file, we now need a way to access these files. Each file source needs what I call a "Vinyl adapter". A Vinyl adapter simply exposes a src(globs) and a dest(folder) method. Each return a stream. The src stream produces Vinyl objects, and the dest stream consumes Vinyl objects. Vinyl adapters can expose extra methods that might be specific to their input/output medium, such as the symlink method vinyl-fs provides.
var map = require('map-stream');
var vfs = require('vinyl-fs');
var log = function(file, cb) {
console.log(file.path);
cb(null, file);
};
vfs.src(['./js/**/*.js', '!./js/vendor/*.js'])
.pipe(map(log))
.pipe(vfs.dest('./output'));Takes a glob string or an array of glob strings as the first argument and an options object as the second.
Returns a stream of vinyl File objects.
Note: UTF-8 BOM will be removed from all UTF-8 files read with .src unless disabled in the options.
Globs are executed in order, so negations should follow positive globs.
For example:
fs.src(['!b*.js', '*.js'])would not exclude any files, but the following would:
fs.src(['*.js', '!b*.js'])- Values passed to the options must be of the right type, otherwise they will be ignored.
- All options can be passed a function instead of a value. The function will be called with the vinyl
Fileobject as its only argument and must return a value of the right type for the option.
Whether or not you want to buffer the file contents into memory. Setting to false will make file.contents a paused Stream.
Type: Boolean
Default: true
Whether or not you want the file to be read at all. Useful for stuff like removing files. Setting to false will make file.contents null and will disable writing the file to disk via .dest().
Type: Boolean
Default: true
Only streams files that have been modified since the time specified.
Type: Date or Number
Default: undefined
Causes the BOM to be removed on UTF-8 encoded files. Set to false if you need the BOM for some reason.
Type: Boolean
Default: true
Enables sourcemap support on files passed through the stream. Will load inline sourcemaps and resolve sourcemap links from files.
Type: Boolean
Default: false
Whether or not to recursively resolve symlinks to their targets. Setting to false to preserve them as symlinks and make file.symlink equal the original symlink's target path.
Type: Boolean
Default: true
Whether or not you want globs to match on dot files or not (e.g. .gitignore). Note: This option is not resolved from a function because it is passed verbatim to node-glob.
Type: Boolean
Default: false
Any glob-related options are documented in glob-stream and node-glob. Those options are forwarded verbatim.
Takes a folder path string or a function as the first argument and an options object as the second. If given a function, it will be called with each vinyl File object and must return a folder path.
Returns a stream that accepts vinyl File objects, writes them to disk at the folder/cwd specified, and passes them downstream so you can keep piping these around.
Once the file is written to disk, an attempt is made to determine if the stat.mode, stat.mtime and stat.atime of the vinyl File object differ from the file on the filesystem.
If they differ and the running process owns the file, the corresponding filesystem metadata is updated.
If they don't differ or the process doesn't own the file, the attempt is skipped silently.
This functionality is disabled on Windows operating systems or any other OS that doesn't support process.getuid or process.geteuid in node. This is due to Windows having very unexpected results through usage of fs.fchmod and fs.futimes.
Note: The fs.futimes() method internally converts stat.mtime and stat.atime timestamps to seconds; this division by 1000 may cause some loss of precision in 32-bit Node.js.
If the file has a symlink attribute specifying a target path, then a symlink will be created.
Note: The file will be modified after being written to this stream.
cwd,base, andpathwill be overwritten to match the folder.statwill be updated to match the file on the filesystem.contentswill have it's position reset to the beginning if it is a stream.
- Values passed to the options must be of the right type, otherwise they will be ignored.
- All options can be passed a function instead of a value. The function will be called with the vinyl
Fileobject as its only argument and must return a value of the right type for the option.
The working directory the folder is relative to.
Type: String
Default: process.cwd()
The mode the files should be created with.
Type: Number
Default: The mode of the input file (file.stat.mode) if any, or the process mode if the input file has no mode property.
The mode the directory should be created with.
Type: Number
Default: The process mode.
Whether or not existing files with the same path should be overwritten.
Type: Boolean
Default: true (always overwrite existing files)
Enables sourcemap support on files passed through the stream. Will write inline soucemaps if specified as true.
Specifying a string path will write external sourcemaps at the given path.
Examples:
// Write as inline comments
vfs.dest('./', { sourcemaps: true });
// Write as files in the same folder
vfs.dest('./', { sourcemaps: '.' });Type: Boolean or String
Default: undefined (do not write sourcemaps)
When creating a symlink, whether or not the created symlink should be relative. If false, the symlink will be absolute. Note: This option will be ignored if a junction is being created.
Type: Boolean
Default: false
When creating a symlink, whether or not a directory symlink should be created as a junction.
Type: Boolean
Default: true on Windows, false on all other platforms
Takes a folder path string or a function as the first argument and an options object as the second. If given a function, it will be called with each vinyl File object and must return a folder path.
Returns a stream that accepts vinyl File objects, create a symbolic link (i.e. symlink) at the folder/cwd specified, and passes them downstream so you can keep piping these around.
Note: The file will be modified after being written to this stream.
cwd,base, andpathwill be overwritten to match the folder.
Note: On Windows, directory links are created using Junctions by default. Use the useJunctions option to disable this behavior.
- Values passed to the options must be of the right type, otherwise they will be ignored.
- All options can be passed a function instead of a value. The function will be called with the vinyl
Fileobject as its only argument and must return a value of the right type for the option.
The working directory the folder is relative to.
Type: String
Default: process.cwd()
The mode the symlinks should be created with.
Type: Number
Default: The mode of the input file (file.stat.mode) if any, or the process mode if the input file has no mode property.
The mode the directory should be created with.
Type: Number
Default: The process mode.
Whether or not existing files with the same path should be overwritten.
Type: Boolean
Default: true (always overwrite existing files)
Whether or not the created symlinks should be relative. If false, the symlink will be absolute. Note: This option will be ignored if a junction is being created.
Type: Boolean
Default: false
Whether or not a directory symlink should be created as a junction.
Type: Boolean
Default: true on Windows, false on all other platforms