n_shell

n_shell

A node REPL with ShellJS loaded by default.

This was inspired by (and forked from) n_.

Installation:

It's recommended to install this package globally:

$ npm install -g n_shell

Usage:

Invoking n_shell starts a node REPL with ShellJS required globally:

bash $ n_shell
shelljs $ ls()
[ 'LICENSE',
  'README.md',
  'bin',
  'node_modules',
  'package.json',
  'src',
  'tmp' ]
shelljs $ pwd()
'/path/to/dir'

But I don't want to use shelljs/global

No problem:

bash $ n_shell --no_global
shelljs $ typeof ls // not in the global namespace
'undefined'
shelljs $ shell.ls()
[ 'LICENSE',
  'README.md',
  'bin',
  'node_modules',
  'package.json',
  'src',
  'tmp' ]
shelljs $ shell.pwd()
'/path/to/dir'

But I want to use a different namespace

You're covered:

bash $ n_shell --no_global=$
shelljs $ $.ls()
[ 'LICENSE',
  'README.md',
  'bin',
  'node_modules',
  'package.json',
  'src',
  'tmp' ]
shelljs $ $.pwd()
'/path/to/dir'

But I want to use a different version of shelljs

Just install that version locally (npm install shelljs) and start up n_shell. You should see a warning message like this:

bash $ n_shell
Warning: using shelljs found at /path/to/dir/node_modules/shelljs
shelljs $

Options

• --global: Start a node REPL with the equivalent of require('shelljs/global'). This is the default behavior.
• --no_global [PREFIX], --local [PREFIX], -n [PREFIX]: Start a node REPL with the equivalent of var PREFIX = require('shelljs'). PREFIX defaults to shell, if not specified.
• --use_strict: enforce strict mode (default is false)
• --prompt <FORMAT>: use this format to generate the REPL prompt. Default is "shelljs %v%l $ "
  • %v: show the current version (from package.json)
  • %l: show [local] if this is installed from a local module (whenever the warning message above would be printed)
  • Warn more formats options? Let me know or send me a PR

History

Similarly to n_, n_shell stores REPL history under ~/.n_shell_history.