https://github.com/evilmartians/capybara-thruster

Thruster server definition for Capybara
https://github.com/evilmartians/capybara-thruster

Last synced: 3 months ago
JSON representation

Thruster server definition for Capybara

• Host: GitHub
• URL: https://github.com/evilmartians/capybara-thruster
• Owner: evilmartians
• License: mit
• Created: 2024-05-28T16:29:57.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2024-07-08T12:08:25.000Z (4 months ago)
• Last Synced: 2024-07-08T15:01:22.494Z (4 months ago)
• Language: Ruby
• Size: 14.6 KB
• Stars: 26
• Watchers: 6
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
[![Gem Version](https://badge.fury.io/rb/capybara-thruster.svg)](https://rubygems.org/gems/capybara-thruster)

[![Build](https://github.com/evilmartians/capybara-thruster/workflows/Build/badge.svg)](https://github.com/palkan/capybara-thruster/actions)

# Capybara Thruster server

This gem makes it possible to use [Thruster][] as a Capybara server. Run your browser test with HTTP/2 enabled and static assets served via Thruster for faster load times!

> [!TIP]

> Using AnyCable? This gem works with [AnyCable-d Thruster][anycable-thruster], so you can run your system tests against a real AnyCable server with all its features!

## Getting started

### Prerequisites

Before adding the gem to your project, ensure you have either `thruster` or `anycable-thruster` installed. You can add one of these gems to your `Gemfile`:

```ruby

# For thruster

gem "thruster"

# or for anycable-thruster

gem "anycable-thruster"

```

Adding the gem to your project:

```ruby

# Gemfile

gem "capybara-thruster", group: :test

```

Then, configure Capybara to use Thruster as a server:

```ruby

Capybara.server = :thruster

# You can also specify some options.

# For example, if you want to see the server output,

# pass the `debug: true` option:

Capybara.server = :thruster, {debug: true}

# To customize the server settings, you can pass arbitrary environment

# variables via the `env` option:

Capybara.server = :thruster, {env: {"DEBUG" => "true"}}

# To specify Puma server options, use the `puma_options` option:

Capybara.server = :thruster, {puma_options: {Silent: false}}

```

## Contributing

Bug reports and pull requests are welcome on GitHub at [https://github.com/evilmartians/capybara-thruster](https://github.com/evilmartians/capybara-thruster).

## Credits

This gem is generated via [`newgem` template](https://github.com/palkan/newgem) by [@palkan](https://github.com/palkan).

## License

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

[Thruster]: https://github.com/basecamp/thruster

[anycable-thruster]: https://github.com/anycable/thruster