# TestmetricsElixirClient [![Build Status](](

The official ExUnit client for Testmetrics. This client collects data about your
ExUnit runs on CI and sends that data to Testmetrics so you can gain valuable
insights about your test suite.

## Installation

This package can be installed by adding `testmetrics_elixir_client` to your list
of dependencies in `mix.exs`:

def deps do
    {:testmetrics_elixir_client, "~> 0.1.0", only: [:test]}

Once you've done that, just add `TestmetricsElixirClient` to your `ExUnit`
configuration by adding the following line to your `test_helper.exs` file:

ExUnit.configure(formatters: [ExUnit.CLIFormatter, TestmetricsElixirClient])

That will add `TestmetricsElixirClient` as well as the standard `CLIFormatter`.

In order for the metrics to be send to Testmetrics, you must have your
Testmetrics Project Key set in the "TESTMETRICS_PROJECT_KEY" environment
variable in your CI environment. If this environment variable isn't set, the
collected metrics for your CI run will be discarded. This key should be kept
private and not exposed to the public.

And that's it! Once those steps are done, you'll start collecting data and
seeing how you can improve your test suite!

## License

`TestmetricsElixirClient` is offered under the MIT license. For the full license
text see [](