diff options
Diffstat (limited to 'node_modules/gulp-util/node_modules/vinyl/README.md')
-rw-r--r-- | node_modules/gulp-util/node_modules/vinyl/README.md | 156 |
1 files changed, 114 insertions, 42 deletions
diff --git a/node_modules/gulp-util/node_modules/vinyl/README.md b/node_modules/gulp-util/node_modules/vinyl/README.md index 3f97efc56..2d57d8566 100644 --- a/node_modules/gulp-util/node_modules/vinyl/README.md +++ b/node_modules/gulp-util/node_modules/vinyl/README.md @@ -1,21 +1,9 @@ # vinyl [![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Coveralls Status][coveralls-image]][coveralls-url] [![Dependency Status](https://david-dm.org/wearefractal/vinyl.png?theme=shields.io)](https://david-dm.org/wearefractal/vinyl) - - ## Information +<table><br><tr><br><td>Package</td><td>vinyl</td><br></tr><br><tr><br><td>Description</td><br><td>A virtual file format</td><br></tr><br><tr><br><td>Node Version</td><br><td>>= 0.9</td><br></tr><br></table> -<table> -<tr> -<td>Package</td><td>vinyl</td> -</tr> -<tr> -<td>Description</td> -<td>A virtual file format</td> -</tr> -<tr> -<td>Node Version</td> -<td>>= 0.9</td> -</tr> -</table> +## What is this? +Read this for more info about how this plays into the grand scheme of things [https://medium.com/@eschoff/3828e8126466](https://medium.com/@eschoff/3828e8126466) ## File @@ -25,80 +13,101 @@ var File = require('vinyl'); var coffeeFile = new File({ cwd: "/", base: "/test/", - path: "/test/file.coffee" + path: "/test/file.coffee", contents: new Buffer("test = 123") }); ``` -### constructor(options) +### isVinyl +When checking if an object is a vinyl file, you should not use instanceof. Use the isVinyl function instead. -#### options.cwd +```js +var File = require('vinyl'); -Type: `String` -Default: `process.cwd()` +var dummy = new File({stuff}); +var notAFile = {}; -#### options.base +File.isVinyl(dummy); // true +File.isVinyl(notAFile); // false +``` + +### constructor(options) +#### options.cwd +Type: `String`<br><br>Default: `process.cwd()` +#### options.base Used for relative pathing. Typically where a glob starts. -Type: `String` -Default: `options.cwd` +Type: `String`<br><br>Default: `options.cwd` #### options.path - Full path to the file. -Type: `String` -Default: `null` +Type: `String`<br><br>Default: `undefined` -#### options.stat +#### options.history +Path history. Has no effect if `options.path` is passed. +Type: `Array`<br><br>Default: `options.path ? [options.path] : []` + +#### options.stat The result of an fs.stat call. See [fs.Stats](http://nodejs.org/api/fs.html#fs_class_fs_stats) for more information. -Type: `fs.Stats` -Default: `null` +Type: `fs.Stats`<br><br>Default: `null` #### options.contents - File contents. -Type: `Buffer, Stream, or null` -Default: `null` +Type: `Buffer, Stream, or null`<br><br>Default: `null` ### isBuffer() - Returns true if file.contents is a Buffer. ### isStream() - Returns true if file.contents is a Stream. ### isNull() - Returns true if file.contents is null. -### clone() +### clone([opt]) +Returns a new File object with all attributes cloned.<br>By default custom attributes are deep-cloned. -Returns a new File object with all attributes cloned. +If opt or opt.deep is false, custom attributes will not be deep-cloned. -### pipe(stream[, opt]) +If opt.contents is false, it will copy file.contents Buffer's reference. +### pipe(stream[, opt]) If file.contents is a Buffer, it will write it to the stream. If file.contents is a Stream, it will pipe it to the stream. If file.contents is null, it will do nothing. -If opt.end is true, the destination stream will not be ended (same as node core). +If opt.end is false, the destination stream will not be ended (same as node core). Returns the stream. ### inspect() - Returns a pretty String interpretation of the File. Useful for console.log. -### relative +### contents +The [Stream](https://nodejs.org/api/stream.html#stream_stream) or [Buffer](https://nodejs.org/api/buffer.html#buffer_class_buffer) of the file as it was passed in via options, or as the result of modification. + +For example: + +```js +if (file.isBuffer()) { + console.log(file.contents.toString()); // logs out the string of contents +} +``` +### path +Absolute pathname string or `undefined`. Setting to a different value pushes the old value to `history`. + +### history +Array of `path` values the file object has had, from `history[0]` (original) through `history[history.length - 1]` (current). `history` and its elements should normally be treated as read-only and only altered indirectly by setting `path`. + +### relative Returns path.relative for the file base and file path. Example: @@ -113,6 +122,69 @@ var file = new File({ console.log(file.relative); // file.coffee ``` +### dirname +Gets and sets path.dirname for the file path. + +Example: + +```javascript +var file = new File({ + cwd: "/", + base: "/test/", + path: "/test/file.coffee" +}); + +console.log(file.dirname); // /test + +file.dirname = '/specs'; + +console.log(file.dirname); // /specs +console.log(file.path); // /specs/file.coffee +` +``` + +### basename +Gets and sets path.basename for the file path. + +Example: + +```javascript +var file = new File({ + cwd: "/", + base: "/test/", + path: "/test/file.coffee" +}); + +console.log(file.basename); // file.coffee + +file.basename = 'file.js'; + +console.log(file.basename); // file.js +console.log(file.path); // /test/file.js +` +``` + +### extname +Gets and sets path.extname for the file path. + +Example: + +```javascript +var file = new File({ + cwd: "/", + base: "/test/", + path: "/test/file.coffee" +}); + +console.log(file.extname); // .coffee + +file.extname = '.js'; + +console.log(file.extname); // .js +console.log(file.path); // /test/file.js +` +``` + [npm-url]: https://npmjs.org/package/vinyl [npm-image]: https://badge.fury.io/js/vinyl.png [travis-url]: https://travis-ci.org/wearefractal/vinyl @@ -120,4 +192,4 @@ console.log(file.relative); // file.coffee [coveralls-url]: https://coveralls.io/r/wearefractal/vinyl [coveralls-image]: https://coveralls.io/repos/wearefractal/vinyl/badge.png [depstat-url]: https://david-dm.org/wearefractal/vinyl -[depstat-image]: https://david-dm.org/wearefractal/vinyl.png
\ No newline at end of file +[depstat-image]: https://david-dm.org/wearefractal/vinyl.png |