3zcurdia/capybara-pagemap

View on GitHub
README.md

Summary

Maintainability
Test Coverage
# Capybara Pagemap
[![Build Status](https://travis-ci.org/3zcurdia/capybara-pagemap.svg?branch=master)](https://travis-ci.org/3zcurdia/capybara-pagemap)
[![Maintainability](https://api.codeclimate.com/v1/badges/19084f69bfee063ec218/maintainability)](https://codeclimate.com/github/3zcurdia/capybara-pagemap/maintainability)
[![Test Coverage](https://api.codeclimate.com/v1/badges/19084f69bfee063ec218/test_coverage)](https://codeclimate.com/github/3zcurdia/capybara-pagemap/test_coverage)
[![Gem Version](https://badge.fury.io/rb/capybara-pagemap.svg)](https://badge.fury.io/rb/capybara-pagemap)

Simple object mapper for page objects with capybara

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'capybara-pagemap'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install capybara-pagemap

## Usage

Inherit from ```Capybara::Pagemap::Base``` and define the input fields as the following example

```ruby
class LoginPage
  include Capybara::Pagemap
  define_input :email, '//*[@id="user_email"]'
  define_input :password, '//*[@id="user_password"]'
  define_button :log_in, '//*[@id="log_in"]'
end
```
Once you have define your input you will have access to the getters setters

```ruby
login_page = LoginPage.new
login_page.email = "test@example.org"
login_page.email
# => "test@example.org"
login_page.email_input
# => Capybara::Node
login_page.log_in_button.click if login_page.valid?
```


## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/3zcurdia/capybara-pagemap.