@shadowspawn/nvh - npm Package Compare versions

Comparing version 6.1.0 to 6.2.0

CHANGELOG.md

@@ -10,2 +10,20 @@ # Changelog
 
+## [6.2.0] (2019-01-02)
+
+## Added
+
+- `nvh exec <version> <command> [args]` executes command with PATH modified, allowing running scripts or commands using cached node and npm. (So like `nvh run` but more general.)
+
+### Changed
+
+- `docs` directory name changed to `doc`
+- dev: make `bats` a dev dependency rather than use global install
+- dev: major refactor of tests and scripts
+- dev: tests more self-contained (and easier to run)
+
+
+## Fixed
+
+- invalid version error handling for `nvh run` and `nvh which`
+
 ## [6.1.0] (2018-12-10)
@@ -228,2 +246,3 @@
 [Unreleased]: https://github.com/JohnRGee/nvh/compare/master...develop
+[6.2.0]: https://github.com/JohnRGee/nvh/compare/v6.1.0...JohnRGee:v6.2.0
 [6.1.0]: https://github.com/JohnRGee/nvh/compare/v6.0.4...JohnRGee:v6.1.0
@@ -230,0 +249,0 @@ [6.0.3]: https://github.com/JohnRGee/nvh/compare/v6.0.3...JohnRGee:v6.0.4

package.json

 {
   "name": "@shadowspawn/nvh",
   "description": "Node Version Helper. Easily install Node.js versions.",
-  "version": "6.1.0",
+  "version": "6.2.0",
   "author": "John Gee",
@@ -29,5 +29,9 @@ "homepage": "https://github.com/JohnRGee/nvh",
     "lint": "shellcheck bin/nvh",
-    "release": "scripts/release"
+    "test": "test/bin/run-all-tests",
+    "release": "bin/release"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "devDependencies": {
+    "bats": "^1.1.0"
+  }
 }

README.md

@@ -9,13 +9,14 @@ # Node Version Helper
 
-Forked from [tj/n](https://github.com/tj/n) with [changes to command syntax](docs/coming-from-n.md), bug fixes, and new features.
+Forked from [tj/n](https://github.com/tj/n) with [changes to command syntax](doc/coming-from-n.md), bug fixes, and new features.
 
 - [Node Version Helper](#node-version-helper)
-  - [Installation](#installation)
-  - [Installing Node Versions](#installing-node-versions)
-  - [Specifying Node Versions](#specifying-node-versions)
-  - [Using Downloaded Node Versions Without Reinstalling](#using-downloaded-node-versions-without-reinstalling)
-  - [Preserving npm](#preserving-npm)
-  - [Miscellaneous](#miscellaneous)
-  - [Optional Environment Variables](#optional-environment-variables)
-  - [Alternatives to `nvh`](#alternatives-to-nvh)
+    - [Installation](#installation)
+    - [Installing Node Versions](#installing-node-versions)
+    - [Specifying Node Versions](#specifying-node-versions)
+    - [Using Downloaded Node Versions Without Reinstalling](#using-downloaded-node-versions-without-reinstalling)
+    - [Preserving npm](#preserving-npm)
+    - [Miscellaneous](#miscellaneous)
+    - [Optional Environment Variables](#optional-environment-variables)
+    - [How It Works](#how-it-works)
+    - [Alternatives to `nvh`](#alternatives-to-nvh)
 
@@ -84,3 +85,3 @@ ## Installation
 
-There are two commands for working directly with your downloaded versions of `node`, without reinstalling.
+There are three commands for working directly with your downloaded versions of `node`, without reinstalling.
 
@@ -96,2 +97,8 @@ You can show the path to the downloaded version:
 
+Or execute a command with `PATH` modified so `node` and `npm` will be from the downloaded `node` version.
+(NB: this `npm` will be working with a different and empty global node_modules directory, and you should not install global
+modules this way.)
+
+    nvh exec 10 my-script --fast test
+
 ## Preserving npm
@@ -148,3 +155,3 @@
 
-See [Environment Variables](docs/environment-variables.md) for more about these settings:
+See [Environment Variables](doc/environment-variables.md) for more about these settings:
 
@@ -155,6 +162,15 @@ NVH_NODE_MIRROR
 
-See [Proxy Server](docs/proxy-server.md) for variables and advice for using a proxy server.
+See [Proxy Server](doc/proxy-server.md) for variables and advice for using a proxy server.
 
     https_proxy
 
+## How It Works
+
+`nvh` downloads a prebuilt `node` package and installs to a single prefix (e.g. `/usr/local`). This overwrites the previous version. The `bin` folder in this location should be in your `PATH` (e.g. `/usr/local/bin`).
+
+The downloads are kept in a cache folder to be used for reinstalls. The downloads are also available for limited use using `nvh which` and `nvh run` and `nvh exec`.
+
+The global `npm` packages are not changed by the install, with the 
+exception of `npm` itself which by default is part of the `node` install.
+
 ## Alternatives to `nvh`
@@ -161,0 +177,0 @@

No alert changes

Improved metrics

Total package byte prevSize

48966

increased by4.24%

Number of lines in readme file

186

increased by9.41%

Worsened metrics

Dev dependency count

1

increased byInfinity%

No dependency changes