https://github.com/amatsuda/heavens_door

Capybara test scenario recorder for Rails
https://github.com/amatsuda/heavens_door

capybara engine feature-tests rails rspec test-unit

Last synced: 29 days ago
JSON representation

Capybara test scenario recorder for Rails

• Host: GitHub
• URL: https://github.com/amatsuda/heavens_door
• Owner: amatsuda
• License: mit
• Created: 2019-02-01T07:57:46.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-08-12T19:32:57.000Z (about 1 year ago)
• Last Synced: 2024-10-04T03:56:49.851Z (about 1 month ago)
• Topics: capybara, engine, feature-tests, rails, rspec, test-unit
• Language: JavaScript
• Homepage:
• Size: 217 KB
• Stars: 868
• Watchers: 29
• Forks: 27
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: MIT-LICENSE

Awesome Lists containing this project

README

        
# Heaven's Door

A tiny Rails engine that generates capybara test scenario by recording browser operation in development env.

## Installation

Add this line to your Rails application's Gemfile (in most cases, for development group only):

```ruby

gem 'heavens_door', group: :development

```

## Usage

![Usage](heavens_door.gif)

### Start Recording

Visit your development app with your browser, then click the ⏺ button on the top right.

### Generate Scenarios

Just manipulate the browser, like fill-in the forms and submit, or click the links.

Your operations will be recorded on the browser.

### Copy to Clipboard

You can export the operations as a Capybara test scenario script by clicking the 📋 button.

### Stop Recording

To stop recording and clear the whole recorded scenario, click the ⏹ button.

## Requirements

- Rails

- Modern browsers

## Contributing

Pull requests are welcome on GitHub at https://github.com/amatsuda/heavens_door.

## TODO

- Insert assertions from the browser

- Some kinds of input (like time\_field, datetime\_field) might not be working properly

- Hotkeys to hide/show the panel

- Better UI

- Cleaner JS code

- Tests (do we really need tests for this? Well, maybe...)

- etcetcetc.

## License

The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).