replc

replc

replc is a colorful cli console for iojs. It prefers to be installed globally and operates in your current working directory.

Usage

$ npm install replc -g
$ jsh --help
Usage: jsh [--help -ha0dD -r <require-package> -x <exclude-package> fileName fileName

Options:
  -0                          Dont require anything unless stated explicitly
                              with -r.
  --all, -a                   Require all dependencies (for the project in your
                              current working directory).
  --require <package>         Require package into context with camel came name

  --exclude <package>         Ignore package
  --use-dependencies, -d      require package.json dependencies
  --use-dev-dependencies, -D  require devDependencies
  --last-result, -l           remap node repl's context._; '$_' by default.
  --no-color, -C              Disable colors
  --debug-mode                Debug verbosity.
  --soft-tabs                 Pretty print soft tabs, defaults to 2
  --help, -h                  Show help

Usage in code

var replc = require('replc');
replc({
  context: {
    anythingYouWouldUse: 42,
    customFunction: () => console.log('whatever');
  },
  packages: ['fs', 'lodash'],
  useDevDependencies: true
});

Example usage in gulp

Note that a setTimeout or similar call is highly adviced to keep stdout clean.

gulp.task('replc', function() {
  setTimeout(function() {
    replc({
      context: {
        useDevDependencies: true,
        expect: require('chai').expect
      }
    })
  });
});

Config parameters

• ctx: context; any values in here will be accessible in your REPL.
• preprocessor: Transform the line before sending it to the vm. The place for coffeescript, babel, etc. Defaults to _.identity.
• aliases: require dependencies to a different name, e.g.: {lodash: '__'} Note that _ contains the result of the last expression.
• dependencies: an optional array of package names, if you don't want to useDependencies.
• useDependencies: all package.json dependencies will be available, true by default
• useDevDependencies: all package.json devDependencies will be available, false by default,
• replOptions: additional params given to the underlying repl.
• logger: defaults to console.log
• useColors: true by default
• silent: suppress welcome message, false by default

Config example

var defaultConfig = {
  context: {log: console.log},
  logger: console.log,
  path: process.cwd(),
  useDependencies: true,
  useDevDependencies: false,
  useColors: true,
  silent: false,
  dependencies: [
    'fs', 
    'lodash', 
    'moment', 
    'string', 
    'co'
  ],
  aliases: { 
    lodash: '__', 
    underscore: '__',
    string: 'S' 
  },
  replOptions: { 
    prompt: pkg.name + '#> ' 
  },
  debugMode: pkg.name === 'replc'
};