Contents

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'ci-queue'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install ci-queue

## Usage

### Supported CI providers

`ci-queue` automatically infers most of its configuration if ran on one of the following CI providers:

  - Buildkite
  - CircleCI
  - Travis

If you are using another CI system, please refer to the command usage message.

### Minitest

Assuming you use one of the supported CI providers, the command can be as simple as:

```bash
minitest-queue --queue redis://example.com run -Itest test/**/*_test.rb
```

Additionally you can configure the requeue settings (see main README) with `--max-requeues` and `--requeue-tolerance`.


If you'd like to centralize the error reporting you can do so with:

```bash
minitest-queue --queue redis://example.com --timeout 600 report
```

The runner also comes with a tool to investigate leaky tests:

```bash
minitest-queue --queue path/to/test_order.log --failing-test 'SomeTest#test_something' bisect -Itest test/**/*_test.rb
```

### RSpec

The RSpec integration is still missing some features, but is already usable:

```bash
rspec-queue --queue redis://example.com --build XXX --worker XXX
```

#### Missing features

To be implemented:

  - Requeueing
  - Centralized reporting

#### Limitations

Because of how `ci-queue` execute the examples, `before(:all)` and `after(:all)` hooks are not supported. `rspec-queue` will explicitly reject them.

Version data entries

5 entries across 5 versions & 1 rubygems

Version	Path
ci-queue-0.10.1	README.md
ci-queue-0.10.0	README.md
ci-queue-0.9.2	README.md
ci-queue-0.9.1	README.md
ci-queue-0.9.0	README.md