Botium CLI - The Selenium for Chatbots

Botium is the Selenium for chatbots. Botium CLI is the swiss army knife of Botium.

IF YOU LIKE WHAT YOU SEE, PLEASE CONSIDER GIVING US A STAR ON GITHUB!

How do I get help ?

• Read the Botium in a Nutshell series
• If you think you found a bug in Botium, please use the Github issue tracker.
• The documentation on a very technical level can be found in the Botium Wiki.
• For asking questions please use Stackoverflow - we are monitoring and answering questions there.
• For our VIP users, there is also a Slack workspace available (coming soon).

Installation

Download latest executable, standalone program from here

In case you have Node.js installed on your system, just install the botium-cli module globally:

> npm install -g botium-cli

Usage

Did you read the Botium in a Nutshell articles ? Be warned, without prior knowledge of Botium you won't be able to properly use this library!

Prepare and run a simple Botium test case:

> botium-cli init
> botium-cli run

Got get help on the command line options:

> botium-cli help

Botium Capabilities configuration

The chatbot capabilities are described in a configuration file. By default, the file named "botium.json" in the current directory is used, but it can be specified with the "--config" command line parameter. The configuration file holds capabilities, envs and sources. Configuration via environment variables is supported as well.

{
  "botium": {
    "Capabilities": {
      "PROJECTNAME": "botium-sample1",
      ....
    },
    "Sources: {
      ....
    },
    "Envs": {
      "NODE_TLS_REJECT_UNAUTHORIZED": 0,
      ....
    }
  }
}

Commands

botium-cli init

Prepare a directory for Botium usage:

• Adds a simple botium.json
• Adds a sample convo file

botium-cli run

Automatically run all your scripted conversations against your chatbot and output a test report

botium-cli import

Import conversation scripts or utterances from some source (for example, from IBM Watson workspace)

botium-cli emulator

Especially with structured messages, it can become uncomfortable to write conversation files manually. Botium contains two emulators to support you with browsing and writing your conversation files:

Browser Emulator

The Botium Browser Emulator provides a simple browser interface to record and organize your test cases, and to interact with your Chatbot.

Running it is simple:

$ botium-cli emulator browser

To specify directory holding your convo files and to specify the configuration file:

$ botium-cli emulator browser --convos=./spec/convo --config=./spec/botium.json

Console Emulator

The Botium Console Emulator is a basic command line interface to your chatbot running within Botium . You can record and save your conversation files.

Running it is simple:

$ botium-cli emulator console