👋 Email us at [email protected] with questions or feedback. We'd love to hear from you. If you have an account with RWX, view your support page for access to support via Slack.

Running ABQ Locally

You can install ABQ locally on OS X using homebrew.

brew install rwx-research/tap/abq

We do not currently have packages available for other operating systems. Please let us know if you'd like to install ABQ locally on Linux.

Test Framework Integration

To run ABQ locally, you'll need to configure your test framework using the same configuration you need when running ABQ on CI.

Example CLI Usage

Once your test framework is configured, you can use ABQ to parallelize your test suite when running it locally.

Although ABQ is designed to run in a distributed network, when running the abq test command locally, ABQ will start an ephemeral queue and one or more workers locally. The command can be invoked with any native test command, similar to how its used on CI.

abq test -- any test command goes here

For example with RSpec:

abq test -- bundle exec rspec

By default, abq test will only run a single worker. You can set the number of workers by passing the -n option. For example, to run two workers:

abq test -n 2 -- any test command goes here

If you'd like to run one worker per CPU core available, you can pass -n cpu-cores.

You can see a full list of commands by running abq help and a full list of arguments to abq test by running abq test --help.

Worker Number Environment Variable

Depending on your native test suite, you may need an environment variable to differentiate test processes. For example, it's common in some frameworks to set up separate databases for each parallel test process. ABQ will set an ABQ_RUNNER environment variable that contains an integer sequence starting from 1.

For example, in a project that needs TEST_ENV_NUMBER set to run tests in parallel, ABQ can be invoked like this:

abq test -n 2 -- bash -c 'TEST_ENV_NUMBER=$ABQ_RUNNER bundle exec rspec'

ABQ_RUNNER is set when abq test invokes the command specified after --. Therefore, to set another environment variable based on the value of ABQ_RUNNER, you need to wrap the specified command in another script or shell command, such as bash -c. Without wrapping it, your shell would attempt to use ABQ_RUNNER before it's been set by abq test.