check-installed 2.0.2 → 2.1.1

package/README.md

@@ -2,63 +2,105 @@
 Minimal Node package to check that dependencies are installed ✅
 
 [![npm](https://img.shields.io/npm/v/check-installed)](https://www.npmjs.com/package/check-installed)
+[![pipeline status](https://gitlab.com/flippidippi/check-installed/badges/main/pipeline.svg)](https://gitlab.com/flippidippi/check-installed/-/pipelines?ref=main)
+[![coverage report](https://gitlab.com/flippidippi/check-installed/badges/main/coverage.svg)](https://check-installed-flippidippi-09a6e441a6dd0a7a65f32f5fe3ec449245f.gitlab.io/coverage)
 
 ## Install
 ```bash
 $ npm i check-installed --save-dev
 ```
 
-## Usage
-- Run this before npm scripts to make sure that the environment is set up correctly
-- It checks that engines and node modules are installed and are the correct versions
+## Checks
+### Engines Check
+- Compares the installed version of engines to the versions specified in `package.json`
+- Engines can be things like node, dotnet, or anything that responds to `--version`
 - Version are checked with `semver.satisfies()`, so you can use any valid semver range
   - See [semver](https://www.npmjs.com/package/semver) for more info
-
-### Engine Check
-- Compares the installed version of an engine to the version specified in `package.json`
-- Engines can be things like node, dotnet, or anything that responds to `--version`
-
-### Node Module Check
-- Compares the installed version of a node module to the version specified in `package.json`
-- Versions for modules that have `latest` are not checked, only that they are installed
-- Optional node module dependencies are only checked if they are installed
-- Git URL versions are skipped
-
-## Example
-In `package.json`:
 ```json
   "engines": {
     "node": ">=12.x",
     "npm": ">=6",
     "dotnet": "^6.0.410"
   },
+```
+
+### Modules Check
+- Compares the installed versions of node modules to the versions specified in `package.json`
+- Versions for modules that have `latest` are not checked, only that they are installed
+- Optional node module dependencies are only checked if they are installed
+- Git URL versions are skipped
+
+## Usage
+
+### CLI
+Run `check-installed` before npm scripts or directly to ensure that the environment is set up correctly.
+If any check fails, the process will throw and exit with a non-zero exit code.
+
+#### NPM Scripts
+You can add a check script and run with `npm run check` or call it from other commands:
+```json
   "scripts": {
     "check": "check-installed",
-    "start": "npm run check && node index.js"
+    "start": "npm run check && node index.js",
+    "test": "npm run check && jest"
   }
 ```
+This repo actually uses `check-installed` directly 🤯.
 
-## Options
-- Use `npx` to test out options like: `npx check-installed --help`
-- Update `package.json` to use options like:
-```json
-    "check": "check-installed --show-engines"
+#### Command Line
+```bash
+npx check-installed
+```
+
+### API
+You can call the checks directly from node programatically if needed like:
+```js
+const { checkEngines, checkModules } = require('check-installed')
+const json = require('./package.json')
+
+await checkEngines(json)
+await checkModules(json)
+await checkEngines(json, { showEngines: true })
+await checkModules(json, { showSuccess: true })
 ```
+Each check returns a `Promise<void>` that throws if any check fails.
+They are typed to accept the entire `options` object, but only use options they need.
 
-#### `--help`
+### Options
+- All options are optional and will be defaulted
+- CLI formats to change default values:
+  - `boolean`:
+    - `true`: `--option-name` or `--option-name=true`
+    - `false`: `--option-name=false` or `--option-name=` or `--option-name=anythingelse`
+  - `string`: `--option-name=value`
+- Options for `checkEngines` and `checkModules` are the same as CLI options but `camelCased`
+
+### `--help`
 Show help (skips check)
 
-#### `--skip-engines`
+*Type: `boolean`, Default: `false`*
+
+### `--skip-engines`
 Skip checking engines
 
-#### `--skip-modules`
+*Type: `boolean`, Default: `false`*
+
+### `--skip-modules`
 Skip checking node modules
 
-#### `--show-success`
+*Type: `boolean`, Default: `false`*
+
+### `--show-success`
 Show success message on successful checks
 
-#### `--show-engines`
+*Type: `boolean`, Default: `false`*
+
+### `--show-engines`
 Show installed engines on successful check
 
+*Type: `boolean`, Default: `false`*
+
 ### `--show-modules`
 Show installed node modules on successful check
+
+*Type: `boolean`, Default: `false`*

package/bin/check-installed

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require("../index").cli();
+require('../index').cli()

package/index.js

@@ -1,49 +1,9 @@
-const { HELP, OPTIONS } = require('./lib/constants')
+const { cli } = require('./lib/cli')
 const { checkEngines } = require('./lib/checkEngines')
 const { checkModules } = require('./lib/checkModules')
 
-/**
- * Get options from CLI arguments
- * @param {string[]} args - CLI arguments
- * @returns {typeof OPTIONS} - Options for the CLI with defaults
- */
-function getOptions (args) {
-  const options = { ...OPTIONS }
-
-  for (const arg of args) {
-    if (arg.startsWith('--')) {
-      const [key, value] = arg.slice(2).split('=')
-      const keyCamelCase = key.replace(/-([a-z])/g, (_, c) => c.toUpperCase())
-
-      if (options[keyCamelCase] != null) {
-        options[keyCamelCase] = value ?? true
-      }
-    }
-  }
-
-  return options
+module.exports = {
+  cli,
+  checkEngines,
+  checkModules
 }
-
-/**
- * check-installed CLI entry point
- * @param {string[]} argv - CLI arguments
- */
-async function cli (argv = process.argv) {
-  const args = argv.slice(2)
-  const options = getOptions(args)
-
-  if (options.help) {
-    console.log(HELP)
-    return
-  }
-
-  if (!options.skipEngines) {
-    await checkEngines(options)
-  }
-
-  if (!options.skipModules) {
-    await checkModules(options)
-  }
-}
-
-exports.cli = cli

package/lib/checkEngines.js

@@ -1,6 +1,6 @@
 const { spawn } = require('child_process')
-const { resolve } = require('path')
 const semver = require('semver')
+const { OPTIONS } = require('./constants')
 
 /**
  * Get the version of an engine
@@ -51,11 +51,12 @@ async function checkEngineVersion (name, version) {
 
 /**
  * Checks engines in `package.json` are installed
- * @param {typeof import('./constants').OPTIONS} options - Options for the CLI
+ * @param {object} json - The `package.json` JSON object
+ * @param {Partial<typeof import('./constants').OPTIONS>} options - Options for the CLI
+ * @returns {Promise<void>} - Resolves when all engines are checked (throws on check fail)
  */
-async function checkEngines (options) {
-  const { showSuccess, showEngines } = options
-  const json = require(resolve(process.cwd(), 'package.json'))
+async function checkEngines (json = {}, options) {
+  const { showSuccess, showEngines } = { ...OPTIONS, ...options }
 
   // Check engines
   const engines = await Promise.all(

package/lib/checkModules.js

@@ -1,6 +1,7 @@
 const { resolve } = require('path')
 const fs = require('fs')
 const semver = require('semver')
+const { OPTIONS } = require('./constants')
 
 /**
  * Regex used to extract the real name and version from an npm alias
@@ -53,11 +54,12 @@ function checkModuleVersion (name, version, optional) {
 
 /**
  * Checks node modules in `package.json` are installed
- * @param {typeof import('./constants').OPTIONS} options - Options for the CLI
+ * @param {object} json - The `package.json` JSON object
+ * @param {Partial<typeof import('./constants').OPTIONS>} options - Options for the CLI
+ * @returns {Promise<void>} - Resolves when all modules are checked (throws on check fail)
  */
-async function checkModules (options) {
-  const { showSuccess, showModules } = options
-  const json = require(resolve(process.cwd(), 'package.json'))
+async function checkModules (json = {}, options) {
+  const { showSuccess, showModules } = { ...OPTIONS, ...options }
 
   // Check modules
   const modules = [

package/lib/cli.js

@@ -0,0 +1,68 @@
+const { resolve } = require('path')
+const { HELP, OPTIONS } = require('./constants')
+const { checkEngines } = require('./checkEngines')
+const { checkModules } = require('./checkModules')
+
+/**
+ * Get options from CLI arguments
+ * @param {string[]} args - CLI arguments
+ * @returns {typeof OPTIONS} - Options for the CLI with defaults
+ */
+function getOptions (args) {
+  const options = {}
+
+  for (const arg of args) {
+    if (arg.startsWith('--')) {
+      const [key, value] = arg.slice(2).split('=')
+      const keyCamelCase = key.replace(/-([a-z])/g, (_, c) => c.toUpperCase())
+      const option = OPTIONS[keyCamelCase]
+
+      // Only set if the option is defined in `OPTIONS`
+      if (option !== undefined) {
+        let newValue
+
+        // If boolean, `true` only if no value or value is "true"
+        // Otherwise, only if value provided
+        if (typeof option === 'boolean') {
+          newValue = value == null ? true : value === 'true'
+        } else if (value != null) {
+          newValue = value
+        }
+
+        // Set only if valid and not already default
+        if (newValue !== undefined && newValue !== option) {
+          options[keyCamelCase] = newValue
+        }
+      }
+    }
+  }
+
+  return options
+}
+
+/**
+ * check-installed CLI entry point
+ * @param {string[]} argv - CLI arguments
+ * @returns {Promise<void>} - Promise that resolves when the CLI is done (throws on check fail)
+ */
+async function cli (argv = process.argv) {
+  const json = require(resolve(process.cwd(), 'package.json'))
+  const options = getOptions(argv.slice(2))
+
+  if (options.help) {
+    console.log(HELP)
+    return
+  }
+
+  if (!options.skipEngines) {
+    await checkEngines(json, options)
+  }
+
+  if (!options.skipModules) {
+    await checkModules(json, options)
+  }
+}
+
+module.exports = {
+  cli
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "check-installed",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "description": "Minimal Node package to check that dependencies are installed ✅",
   "author": "Phillip Lanclos <check-installed@flippidippi.com>",
   "license": "Unlicense",
@@ -35,7 +35,10 @@
     "check": "./bin/check-installed",
     "lint": "standard",
     "lint:fix": "npm run lint -- --fix",
-    "test": "npm run check",
+    "test": "npm run check && jest",
+    "test:coverage": "npm run test -- --coverage",
+    "test:watch": "npm run test -- --watch",
+    "test:ci": "npm run test:coverage -- --ci --reporters=default --reporters=jest-junit",
     "prepare": "husky install"
   },
   "dependencies": {
@@ -43,6 +46,25 @@
   },
   "devDependencies": {
     "husky": "^8.0.3",
+    "jest": "^29.7.0",
+    "jest-junit": "^16.0.0",
     "standard": "^17.1.0"
+  },
+  "standard": {
+    "env": [
+      "jest"
+    ]
+  },
+  "jest": {
+    "collectCoverageFrom": [
+      "index.js",
+      "lib/**/*.js"
+    ],
+    "coverageReporters": [
+      "html",
+      "text",
+      "text-summary",
+      "cobertura"
+    ]
   }
 }