REPL console

moleculer repl

The moleculer-repl is an interactive developer console for Moleculer.

Install

npm i moleculer-repl

Usage

Switch broker to REPL mode

let broker = new ServiceBroker({ logger: console });

// Switch to REPL mode
broker.repl();

REPL Commands

Commands:
  help [command...]                                   Provides help for a given command.
  q                                                   Exit application
  actions [options]                                   List of actions
  bench [options] <action> [jsonParams]               Benchmark a service
  broadcast <eventName>                               Broadcast an event
  broadcastLocal <eventName>                          Broadcast an event locally
  call [options] <actionName> [jsonParams]            Call an action
  dcall [options] <nodeID> <actionName> [jsonParams]  Direct call an action
  clear [pattern]                                     Clear cache entries
  emit <eventName>                                    Emit an event
  env                                                 List of environment variables
  events [options]                                    List of event listeners
  info                                                Information about broker
  load <servicePath>                                  Load a service from file
  loadFolder <serviceFolder> [fileMask]               Load all services from folder
  nodes [options]                                     List of nodes
  services [options]                                  List of services
  hello [options] <name>                              Call the greeter.hello service with name

List nodes

mol $ nodes

Options

-d, --details      detailed list
-a, --all          list all (offline) nodes
--raw              print service registry to JSON
--save [filename]  save service registry to a JSON file

Output

Detailed output

List services

mol $ services

Options

-l, --local         only local services
-i, --skipinternal  skip internal services
-d, --details       print endpoints
-a, --all           list all (offline) services

Output

Detailed output

List actions

mol $ actions

Options

-l, --local         only local actions
-i, --skipinternal  skip internal actions
-d, --details       print endpoints
-a, --all           list all (offline) actions

Output

Detailed output

List events

mol $ events

Options

-l, --local         only local actions
-i, --skipinternal  skip internal actions
-d, --details       print endpoints
-a, --all           list all (offline) actions

Output

Detailed output

Show common information

mol $ info

Output

List environment variables

mol $ env

Call an action

mol $ call "test.hello"

Output

Call an action with parameters

mol $ call "math.add" --a 5 --b Bob --c --no-d --e.f "hello"

Params will be { a: 5, b: 'Bob', c: true, d: false, e: { f: 'hello' } }

Call with JSON string parameter

mol $ call "math.add" '{"a": 5, "b": "Bob", "c": true, "d": false, "e": { "f": "hello" } }'

Params will be { a: 5, b: 'Bob', c: true, d: false, e: { f: 'hello' } }

Call with parameters from file

mol $ call "math.add" --load

It tries to load the <current_dir>/math.add.params.json file to params.

mol $ call "math.add" --load my-params.json

It tries to load the my-params.jon file to params.

Call and save response to file

mol $ call "math.add" --save

It saved the response to the <current_dir>/posts.find.response.json file. The extension is .json when the response is object. Otherwise it is .txt.

mol $ call "math.add" --save my-response.json

It saved the response to the my-response.json file.

Direct call

Get health info from node-12 node

mol $ dcall "node-12" "$node.health"

Parameter passing is similar to call command.

Emit an event

mol $ emit "user.created"

Emit an event with parameters

mol $ emit "user.created" --a 5 --b Bob --c --no-d --e.f "hello"

Params will be { a: 5, b: 'Bob', c: true, d: false, e: { f: 'hello' } }

Benchmark services

Moleculer REPL module has a new bench command to measure your services.

# Call service until 5 seconds (default)
mol $ bench math.add

# Call service 5000 times
mol $ bench --num 5000 math.add

# Call service until 30 seconds
mol $ bench --time 30 math.add

Options

--num <number>     Number of iterates
--time <seconds>   Time of bench
--nodeID <nodeID>  NodeID (direct call)

Output

Parameters

Please note, you can pass parameters only with JSON string.

mol $ bench math.add '{ "a": 50, "b": 32 }'

Load a service from file

mol $ load "./math.service.js"

Load all services from a folder

mol $ load "./services"

Custom commands

You can define your custom REPL commands in broker options to extend Moleculer REPL commands.

let broker = new ServiceBroker({
    logger: true,
    replCommands: [
        {
            command: "hello <name>",
            description: "Call the greeter.hello service with name",
            alias: "hi",
            options: [
                { option: "-u, --uppercase", description: "Uppercase the name" }
            ],
            types: {
                string: ["name"],
                boolean: ["u", "uppercase"]
            },
            //parse(command, args) {},
            //validate(args) {},
            //help(args) {},
            allowUnknownOptions: true,
            action(broker, args/*, helpers*/) {
                const name = args.options.uppercase ? args.name.toUpperCase() : args.name;
                return broker.call("greeter.hello", { name }).then(console.log);
            }
        }
    ]
});

broker.repl();

mol $ hello -u John
Hello JOHN