https://github.com/DefactoSoftware/test_selector

Elixir library to help selecting the right elements in your tests.
https://github.com/DefactoSoftware/test_selector

elixir phoenix selectors test

Last synced: 3 months ago
JSON representation

Elixir library to help selecting the right elements in your tests.

• Host: GitHub
• URL: https://github.com/DefactoSoftware/test_selector
• Owner: DefactoSoftware
• License: mit
• Created: 2017-07-14T13:41:40.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-06-27T15:45:48.000Z (7 months ago)
• Last Synced: 2024-10-30T00:34:09.622Z (3 months ago)
• Topics: elixir, phoenix, selectors, test
• Language: Elixir
• Homepage:
• Size: 61.5 KB
• Stars: 14
• Watchers: 16
• Forks: 2
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• freaking_awesome_elixir - Elixir - A set of test helpers that make sure you always select the right elements in your Phoenix app. (Testing)
• fucking-awesome-elixir - test_selector - A set of test helpers that make sure you always select the right elements in your Phoenix app. (Testing)
• awesome-elixir - test_selector - A set of test helpers that make sure you always select the right elements in your Phoenix app. (Testing)

README

        
# TestSelector

[![CircleCI](https://circleci.com/gh/DefactoSoftware/test_selector/tree/master.svg?style=shield)](https://circleci.com/gh/DefactoSoftware/test_selector)

[![Module Version](https://img.shields.io/hexpm/v/test_selector.svg)](https://hex.pm/packages/test_selector)

[![Hex Docs](https://img.shields.io/badge/hex-docs-lightgreen.svg)](https://hexdocs.pm/test_selector/)

[![Total Download](https://img.shields.io/hexpm/dt/test_selector.svg)](https://hex.pm/packages/test_selector)

[![License](https://img.shields.io/hexpm/l/test_selector.svg)](https://github.com/DefactoSoftware/test_selector/blob/master/LICENSE.md)

[![Last Updated](https://img.shields.io/github/last-commit/DefactoSoftware/test_selector.svg)](https://github.com/DefactoSoftware/test_selector/commits/master)

A set of Elixir 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

- [Floki](https://github.com/philss/floki) v0.25.x and higher

## Installation

```elixir

def deps do

  [

    {:test_selector, "~> 0.3.3"}

  ]

end

```

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

- In phoenix 1.2.0 at `web/web.ex`

- In newer Phoenix versions `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

```

**Testing with Floki**

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

```elixir

defmodule Project.Web.MyTest do

  ...

  import TestSelector.Test.FlokiHelpers

  ...

end

```

## Tests

Run the tests:

```

mix test

```

## Copyright and License

Copyright (c) 2017 Defacto

Released under the MIT License, which can be found in the repository in

[LICENSE.md](./LICENSE.md).