r3-v2/node_modules/mkdirp
Theunis J. Botha 5f5bbac56e initial comit 2020-02-27 15:24:35 +01:00
..
bin initial comit 2020-02-27 15:24:35 +01:00
examples initial comit 2020-02-27 15:24:35 +01:00
node_modules/minimist initial comit 2020-02-27 15:24:35 +01:00
test initial comit 2020-02-27 15:24:35 +01:00
.travis.yml initial comit 2020-02-27 15:24:35 +01:00
LICENSE initial comit 2020-02-27 15:24:35 +01:00
index.js initial comit 2020-02-27 15:24:35 +01:00
package.json initial comit 2020-02-27 15:24:35 +01:00
readme.markdown initial comit 2020-02-27 15:24:35 +01:00

readme.markdown

mkdirp

Like mkdir -p, but in node.js!

build status

example

pow.js

var mkdirp = require('mkdirp');
    
mkdirp('/tmp/foo/bar/baz', function (err) {
    if (err) console.error(err)
    else console.log('pow!')
});

Output

pow!

And now /tmp/foo/bar/baz exists, huzzah!

methods

var mkdirp = require('mkdirp');

mkdirp(dir, opts, cb)

Create a new directory and any necessary subdirectories at dir with octal permission string opts.mode. If opts is a non-object, it will be treated as the opts.mode.

If opts.mode isn't specified, it defaults to 0777 & (~process.umask()).

cb(err, made) fires with the error or the first directory made that had to be created, if any.

You can optionally pass in an alternate fs implementation by passing in opts.fs. Your implementation should have opts.fs.mkdir(path, mode, cb) and opts.fs.stat(path, cb).

mkdirp.sync(dir, opts)

Synchronously create a new directory and any necessary subdirectories at dir with octal permission string opts.mode. If opts is a non-object, it will be treated as the opts.mode.

If opts.mode isn't specified, it defaults to 0777 & (~process.umask()).

Returns the first directory that had to be created, if any.

You can optionally pass in an alternate fs implementation by passing in opts.fs. Your implementation should have opts.fs.mkdirSync(path, mode) and opts.fs.statSync(path).

usage

This package also ships with a mkdirp command.

usage: mkdirp [DIR1,DIR2..] {OPTIONS}

  Create each supplied directory including any necessary parent directories that
  don't yet exist.
  
  If the directory already exists, do nothing.

OPTIONS are:

  -m, --mode   If a directory needs to be created, set the mode as an octal
               permission string.

install

With npm do:

npm install mkdirp

to get the library, or

npm install -g mkdirp

to get the command.

license

MIT