tombyrer / nodist

Natural node and io.js version manager for windows.

nodist

A node.js and io.js version manager for the windows folks out there. Inspired by n. And nodenv.

> nodist 0.10
nodev0.10.26

> node -v
v0.10.26

> nodist
  nodev0.10.24
  nodev0.10.25
> nodev0.10.26 (global)
  nodev0.11.11
  nodev0.11.12
  iojsv2.3.4

(see Usage)

Installation

Nodist was designed to replace any existing node.js installation, so if node is already installed on your machine, uninstall it first.

Installing with the official installer

1. Download the installer here
2. Run the installer and follow the install wizard

Migrating from <=0.6 to 0.7

If you're looking to upgrade your Nodist installation, the easiest way is to uninstall (see below) the old installation and install the new version with the installer above.

Uninstall (<v0.7)

1. Remove <..path..>\nodist\bin from your path. (how?).

2. Remove the NODIST_PREFIX env var.

3. Delete the nodist directory

4. Run npm config delete prefix on the command prompt to restore NPM functionality if you are going back to the official node install.

Usage

Nodist understands version patterns, like 0.8 or 0.8.x or ~0.8 as well as 0.8.12 or v0.8.12. As an added bonus, you may also use latest and stable. When dealing with io.js versions you need to use the following: iojsv2.x and iojs-latest.

Btw, nodist also works in your PowerShell, but you might first need to 'Unblock' the file \bin\nodist.ps1.

Commands

All commands implicitly install the specified version before using it, if it's not installed already.

> nodist
# Lists installed versions highlighting the active one.

> nodist 0.8.1
# Sets the global node version.

> nodist local 0.8.1
# Sets the node version per directory (including subdirectories).

> nodist env v0.7.12
# Sets the node version per terminal.

call nodist env 0.7.12
# In a batch script use `call`.

> nodist dist
# Lists all available node versions.

> nodist r v0.8.1 -- foo.js -s
# Runs a specific version without modifying any state.

> nodist + v0.8.1
# Just checks, if the version is installed and downloads it if not.

> nodist + all
# will install *everything*.

> nodist - 0.5.10
# Removes a version.

> nodist --help
# Displays a complete list of commands with examples.

Settings

> set HTTP_PROXY=http://myproxy.com:8213
# Set a proxy to use for fetching the executables
# (you may also use `HTTP_PROXY`/`http_proxy`/`HTTPS_PROXY`/`https_proxy`).

> set NODIST_X64=0
# Override x64 auto-detection.
# (Set to `1` to enforce 64bit, `0` to enforce 32bit.)

Details

Node executables are stored in NODIST_PREFIX\v and NODIST_PREFIX\v-x64. The global node.exe is a shim and chooses the right node version to run based on the various version settings:

• global -- NODIST_PREFIX\.node-version contains the global node version
• local -- ./.node-version in the current working directory contains the local node verison
• env -- NODIST_VERSION containst the environmental node version

The latest npm version is available out of the box.

As the global node version will be subject to change, nodist comes with its own dedicated node binary.

Got ideas? Doesn't work for you? Want to give feedback?

File an issue and tell me what you'd change or add or what doesn't work for you. Every issue is welcome!

Testing

The default test suite can be ran using npm

$ npm test

For development a more interactive test method might be best

$ npm -g install vows
$ vows --spec test\cli-test.js

To see nodist output during tests try this

$ set DEBUG=nodist*
$ set TEST=test
$ vows --spec test\cli-test.js

Testing also accepts env variables for using a mirror to download from.

$ set NODIST_NODE_MIRROR=http://nodejs.serverpals.com/dist
$ vows --spec test\cli-test.js

Debugging

All debug logging now uses the https://github.com/visionmedia/debug package.

The following can be used to see all messages (typically used in dev)

$ DEBUG=nodist node app

Legal

Copyright (c) 2012-2014 by Marcel Klehr
MIT License

Changelog

v0.7.2

• New build with the correct version of NPM

v0.7.1

• Fix x64 support

v0.7.0 (thanks to @nullivex)

• Add support for hashing downloading binaries and comparing to upstream
• Code refactor to implement standards similar to npmjs style
• Implement download progress bar
• Add debugging output to aid in development and issue handling
• Bump NPM version to 3.3.8
• Improve testing and offer ability to see test output
• Testing now accepts mirror env variables
• Env variables can now be used to point nodist at a mirror
• Only downloads binaries from HTTPS now as node is phasing out HTTP support

v0.6.1

• Fix for node v4 dist directory structure (thanks to @jakub-g)

v0.6.0

• Write out version spec that's being used, to make version errors more intuitive. (thanks to @blzaugg)
• Fix replace for nodistPrefix and envVersion (thanks to @sdovenor)
• Fix chocolatey package (thanks to @u9520107)
• Add support for io.js

v0.5.2

• Fix nodist version

v0.5.1

• Fix npm prefix in nodist selfupdate

v0.5.0

• Use a binary shim
• Support for localized version switching

v0.4.8

• Check in dependencies to avoid relying on npm on install

v0.4.7

• Update bundled npm to v1.4.6 and check-in all files

v0.4.6

• Update pre-packaged npm to v1.4.3

v0.4.5

• Fix nodist -v in powershell (thanks to @devert for reporting)

v0.4.4

• Fix GOTO in batch file (thanks to @BergWerkGIS)

v0.4.3

• Fix a type coercion catch in x64 detection (NODIST_X64=0 had the same effect as NODIST_X64=1; thanks to @springmeyer for reporting)

v0.4.2

• Use the right URI for fetching the x64 executables

v0.4.1

• x64 auto-detection

v0.4.0

• Refactor 64bit support (All commands now work with x64 versions)
• Make npm use the user-chosen node version (thanks to @k-j-kleist for reporting)
• Fix some minor bugs in error handling
• Don't try installing 'vUpdate' after running nodist update
• Install latest stable version after running nodist update

v0.3.11

• Fix 'use' command in powershell (thanks to @paulbatum for reporting)

v0.3.10

• Fix 'use' by fixing 'path' and 'bin' commands

v0.3.9

• Fix renaming mistake (thanks to @paulbatum for reporting)
• Tighten nodist update

v0.3.8

• Add support for x64 versions (thanks to @CycoPH)
• Improve performance by caching version lists

v0.3.7

• Fix nodist run and list commands
• Allow people to use an http proxy (thanks to @gratex)

v0.3.5

• Fix install script. How did that go astray?

v0.3.4

• Fix error message if n.checkout fails

v0.3.3

• Fix installer (thanks to @Ciantic for reporting)
• Fix a bug introduced by npm update

v0.3.2

• Update npm on install/update

v0.3.1

• Optimized nodist + all
• Use a clean npm
• Don't bundle dependencies, anymore -- nodist update must be run at install

v0.3.0

• Dropped optimist (caused more problems than it solved)
• Using node-semver, now, for better usability... (fixes #10)
• Allow use of version patterns for every command (fixes #9)
• Fix issue #8: Version patterns should require internet access

v0.2.8

• Fix use command

v0.2.7

• Deploy by copying node.exe, again, this should allow people to use nodist together with nodemon

v0.2.6

• Fix a bug, that used to break everything on Win7 x64

v0.2.5

• Updated npm to v1.1.48

v0.2.4

• Fix nodist update command to work from all drives
• Add basic support for MinGW shell (thanks to jdiamond) (update and use commands are still missing)
• Fix tests
• Allow npm updates with npm u npm -g
• updated npm

v0.2.3

• Install latest stable as default version
• Add update command
• Updated npm