fsevents 0.3.8 → 1.0.0

package/node_modules/node-pre-gyp/node_modules/tar/node_modules/fstream/README.md

@@ -0,0 +1,76 @@
+Like FS streams, but with stat on them, and supporting directories and
+symbolic links, as well as normal files.  Also, you can use this to set
+the stats on a file, even if you don't change its contents, or to create
+a symlink, etc.
+
+So, for example, you can "write" a directory, and it'll call `mkdir`.  You
+can specify a uid and gid, and it'll call `chown`.  You can specify a
+`mtime` and `atime`, and it'll call `utimes`.  You can call it a symlink
+and provide a `linkpath` and it'll call `symlink`.
+
+Note that it won't automatically resolve symbolic links.  So, if you
+call `fstream.Reader('/some/symlink')` then you'll get an object
+that stats and then ends immediately (since it has no data).  To follow
+symbolic links, do this: `fstream.Reader({path:'/some/symlink', follow:
+true })`.
+
+There are various checks to make sure that the bytes emitted are the
+same as the intended size, if the size is set.
+
+## Examples
+
+```javascript
+fstream
+  .Writer({ path: "path/to/file"
+          , mode: 0755
+          , size: 6
+          })
+  .write("hello\n")
+  .end()
+```
+
+This will create the directories if they're missing, and then write
+`hello\n` into the file, chmod it to 0755, and assert that 6 bytes have
+been written when it's done.
+
+```javascript
+fstream
+  .Writer({ path: "path/to/file"
+          , mode: 0755
+          , size: 6
+          , flags: "a"
+          })
+  .write("hello\n")
+  .end()
+```
+
+You can pass flags in, if you want to append to a file.
+
+```javascript
+fstream
+  .Writer({ path: "path/to/symlink"
+          , linkpath: "./file"
+          , SymbolicLink: true
+          , mode: "0755" // octal strings supported
+          })
+  .end()
+```
+
+If isSymbolicLink is a function, it'll be called, and if it returns
+true, then it'll treat it as a symlink.  If it's not a function, then
+any truish value will make a symlink, or you can set `type:
+'SymbolicLink'`, which does the same thing.
+
+Note that the linkpath is relative to the symbolic link location, not
+the parent dir or cwd.
+
+```javascript
+fstream
+  .Reader("path/to/dir")
+  .pipe(fstream.Writer("path/to/other/dir"))
+```
+
+This will do like `cp -Rp path/to/dir path/to/other/dir`.  If the other
+dir exists and isn't a directory, then it'll emit an error.  It'll also
+set the uid, gid, mode, etc. to be identical.  In this way, it's more
+like `rsync -a` than simply a copy.

package/node_modules/node-pre-gyp/node_modules/tar/node_modules/fstream/examples/filter-pipe.js

