Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

vinyl-file

sindresorhus4.3mMIT5.0.0TypeScript support: included

Create a vinyl file from an actual file

vinyl, fs, file, read, virtual, format, gulp, gulpfriendly

readme

vinyl-file

Create a Vinyl file from an actual file

Install

npm install vinyl-file

Usage

import {vinylFile} from 'vinyl-file';

const file = await vinylFile('index.js');

console.log(file.path);
//=> '/Users/sindresorhus/dev/vinyl-file/index.js'

console.log(file.cwd);
//=> '/Users/sindresorhus/dev/vinyl-file'

API

vinylFile(path, options?)

Create a Vinyl file asynchronously and return it.

vinylFileSync(path, options?)

Create a Vinyl file synchronously and return it.

options

Type: object

base

Type: string\ Default: process.cwd()

Override the base of the Vinyl file.

cwd

Type: string\ Default: process.cwd()

Override the cwd (current working directory) of the Vinyl file.

buffer

Type: boolean\ Default: true

Setting this to false will return file.contents as a stream. This is useful when working with large files.

Note: Plugins might not implement support for streams.

read

Type: boolean\ Default: true

Setting this to false will return file.contents as null and not read the file at all.

  • vinyl-read - Create vinyl files from glob patterns