rbc-cli-tools

Command Line Tools for the RBC Cloud

##Installation

The cli tools require a nodejs runtime and are installed using the node package manager (npm).

> npm install -g rbc-cli

Not that on *nix based systems and Macs, a global install command MUST be run using sudo.

One the tools are installed, verify the installation using the version command. The command SHOULD respond with a semantic version of the tools: M is the major version, m is the minor version, and b is the build increment.

> rbc-cli -V
  M.m.b 

##General Str

###Common Usage

<rbc-tool> [options] <command> [arguments ..] 

The first entry is the name of the tool. The second argument is the command. All further arguments are interpretted in the context of the command.

Options can be specified anywhere on the command line AFTER the tool designation. The following commands are considered equivalent.

rbc-cli -e my-environment -v command

rbc-cli -v command -e my-environment

rbc-cli command -v -e my-environment

###Processing Options

The following switch are universal and have consistent semantics across the tools.

long | short | meaning ---- | ----- | ------- version | V | request the version of a tool help | H | request help in the form of usage instructions verbose | v | execute the command with intermediate output debug | d | execute the command in debug mode force | f | force the command to ignore saftey considerations no-color| C | do not use color

##Project Commands

• pwd
• init

###pwd

Aliases: home

This command will print the home directory of the current project.

#####Arguments

None.

#####Return

Platform specific directory path of the current project.

#####Sample

> rbc-cli pwd
/path/to/project/root

###init

This command will establish the current directory as a new project by creating a new rbc-project.json file. This command will fail safely if an existing rbc-project.json file exists up the directory tree. A user may create a project in a subfolder by using the --force command line option.

> rbc-cli init [-f]
/path/to/new/project/root

#####Arguments

None.

#####Return

Platform specific directory path to the newly initialized project.