@@ -0,0 +1,134 @@
+var fstream = require('../fstream.js')
+var path = require('path')
+
+var r = fstream.Reader({
+  path: path.dirname(__dirname),
+  filter: function () {
+    return !this.basename.match(/^\./) &&
+      !this.basename.match(/^node_modules$/) &&
+      !this.basename.match(/^deep-copy$/) &&
+      !this.basename.match(/^filter-copy$/)
+  }
+})
+
+// this writer will only write directories
+var w = fstream.Writer({
+  path: path.resolve(__dirname, 'filter-copy'),
+  type: 'Directory',
+  filter: function () {
+    return this.type === 'Directory'
+  }
+})
+
+var indent = ''
+
+r.on('entry', appears)
+r.on('ready', function () {
+  console.error('ready to begin!', r.path)
+})
+
+function appears (entry) {
+  console.error(indent + 'a %s appears!', entry.type, entry.basename, typeof entry.basename)
+  if (foggy) {
+    console.error('FOGGY!')
+    var p = entry
+    do {
+      console.error(p.depth, p.path, p._paused)
+      p = p.parent
+    } while (p)
+
+    throw new Error('\u001b[mshould not have entries while foggy')
+  }
+  indent += '\t'
+  entry.on('data', missile(entry))
+  entry.on('end', runaway(entry))
+  entry.on('entry', appears)
+}
+
+var foggy
+function missile (entry) {
+  function liftFog (who) {
+    if (!foggy) return
+    if (who) {
+      console.error('%s breaks the spell!', who && who.path)
+    } else {
+      console.error('the spell expires!')
+    }
+    console.error('\u001b[mthe fog lifts!\n')
+    clearTimeout(foggy)
+    foggy = null
+    if (entry._paused) entry.resume()
+  }
+
+  if (entry.type === 'Directory') {
+    var ended = false
+    entry.once('end', function () { ended = true })
+    return function (c) {
+      // throw in some pathological pause()/resume() behavior
+      // just for extra fun.
+      process.nextTick(function () {
+        if (!foggy && !ended) { // && Math.random() < 0.3) {
+          console.error(indent + '%s casts a spell', entry.basename)
+          console.error('\na slowing fog comes over the battlefield...\n\u001b[32m')
+          entry.pause()
+          entry.once('resume', liftFog)
+          foggy = setTimeout(liftFog, 1000)
+        }
+      })
+    }
+  }
+
+  return function (c) {
+    var e = Math.random() < 0.5
+    console.error(indent + '%s %s for %d damage!',
+      entry.basename,
+      e ? 'is struck' : 'fires a chunk',
+      c.length)
+  }
+}
+
+function runaway (entry) {
+  return function () {
+    var e = Math.random() < 0.5
+    console.error(indent + '%s %s',
+      entry.basename,
+      e ? 'turns to flee' : 'is vanquished!')
+    indent = indent.slice(0, -1)
+  }
+}
+
+w.on('entry', attacks)
+// w.on('ready', function () { attacks(w) })
+function attacks (entry) {
+  console.error(indent + '%s %s!', entry.basename,
+    entry.type === 'Directory' ? 'calls for backup' : 'attacks')
+  entry.on('entry', attacks)
+}
+
+var ended = false
+var i = 1
+r.on('end', function () {
+  if (foggy) clearTimeout(foggy)
+  console.error("\u001b[mIT'S OVER!!")
+  console.error('A WINNAR IS YOU!')
+
+  console.log('ok ' + (i++) + ' A WINNAR IS YOU')
+  ended = true
+  // now go through and verify that everything in there is a dir.
+  var p = path.resolve(__dirname, 'filter-copy')
+  var checker = fstream.Reader({ path: p })
+  checker.checker = true
+  checker.on('child', function (e) {
+    var ok = e.type === 'Directory'
+    console.log((ok ? '' : 'not ') + 'ok ' + (i++) +
+      ' should be a dir: ' +
+      e.path.substr(checker.path.length + 1))
+  })
+})
+
+process.on('exit', function () {
+  console.log((ended ? '' : 'not ') + 'ok ' + (i) + ' ended')
+  console.log('1..' + i)
+})
+
+r.pipe(w)

package/node_modules/node-pre-gyp/node_modules/tar/node_modules/fstream/examples/pipe.js

