feat: new npm-cli feature to install missing dependencies

doc/cli/npm-mp.md

@@ -0,0 +1,55 @@
+npm-mp(1) -- Find and install required packages in a file or directory
+======================================================================
+
+## SYNOPSIS
+
+ npm mp <folder>
+ npm mp <file>
+
+ common options: [i|install|c|check]
+
+## DESCRIPTION
+
+Missing-packages (mp) is a tool you will love to use whenever
+you create a NodeJS package or work in team. It is used to check that all packages
+used in a file or directory are well installed in the 'node_modules' directory.
+
+The packages to install are read in from prompts.
+
+It can be used when passing a folder from one person to another
+and automatically detect what dependencies are required for the files in the folder
+to work properly.
+
+## CONFIGURATION
+
+### check
+
+Default: none
+
+`check` is used whenever the purpose is only to know what dependency should be installed.
+
+e.g.
+ ```
+ npm mp check ./folder1
+ ```
+
+### install
+
+Default: true
+
+`install` is used whenever the purpose is to install all dependencies used in
+a file or folder that are missing in the `package.json`.
+
+e.g.
+ ```
+ npm mp i ./file42.js
+ ```
+
+## SEE ALSO
+
+* npm-registry(7)
+* npm-config(1)
+* npm-config(7)
+* npmrc(5)
+* npm-owner(1)
+* npm-whoami(1)

lib/config/cmd-list.js

