All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

• --cleanup option to delete cached version after install for a one-shot install (#818)
• download command to download Node.js version into cache (#821)
• document using --download with run/exec/which in README
• support trailing comments in .nvmrc file (#820)
• mask password in download URL when displayed (#815)

• removed stale code (#817)

The major version bump is due to using jq in preference to node for reading package.json.

• if jq is available, use jq for reading engines from package.json instead of using node (#810)
• avoid a network lookup if auto or engine find a fully specified numeric version. (#813)

• avoid problems with curl 8.7.1 and --compressed by removing option until fixed

(No changes.)

• n doctor works with custom N_CACHE_PREFIX

• expand tests in n doctor for folder existence and permissions

• --offline for resolving target version against cached downloads instead of internet lookup (#785)

• check for possible problem with multiple npm locations when running n doctor (#764)

• Makefile compatible with more flavours of make (#745)
• quote paths in Makefile in case PREFIX contains spaces (#746)

• --preserve preserves corepack too (#736)

• optional N_PRESERVE_COREPACK to change default behaviour for preserving corepack (#736)

• log before copying files during install (#720)

• optional N_CACHE_PREFIX for separate location for downloaded files than install location (#717)

• improved warning message when utility location hash may be holding old location to cover a wider range of shells including dash (#707)

• improve error handling for tar extraction errors (#701)
• add tar flag for compatibility with tar builds which do not default to stdin (#697)

• display error if version missing in version file for n auto and n engine (rather than fallback to current) (#693)

• support for Corepack (which was added to Node.js in v16.9.0)

• run commands from correct directory after --download causes a download

• support for --download option to run and exec to download the target version when needed (#685)

• Improved README for new users missing expected folders in /usr/local (#679)

• ls-remote supports engine and auto labels (#675)
• reduce engine and auto logging with --quiet (#675)
• add WSL support to README (#676)
• support for Emacs up and down keys (ctrl-p and ctrl-n) (#669)

• diagnostic logging during processing of engine and auto written to stderr rather than stdout (#675)

• arrow key navigation of version menu when terminal in application mode (e.g. PowerShell on Mac) (#668)

• install native arm64 Node.js on Macs with Apple silicon for Node.js 16 and higher (#664)

Released off wrong branch, essentially same as 7.1.0.

• support installs where /usr/local/share/man is a symlink (such as archlinux)
• remove requirement for rsync for --preserve
• avoid install pollution if user installs global packages when using n exec

• consistently log to STDOUT (#654)

• update bats, and use bats-assert for better unit test failure messages

• fail to display error in some cases for missing both curl and wget (#649)

• auto label now scans for package.json only if it can not find a version control file (#644)

• engine label to look for engines.node in package.json (as used byauto) (#644)

• avoid colorized grep output via GREP_OPTIONS breaking version lookup (#643)

• suppress unwanted warning during auto when using npx with npm 7
• temporary fix for installing on Mac with Apple M1 chip, look for x64 versions of node as arm64 not available yet

• detect and handle a failed download of full archive (#635)

• auto support for:
  • .node-version
  • .nvmrc
  • engines field of package.json

• labels for node support aliases, such as lts_latest

• Enable xz support by default for macOS 11+ (#624)

• specify auto to read the target version from a .n-node-version file (i.e. change filename)

• specify auto to read the target version from a .node-version file (#616)

• treat armv8l as arm64 (#614)

• remove old version of node before copy to avoid firewall issues on macOS (#394)

• --preserve to preserve npm and npx during install of node (#587)

• Downloads now default to using tarballs compressed by xz over gzip, if xz support detected. (#606 #607)

• added How It Works to README

• simplified layout for n doctor output

• advice to reset command hash when node location changes (#170 #381 #451 #588)
• in README describe raw download of n to bootstrap install of node and npm

• Specify --no-same-owner for tarball extraction so cache files not owned by unexpected user (when run with sudo) (#593)

• deletion of cached versions from menu using 'd' (#590)

• allow options to come after commands, especially n lsr --all

• version specified using release stream codenames, like argon (#423)
• version specified using nightly et al (#376)
• n exec for running arbitrary command with node and npm in PATH (#185)
• n run with legacy aliases of as and use
• n lsr for listing matching remote versions, limited to 20 by default (#383)
• n doctor for displaying diagnostic information
• n install for people used to other products with this command (#524)
• --insecure to disable curl/wget certificate checks
• added npm version to installed message (#210 #484 #574)

• Breaking wget now checks certificates (secure by default, same as curl setup). (#475 #509)
• failure messages go to stderr instead of stdout
• prefixed N_NODE_MIRROR to eventually replace NODE_MIRROR
• Breaking n ls now lists local download versions (rather than remote versions)
• lookup available versions using index.tab rather than screen-scraping (#560)

• download errors display informative message, instead of just Invalid version (#482 #492 et al)
• improve reliability of downloads from custom node mirrors, including removing broken is_oss_ok (#560)
• restrict downloads to versions with architecture available (#463)

• Breaking support for PROJECT_NAME and PROJECT_URL for custom downloads (#342)

• instructions to bottom of menu version selection

• removed reference to prerelease version of v5.0.0 from README

• log message after install from cache (previously silent)
• extra logging after install if the active and installed node locations are different
• support for NO_COLOR and CLICOLOR=0
• suppress progress and colour if not interactive tty
• define N_USE_XZ to download .xz compressed archives instead of .gz archives

• reinstalling active node version always does reinstall (previously silently did nothing)
• log message for installing using menu now same format as npm install message
• updates to GitHub templates and guidelines for contributing et al

• 'n uninstall` to remove node and npm
• describe NODE_MIRROR in README

• PROJECT_NAME and PROJECT_URL from README. First step to deprecating n project. Open an issue if you still need this!

Only minor functional changes, but technically could break scripts relying on specific behaviour.

• remove trailing space from bin output #456

• development tests #545

• internal: improve shell script based on ShellCheck suggestions, quoting variables use etc #187 #465
• put single quote marks around parameters to clarify error messages #485
• update terminology to be more careful with current/latest #522

• instructions to avoid need for sudo when installing to /usr/local #416 #562

• permission denied errors when running read-only commands without sudo #416

• install instruction using Homebrew (macOS) #534
• Table of Contents to README #466

• lts lookup on node mirrors which don't purge old versions (e.g. taobao) #512
• hide cursor while selecting version from menu #528

• gitter badge from README, as gitter chatroom inactive
• inactive Core Team from README
• instructions for scripted install of npm from README, which should no longer be needed and not working on Mac #536

• detect arm64 architecture #448 #521

• allow n rm of active version of node #541 #169 #327 #441
• show more version examples in README, including partial version number #548
• updated description of interactive version selection #518
• make (old) stable an alias for lts #467 #335
• replace use of which with more standard command -v #532

• error messages when selecting from version menu if active node version not listed #541 #292 #367 #391 #400
• removed inappropriate shift from prune function #531 #529

• Remove old io project support #516 #331