@@ -0,0 +1,118 @@
+var fstream = require('../fstream.js')
+var path = require('path')
+
+var r = fstream.Reader({
+  path: path.dirname(__dirname),
+  filter: function () {
+    return !this.basename.match(/^\./) &&
+      !this.basename.match(/^node_modules$/) &&
+      !this.basename.match(/^deep-copy$/)
+  }
+})
+
+var w = fstream.Writer({
+  path: path.resolve(__dirname, 'deep-copy'),
+  type: 'Directory'
+})
+
+var indent = ''
+
+r.on('entry', appears)
+r.on('ready', function () {
+  console.error('ready to begin!', r.path)
+})
+
+function appears (entry) {
+  console.error(indent + 'a %s appears!', entry.type, entry.basename, typeof entry.basename, entry)
+  if (foggy) {
+    console.error('FOGGY!')
+    var p = entry
+    do {
+      console.error(p.depth, p.path, p._paused)
+      p = p.parent
+    } while (p)
+
+    throw new Error('\u001b[mshould not have entries while foggy')
+  }
+  indent += '\t'
+  entry.on('data', missile(entry))
+  entry.on('end', runaway(entry))
+  entry.on('entry', appears)
+}
+
+var foggy
+function missile (entry) {
+  function liftFog (who) {
+    if (!foggy) return
+    if (who) {
+      console.error('%s breaks the spell!', who && who.path)
+    } else {
+      console.error('the spell expires!')
+    }
+    console.error('\u001b[mthe fog lifts!\n')
+    clearTimeout(foggy)
+    foggy = null
+    if (entry._paused) entry.resume()
+  }
+
+  if (entry.type === 'Directory') {
+    var ended = false
+    entry.once('end', function () { ended = true })
+    return function (c) {
+      // throw in some pathological pause()/resume() behavior
+      // just for extra fun.
+      process.nextTick(function () {
+        if (!foggy && !ended) { // && Math.random() < 0.3) {
+          console.error(indent + '%s casts a spell', entry.basename)
+          console.error('\na slowing fog comes over the battlefield...\n\u001b[32m')
+          entry.pause()
+          entry.once('resume', liftFog)
+          foggy = setTimeout(liftFog, 10)
+        }
+      })
+    }
+  }
+
+  return function (c) {
+    var e = Math.random() < 0.5
+    console.error(indent + '%s %s for %d damage!',
+      entry.basename,
+      e ? 'is struck' : 'fires a chunk',
+      c.length)
+  }
+}
+
+function runaway (entry) {
+  return function () {
+    var e = Math.random() < 0.5
+    console.error(indent + '%s %s',
+      entry.basename,
+      e ? 'turns to flee' : 'is vanquished!')
+    indent = indent.slice(0, -1)
+  }
+}
+
+w.on('entry', attacks)
+// w.on('ready', function () { attacks(w) })
+function attacks (entry) {
+  console.error(indent + '%s %s!', entry.basename,
+    entry.type === 'Directory' ? 'calls for backup' : 'attacks')
+  entry.on('entry', attacks)
+}
+
+var ended = false
+r.on('end', function () {
+  if (foggy) clearTimeout(foggy)
+  console.error("\u001b[mIT'S OVER!!")
+  console.error('A WINNAR IS YOU!')
+
+  console.log('ok 1 A WINNAR IS YOU')
+  ended = true
+})
+
+process.on('exit', function () {
+  console.log((ended ? '' : 'not ') + 'ok 2 ended')
+  console.log('1..2')
+})
+
+r.pipe(w)

package/node_modules/node-pre-gyp/node_modules/tar/node_modules/fstream/examples/reader.js

@@ -0,0 +1,68 @@
+var fstream = require('../fstream.js')
+var tap = require('tap')
+var fs = require('fs')
+var path = require('path')
+var dir = path.dirname(__dirname)
+
+tap.test('reader test', function (t) {
+  var children = -1
+  var gotReady = false
+  var ended = false
+
+  var r = fstream.Reader({
+    path: dir,
+    filter: function () {
+      // return this.parent === r
+      return this.parent === r || this === r
+    }
+  })
+
+  r.on('ready', function () {
+    gotReady = true
+    children = fs.readdirSync(dir).length
+    console.error('Setting expected children to ' + children)
+    t.equal(r.type, 'Directory', 'should be a directory')
+  })
+
+  r.on('entry', function (entry) {
+    children--
+    if (!gotReady) {
+      t.fail('children before ready!')
+    }
+    t.equal(entry.dirname, r.path, 'basename is parent dir')
+  })
+
+  r.on('error', function (er) {
+    t.fail(er)
+    t.end()
+    process.exit(1)
+  })
+
+  r.on('end', function () {
+    t.equal(children, 0, 'should have seen all children')
+    ended = true
+  })
+
+  var closed = false
+  r.on('close', function () {
+    t.ok(ended, 'saw end before close')
+    t.notOk(closed, 'close should only happen once')
+    closed = true
+    t.end()
+  })
+})
+
+tap.test('reader error test', function (t) {
+  // assumes non-root on a *nix system
+  var r = fstream.Reader({ path: '/etc/shadow' })
+
+  r.once('error', function (er) {
+    t.ok(true)
+    t.end()
+  })
+
+  r.on('end', function () {
+    t.fail('reader ended without error')
+    t.end()
+  })
+})

