rspec-webservice_matchers 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7a91cd72d70ca58ac4b471caef6ff810ee90b2b1
-  data.tar.gz: fbda72dad2ca7a23c05be9fc90af9fcb98dfe198
+  metadata.gz: f213b57f745129ca27f161fafab51468beec886c
+  data.tar.gz: 8e9a30715b9de34263e66db6f4776caed4fd6418
 SHA512:
-  metadata.gz: 8b846008102ec2520cff3be9481d15dc5862dbdcca59025199dbdb6f7c9a887534858cfb9b6dd3bd32b3b31c7bf6a91ba34df8c19065ed32f93e41bfdc46e42c
-  data.tar.gz: f7c089dfbee764e7b96f05cd71e41c03ad97e4ea1ed6dbeb306b57bebc6efb808806a3dcd42111549e7c30725829e5887365f368dacf1a9f17e4114906bf4e1b
+  metadata.gz: dc69ca69ee807788b27af421a90088f6b0f3c4cd14126a215e58c2bd6bb66d7882225d1b7c3399e54d8e8cf720070f24f7fd7e63371dc6b477a32eac6695fddd
+  data.tar.gz: 17301939ab8f4cc7ffacd7b53cfd55880074285c56663f90eb0d4b97a4308b155159dd26d85119a3d9a64afa51d915f8b1b87c419581d79aaf3442353f53e821

data/README.md

@@ -2,28 +2,35 @@
 
 This [gem](https://rubygems.org/gems/rspec-webservice_matchers) 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.)
 
+This library takes a very minimalist approach: by simply adding new RSpec matchers,
+you can use your own RSpec writing style; no new DSL to learn.
+
 Installation
 ------------
 ```Shell
 $ gem install rspec-webservice_matchers
 ```
 
+What You Get
+------------
+These new RSpec matchers:
 
-Example
--------
-
-Currently, three matchers are implemented: 
-
+* `be_status`
 * `have_a_valid_cert`
+* `enforce_https_everywhere`  (See [EFF](https://www.eff.org/https-everywhere))
 * `redirect_permanently_to`
-* `enforce_https_everywhere` (See the [EFF site](https://www.eff.org/https-everywhere) for more info)
+
+
+Example
+-------
 
 ```Ruby
 require 'rspec/webservice_matchers'
 
-describe 'My app' do
-  it 'is configured for ssl' do
-    expect('www.myapp.com').to have_a_valid_cert
+describe 'My app' do 
+  context 'www.myapp.com' do
+    it { should be_status 200 }
+    it { should have_a_valid_cert }
   end
 
   it 'redirects to www' do
@@ -39,6 +46,13 @@ end
 
 TODO 
 ----
-* Matchers for more HTTP result codes. I'm adding these in by refactoring code out of my [oregonlaws.org](http://www.oregonlaws.org/) and [weblaws.org](http://www.weblaws.org/) projects.
+* Matchers for more high-level cases, such as the two kinds of temp. redirect
 * Matchers for JSON schema 
+* More matchers refactored from [weblaws.org](http://www.weblaws.org/) code
+
+Related Projects
+----------------
+* [serverspec](http://serverspec.org)
+* [HTTP Assertions](https://github.com/dogweather/HTTP-Assertions)
+
 

data/lib/rspec/webservice_matchers/version.rb

@@ -1,5 +1,5 @@
 module RSpec
   module WebserviceMatchers
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
   end
 end

data/lib/rspec/webservice_matchers.rb

@@ -53,9 +53,30 @@ module RSpec
       end
     end   
 
+    # Pass when a URL returns the expected status code
+    # Codes are defined in http://www.rfc-editor.org/rfc/rfc2616.txt
+    RSpec::Matchers.define :be_status do |expected|
+      match do |url_or_domain_name|
+        url    = RSpec::WebserviceMatchers.make_url(url_or_domain_name)
+        result = Curl::Easy.http_head(url)
+        (result.response_code == expected.to_i)
+      end
+    end
+
 
     private
 
+    # Ensure that the given string is a URL,
+    # making it into one if necessary.
+    def self.make_url(url_or_domain_name)
+      unless %r|^https?://| === url_or_domain_name
+        "http://#{url_or_domain_name}"
+      else
+        url_or_domain_name
+      end
+    end
+
+
     # Return a hash of response headers from the
     # given curl result.
     # TODO: Submit as a pull request to the Curb gem.

data/spec/rspec/webservice_matchers/protcol_spec.rb

@@ -0,0 +1,18 @@
+require 'rspec/webservice_matchers'
+
+#
+# TODO: set up a test server or mocks for these.
+#
+describe 'status_code' do
+  it 'can check 200 for successful resource requests' do
+    'http://www.rfc-editor.org/rfc/rfc2616.txt'.should be_status 200
+  end
+
+  it 'handles domain names as well as URLs' do
+    'www.rfc-editor.org'.should be_status 200
+  end
+
+  it 'can check 503 for the Service Unavailable status' do
+    'http://www.weblaws.org/texas/laws/tex._spec._dist._local_laws_code_section_1011.202_tax_to_pay_general_obligation_bonds'.should be_status 503
+  end
+end

metadata

@@ -1,69 +1,69 @@
 --- !ruby/object:Gem::Specification
 name: rspec-webservice_matchers
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Robb Shecter
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-17 00:00:00.000000000 Z
+date: 2014-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: curb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.8'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2'
 description: Black-box web app configuration testing
@@ -73,7 +73,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -81,6 +81,7 @@ files:
 - lib/rspec/webservice_matchers.rb
 - lib/rspec/webservice_matchers/version.rb
 - rspec-webservice_matchers.gemspec
+- spec/rspec/webservice_matchers/protcol_spec.rb
 - spec/rspec/webservice_matchers/redirect_spec.rb
 - spec/rspec/webservice_matchers/ssl_spec.rb
 homepage: https://github.com/dogweather/rspec-webservice_matchers
@@ -93,12 +94,12 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
@@ -108,5 +109,6 @@ signing_key:
 specification_version: 4
 summary: Black-box web app configuration testing
 test_files:
+- spec/rspec/webservice_matchers/protcol_spec.rb
 - spec/rspec/webservice_matchers/redirect_spec.rb
 - spec/rspec/webservice_matchers/ssl_spec.rb