1.3.8 • Published 4 years ago

vfile-read v1.3.8

Weekly downloads
2
License
MIT
Repository
github
Last release
4 years ago

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

1.3.8

4 years ago

1.3.7

4 years ago

1.3.6

5 years ago

1.3.4

5 years ago

1.3.3

5 years ago

1.3.2

5 years ago

1.3.1

5 years ago

1.3.0

6 years ago

1.2.0

6 years ago

1.0.1

6 years ago

1.0.0

6 years ago