Skip to content

mrzmmr/vfile-read

Repository files navigation

vfile-read

Read a file or directory into a vfile.

Travis Coveralls github

Read a file or directory into avfilewhile keeping the directories structure using vfiles contents key. Vfile-read returns a promise if no callback is given.

install

npm i vfile-read

usage

Given:

./foo
|_bar
|_foo.txt
|_"Foo"
varread=require('vfile-read')

read('./foo')
.then(console.log)
.catch(console.error)

Outputs:

VFile{
data:{},
messages:[],
history:['foo'],
cwd:'./',
contents:[
VFile{
data:{},
messages:[],
history:["foo/bar"],
cwd:"./",
contents:[
VFile{
data:{},
messages:[],
history:["foo/bar/foo.txt"],
cwd:"./",
contents:"Foo"
}
]
}
]
}

api

read(location[, options [, callback]])


location

string- Location to read from.


options?

[string|array|object] - If options is a string then options.encoding is set to options. If options is an array then options.ignores is set to options.

options.encoding

string- default = 'utf-8'

options.ignores

array- default = []


callback?

function- If no callback is given, then read returns a promise.


read#sync

Synchronous version of vfile-read

varread=require('vfile-read')

try{
varfile=read.sync('./',{ignores:['node_modules'])
...
}catch(err){
...
}

Vfile-read uses fs.readdir and fs.readFile and options will be passed down to those functions.

related

to-vfile- Create a vfile from a file-path

License

MIT © Paul Zimmer

About

Read a file or directory into a vfile.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published