package/node_modules/node-pre-gyp/node_modules/tar/node_modules/fstream/examples/symlink-write.js

@@ -0,0 +1,27 @@
+var fstream = require('../fstream.js')
+var notOpen = false
+process.chdir(__dirname)
+
+fstream
+  .Writer({
+    path: 'path/to/symlink',
+    linkpath: './file',
+    isSymbolicLink: true,
+    mode: '0755' // octal strings supported
+  })
+  .on('close', function () {
+    notOpen = true
+    var fs = require('fs')
+    var s = fs.lstatSync('path/to/symlink')
+    var isSym = s.isSymbolicLink()
+    console.log((isSym ? '' : 'not ') + 'ok 1 should be symlink')
+    var t = fs.readlinkSync('path/to/symlink')
+    var isTarget = t === './file'
+    console.log((isTarget ? '' : 'not ') + 'ok 2 should link to ./file')
+  })
+  .end()
+
+process.on('exit', function () {
+  console.log((notOpen ? '' : 'not ') + 'ok 3 should be closed')
+  console.log('1..3')
+})

package/node_modules/node-pre-gyp/node_modules/tar/node_modules/fstream/fstream.js

@@ -0,0 +1,35 @@
+exports.Abstract = require('./lib/abstract.js')
+exports.Reader = require('./lib/reader.js')
+exports.Writer = require('./lib/writer.js')
+
+exports.File = {
+  Reader: require('./lib/file-reader.js'),
+  Writer: require('./lib/file-writer.js')
+}
+
+exports.Dir = {
+  Reader: require('./lib/dir-reader.js'),
+  Writer: require('./lib/dir-writer.js')
+}
+
+exports.Link = {
+  Reader: require('./lib/link-reader.js'),
+  Writer: require('./lib/link-writer.js')
+}
+
+exports.Proxy = {
+  Reader: require('./lib/proxy-reader.js'),
+  Writer: require('./lib/proxy-writer.js')
+}
+
+exports.Reader.Dir = exports.DirReader = exports.Dir.Reader
+exports.Reader.File = exports.FileReader = exports.File.Reader
+exports.Reader.Link = exports.LinkReader = exports.Link.Reader
+exports.Reader.Proxy = exports.ProxyReader = exports.Proxy.Reader
+
+exports.Writer.Dir = exports.DirWriter = exports.Dir.Writer
+exports.Writer.File = exports.FileWriter = exports.File.Writer
+exports.Writer.Link = exports.LinkWriter = exports.Link.Writer
+exports.Writer.Proxy = exports.ProxyWriter = exports.Proxy.Writer
+
+exports.collect = require('./lib/collect.js')

package/node_modules/node-pre-gyp/node_modules/tar/node_modules/fstream/lib/abstract.js

