Nanotechnology Promises Much

npm

Need private packages and team management tools?Check out npm Orgs. »

vfile-read

1.3.6 • Public • Published

vfile-read

Read a file or directory into a vfile.

Travis Coveralls github

Read a file or directory into a vfile while 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"
var read = 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

var read = require('vfile-read')
 
try {
  var file = 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

install

npm i vfile-read

Downloadsweekly downloads

0

version

1.3.6

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability