Overview

The Communications Mining Command Line Interface, re, is a unified tool that provides a consistent interface for interacting with all parts of Communications Mining from a terminal.

re simplifies managing Communications Mining resources, such as sources and datasets, as well as importing or exporting communications data. Additionally, re maintains multiple contexts, making it easy to switch between multiple authentication tokens for different users, service accounts or Communications Mining endpoints.

The Communications Mining CLI is open source and developed on GitHub.

Features

• Create, get, update and delete operations for all the different Communications Mining resources. This includes sources, datasets, comments, buckets, streams and more.
• Context management for multiple API tokens and Communications Mining endpoints.
• Easily upload new messages to a source.
• Download messages from a set of sources and datasets together with the human applied annotations. Useful for backups, migrating data or for applying some transformations to the data.
• Basic shell autocompletion for zsh and bash, colorized terminal output, progress bars and more

Installation

Binary

Statically linked binaries with no dependencies are provided for all major platforms

• Linux (x86_64-unknown-linux-musl)
• macOS (x86_64-apple-darwin)
• Windows (x86_64-pc-windows-gnu)

From Source

To build from source, you need a recent version of the Rust toolchain installed. To install using cargo.

cargo install --locked reinfer-cli

Ensure you have the cargo bin directory in your path (typically ~/.cargo/bin).

Alternatively, you can always clone the repository and build it with cargo build.

Help

The Communications Mining CLI ships with a lot of command documentation that is accessible with the --help or -h flag.

$ re --help
$ re <command> --help
$ re <command> <subcommand> --help

We encourgage you to use read the included documentation as it's extensive and always up to date.

$ re --help

reinfer-cli 0.11.0
re is the command line interface to reinfer clusters

USAGE:
    re [FLAGS] [OPTIONS] <SUBCOMMAND>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information
    -v, --verbose    Enable more verbose logging

OPTIONS:
    -k, --accept-invalid-certificates <accept-invalid-certificates>
        --config-file <config>
            Path to the configuration file. Typically defaults to ~/.config/reinfer on Linux

    -c, --context <context>
            Specify what context to use. Overrides the current context, if any

        --endpoint <endpoint>
            Specify what endpoint to use. Overrides the one from the current context, if any

    -o, --output <output>
            Output format. One of: json, table [default: table]

        --proxy <proxy>
            URL for an HTTP proxy that will be used for all requests if specified

        --token <token>
            Specify what API token to use. Overrides the one from the current context, if any


SUBCOMMANDS:
    completion    Output shell completion code for the specified shell (bash or zsh)
    config        Manage reinfer authentication and endpoint contexts
    create        Create new resources
    delete        Delete a resource
    get           Display resources and export comments to the local filesystem
    help          Prints this message or the help of the given subcommand(s)
    update        Update existing resources

Troubleshooting

To troubleshoot issues with the Communications Mining CLI, the following may be useful

• Make sure the latest version of re is installed. Get the installed version by running re --version or re -V
• The --verbose flag prints debugging messages, which may narrow down the issue.
• Connection issues may be due to improperly configured proxy settings. See Using a Proxy to configure request proxying.
• The Communications Mining CLI configuration directory is system specific, e.g. ~/.config/reinfer on Linux or macOS and %AppData%/reinfer on Windows. It can safely be deleted and the CLI will repopulate it, but all configuration (including user sessions) will be lost.

If there is anything you feel we can do to improve it or if you encounter any bugs or unexpected behavior, please contact support.