RSpec::WebserviceMatchers
This gem enables you to black-box test a web app's server configuration. For example, whether its SSL certificate is correctly configured and not expired. It's a tool for doing Test Driven Devops. (I just made that up.) See my blog post for more about my motivations for making this.
This library takes a very minimalist approach: it simply adds new RSpec matchers, and so you can use your own RSpec writing style; there's no new DSL to learn.
Installation
$ gem install rspec-webservice_matchers
What You Get
These new RSpec matchers:
| Notes | |
|---|---|
| be_status | |
| be_up | Follows redirects if necessary and checks for 200 |
| have_a_valid_cert | |
| enforce_https_everywhere | See the EFF project |
| redirect_permanently_to | Checks for 301 |
| redirect_temporarily_to | Checks for 302 or 307 |
Example
Here's an example which uses them all:
require 'rspec/webservice_matchers'
describe 'My app' do
context 'www.myapp.com' do
it { should be_up }
it { should have_a_valid_cert }
end
it 'serves the "about" page without redirecting' do
expect('http://www.myapp.com/about').to be_status 200
end
it 'only serves via www' do
expect('http://myapp.com').to redirect_permanently_to 'http://www.myapp.com/'
end
it 'forces visitors to use https' do
expect('myapp.com').to enforce_https_everywhere
end
end
TODO
- Matchers for more high-level cases
- Matchers for JSON schema
- More matchers refactored from weblaws.org code