@@ -60,6 +60,7 @@ var cmdList = [
  'config',
  'set',
  'get',
+ 'mp',
  'update',
  'outdated',
  'prune',

lib/mp.js

@@ -0,0 +1,228 @@
+
+/*
+ * mp - missing packages
+ *
+ * Shows what packages do not appear as dependencies in package.json
+ * within a file or a folder (multiple files) and prompts the user
+ * to install those relevant
+ */
+
+module.exports = mp
+
+const usage = require("./utils/usage")
+const output = require("./utils/output.js")
+const log = require("npmlog")
+const uniq = require("lodash.uniq")
+const fs = require("graceful-fs")
+const Bluebird = require("bluebird")
+const readAsync = Bluebird.promisify(require("read"))
+const npmInstall = require("./install")
+
+mp.usage = usage(
+ "mp",
+ "\nnpm mp <path>" +
+ "\nnpm mp install <path>" +
+ "npm mp i <path>" +
+ "\nnpm mp check <path>" +
+ "\nnpm mp c <path>"
+)
+
+function mp(args, cb) {
+ const firstParam = args.shift()
+ const secondParam = args.shift()
+ const packagesInstalled = getPackagesInstalled(cb)
+
+ if ((firstParam === "i" || firstParam === "install") && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (firstParam === "c" || firstParam === "check" && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ displayPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (fs.existsSync(`${process.cwd()}/${firstParam}`)) {
+ const filePath = `${process.cwd()}/${firstParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else {
+ misuse(cb)
+ }
+}
+
+// Installs packages
+function installPackagesString(packagesString, cb) {
+ npmInstall([packagesString], (err) => {
+ output(" ✅ Packages installed !")
+ cb()
+ })
+}
+
+function installFromQuestions(toInstallQuestions, cpt, cb) {
+ readAnswer(toInstallQuestions[cpt].message, toInstallQuestions[cpt].answer).then((answer) => {
+ toInstallQuestions[cpt].answer = answer
+
+ if(cpt === toInstallQuestions.length-1) {
+ cb(toInstallQuestions)
+ } else {
+ cpt++
+ return installFromQuestions(toInstallQuestions, cpt, cb)
+ }
+ })
+}
+
+// Prompts the user before installing missing packages
+function installPackages(packages, installed, cb) {
+ const toInstallQuestions = packages
+ .filter((pack) => !installed.includes(pack))
+ .map((pack) => {
+ return {
+ message: `Install package \x1b[32m${pack}\x1b[0m ? (y/n)`,
+ answer: null,
+ name: pack,
+ }
+ })
+
+ let initialCpt = 0
+
+ installFromQuestions(toInstallQuestions, initialCpt, (packagesToInstall) => {
+ const mappedPackages = packagesToInstall
+ .filter(({ answer }) => answer === "y")
+ .map(package => package.name)
+
+ installPackagesString(mappedPackages.join(" "), cb)
+ })
+}
+
+// Compare packages given in parameters and shows those to install
+function displayPackages(packagesToShow, installed, cb) {
+ const display = packagesToShow
+ .filter((pack) => !installed.includes(pack))
+
+ const message = display.length ?
+ ` ⚡️ Package(s) to install: ${display.toString()}` : " ❌ No package to install"
+
+ output(message)
+ cb()
+}
+
+// Checks a file before deciding weither to install or display
+function checkFile(filePath, knownPackages) {
+ const file = fs.readFileSync(filePath, "utf8")
+ const packages = extractPackagesToInstall(file)
+
+ if (packages) {
+ packages.forEach((pack) => {
+ if (!knownPackages.includes(pack)) {
+ knownPackages.push(pack)
+ }
+ })
+ }
+
+ return packages
+}
+
+function checkDirectoryRecursive(path, knownPackages) {
+ let localPackages = []
+
+ fs.readdirSync(path).forEach((file) => {
+ const filePath = `${path}/${file}`
+
+ if (fs.lstatSync(filePath).isDirectory()
+ && file !== "node_modules") {
+ localPackages = localPackages.concat(checkDirectoryRecursive(`${path}/${file}`, knownPackages))
+ } else if (file.match(/\.js/gu) && !file.match(/\.json/gu)) {
+ localPackages = localPackages.concat(checkFile(filePath, knownPackages))
+ }
+ })
+
+ knownPackages = knownPackages.concat(localPackages)
+
+ return uniq(knownPackages)
+}
+
+// Checks all for packages in file(s)
+function check(path) {
+ let packages = []
+ const isDir = fs.lstatSync(path).isDirectory()
+
+ // Passing an empty array to initiate recursivity or search one file
+ packages = isDir ? checkDirectoryRecursive(path, packages) : checkFile(path, packages)
+
+ return packages
+}
+
+function getPackageJsonRecursive(packagePath, cpt) {
+ try {
+ const file = fs.readFileSync(`${process.cwd()}/${packagePath}`, "utf8")
+
+ return file
+ } catch (err) {
+ cpt++
+ // Loop recursively only 5 times then abort
+ if (cpt < 5) {
+ return getPackageJsonRecursive(`../${packagePath}`, cpt)
+ }
+
+ return null
+ }
+}
+
+// Tries to find a package.json
+function getPackageJson() {
+ let cpt = 0
+ const packageJson = getPackageJsonRecursive("package.json", cpt)
+
+ return packageJson
+}
+
+function getPackagesInstalled(cb) {
+ const packageJson = getPackageJson()
+
+ if (!packageJson) {
+ cb(new Error(" ❌ No package.json found"))
+ }
+
+ const installedPackagesObject = JSON.parse(packageJson).dependencies || {}
+ const installedPackagesArray = Object.keys(installedPackagesObject)
+
+ return installedPackagesArray
+}
+
+// Finds all packages to install in a file
+function extractPackagesToInstall(fileContent) {
+ const packages = fileContent.match(/require\(["'][A-Za-z0-9_-]+['"]\)/giu)
+
+ if (!packages) {
+ return []
+ }
+
+ // removes "require(" and ")"
+ const mappedPackages = packages.map((pack) => pack.substr(9, pack.length - 11))
+
+ return mappedPackages
+}
+
+function misuse(cb) {
+ cb(`Usage: \n${mp.usage}`);
+}
+
+function read (opts) {
+ return Bluebird.try(() => {
+ log.clearProgress()
+ return readAsync(opts)
+ }).finally(() => {
+ log.showProgress()
+ })
+}
+
+function readAnswer (msg, answer, opts, isRetry) {
+ if (isRetry && (answer === "y" || answer === "n")) {
+ return Promise.resolve(answer.trim())
+ }
+
+ return read({prompt: msg, default: answer ? `Entered: ${answer}` : ''})
+ .then((answer) => readAnswer(msg, answer, opts, true))
+}

doc/cli/npm-mp.md

@@ -0,0 +1,55 @@
+npm-mp(1) -- Find and install required packages in a file or directory
+======================================================================
+
+## SYNOPSIS
+
+ npm mp <folder>
+ npm mp <file>
+
+ common options: [i|install|c|check]
+
+## DESCRIPTION
+
+Missing-packages (mp) is a tool you will love to use whenever
+you create a NodeJS package or work in team. It is used to check that all packages
+used in a file or directory are well installed in the 'node_modules' directory.
+
+The packages to install are read in from prompts.
+
+It can be used when passing a folder from one person to another
+and automatically detect what dependencies are required for the files in the folder
+to work properly.
+
+## CONFIGURATION
+
+### check
+
+Default: none
+
+`check` is used whenever the purpose is only to know what dependency should be installed.
+
+e.g.
+ ```
+ npm mp check ./folder1
+ ```
+
+### install
+
+Default: true
+
+`install` is used whenever the purpose is to install all dependencies used in
+a file or folder that are missing in the `package.json`.
+
+e.g.
+ ```
+ npm mp i ./file42.js
+ ```
+
+## SEE ALSO
+
+* npm-registry(7)
+* npm-config(1)
+* npm-config(7)
+* npmrc(5)
+* npm-owner(1)
+* npm-whoami(1)

lib/config/cmd-list.js

@@ -60,6 +60,7 @@ var cmdList = [
  'config',
  'set',
  'get',
+ 'mp',
  'update',
  'outdated',
  'prune',

lib/mp.js

@@ -0,0 +1,228 @@
+
+/*
+ * mp - missing packages
+ *
+ * Shows what packages do not appear as dependencies in package.json
+ * within a file or a folder (multiple files) and prompts the user
+ * to install those relevant
+ */
+
+module.exports = mp
+
+const usage = require("./utils/usage")
+const output = require("./utils/output.js")
+const log = require("npmlog")
+const uniq = require("lodash.uniq")
+const fs = require("graceful-fs")
+const Bluebird = require("bluebird")
+const readAsync = Bluebird.promisify(require("read"))
+const npmInstall = require("./install")
+
+mp.usage = usage(
+ "mp",
+ "\nnpm mp <path>" +
+ "\nnpm mp install <path>" +
+ "npm mp i <path>" +
+ "\nnpm mp check <path>" +
+ "\nnpm mp c <path>"
+)
+
+function mp(args, cb) {
+ const firstParam = args.shift()
+ const secondParam = args.shift()
+ const packagesInstalled = getPackagesInstalled(cb)
+
+ if ((firstParam === "i" || firstParam === "install") && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (firstParam === "c" || firstParam === "check" && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ displayPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (fs.existsSync(`${process.cwd()}/${firstParam}`)) {
+ const filePath = `${process.cwd()}/${firstParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else {
+ misuse(cb)
+ }
+}
+
+// Installs packages
+function installPackagesString(packagesString, cb) {
+ npmInstall([packagesString], (err) => {
+ output(" ✅ Packages installed !")
+ cb()
+ })
+}
+
+function installFromQuestions(toInstallQuestions, cpt, cb) {
+ readAnswer(toInstallQuestions[cpt].message, toInstallQuestions[cpt].answer).then((answer) => {
+ toInstallQuestions[cpt].answer = answer
+
+ if(cpt === toInstallQuestions.length-1) {
+ cb(toInstallQuestions)
+ } else {
+ cpt++
+ return installFromQuestions(toInstallQuestions, cpt, cb)
+ }
+ })
+}
+
+// Prompts the user before installing missing packages
+function installPackages(packages, installed, cb) {
+ const toInstallQuestions = packages
+ .filter((pack) => !installed.includes(pack))
+ .map((pack) => {
+ return {
+ message: `Install package \x1b[32m${pack}\x1b[0m ? (y/n)`,
+ answer: null,
+ name: pack,
+ }
+ })
+
+ let initialCpt = 0
+
+ installFromQuestions(toInstallQuestions, initialCpt, (packagesToInstall) => {
+ const mappedPackages = packagesToInstall
+ .filter(({ answer }) => answer === "y")
+ .map(package => package.name)
+
+ installPackagesString(mappedPackages.join(" "), cb)
+ })
+}
+
+// Compare packages given in parameters and shows those to install
+function displayPackages(packagesToShow, installed, cb) {
+ const display = packagesToShow
+ .filter((pack) => !installed.includes(pack))
+
+ const message = display.length ?
+ ` ⚡️ Package(s) to install: ${display.toString()}` : " ❌ No package to install"
+
+ output(message)
+ cb()
+}
+
+// Checks a file before deciding weither to install or display
+function checkFile(filePath, knownPackages) {
+ const file = fs.readFileSync(filePath, "utf8")
+ const packages = extractPackagesToInstall(file)
+
+ if (packages) {
+ packages.forEach((pack) => {
+ if (!knownPackages.includes(pack)) {
+ knownPackages.push(pack)
+ }
+ })
+ }
+
+ return packages
+}
+
+function checkDirectoryRecursive(path, knownPackages) {
+ let localPackages = []
+
+ fs.readdirSync(path).forEach((file) => {
+ const filePath = `${path}/${file}`
+
+ if (fs.lstatSync(filePath).isDirectory()
+ && file !== "node_modules") {
+ localPackages = localPackages.concat(checkDirectoryRecursive(`${path}/${file}`, knownPackages))
+ } else if (file.match(/\.js/gu) && !file.match(/\.json/gu)) {
+ localPackages = localPackages.concat(checkFile(filePath, knownPackages))
+ }
+ })
+
+ knownPackages = knownPackages.concat(localPackages)
+
+ return uniq(knownPackages)
+}
+
+// Checks all for packages in file(s)
+function check(path) {
+ let packages = []
+ const isDir = fs.lstatSync(path).isDirectory()
+
+ // Passing an empty array to initiate recursivity or search one file
+ packages = isDir ? checkDirectoryRecursive(path, packages) : checkFile(path, packages)
+
+ return packages
+}
+
+function getPackageJsonRecursive(packagePath, cpt) {
+ try {
+ const file = fs.readFileSync(`${process.cwd()}/${packagePath}`, "utf8")
+
+ return file
+ } catch (err) {
+ cpt++
+ // Loop recursively only 5 times then abort
+ if (cpt < 5) {
+ return getPackageJsonRecursive(`../${packagePath}`, cpt)
+ }
+
+ return null
+ }
+}
+
+// Tries to find a package.json
+function getPackageJson() {
+ let cpt = 0
+ const packageJson = getPackageJsonRecursive("package.json", cpt)
+
+ return packageJson
+}
+
+function getPackagesInstalled(cb) {
+ const packageJson = getPackageJson()
+
+ if (!packageJson) {
+ cb(new Error(" ❌ No package.json found"))
+ }
+
+ const installedPackagesObject = JSON.parse(packageJson).dependencies || {}
+ const installedPackagesArray = Object.keys(installedPackagesObject)
+
+ return installedPackagesArray
+}
+
+// Finds all packages to install in a file
+function extractPackagesToInstall(fileContent) {
+ const packages = fileContent.match(/require\(["'][A-Za-z0-9_-]+['"]\)/giu)
+
+ if (!packages) {
+ return []
+ }
+
+ // removes "require(" and ")"
+ const mappedPackages = packages.map((pack) => pack.substr(9, pack.length - 11))
+
+ return mappedPackages
+}
+
+function misuse(cb) {
+ cb(`Usage: \n${mp.usage}`);
+}
+
+function read (opts) {
+ return Bluebird.try(() => {
+ log.clearProgress()
+ return readAsync(opts)
+ }).finally(() => {
+ log.showProgress()
+ })
+}
+
+function readAnswer (msg, answer, opts, isRetry) {
+ if (isRetry && (answer === "y" || answer === "n")) {
+ return Promise.resolve(answer.trim())
+ }
+
+ return read({prompt: msg, default: answer ? `Entered: ${answer}` : ''})
+ .then((answer) => readAnswer(msg, answer, opts, true))
+}

doc/cli/npm-mp.md

@@ -0,0 +1,55 @@
+npm-mp(1) -- Find and install required packages in a file or directory
+======================================================================
+
+## SYNOPSIS
+
+ npm mp <folder>
+ npm mp <file>
+
+ common options: [i|install|c|check]
+
+## DESCRIPTION
+
+Missing-packages (mp) is a tool you will love to use whenever
+you create a NodeJS package or work in team. It is used to check that all packages
+used in a file or directory are well installed in the 'node_modules' directory.
+
+The packages to install are read in from prompts.
+
+It can be used when passing a folder from one person to another
+and automatically detect what dependencies are required for the files in the folder
+to work properly.
+
+## CONFIGURATION
+
+### check
+
+Default: none
+
+`check` is used whenever the purpose is only to know what dependency should be installed.
+
+e.g.
+ ```
+ npm mp check ./folder1
+ ```
+
+### install
+
+Default: true
+
+`install` is used whenever the purpose is to install all dependencies used in
+a file or folder that are missing in the `package.json`.
+
+e.g.
+ ```
+ npm mp i ./file42.js
+ ```
+
+## SEE ALSO
+
+* npm-registry(7)
+* npm-config(1)
+* npm-config(7)
+* npmrc(5)
+* npm-owner(1)
+* npm-whoami(1)

lib/config/cmd-list.js

@@ -60,6 +60,7 @@ var cmdList = [
  'config',
  'set',
  'get',
+ 'mp',
  'update',
  'outdated',
  'prune',

lib/mp.js

@@ -0,0 +1,228 @@
+
+/*
+ * mp - missing packages
+ *
+ * Shows what packages do not appear as dependencies in package.json
+ * within a file or a folder (multiple files) and prompts the user
+ * to install those relevant
+ */
+
+module.exports = mp
+
+const usage = require("./utils/usage")
+const output = require("./utils/output.js")
+const log = require("npmlog")
+const uniq = require("lodash.uniq")
+const fs = require("graceful-fs")
+const Bluebird = require("bluebird")
+const readAsync = Bluebird.promisify(require("read"))
+const npmInstall = require("./install")
+
+mp.usage = usage(
+ "mp",
+ "\nnpm mp <path>" +
+ "\nnpm mp install <path>" +
+ "npm mp i <path>" +
+ "\nnpm mp check <path>" +
+ "\nnpm mp c <path>"
+)
+
+function mp(args, cb) {
+ const firstParam = args.shift()
+ const secondParam = args.shift()
+ const packagesInstalled = getPackagesInstalled(cb)
+
+ if ((firstParam === "i" || firstParam === "install") && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (firstParam === "c" || firstParam === "check" && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ displayPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (fs.existsSync(`${process.cwd()}/${firstParam}`)) {
+ const filePath = `${process.cwd()}/${firstParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else {
+ misuse(cb)
+ }
+}
+
+// Installs packages
+function installPackagesString(packagesString, cb) {
+ npmInstall([packagesString], (err) => {
+ output(" ✅ Packages installed !")
+ cb()
+ })
+}
+
+function installFromQuestions(toInstallQuestions, cpt, cb) {
+ readAnswer(toInstallQuestions[cpt].message, toInstallQuestions[cpt].answer).then((answer) => {
+ toInstallQuestions[cpt].answer = answer
+
+ if(cpt === toInstallQuestions.length-1) {
+ cb(toInstallQuestions)
+ } else {
+ cpt++
+ return installFromQuestions(toInstallQuestions, cpt, cb)
+ }
+ })
+}
+
+// Prompts the user before installing missing packages
+function installPackages(packages, installed, cb) {
+ const toInstallQuestions = packages
+ .filter((pack) => !installed.includes(pack))
+ .map((pack) => {
+ return {
+ message: `Install package \x1b[32m${pack}\x1b[0m ? (y/n)`,
+ answer: null,
+ name: pack,
+ }
+ })
+
+ let initialCpt = 0
+
+ installFromQuestions(toInstallQuestions, initialCpt, (packagesToInstall) => {
+ const mappedPackages = packagesToInstall
+ .filter(({ answer }) => answer === "y")
+ .map(package => package.name)
+
+ installPackagesString(mappedPackages.join(" "), cb)
+ })
+}
+
+// Compare packages given in parameters and shows those to install
+function displayPackages(packagesToShow, installed, cb) {
+ const display = packagesToShow
+ .filter((pack) => !installed.includes(pack))
+
+ const message = display.length ?
+ ` ⚡️ Package(s) to install: ${display.toString()}` : " ❌ No package to install"
+
+ output(message)
+ cb()
+}
+
+// Checks a file before deciding weither to install or display
+function checkFile(filePath, knownPackages) {
+ const file = fs.readFileSync(filePath, "utf8")
+ const packages = extractPackagesToInstall(file)
+
+ if (packages) {
+ packages.forEach((pack) => {
+ if (!knownPackages.includes(pack)) {
+ knownPackages.push(pack)
+ }
+ })
+ }
+
+ return packages
+}
+
+function checkDirectoryRecursive(path, knownPackages) {
+ let localPackages = []
+
+ fs.readdirSync(path).forEach((file) => {
+ const filePath = `${path}/${file}`
+
+ if (fs.lstatSync(filePath).isDirectory()
+ && file !== "node_modules") {
+ localPackages = localPackages.concat(checkDirectoryRecursive(`${path}/${file}`, knownPackages))
+ } else if (file.match(/\.js/gu) && !file.match(/\.json/gu)) {
+ localPackages = localPackages.concat(checkFile(filePath, knownPackages))
+ }
+ })
+
+ knownPackages = knownPackages.concat(localPackages)
+
+ return uniq(knownPackages)
+}
+
+// Checks all for packages in file(s)
+function check(path) {
+ let packages = []
+ const isDir = fs.lstatSync(path).isDirectory()
+
+ // Passing an empty array to initiate recursivity or search one file
+ packages = isDir ? checkDirectoryRecursive(path, packages) : checkFile(path, packages)
+
+ return packages
+}
+
+function getPackageJsonRecursive(packagePath, cpt) {
+ try {
+ const file = fs.readFileSync(`${process.cwd()}/${packagePath}`, "utf8")
+
+ return file
+ } catch (err) {
+ cpt++
+ // Loop recursively only 5 times then abort
+ if (cpt < 5) {
+ return getPackageJsonRecursive(`../${packagePath}`, cpt)
+ }
+
+ return null
+ }
+}
+
+// Tries to find a package.json
+function getPackageJson() {
+ let cpt = 0
+ const packageJson = getPackageJsonRecursive("package.json", cpt)
+
+ return packageJson
+}
+
+function getPackagesInstalled(cb) {
+ const packageJson = getPackageJson()
+
+ if (!packageJson) {
+ cb(new Error(" ❌ No package.json found"))
+ }
+
+ const installedPackagesObject = JSON.parse(packageJson).dependencies || {}
+ const installedPackagesArray = Object.keys(installedPackagesObject)
+
+ return installedPackagesArray
+}
+
+// Finds all packages to install in a file
+function extractPackagesToInstall(fileContent) {
+ const packages = fileContent.match(/require\(["'][A-Za-z0-9_-]+['"]\)/giu)
+
+ if (!packages) {
+ return []
+ }
+
+ // removes "require(" and ")"
+ const mappedPackages = packages.map((pack) => pack.substr(9, pack.length - 11))
+
+ return mappedPackages
+}
+
+function misuse(cb) {
+ cb(`Usage: \n${mp.usage}`);
+}
+
+function read (opts) {
+ return Bluebird.try(() => {
+ log.clearProgress()
+ return readAsync(opts)
+ }).finally(() => {
+ log.showProgress()
+ })
+}
+
+function readAnswer (msg, answer, opts, isRetry) {
+ if (isRetry && (answer === "y" || answer === "n")) {
+ return Promise.resolve(answer.trim())
+ }
+
+ return read({prompt: msg, default: answer ? `Entered: ${answer}` : ''})
+ .then((answer) => readAnswer(msg, answer, opts, true))
+}

doc/cli/npm-mp.md

@@ -0,0 +1,55 @@
+npm-mp(1) -- Find and install required packages in a file or directory
+======================================================================
+
+## SYNOPSIS
+
+ npm mp <folder>
+ npm mp <file>
+
+ common options: [i|install|c|check]
+
+## DESCRIPTION
+
+Missing-packages (mp) is a tool you will love to use whenever
+you create a NodeJS package or work in team. It is used to check that all packages
+used in a file or directory are well installed in the 'node_modules' directory.
+
+The packages to install are read in from prompts.
+
+It can be used when passing a folder from one person to another
+and automatically detect what dependencies are required for the files in the folder
+to work properly.
+
+## CONFIGURATION
+
+### check
+
+Default: none
+
+`check` is used whenever the purpose is only to know what dependency should be installed.
+
+e.g.
+ ```
+ npm mp check ./folder1
+ ```
+
+### install
+
+Default: true
+
+`install` is used whenever the purpose is to install all dependencies used in
+a file or folder that are missing in the `package.json`.
+
+e.g.
+ ```
+ npm mp i ./file42.js
+ ```
+
+## SEE ALSO
+
+* npm-registry(7)
+* npm-config(1)
+* npm-config(7)
+* npmrc(5)
+* npm-owner(1)
+* npm-whoami(1)

lib/config/cmd-list.js

@@ -60,6 +60,7 @@ var cmdList = [
  'config',
  'set',
  'get',
+ 'mp',
  'update',
  'outdated',
  'prune',

lib/mp.js

@@ -0,0 +1,228 @@
+
+/*
+ * mp - missing packages
+ *
+ * Shows what packages do not appear as dependencies in package.json
+ * within a file or a folder (multiple files) and prompts the user
+ * to install those relevant
+ */
+
+module.exports = mp
+
+const usage = require("./utils/usage")
+const output = require("./utils/output.js")
+const log = require("npmlog")
+const uniq = require("lodash.uniq")
+const fs = require("graceful-fs")
+const Bluebird = require("bluebird")
+const readAsync = Bluebird.promisify(require("read"))
+const npmInstall = require("./install")
+
+mp.usage = usage(
+ "mp",
+ "\nnpm mp <path>" +
+ "\nnpm mp install <path>" +
+ "npm mp i <path>" +
+ "\nnpm mp check <path>" +
+ "\nnpm mp c <path>"
+)
+
+function mp(args, cb) {
+ const firstParam = args.shift()
+ const secondParam = args.shift()
+ const packagesInstalled = getPackagesInstalled(cb)
+
+ if ((firstParam === "i" || firstParam === "install") && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (firstParam === "c" || firstParam === "check" && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ displayPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (fs.existsSync(`${process.cwd()}/${firstParam}`)) {
+ const filePath = `${process.cwd()}/${firstParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else {
+ misuse(cb)
+ }
+}
+
+// Installs packages
+function installPackagesString(packagesString, cb) {
+ npmInstall([packagesString], (err) => {
+ output(" ✅ Packages installed !")
+ cb()
+ })
+}
+
+function installFromQuestions(toInstallQuestions, cpt, cb) {
+ readAnswer(toInstallQuestions[cpt].message, toInstallQuestions[cpt].answer).then((answer) => {
+ toInstallQuestions[cpt].answer = answer
+
+ if(cpt === toInstallQuestions.length-1) {
+ cb(toInstallQuestions)
+ } else {
+ cpt++
+ return installFromQuestions(toInstallQuestions, cpt, cb)
+ }
+ })
+}
+
+// Prompts the user before installing missing packages
+function installPackages(packages, installed, cb) {
+ const toInstallQuestions = packages
+ .filter((pack) => !installed.includes(pack))
+ .map((pack) => {
+ return {
+ message: `Install package \x1b[32m${pack}\x1b[0m ? (y/n)`,
+ answer: null,
+ name: pack,
+ }
+ })
+
+ let initialCpt = 0
+
+ installFromQuestions(toInstallQuestions, initialCpt, (packagesToInstall) => {
+ const mappedPackages = packagesToInstall
+ .filter(({ answer }) => answer === "y")
+ .map(package => package.name)
+
+ installPackagesString(mappedPackages.join(" "), cb)
+ })
+}
+
+// Compare packages given in parameters and shows those to install
+function displayPackages(packagesToShow, installed, cb) {
+ const display = packagesToShow
+ .filter((pack) => !installed.includes(pack))
+
+ const message = display.length ?
+ ` ⚡️ Package(s) to install: ${display.toString()}` : " ❌ No package to install"
+
+ output(message)
+ cb()
+}
+
+// Checks a file before deciding weither to install or display
+function checkFile(filePath, knownPackages) {
+ const file = fs.readFileSync(filePath, "utf8")
+ const packages = extractPackagesToInstall(file)
+
+ if (packages) {
+ packages.forEach((pack) => {
+ if (!knownPackages.includes(pack)) {
+ knownPackages.push(pack)
+ }
+ })
+ }
+
+ return packages
+}
+
+function checkDirectoryRecursive(path, knownPackages) {
+ let localPackages = []
+
+ fs.readdirSync(path).forEach((file) => {
+ const filePath = `${path}/${file}`
+
+ if (fs.lstatSync(filePath).isDirectory()
+ && file !== "node_modules") {
+ localPackages = localPackages.concat(checkDirectoryRecursive(`${path}/${file}`, knownPackages))
+ } else if (file.match(/\.js/gu) && !file.match(/\.json/gu)) {
+ localPackages = localPackages.concat(checkFile(filePath, knownPackages))
+ }
+ })
+
+ knownPackages = knownPackages.concat(localPackages)
+
+ return uniq(knownPackages)
+}
+
+// Checks all for packages in file(s)
+function check(path) {
+ let packages = []
+ const isDir = fs.lstatSync(path).isDirectory()
+
+ // Passing an empty array to initiate recursivity or search one file
+ packages = isDir ? checkDirectoryRecursive(path, packages) : checkFile(path, packages)
+
+ return packages
+}
+
+function getPackageJsonRecursive(packagePath, cpt) {
+ try {
+ const file = fs.readFileSync(`${process.cwd()}/${packagePath}`, "utf8")
+
+ return file
+ } catch (err) {
+ cpt++
+ // Loop recursively only 5 times then abort
+ if (cpt < 5) {
+ return getPackageJsonRecursive(`../${packagePath}`, cpt)
+ }
+
+ return null
+ }
+}
+
+// Tries to find a package.json
+function getPackageJson() {
+ let cpt = 0
+ const packageJson = getPackageJsonRecursive("package.json", cpt)
+
+ return packageJson
+}
+
+function getPackagesInstalled(cb) {
+ const packageJson = getPackageJson()
+
+ if (!packageJson) {
+ cb(new Error(" ❌ No package.json found"))
+ }
+
+ const installedPackagesObject = JSON.parse(packageJson).dependencies || {}
+ const installedPackagesArray = Object.keys(installedPackagesObject)
+
+ return installedPackagesArray
+}
+
+// Finds all packages to install in a file
+function extractPackagesToInstall(fileContent) {
+ const packages = fileContent.match(/require\(["'][A-Za-z0-9_-]+['"]\)/giu)
+
+ if (!packages) {
+ return []
+ }
+
+ // removes "require(" and ")"
+ const mappedPackages = packages.map((pack) => pack.substr(9, pack.length - 11))
+
+ return mappedPackages
+}
+
+function misuse(cb) {
+ cb(`Usage: \n${mp.usage}`);
+}
+
+function read (opts) {
+ return Bluebird.try(() => {
+ log.clearProgress()
+ return readAsync(opts)
+ }).finally(() => {
+ log.showProgress()
+ })
+}
+
+function readAnswer (msg, answer, opts, isRetry) {
+ if (isRetry && (answer === "y" || answer === "n")) {
+ return Promise.resolve(answer.trim())
+ }
+
+ return read({prompt: msg, default: answer ? `Entered: ${answer}` : ''})
+ .then((answer) => readAnswer(msg, answer, opts, true))
+}

doc/cli/npm-mp.md

@@ -0,0 +1,55 @@
+npm-mp(1) -- Find and install required packages in a file or directory
+======================================================================
+
+## SYNOPSIS
+
+ npm mp <folder>
+ npm mp <file>
+
+ common options: [i|install|c|check]
+
+## DESCRIPTION
+
+Missing-packages (mp) is a tool you will love to use whenever
+you create a NodeJS package or work in team. It is used to check that all packages
+used in a file or directory are well installed in the 'node_modules' directory.
+
+The packages to install are read in from prompts.
+
+It can be used when passing a folder from one person to another
+and automatically detect what dependencies are required for the files in the folder
+to work properly.
+
+## CONFIGURATION
+
+### check
+
+Default: none
+
+`check` is used whenever the purpose is only to know what dependency should be installed.
+
+e.g.
+ ```
+ npm mp check ./folder1
+ ```
+
+### install
+
+Default: true
+
+`install` is used whenever the purpose is to install all dependencies used in
+a file or folder that are missing in the `package.json`.
+
+e.g.
+ ```
+ npm mp i ./file42.js
+ ```
+
+## SEE ALSO
+
+* npm-registry(7)
+* npm-config(1)
+* npm-config(7)
+* npmrc(5)
+* npm-owner(1)
+* npm-whoami(1)

lib/config/cmd-list.js

@@ -60,6 +60,7 @@ var cmdList = [
  'config',
  'set',
  'get',
+ 'mp',
  'update',
  'outdated',
  'prune',

lib/mp.js

@@ -0,0 +1,228 @@
+
+/*
+ * mp - missing packages
+ *
+ * Shows what packages do not appear as dependencies in package.json
+ * within a file or a folder (multiple files) and prompts the user
+ * to install those relevant
+ */
+
+module.exports = mp
+
+const usage = require("./utils/usage")
+const output = require("./utils/output.js")
+const log = require("npmlog")
+const uniq = require("lodash.uniq")
+const fs = require("graceful-fs")
+const Bluebird = require("bluebird")
+const readAsync = Bluebird.promisify(require("read"))
+const npmInstall = require("./install")
+
+mp.usage = usage(
+ "mp",
+ "\nnpm mp <path>" +
+ "\nnpm mp install <path>" +
+ "npm mp i <path>" +
+ "\nnpm mp check <path>" +
+ "\nnpm mp c <path>"
+)
+
+function mp(args, cb) {
+ const firstParam = args.shift()
+ const secondParam = args.shift()
+ const packagesInstalled = getPackagesInstalled(cb)
+
+ if ((firstParam === "i" || firstParam === "install") && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (firstParam === "c" || firstParam === "check" && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ displayPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (fs.existsSync(`${process.cwd()}/${firstParam}`)) {
+ const filePath = `${process.cwd()}/${firstParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else {
+ misuse(cb)
+ }
+}
+
+// Installs packages
+function installPackagesString(packagesString, cb) {
+ npmInstall([packagesString], (err) => {
+ output(" ✅ Packages installed !")
+ cb()
+ })
+}
+
+function installFromQuestions(toInstallQuestions, cpt, cb) {
+ readAnswer(toInstallQuestions[cpt].message, toInstallQuestions[cpt].answer).then((answer) => {
+ toInstallQuestions[cpt].answer = answer
+
+ if(cpt === toInstallQuestions.length-1) {
+ cb(toInstallQuestions)
+ } else {
+ cpt++
+ return installFromQuestions(toInstallQuestions, cpt, cb)
+ }
+ })
+}
+
+// Prompts the user before installing missing packages
+function installPackages(packages, installed, cb) {
+ const toInstallQuestions = packages
+ .filter((pack) => !installed.includes(pack))
+ .map((pack) => {
+ return {
+ message: `Install package \x1b[32m${pack}\x1b[0m ? (y/n)`,
+ answer: null,
+ name: pack,
+ }
+ })
+
+ let initialCpt = 0
+
+ installFromQuestions(toInstallQuestions, initialCpt, (packagesToInstall) => {
+ const mappedPackages = packagesToInstall
+ .filter(({ answer }) => answer === "y")
+ .map(package => package.name)
+
+ installPackagesString(mappedPackages.join(" "), cb)
+ })
+}
+
+// Compare packages given in parameters and shows those to install
+function displayPackages(packagesToShow, installed, cb) {
+ const display = packagesToShow
+ .filter((pack) => !installed.includes(pack))
+
+ const message = display.length ?
+ ` ⚡️ Package(s) to install: ${display.toString()}` : " ❌ No package to install"
+
+ output(message)
+ cb()
+}
+
+// Checks a file before deciding weither to install or display
+function checkFile(filePath, knownPackages) {
+ const file = fs.readFileSync(filePath, "utf8")
+ const packages = extractPackagesToInstall(file)
+
+ if (packages) {
+ packages.forEach((pack) => {
+ if (!knownPackages.includes(pack)) {
+ knownPackages.push(pack)
+ }
+ })
+ }
+
+ return packages
+}
+
+function checkDirectoryRecursive(path, knownPackages) {
+ let localPackages = []
+
+ fs.readdirSync(path).forEach((file) => {
+ const filePath = `${path}/${file}`
+
+ if (fs.lstatSync(filePath).isDirectory()
+ && file !== "node_modules") {
+ localPackages = localPackages.concat(checkDirectoryRecursive(`${path}/${file}`, knownPackages))
+ } else if (file.match(/\.js/gu) && !file.match(/\.json/gu)) {
+ localPackages = localPackages.concat(checkFile(filePath, knownPackages))
+ }
+ })
+
+ knownPackages = knownPackages.concat(localPackages)
+
+ return uniq(knownPackages)
+}
+
+// Checks all for packages in file(s)
+function check(path) {
+ let packages = []
+ const isDir = fs.lstatSync(path).isDirectory()
+
+ // Passing an empty array to initiate recursivity or search one file
+ packages = isDir ? checkDirectoryRecursive(path, packages) : checkFile(path, packages)
+
+ return packages
+}
+
+function getPackageJsonRecursive(packagePath, cpt) {
+ try {
+ const file = fs.readFileSync(`${process.cwd()}/${packagePath}`, "utf8")
+
+ return file
+ } catch (err) {
+ cpt++
+ // Loop recursively only 5 times then abort
+ if (cpt < 5) {
+ return getPackageJsonRecursive(`../${packagePath}`, cpt)
+ }
+
+ return null
+ }
+}
+
+// Tries to find a package.json
+function getPackageJson() {
+ let cpt = 0
+ const packageJson = getPackageJsonRecursive("package.json", cpt)
+
+ return packageJson
+}
+
+function getPackagesInstalled(cb) {
+ const packageJson = getPackageJson()
+
+ if (!packageJson) {
+ cb(new Error(" ❌ No package.json found"))
+ }
+
+ const installedPackagesObject = JSON.parse(packageJson).dependencies || {}
+ const installedPackagesArray = Object.keys(installedPackagesObject)
+
+ return installedPackagesArray
+}
+
+// Finds all packages to install in a file
+function extractPackagesToInstall(fileContent) {
+ const packages = fileContent.match(/require\(["'][A-Za-z0-9_-]+['"]\)/giu)
+
+ if (!packages) {
+ return []
+ }
+
+ // removes "require(" and ")"
+ const mappedPackages = packages.map((pack) => pack.substr(9, pack.length - 11))
+
+ return mappedPackages
+}
+
+function misuse(cb) {
+ cb(`Usage: \n${mp.usage}`);
+}
+
+function read (opts) {
+ return Bluebird.try(() => {
+ log.clearProgress()
+ return readAsync(opts)
+ }).finally(() => {
+ log.showProgress()
+ })
+}
+
+function readAnswer (msg, answer, opts, isRetry) {
+ if (isRetry && (answer === "y" || answer === "n")) {
+ return Promise.resolve(answer.trim())
+ }
+
+ return read({prompt: msg, default: answer ? `Entered: ${answer}` : ''})
+ .then((answer) => readAnswer(msg, answer, opts, true))
+}

doc/cli/npm-mp.md

@@ -0,0 +1,55 @@
+npm-mp(1) -- Find and install required packages in a file or directory
+======================================================================
+
+## SYNOPSIS
+
+ npm mp <folder>
+ npm mp <file>
+
+ common options: [i|install|c|check]
+
+## DESCRIPTION
+
+Missing-packages (mp) is a tool you will love to use whenever
+you create a NodeJS package or work in team. It is used to check that all packages
+used in a file or directory are well installed in the 'node_modules' directory.
+
+The packages to install are read in from prompts.
+
+It can be used when passing a folder from one person to another
+and automatically detect what dependencies are required for the files in the folder
+to work properly.
+
+## CONFIGURATION
+
+### check
+
+Default: none
+
+`check` is used whenever the purpose is only to know what dependency should be installed.
+
+e.g.
+ ```
+ npm mp check ./folder1
+ ```
+
+### install
+
+Default: true
+
+`install` is used whenever the purpose is to install all dependencies used in
+a file or folder that are missing in the `package.json`.
+
+e.g.
+ ```
+ npm mp i ./file42.js
+ ```
+
+## SEE ALSO
+
+* npm-registry(7)
+* npm-config(1)
+* npm-config(7)
+* npmrc(5)
+* npm-owner(1)
+* npm-whoami(1)

lib/config/cmd-list.js

@@ -60,6 +60,7 @@ var cmdList = [
  'config',
  'set',
  'get',
+ 'mp',
  'update',
  'outdated',
  'prune',

lib/mp.js

@@ -0,0 +1,228 @@
+
+/*
+ * mp - missing packages
+ *
+ * Shows what packages do not appear as dependencies in package.json
+ * within a file or a folder (multiple files) and prompts the user
+ * to install those relevant
+ */
+
+module.exports = mp
+
+const usage = require("./utils/usage")
+const output = require("./utils/output.js")
+const log = require("npmlog")
+const uniq = require("lodash.uniq")
+const fs = require("graceful-fs")
+const Bluebird = require("bluebird")
+const readAsync = Bluebird.promisify(require("read"))
+const npmInstall = require("./install")
+
+mp.usage = usage(
+ "mp",
+ "\nnpm mp <path>" +
+ "\nnpm mp install <path>" +
+ "npm mp i <path>" +
+ "\nnpm mp check <path>" +
+ "\nnpm mp c <path>"
+)
+
+function mp(args, cb) {
+ const firstParam = args.shift()
+ const secondParam = args.shift()
+ const packagesInstalled = getPackagesInstalled(cb)
+
+ if ((firstParam === "i" || firstParam === "install") && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (firstParam === "c" || firstParam === "check" && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ displayPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (fs.existsSync(`${process.cwd()}/${firstParam}`)) {
+ const filePath = `${process.cwd()}/${firstParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else {
+ misuse(cb)
+ }
+}
+
+// Installs packages
+function installPackagesString(packagesString, cb) {
+ npmInstall([packagesString], (err) => {
+ output(" ✅ Packages installed !")
+ cb()
+ })
+}
+
+function installFromQuestions(toInstallQuestions, cpt, cb) {
+ readAnswer(toInstallQuestions[cpt].message, toInstallQuestions[cpt].answer).then((answer) => {
+ toInstallQuestions[cpt].answer = answer
+
+ if(cpt === toInstallQuestions.length-1) {
+ cb(toInstallQuestions)
+ } else {
+ cpt++
+ return installFromQuestions(toInstallQuestions, cpt, cb)
+ }
+ })
+}
+
+// Prompts the user before installing missing packages
+function installPackages(packages, installed, cb) {
+ const toInstallQuestions = packages
+ .filter((pack) => !installed.includes(pack))
+ .map((pack) => {
+ return {
+ message: `Install package \x1b[32m${pack}\x1b[0m ? (y/n)`,
+ answer: null,
+ name: pack,
+ }
+ })
+
+ let initialCpt = 0
+
+ installFromQuestions(toInstallQuestions, initialCpt, (packagesToInstall) => {
+ const mappedPackages = packagesToInstall
+ .filter(({ answer }) => answer === "y")
+ .map(package => package.name)
+
+ installPackagesString(mappedPackages.join(" "), cb)
+ })
+}
+
+// Compare packages given in parameters and shows those to install
+function displayPackages(packagesToShow, installed, cb) {
+ const display = packagesToShow
+ .filter((pack) => !installed.includes(pack))
+
+ const message = display.length ?
+ ` ⚡️ Package(s) to install: ${display.toString()}` : " ❌ No package to install"
+
+ output(message)
+ cb()
+}
+
+// Checks a file before deciding weither to install or display
+function checkFile(filePath, knownPackages) {
+ const file = fs.readFileSync(filePath, "utf8")
+ const packages = extractPackagesToInstall(file)
+
+ if (packages) {
+ packages.forEach((pack) => {
+ if (!knownPackages.includes(pack)) {
+ knownPackages.push(pack)
+ }
+ })
+ }
+
+ return packages
+}
+
+function checkDirectoryRecursive(path, knownPackages) {
+ let localPackages = []
+
+ fs.readdirSync(path).forEach((file) => {
+ const filePath = `${path}/${file}`
+
+ if (fs.lstatSync(filePath).isDirectory()
+ && file !== "node_modules") {
+ localPackages = localPackages.concat(checkDirectoryRecursive(`${path}/${file}`, knownPackages))
+ } else if (file.match(/\.js/gu) && !file.match(/\.json/gu)) {
+ localPackages = localPackages.concat(checkFile(filePath, knownPackages))
+ }
+ })
+
+ knownPackages = knownPackages.concat(localPackages)
+
+ return uniq(knownPackages)
+}
+
+// Checks all for packages in file(s)
+function check(path) {
+ let packages = []
+ const isDir = fs.lstatSync(path).isDirectory()
+
+ // Passing an empty array to initiate recursivity or search one file
+ packages = isDir ? checkDirectoryRecursive(path, packages) : checkFile(path, packages)
+
+ return packages
+}
+
+function getPackageJsonRecursive(packagePath, cpt) {
+ try {
+ const file = fs.readFileSync(`${process.cwd()}/${packagePath}`, "utf8")
+
+ return file
+ } catch (err) {
+ cpt++
+ // Loop recursively only 5 times then abort
+ if (cpt < 5) {
+ return getPackageJsonRecursive(`../${packagePath}`, cpt)
+ }
+
+ return null
+ }
+}
+
+// Tries to find a package.json
+function getPackageJson() {
+ let cpt = 0
+ const packageJson = getPackageJsonRecursive("package.json", cpt)
+
+ return packageJson
+}
+
+function getPackagesInstalled(cb) {
+ const packageJson = getPackageJson()
+
+ if (!packageJson) {
+ cb(new Error(" ❌ No package.json found"))
+ }
+
+ const installedPackagesObject = JSON.parse(packageJson).dependencies || {}
+ const installedPackagesArray = Object.keys(installedPackagesObject)
+
+ return installedPackagesArray
+}
+
+// Finds all packages to install in a file
+function extractPackagesToInstall(fileContent) {
+ const packages = fileContent.match(/require\(["'][A-Za-z0-9_-]+['"]\)/giu)
+
+ if (!packages) {
+ return []
+ }
+
+ // removes "require(" and ")"
+ const mappedPackages = packages.map((pack) => pack.substr(9, pack.length - 11))
+
+ return mappedPackages
+}
+
+function misuse(cb) {
+ cb(`Usage: \n${mp.usage}`);
+}
+
+function read (opts) {
+ return Bluebird.try(() => {
+ log.clearProgress()
+ return readAsync(opts)
+ }).finally(() => {
+ log.showProgress()
+ })
+}
+
+function readAnswer (msg, answer, opts, isRetry) {
+ if (isRetry && (answer === "y" || answer === "n")) {
+ return Promise.resolve(answer.trim())
+ }
+
+ return read({prompt: msg, default: answer ? `Entered: ${answer}` : ''})
+ .then((answer) => readAnswer(msg, answer, opts, true))
+}

doc/cli/npm-mp.md

@@ -0,0 +1,55 @@
+npm-mp(1) -- Find and install required packages in a file or directory
+======================================================================
+
+## SYNOPSIS
+
+ npm mp <folder>
+ npm mp <file>
+
+ common options: [i|install|c|check]
+
+## DESCRIPTION
+
+Missing-packages (mp) is a tool you will love to use whenever
+you create a NodeJS package or work in team. It is used to check that all packages
+used in a file or directory are well installed in the 'node_modules' directory.
+
+The packages to install are read in from prompts.
+
+It can be used when passing a folder from one person to another
+and automatically detect what dependencies are required for the files in the folder
+to work properly.
+
+## CONFIGURATION
+
+### check
+
+Default: none
+
+`check` is used whenever the purpose is only to know what dependency should be installed.
+
+e.g.
+ ```
+ npm mp check ./folder1
+ ```
+
+### install
+
+Default: true
+
+`install` is used whenever the purpose is to install all dependencies used in
+a file or folder that are missing in the `package.json`.
+
+e.g.
+ ```
+ npm mp i ./file42.js
+ ```
+
+## SEE ALSO
+
+* npm-registry(7)
+* npm-config(1)
+* npm-config(7)
+* npmrc(5)
+* npm-owner(1)
+* npm-whoami(1)

lib/config/cmd-list.js

@@ -60,6 +60,7 @@ var cmdList = [
  'config',
  'set',
  'get',
+ 'mp',
  'update',
  'outdated',
  'prune',

lib/mp.js

@@ -0,0 +1,228 @@
+
+/*
+ * mp - missing packages
+ *
+ * Shows what packages do not appear as dependencies in package.json
+ * within a file or a folder (multiple files) and prompts the user
+ * to install those relevant
+ */
+
+module.exports = mp
+
+const usage = require("./utils/usage")
+const output = require("./utils/output.js")
+const log = require("npmlog")
+const uniq = require("lodash.uniq")
+const fs = require("graceful-fs")
+const Bluebird = require("bluebird")
+const readAsync = Bluebird.promisify(require("read"))
+const npmInstall = require("./install")
+
+mp.usage = usage(
+ "mp",
+ "\nnpm mp <path>" +
+ "\nnpm mp install <path>" +
+ "npm mp i <path>" +
+ "\nnpm mp check <path>" +
+ "\nnpm mp c <path>"
+)
+
+function mp(args, cb) {
+ const firstParam = args.shift()
+ const secondParam = args.shift()
+ const packagesInstalled = getPackagesInstalled(cb)
+
+ if ((firstParam === "i" || firstParam === "install") && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (firstParam === "c" || firstParam === "check" && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ displayPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (fs.existsSync(`${process.cwd()}/${firstParam}`)) {
+ const filePath = `${process.cwd()}/${firstParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else {
+ misuse(cb)
+ }
+}
+
+// Installs packages
+function installPackagesString(packagesString, cb) {
+ npmInstall([packagesString], (err) => {
+ output(" ✅ Packages installed !")
+ cb()
+ })
+}
+
+function installFromQuestions(toInstallQuestions, cpt, cb) {
+ readAnswer(toInstallQuestions[cpt].message, toInstallQuestions[cpt].answer).then((answer) => {
+ toInstallQuestions[cpt].answer = answer
+
+ if(cpt === toInstallQuestions.length-1) {
+ cb(toInstallQuestions)
+ } else {
+ cpt++
+ return installFromQuestions(toInstallQuestions, cpt, cb)
+ }
+ })
+}
+
+// Prompts the user before installing missing packages
+function installPackages(packages, installed, cb) {
+ const toInstallQuestions = packages
+ .filter((pack) => !installed.includes(pack))
+ .map((pack) => {
+ return {
+ message: `Install package \x1b[32m${pack}\x1b[0m ? (y/n)`,
+ answer: null,
+ name: pack,
+ }
+ })
+
+ let initialCpt = 0
+
+ installFromQuestions(toInstallQuestions, initialCpt, (packagesToInstall) => {
+ const mappedPackages = packagesToInstall
+ .filter(({ answer }) => answer === "y")
+ .map(package => package.name)
+
+ installPackagesString(mappedPackages.join(" "), cb)
+ })
+}
+
+// Compare packages given in parameters and shows those to install
+function displayPackages(packagesToShow, installed, cb) {
+ const display = packagesToShow
+ .filter((pack) => !installed.includes(pack))
+
+ const message = display.length ?
+ ` ⚡️ Package(s) to install: ${display.toString()}` : " ❌ No package to install"
+
+ output(message)
+ cb()
+}
+
+// Checks a file before deciding weither to install or display
+function checkFile(filePath, knownPackages) {
+ const file = fs.readFileSync(filePath, "utf8")
+ const packages = extractPackagesToInstall(file)
+
+ if (packages) {
+ packages.forEach((pack) => {
+ if (!knownPackages.includes(pack)) {
+ knownPackages.push(pack)
+ }
+ })
+ }
+
+ return packages
+}
+
+function checkDirectoryRecursive(path, knownPackages) {
+ let localPackages = []
+
+ fs.readdirSync(path).forEach((file) => {
+ const filePath = `${path}/${file}`
+
+ if (fs.lstatSync(filePath).isDirectory()
+ && file !== "node_modules") {
+ localPackages = localPackages.concat(checkDirectoryRecursive(`${path}/${file}`, knownPackages))
+ } else if (file.match(/\.js/gu) && !file.match(/\.json/gu)) {
+ localPackages = localPackages.concat(checkFile(filePath, knownPackages))
+ }
+ })
+
+ knownPackages = knownPackages.concat(localPackages)
+
+ return uniq(knownPackages)
+}
+
+// Checks all for packages in file(s)
+function check(path) {
+ let packages = []
+ const isDir = fs.lstatSync(path).isDirectory()
+
+ // Passing an empty array to initiate recursivity or search one file
+ packages = isDir ? checkDirectoryRecursive(path, packages) : checkFile(path, packages)
+
+ return packages
+}
+
+function getPackageJsonRecursive(packagePath, cpt) {
+ try {
+ const file = fs.readFileSync(`${process.cwd()}/${packagePath}`, "utf8")
+
+ return file
+ } catch (err) {
+ cpt++
+ // Loop recursively only 5 times then abort
+ if (cpt < 5) {
+ return getPackageJsonRecursive(`../${packagePath}`, cpt)
+ }
+
+ return null
+ }
+}
+
+// Tries to find a package.json
+function getPackageJson() {
+ let cpt = 0
+ const packageJson = getPackageJsonRecursive("package.json", cpt)
+
+ return packageJson
+}
+
+function getPackagesInstalled(cb) {
+ const packageJson = getPackageJson()
+
+ if (!packageJson) {
+ cb(new Error(" ❌ No package.json found"))
+ }
+
+ const installedPackagesObject = JSON.parse(packageJson).dependencies || {}
+ const installedPackagesArray = Object.keys(installedPackagesObject)
+
+ return installedPackagesArray
+}
+
+// Finds all packages to install in a file
+function extractPackagesToInstall(fileContent) {
+ const packages = fileContent.match(/require\(["'][A-Za-z0-9_-]+['"]\)/giu)
+
+ if (!packages) {
+ return []
+ }
+
+ // removes "require(" and ")"
+ const mappedPackages = packages.map((pack) => pack.substr(9, pack.length - 11))
+
+ return mappedPackages
+}
+
+function misuse(cb) {
+ cb(`Usage: \n${mp.usage}`);
+}
+
+function read (opts) {
+ return Bluebird.try(() => {
+ log.clearProgress()
+ return readAsync(opts)
+ }).finally(() => {
+ log.showProgress()
+ })
+}
+
+function readAnswer (msg, answer, opts, isRetry) {
+ if (isRetry && (answer === "y" || answer === "n")) {
+ return Promise.resolve(answer.trim())
+ }
+
+ return read({prompt: msg, default: answer ? `Entered: ${answer}` : ''})
+ .then((answer) => readAnswer(msg, answer, opts, true))
+}

doc/cli/npm-mp.md

@@ -0,0 +1,55 @@
+npm-mp(1) -- Find and install required packages in a file or directory
+======================================================================
+
+## SYNOPSIS
+
+ npm mp <folder>
+ npm mp <file>
+
+ common options: [i|install|c|check]
+
+## DESCRIPTION
+
+Missing-packages (mp) is a tool you will love to use whenever
+you create a NodeJS package or work in team. It is used to check that all packages
+used in a file or directory are well installed in the 'node_modules' directory.
+
+The packages to install are read in from prompts.
+
+It can be used when passing a folder from one person to another
+and automatically detect what dependencies are required for the files in the folder
+to work properly.
+
+## CONFIGURATION
+
+### check
+
+Default: none
+
+`check` is used whenever the purpose is only to know what dependency should be installed.
+
+e.g.
+ ```
+ npm mp check ./folder1
+ ```
+
+### install
+
+Default: true
+
+`install` is used whenever the purpose is to install all dependencies used in
+a file or folder that are missing in the `package.json`.
+
+e.g.
+ ```
+ npm mp i ./file42.js
+ ```
+
+## SEE ALSO
+
+* npm-registry(7)
+* npm-config(1)
+* npm-config(7)
+* npmrc(5)
+* npm-owner(1)
+* npm-whoami(1)

lib/config/cmd-list.js

@@ -60,6 +60,7 @@ var cmdList = [
  'config',
  'set',
  'get',
+ 'mp',
  'update',
  'outdated',
  'prune',

lib/mp.js

@@ -0,0 +1,228 @@
+
+/*
+ * mp - missing packages
+ *
+ * Shows what packages do not appear as dependencies in package.json
+ * within a file or a folder (multiple files) and prompts the user
+ * to install those relevant
+ */
+
+module.exports = mp
+
+const usage = require("./utils/usage")
+const output = require("./utils/output.js")
+const log = require("npmlog")
+const uniq = require("lodash.uniq")
+const fs = require("graceful-fs")
+const Bluebird = require("bluebird")
+const readAsync = Bluebird.promisify(require("read"))
+const npmInstall = require("./install")
+
+mp.usage = usage(
+ "mp",
+ "\nnpm mp <path>" +
+ "\nnpm mp install <path>" +
+ "npm mp i <path>" +
+ "\nnpm mp check <path>" +
+ "\nnpm mp c <path>"
+)
+
+function mp(args, cb) {
+ const firstParam = args.shift()
+ const secondParam = args.shift()
+ const packagesInstalled = getPackagesInstalled(cb)
+
+ if ((firstParam === "i" || firstParam === "install") && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (firstParam === "c" || firstParam === "check" && fs.existsSync(`${process.cwd()}/${secondParam}`)) {
+ const filePath = `${process.cwd()}/${secondParam}`
+ const packagesToInstall = check(filePath)
+
+ displayPackages(packagesToInstall, packagesInstalled, cb)
+ } else if (fs.existsSync(`${process.cwd()}/${firstParam}`)) {
+ const filePath = `${process.cwd()}/${firstParam}`
+ const packagesToInstall = check(filePath)
+
+ installPackages(packagesToInstall, packagesInstalled, cb)
+ } else {
+ misuse(cb)
+ }
+}
+
+// Installs packages
+function installPackagesString(packagesString, cb) {
+ npmInstall([packagesString], (err) => {
+ output(" ✅ Packages installed !")
+ cb()
+ })
+}
+
+function installFromQuestions(toInstallQuestions, cpt, cb) {
+ readAnswer(toInstallQuestions[cpt].message, toInstallQuestions[cpt].answer).then((answer) => {
+ toInstallQuestions[cpt].answer = answer
+
+ if(cpt === toInstallQuestions.length-1) {
+ cb(toInstallQuestions)
+ } else {
+ cpt++
+ return installFromQuestions(toInstallQuestions, cpt, cb)
+ }
+ })
+}
+
+// Prompts the user before installing missing packages
+function installPackages(packages, installed, cb) {
+ const toInstallQuestions = packages
+ .filter((pack) => !installed.includes(pack))
+ .map((pack) => {
+ return {
+ message: `Install package \x1b[32m${pack}\x1b[0m ? (y/n)`,
+ answer: null,
+ name: pack,
+ }
+ })
+
+ let initialCpt = 0
+
+ installFromQuestions(toInstallQuestions, initialCpt, (packagesToInstall) => {
+ const mappedPackages = packagesToInstall
+ .filter(({ answer }) => answer === "y")
+ .map(package => package.name)
+
+ installPackagesString(mappedPackages.join(" "), cb)
+ })
+}
+
+// Compare packages given in parameters and shows those to install
+function displayPackages(packagesToShow, installed, cb) {
+ const display = packagesToShow
+ .filter((pack) => !installed.includes(pack))
+
+ const message = display.length ?
+ ` ⚡️ Package(s) to install: ${display.toString()}` : " ❌ No package to install"
+
+ output(message)
+ cb()
+}
+
+// Checks a file before deciding weither to install or display
+function checkFile(filePath, knownPackages) {
+ const file = fs.readFileSync(filePath, "utf8")
+ const packages = extractPackagesToInstall(file)
+
+ if (packages) {
+ packages.forEach((pack) => {
+ if (!knownPackages.includes(pack)) {
+ knownPackages.push(pack)
+ }
+ })
+ }
+
+ return packages
+}
+
+function checkDirectoryRecursive(path, knownPackages) {
+ let localPackages = []
+
+ fs.readdirSync(path).forEach((file) => {
+ const filePath = `${path}/${file}`
+
+ if (fs.lstatSync(filePath).isDirectory()
+ && file !== "node_modules") {
+ localPackages = localPackages.concat(checkDirectoryRecursive(`${path}/${file}`, knownPackages))
+ } else if (file.match(/\.js/gu) && !file.match(/\.json/gu)) {
+ localPackages = localPackages.concat(checkFile(filePath, knownPackages))
+ }
+ })
+
+ knownPackages = knownPackages.concat(localPackages)
+
+ return uniq(knownPackages)
+}
+
+// Checks all for packages in file(s)
+function check(path) {
+ let packages = []
+ const isDir = fs.lstatSync(path).isDirectory()
+
+ // Passing an empty array to initiate recursivity or search one file
+ packages = isDir ? checkDirectoryRecursive(path, packages) : checkFile(path, packages)
+
+ return packages
+}
+
+function getPackageJsonRecursive(packagePath, cpt) {
+ try {
+ const file = fs.readFileSync(`${process.cwd()}/${packagePath}`, "utf8")
+
+ return file
+ } catch (err) {
+ cpt++
+ // Loop recursively only 5 times then abort
+ if (cpt < 5) {
+ return getPackageJsonRecursive(`../${packagePath}`, cpt)
+ }
+
+ return null
+ }
+}
+
+// Tries to find a package.json
+function getPackageJson() {
+ let cpt = 0
+ const packageJson = getPackageJsonRecursive("package.json", cpt)
+
+ return packageJson
+}
+
+function getPackagesInstalled(cb) {
+ const packageJson = getPackageJson()
+
+ if (!packageJson) {
+ cb(new Error(" ❌ No package.json found"))
+ }
+
+ const installedPackagesObject = JSON.parse(packageJson).dependencies || {}
+ const installedPackagesArray = Object.keys(installedPackagesObject)
+
+ return installedPackagesArray
+}
+
+// Finds all packages to install in a file
+function extractPackagesToInstall(fileContent) {
+ const packages = fileContent.match(/require\(["'][A-Za-z0-9_-]+['"]\)/giu)
+
+ if (!packages) {
+ return []
+ }
+
+ // removes "require(" and ")"
+ const mappedPackages = packages.map((pack) => pack.substr(9, pack.length - 11))
+
+ return mappedPackages
+}
+
+function misuse(cb) {
+ cb(`Usage: \n${mp.usage}`);
+}
+
+function read (opts) {
+ return Bluebird.try(() => {
+ log.clearProgress()
+ return readAsync(opts)
+ }).finally(() => {
+ log.showProgress()
+ })
+}
+
+function readAnswer (msg, answer, opts, isRetry) {
+ if (isRetry && (answer === "y" || answer === "n")) {
+ return Promise.resolve(answer.trim())
+ }
+
+ return read({prompt: msg, default: answer ? `Entered: ${answer}` : ''})
+ .then((answer) => readAnswer(msg, answer, opts, true))
+}