# TestSelector

A set of Elixir and [Hound](https://github.com/HashNuke/hound) helpers to set/get test selectors to/from elements in a Phoenix app (when `Mix.env == :test`). These selectors are hashed (scoped to the view module they are used in) for accurate selection and "leakage" prevention. See our [Wiki](https://github.com/DefactoSoftware/test_selector/wiki) for examples.

**Why?** Because we prefer reserving classes for styling, and id's have limitations because they have to be unique.

## Dependencies

- [Hound](https://github.com/HashNuke/hound) v1.x.x

## Installation

```elixir
def deps do
  [{:test_selector, "~> 0.2.0"}]
end
```

Use `TestSelector.HTML.Helpers` to your web.ex.

- In phoenix 1.2.0 at `web/web.ex`
- In phoenix 1.3.0 and up at `lib/your_project/web/web.ex`

Add somewhere along:

```elixir
  def view(opts \\ []) do
    quote do
      ...
      use Phoenix.HTML

      use TestSelector.HTML.Helpers
      ...
    end
  end
```

In the tests import the `TestSelector.Test.Helpers`:

```elixir
defmodule Project.Web.MyTest do
  ...
  use Hound.Helpers

  import TestSelector.Test.Helpers
  ...
end
```

## Tests

To run tests you need to install [PhantomJS](http://phantomjs.org/).
```
brew install phantomjs
```

Run the webdriver:
```
phantomjs -w
```

Run the tests:
```
mix test
```