@@ -0,0 +1,85 @@
+// the parent class for all fstreams.
+
+module.exports = Abstract
+
+var Stream = require('stream').Stream
+var inherits = require('inherits')
+
+function Abstract () {
+  Stream.call(this)
+}
+
+inherits(Abstract, Stream)
+
+Abstract.prototype.on = function (ev, fn) {
+  if (ev === 'ready' && this.ready) {
+    process.nextTick(fn.bind(this))
+  } else {
+    Stream.prototype.on.call(this, ev, fn)
+  }
+  return this
+}
+
+Abstract.prototype.abort = function () {
+  this._aborted = true
+  this.emit('abort')
+}
+
+Abstract.prototype.destroy = function () {}
+
+Abstract.prototype.warn = function (msg, code) {
+  var self = this
+  var er = decorate(msg, code, self)
+  if (!self.listeners('warn')) {
+    console.error('%s %s\n' +
+    'path = %s\n' +
+    'syscall = %s\n' +
+    'fstream_type = %s\n' +
+    'fstream_path = %s\n' +
+    'fstream_unc_path = %s\n' +
+    'fstream_class = %s\n' +
+    'fstream_stack =\n%s\n',
+      code || 'UNKNOWN',
+      er.stack,
+      er.path,
+      er.syscall,
+      er.fstream_type,
+      er.fstream_path,
+      er.fstream_unc_path,
+      er.fstream_class,
+      er.fstream_stack.join('\n'))
+  } else {
+    self.emit('warn', er)
+  }
+}
+
+Abstract.prototype.info = function (msg, code) {
+  this.emit('info', msg, code)
+}
+
+Abstract.prototype.error = function (msg, code, th) {
+  var er = decorate(msg, code, this)
+  if (th) throw er
+  else this.emit('error', er)
+}
+
+function decorate (er, code, self) {
+  if (!(er instanceof Error)) er = new Error(er)
+  er.code = er.code || code
+  er.path = er.path || self.path
+  er.fstream_type = er.fstream_type || self.type
+  er.fstream_path = er.fstream_path || self.path
+  if (self._path !== self.path) {
+    er.fstream_unc_path = er.fstream_unc_path || self._path
+  }
+  if (self.linkpath) {
+    er.fstream_linkpath = er.fstream_linkpath || self.linkpath
+  }
+  er.fstream_class = er.fstream_class || self.constructor.name
+  er.fstream_stack = er.fstream_stack ||
+    new Error().stack.split(/\n/).slice(3).map(function (s) {
+      return s.replace(/^ {4}at /, '')
+    })
+
+  return er
+}

package/node_modules/node-pre-gyp/node_modules/tar/node_modules/fstream/lib/collect.js

@@ -0,0 +1,68 @@
+module.exports = collect
+
+function collect (stream) {
+  if (stream._collected) return
+
+  stream._collected = true
+  stream.pause()
+
+  stream.on('data', save)
+  stream.on('end', save)
+  var buf = []
+  function save (b) {
+    if (typeof b === 'string') b = new Buffer(b)
+    if (Buffer.isBuffer(b) && !b.length) return
+    buf.push(b)
+  }
+
+  stream.on('entry', saveEntry)
+  var entryBuffer = []
+  function saveEntry (e) {
+    collect(e)
+    entryBuffer.push(e)
+  }
+
+  stream.on('proxy', proxyPause)
+  function proxyPause (p) {
+    p.pause()
+  }
+
+  // replace the pipe method with a new version that will
+  // unlock the buffered stuff.  if you just call .pipe()
+  // without a destination, then it'll re-play the events.
+  stream.pipe = (function (orig) {
+    return function (dest) {
+      // console.error(' === open the pipes', dest && dest.path)
+
+      // let the entries flow through one at a time.
+      // Once they're all done, then we can resume completely.
+      var e = 0
+      ;(function unblockEntry () {
+        var entry = entryBuffer[e++]
+        // console.error(" ==== unblock entry", entry && entry.path)
+        if (!entry) return resume()
+        entry.on('end', unblockEntry)
+        if (dest) dest.add(entry)
+        else stream.emit('entry', entry)
+      })()
+
+      function resume () {
+        stream.removeListener('entry', saveEntry)
+        stream.removeListener('data', save)
+        stream.removeListener('end', save)
+
+        stream.pipe = orig
+        if (dest) stream.pipe(dest)
+
+        buf.forEach(function (b) {
+          if (b) stream.emit('data', b)
+          else stream.emit('end')
+        })
+
+        stream.resume()
+      }
+
+      return dest
+    }
+  })(stream.pipe)
+}