embeditor-rails 1.1.1 → 2.0.0.beta

data/lib/node_modules/npm/node_modules/init-package-json/README.md

@@ -0,0 +1,43 @@
+# init-package-json
+
+A node module to get your node module started.
+
+## Usage
+
+```javascript
+var init = require('init-package-json')
+var path = require('path')
+
+// a path to a promzard module.  In the event that this file is
+// not found, one will be provided for you.
+var initFile = path.resolve(process.env.HOME, '.npm-init')
+
+// the dir where we're doin stuff.
+var dir = process.cwd()
+
+// extra stuff that gets put into the PromZard module's context.
+// In npm, this is the resolved config object.  Exposed as 'config'
+// Optional.
+var configData = { some: 'extra stuff' }
+
+// Any existing stuff from the package.json file is also exposed in the
+// PromZard module as the `package` object.  There will also be free
+// vars for:
+// * `filename` path to the package.json file
+// * `basename` the tip of the package dir
+// * `dirname` the parent of the package dir
+
+init(dir, initFile, configData, function (er, data) {
+  // the data's already been written to {dir}/package.json
+  // now you can do stuff with it
+})
+```
+
+Or from the command line:
+
+```
+$ npm-init
+```
+
+See [PromZard](https://github.com/isaacs/promzard) for details about
+what can go in the config file.

data/lib/node_modules/npm/node_modules/init-package-json/default-input.js

@@ -0,0 +1,181 @@
+var fs = require('fs')
+var path = require('path')
+var glob = require('glob')
+
+// more popular packages should go here, maybe?
+function isTestPkg (p) {
+  return !!p.match(/^(expresso|mocha|tap|coffee-script|coco|streamline)$/)
+}
+
+function niceName (n) {
+  return n.replace(/^node-|[.-]js$/g, '')
+}
+
+function readDeps (test) { return function (cb) {
+  fs.readdir('node_modules', function (er, dir) {
+    if (er) return cb()
+    var deps = {}
+    var n = dir.length
+    if (n === 0) return cb(null, deps)
+    dir.forEach(function (d) {
+      if (d.match(/^\./)) return next()
+      if (test !== isTestPkg(d))
+        return next()
+
+      var dp = path.join(dirname, 'node_modules', d, 'package.json')
+      fs.readFile(dp, 'utf8', function (er, p) {
+        if (er) return next()
+        try { p = JSON.parse(p) }
+        catch (e) { return next() }
+        if (!p.version) return next()
+        deps[d] = '~' + p.version
+        return next()
+      })
+    })
+    function next () {
+      if (--n === 0) return cb(null, deps)
+    }
+  })
+}}
+
+
+exports.name = prompt('name', package.name || basename)
+exports.version = prompt('version', package.version || '0.0.0')
+if (!package.description) {
+  exports.description = prompt('description')
+}
+
+if (!package.main) {
+  exports.main = function (cb) {
+    fs.readdir(dirname, function (er, f) {
+      if (er) f = []
+
+      f = f.filter(function (f) {
+        return f.match(/\.js$/)
+      })
+
+      if (f.indexOf('index.js') !== -1)
+        f = 'index.js'
+      else if (f.indexOf('main.js') !== -1)
+        f = 'main.js'
+      else if (f.indexOf(basename + '.js') !== -1)
+        f = basename + '.js'
+      else
+        f = f[0]
+
+      return cb(null, prompt('entry point', f || 'index.js'))
+    })
+  }
+}
+
+if (!package.bin) {
+  exports.bin = function (cb) {
+    fs.readdir(path.resolve(dirname, 'bin'), function (er, d) {
+      // no bins
+      if (er) return cb()
+      // just take the first js file we find there, or nada
+      return cb(null, d.filter(function (f) {
+        return f.match(/\.js$/)
+      })[0])
+    })
+  }
+}
+
+exports.directories = function (cb) {
+  fs.readdir(dirname, function (er, dirs) {
+    if (er) return cb(er)
+    var res = {}
+    dirs.forEach(function (d) {
+      switch (d) {
+        case 'example': case 'examples': return res.example = d
+        case 'test': case 'tests': return res.test = d
+        case 'doc': case 'docs': return res.doc = d
+        case 'man': return res.man = d
+      }
+    })
+    if (Object.keys(res).length === 0) res = undefined
+    return cb(null, res)
+  })
+}
+
+if (!package.dependencies) {
+  exports.dependencies = readDeps(false)
+}
+
+if (!package.devDependencies) {
+  exports.devDependencies = readDeps(true)
+}
+
+// MUST have a test script!
+var s = package.scripts || {}
+var notest = 'echo "Error: no test specified" && exit 1'
+if (!package.scripts) {
+  exports.scripts = function (cb) {
+    fs.readdir(path.join(dirname, 'node_modules'), function (er, d) {
+      setupScripts(d || [], cb)
+    })
+  }
+}
+function setupScripts (d, cb) {
+  // check to see what framework is in use, if any
+  function tx (test) {
+    return test || notest
+  }
+
+  if (!s.test || s.test === notest) {
+    if (d.indexOf('tap') !== -1)
+      s.test = prompt('test command', 'tap test/*.js', tx)
+    else if (d.indexOf('expresso') !== -1)
+      s.test = prompt('test command', 'expresso test', tx)
+    else if (d.indexOf('mocha') !== -1)
+      s.test = prompt('test command', 'mocha', tx)
+    else
+      s.test = prompt('test command', tx)
+  }
+
+  return cb(null, s)
+}
+
+if (!package.repository) {
+  exports.repository = function (cb) {
+    fs.readFile('.git/config', 'utf8', function (er, gconf) {
+      if (er || !gconf) return cb(null, prompt('git repository'))
+
+      gconf = gconf.split(/\r?\n/)
+      var i = gconf.indexOf('[remote "origin"]')
+      if (i !== -1) {
+        var u = gconf[i + 1]
+        if (!u.match(/^\s*url =/)) u = gconf[i + 2]
+        if (!u.match(/^\s*url =/)) u = null
+        else u = u.replace(/^\s*url = /, '')
+      }
+      if (u && u.match(/^git@github.com:/))
+        u = u.replace(/^git@github.com:/, 'git://github.com/')
+
+      return cb(null, prompt('git repository', u))
+    })
+  }
+}
+
+if (!package.keywords) {
+  exports.keywords = prompt('keywords', function (s) {
+    if (!s) return undefined
+    if (Array.isArray(s)) s = s.join(' ')
+    if (typeof s !== 'string') return s
+    return s.split(/[\s,]+/)
+  })
+}
+
+if (!package.author) {
+  exports.author = config.get('init.author.name')
+  ? {
+      "name" : config.get('init.author.name'),
+      "email" : config.get('init.author.email'),
+      "url" : config.get('init.author.url')
+    }
+  : prompt('author')
+}
+
+exports.license = prompt('license', package.license ||
+                         config.get('init.license') ||
+                         'BSD-2-Clause')

data/lib/node_modules/npm/node_modules/init-package-json/example/example-basic.js

@@ -0,0 +1,8 @@
+var init = require('../init-package-json.js')
+var path = require('path')
+var dir = process.cwd()
+var initFile = require.resolve('./init/basic-init.js')
+
+init(dir, initFile, function (err, data) {
+  if (!err) console.log('written successfully')
+})

data/lib/node_modules/npm/node_modules/init-package-json/example/example-default.js

@@ -0,0 +1,7 @@
+var init = require('../init-package-json.js')
+var path = require('path')
+var dir = process.cwd()
+
+init(dir, 'file that does not exist', function (err, data) {
+  if (!err) console.log('written successfully')
+})

data/lib/node_modules/npm/node_modules/init-package-json/example/example-npm.js

@@ -0,0 +1,13 @@
+var init = require('../init-package-json.js')
+var path = require('path')
+var dir = process.cwd()
+var npm = require('npm')
+
+npm.load(function (er, npm) {
+  if (er) throw er
+  init(dir, npm.config.get('init-module'), npm.config, function (er, data) {
+    if (er) throw er
+    console.log('written successfully')
+  })
+})
+

data/lib/node_modules/npm/node_modules/init-package-json/example/init/basic-init.js

@@ -0,0 +1 @@
+exports.flavor = prompt("what's your favorite flavor of ice cream buddy?", "I LIKE THEM ALL")

data/lib/node_modules/npm/node_modules/init-package-json/init-package-json.js

@@ -0,0 +1,129 @@
+
+module.exports = init
+
+var PZ = require('promzard').PromZard
+var path = require('path')
+var def = require.resolve('./default-input.js')
+
+var fs = require('fs')
+var semver = require('semver')
+var read = require('read')
+
+// to validate the data object at the end as a worthwhile package
+// and assign default values for things.
+// readJson.extras(file, data, cb)
+var readJson = require('read-package-json')
+
+function init (dir, input, config, cb) {
+  if (typeof config === 'function')
+    cb = config, config = {}
+
+  // accept either a plain-jane object, or a config object
+  // with a "get" method.
+  if (typeof config.get !== 'function') {
+    var data = config
+    config = {
+      get: function (k) {
+        return data[k]
+      },
+      toJSON: function () {
+        return data
+      }
+    }
+  }
+
+  var package = path.resolve(dir, 'package.json')
+  input = path.resolve(input)
+  var pkg
+  var ctx = {}
+
+  var es = readJson.extraSet
+  readJson.extraSet = es.filter(function (fn) {
+    return fn.name !== 'authors' && fn.name !== 'mans'
+  })
+  readJson(package, function (er, d) {
+    readJson.extraSet = es
+
+    if (er) pkg = {}
+    else pkg = d
+
+    ctx.filename = package
+    ctx.dirname = path.dirname(package)
+    ctx.basename = path.basename(ctx.dirname)
+    if (!pkg.version || !semver.valid(pkg.version))
+      delete pkg.version
+
+    ctx.package = pkg
+    ctx.config = config || {}
+
+    // make sure that the input is valid.
+    // if not, use the default
+    var pz = new PZ(input, ctx)
+    pz.backupFile = def
+    pz.on('error', cb)
+    pz.on('data', function (data) {
+      Object.keys(data).forEach(function (k) {
+        if (data[k] !== undefined && data[k] !== null) pkg[k] = data[k]
+      })
+
+      // only do a few of these.
+      // no need for mans or contributors if they're in the files
+      var es = readJson.extraSet
+      readJson.extraSet = es.filter(function (fn) {
+        return fn.name !== 'authors' && fn.name !== 'mans'
+      })
+      readJson.extras(package, pkg, function (er, pkg) {
+        readJson.extraSet = es
+        if (er) return cb(er, pkg)
+        pkg = unParsePeople(pkg)
+        // no need for the readme now.
+        delete pkg.readme
+        delete pkg.readmeFilename
+
+        // really don't want to have this lying around in the file
+        delete pkg._id
+
+        // ditto
+        delete pkg.gitHead
+
+        // if the repo is empty, remove it.
+        if (!pkg.repository)
+          delete pkg.repository
+
+        var d = JSON.stringify(pkg, null, 2) + '\n'
+        console.log('About to write to %s:\n\n%s\n', package, d)
+        read({prompt:'Is this ok? ', default: 'yes'}, function (er, ok) {
+          if (!ok || ok.toLowerCase().charAt(0) !== 'y') {
+            console.log('Aborted.')
+          } else {
+            fs.writeFile(package, d, 'utf8', function (er) {
+              return cb(er, pkg)
+            })
+          }
+        })
+      })
+    })
+  })
+
+}
+
+// turn the objects into somewhat more humane strings.
+function unParsePeople (data) {
+  if (data.author) data.author = unParsePerson(data.author)
+  ;["maintainers", "contributors"].forEach(function (set) {
+    if (!Array.isArray(data[set])) return;
+    data[set] = data[set].map(unParsePerson)
+  })
+  return data
+}
+
+function unParsePerson (person) {
+  if (typeof person === "string") return person
+  var name = person.name || ""
+  var u = person.url || person.web
+  var url = u ? (" ("+u+")") : ""
+  var e = person.email || person.mail
+  var email = e ? (" <"+e+">") : ""
+  return name+email+url
+}
+

data/lib/node_modules/npm/node_modules/init-package-json/node_modules/promzard/LICENSE

@@ -0,0 +1,15 @@
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/lib/node_modules/npm/node_modules/init-package-json/node_modules/promzard/README.md

@@ -0,0 +1,133 @@
+# promzard
+
+A prompting wizard for building files from specialized PromZard modules.
+Used by `npm init`.
+
+A reimplementation of @SubStack's
+[prompter](https://github.com/substack/node-prompter), which does not
+use AST traversal.
+
+From another point of view, it's a reimplementation of
+[@Marak](https://github.com/marak)'s
+[wizard](https://github.com/Marak/wizard) which doesn't use schemas.
+
+The goal is a nice drop-in enhancement for `npm init`.
+
+## Usage
+
+```javascript
+var promzard = require('promzard')
+promzard(inputFile, optionalContextAdditions, function (er, data) {
+  // .. you know what you doing ..
+})
+```
+
+In the `inputFile` you can have something like this:
+
+```javascript
+var fs = require('fs')
+module.exports = {
+  "greeting": prompt("Who shall you greet?", "world", function (who) {
+    return "Hello, " + who
+  }),
+  "filename": __filename,
+  "directory": function (cb) {
+    fs.readdir(__dirname, cb)
+  }
+}
+```
+
+When run, promzard will display the prompts and resolve the async
+functions in order, and then either give you an error, or the resolved
+data, ready to be dropped into a JSON file or some other place.
+
+
+### promzard(inputFile, ctx, callback)
+
+The inputFile is just a node module.  You can require() things, set
+module.exports, etc.  Whatever that module exports is the result, and it
+is walked over to call any functions as described below.
+
+The only caveat is that you must give PromZard the full absolute path
+to the module (you can get this via Node's `require.resolve`.)  Also,
+the `prompt` function is injected into the context object, so watch out.
+
+Whatever you put in that `ctx` will of course also be available in the
+module.  You can get quite fancy with this, passing in existing configs
+and so on.
+
+### Class: promzard.PromZard(file, ctx)
+
+Just like the `promzard` function, but the EventEmitter that makes it
+all happen.  Emits either a `data` event with the data, or a `error`
+event if it blows up.
+
+If `error` is emitted, then `data` never will be.
+
+### prompt(...)
+
+In the promzard input module, you can call the `prompt` function.
+This prompts the user to input some data.  The arguments are interpreted
+based on type:
+
+1. `string`  The first string encountered is the prompt.  The second is
+   the default value.
+2. `function` A transformer function which receives the data and returns
+   something else.  More than meets the eye.
+3. `object` The `prompt` member is the prompt, the `default` member is
+   the default value, and the `transform` is the transformer.
+
+Whatever the final value is, that's what will be put on the resulting
+object.
+
+### Functions
+
+If there are any functions on the promzard input module's exports, then
+promzard will call each of them with a callback.  This way, your module
+can do asynchronous actions if necessary to validate or ascertain
+whatever needs verification.
+
+The functions are called in the context of the ctx object, and are given
+a single argument, which is a callback that should be called with either
+an error, or the result to assign to that spot.
+
+In the async function, you can also call prompt() and return the result
+of the prompt in the callback.
+
+For example, this works fine in a promzard module:
+
+```
+exports.asyncPrompt = function (cb) {
+  fs.stat(someFile, function (er, st) {
+    // if there's an error, no prompt, just error
+    // otherwise prompt and use the actual file size as the default
+    cb(er, prompt('file size', st.size))
+  })
+}
+```
+
+You can also return other async functions in the async function
+callback.  Though that's a bit silly, it could be a handy way to reuse
+functionality in some cases.
+
+### Sync vs Async
+
+The `prompt()` function is not synchronous, though it appears that way.
+It just returns a token that is swapped out when the data object is
+walked over asynchronously later, and returns a token.
+
+For that reason, prompt() calls whose results don't end up on the data
+object are never shown to the user.  For example, this will only prompt
+once:
+
+```
+exports.promptThreeTimes = prompt('prompt me once', 'shame on you')
+exports.promptThreeTimes = prompt('prompt me twice', 'um....')
+exports.promptThreeTimes = prompt('you cant prompt me again')
+```
+
+### Isn't this exactly the sort of 'looks sync' that you said was bad about other libraries?
+
+Yeah, sorta.  I wouldn't use promzard for anything more complicated than
+a wizard that spits out prompts to set up a config file or something.
+Maybe there are other use cases I haven't considered.