Contents

# The Command Line

* Using the gem

```console
    $ beaker --log-level debug --hosts sample.cfg --tests test.rb
```

* Using latest git

```console
    $ bundle exec beaker --log-level debug --hosts sample.cfg --tests test.rb
```

## Useful options

* `-h, --hosts FILE `, the hosts that you are going to be testing with
* `--log-level debug`, for providing verbose logging and full stacktraces on failure
* `--[no-]provision`, indicates if beaker should provision new boxes upon test execution. If `no` is selected then beaker will attempt to connect to the hosts as defined in `--hosts FILE` without first creating/running them through their hypervisors
* `--preserve-hosts [MODE]`, indicates what should be done with the testing boxes after tests are complete.  If `always` is selected then the boxes will be preserved and left running post-testing.  If `onfail` is selected then the boxes will be preserved only if tests fail, otherwise they will be shut down and destroyed.  If `never` is selected then the boxes will be shut down and destroyed no matter the testing results.
* `--parse-only`, read and parse all command line options, environment options and file options; report the parsed options and exit.

## The Rest

See all options with

* Using the gem

```console
        $ beaker --help
```

* Using latest git

```console
        $ bundle exec beaker --help
```

Version data entries

78 entries across 78 versions & 1 rubygems

Version	Path
beaker-6.4.1	docs/tutorials/the_command_line.md
beaker-6.4.0	docs/tutorials/the_command_line.md
beaker-6.3.0	docs/tutorials/the_command_line.md
beaker-6.2.0	docs/tutorials/the_command_line.md
beaker-6.1.0	docs/tutorials/the_command_line.md
beaker-5.8.1	docs/tutorials/the_command_line.md
beaker-4.42.0	docs/tutorials/the_command_line.md
beaker-5.8.0	docs/tutorials/the_command_line.md
beaker-5.7.0	docs/tutorials/the_command_line.md
beaker-4.41.2	docs/tutorials/the_command_line.md
beaker-4.41.1	docs/tutorials/the_command_line.md
beaker-5.6.0	docs/tutorials/the_command_line.md
beaker-4.41.0	docs/tutorials/the_command_line.md
beaker-5.5.0	docs/tutorials/the_command_line.md
beaker-5.4.0	docs/tutorials/the_command_line.md
beaker-5.3.1	docs/tutorials/the_command_line.md
beaker-4.40.2	docs/tutorials/the_command_line.md
beaker-5.3.0	docs/tutorials/the_command_line.md
beaker-4.40.1	docs/tutorials/the_command_line.md
beaker-5.2.0	docs/tutorials/the_command_line.md