http-rspec 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 38440a523361f901def6f25ea16d718e7616987b9a6627aea7ba945a0fd7b1d0
+  data.tar.gz: 29da744fc13a86642fb3ea3546861aa5c898b318ed57b58c567963583fa04982
+SHA512:
+  metadata.gz: 191c06d510be6887890a5d5dc2c76a1fc6ce2cf342ffbe0e18fe7e11c2a1026e5a56565122bb634bbfafdb8030db65094b8f5a13466557df6ff96b63bb9cc79e
+  data.tar.gz: '0976adaafc6acbd319ab725dcf7eff2febeeb08d43e5d243444846aea3a36e7aac4547192209fa20797e116fe2928f14e5b58ee8348cc7cb8562845a07372984'

data/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+env:
+  BUNDLE_WITHOUT: "development"
+  JRUBY_OPTS: "--dev --debug"
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        ruby: [ ruby-3.0, ruby-3.1, ruby-3.2 ]
+        os: [ ubuntu-latest ]
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - name: bundle exec rspec
+        run: bundle exec rspec --format progress --force-colour
+
+      - name: Prepare Coveralls test coverage report
+        uses: coverallsapp/github-action@v1.1.2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          flag-name: "${{ matrix.ruby }} @${{ matrix.os }}"
+          path-to-lcov: ./coverage/lcov/lcov.info
+          parallel: true
+
+  coveralls:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Finalize Coveralls test coverage report
+        uses: coverallsapp/github-action@master
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          parallel-finished: true
+
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+          bundler-cache: true
+
+      - name: bundle exec rubocop
+        run: bundle exec rubocop --format progress --color
+
+      - run: bundle exec rake verify_measurements

data/.gitignore

@@ -0,0 +1,15 @@
+*.gem
+.config
+.rvmrc
+.yardoc
+InstalledFiles
+_yardoc
+
+.bundle
+.ruby-version
+doc
+coverage
+pkg
+spec/examples.txt
+tmp
+Gemfile.lock

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.rubocop/layout.yml

@@ -0,0 +1,8 @@
+Layout/DotPosition:
+  Enabled: true
+  EnforcedStyle: leading
+
+Layout/HashAlignment:
+  Enabled: true
+  EnforcedColonStyle: table
+  EnforcedHashRocketStyle: table

data/.rubocop/style.yml

@@ -0,0 +1,32 @@
+Style/Documentation:
+  Enabled: false
+
+Style/DocumentDynamicEvalDefinition:
+  Enabled: true
+  Exclude:
+    - 'spec/**/*.rb'
+
+Style/FormatStringToken:
+  Enabled: true
+  EnforcedStyle: unannotated
+
+Style/HashSyntax:
+  Enabled: true
+  EnforcedStyle: hash_rockets
+
+Style/OptionHash:
+  Enabled: true
+
+Style/RescueStandardError:
+  Enabled: true
+  EnforcedStyle: implicit
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/WordArray:
+  Enabled: true
+
+Style/YodaCondition:
+  Enabled: false

data/.rubocop.yml

@@ -0,0 +1,25 @@
+inherit_from:
+  - .rubocop/layout.yml
+  - .rubocop/style.yml
+
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  DefaultFormatter: fuubar
+  DisplayCopNames: true
+  NewCops: enable
+  TargetRubyVersion: 3.0
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*.rb
+
+Metrics/MethodLength:
+  Max: 20
+
+RSpec/MultipleExpectations:
+  Max: 10
+RSpec/ExampleLength:
+  Max: 20

data/.yardopts

@@ -0,0 +1,2 @@
+--markup-provider=kramdown
+--markup=markdown

data/CHANGES.md

@@ -0,0 +1 @@
+## 0.1.0 (Unreleased)

data/CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Help and Discussion
+
+If you need help or just want to talk about the http.rb,
+visit the http.rb Google Group:
+
+https://groups.google.com/forum/#!forum/httprb
+
+You can join by email by sending a message to:
+
+[httprb+subscribe@googlegroups.com](mailto:httprb+subscribe@googlegroups.com)
+
+
+# Reporting bugs
+
+The best way to report a bug is by providing a reproduction script. A half
+working script with comments for the parts you were unable to automate is still
+appreciated.
+
+In any case, specify following info in description of your issue:
+
+- What you're trying to accomplish
+- What you expected to happen
+- What actually happened
+- The exception backtrace(s), if any
+- Version of gem or commit ref you are using
+- Version of ruby you are using

data/Gemfile

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+ruby RUBY_VERSION
+
+gem "rake"
+
+group :development do
+  gem "pry", :require => false
+
+  # RSpec formatter
+  gem "fuubar", :require => false
+
+  platform :mri do
+    gem "pry-byebug"
+  end
+end
+
+group :test do
+  gem "certificate_authority", "~> 1.0", :require => false
+
+  gem "backports"
+
+  gem "rubocop", "~> 1.55.0"
+  gem "rubocop-performance"
+  gem "rubocop-rake"
+  gem "rubocop-rspec"
+
+  gem "simplecov",      :require => false
+  gem "simplecov-lcov", :require => false
+
+  gem "rspec", "~> 3.10"
+  gem "webmock", "~> 3.18"
+
+  gem "yardstick"
+end
+
+group :doc do
+  gem "kramdown"
+  gem "yard"
+end
+
+# Specify your gem's dependencies in http.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011-2022 Tony Arcieri, Erik Michaels-Ober, Alexey V. Zapparov, Zachary Anker
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,135 @@
+# ![http.rb](logo.png)![RSpec](logo-rspec.png)
+
+[![Gem Version][gem-image]][gem-link]
+[![MIT licensed][license-image]][license-link]
+[![Build Status][build-image]][build-link]
+
+[Documentation]
+
+## About
+
+HTTP (The Gem! a.k.a. http.rb) is an easy-to-use client library for making requests
+from Ruby. RSpec is a Behaviour Driven Development spec libary for Ruby. Making TDD 
+Productive and Fun.
+
+This gem adds custom matchers to make it easier to check http requests.
+
+## Installation
+
+Add the gem to your gemfile with bundler 
+```bash 
+$ bunlde add http-rspec  --require
+```
+or manually 
+```
+gem "http-rspec", require: false
+````
+
+Inside of your spec helper (default spec_helper.rb):
+```ruby
+require "http/rspec"
+```
+
+Now you have to include the matchers you want for the blocks you want
+```ruby
+# in spec_helper.rb to include matchers everywhere
+RSpec.configure do |config|
+  config.include HTTP::Support::RspecMatchers
+end
+
+# in spec_helper.rb to include where the type is service
+RSpec.configure do |config|
+  config.include HTTP::Support::RspecMatchers, type: :service
+end
+
+# in the individual describe blocks
+RSpec.describe Service do
+  include HTTP::Support::RspecMatchers
+ 
+  it "makes request" do
+    expect(response).to be_an_http_gem_response.with(status: 200)
+  end
+end
+```
+
+## Documentation
+
+Most things are documented here in the readme
+The following API documentation is also available:
+
+- [YARD API documentation](https://www.rubydoc.info/github/httprb/http-rspec)
+
+### Basic Usage
+
+Here's some simple examples to get you started:
+
+```ruby
+  it "has successful response" do 
+    response = HTTP.get("www.nrk.no")
+    expect(response).to be_an_http_gem_response.with(status: :success) # will match 2xx status code
+    expect(response).to be_an_http_gem_response.with(status: :redirect) # will match 3xx status code
+    expect(response).to be_an_http_gem_response.with(status: :error) # will match 3xx status code
+    
+    expect(response).to be_an_http_gem_response.with(status: :ok) # require 200 status code
+    expect(response).to be_an_http_gem_response.with(status: 200) # require 200 status code
+    expect(response).to be_an_http_gem_response.with(status: :not_found) # require 404 status code
+    expect(response).to be_an_http_gem_response.with(status: 404) # require 404 status code
+    
+    # you can access HTTP::Support::RspecMatchers::STATUS_CODE_TO_SYMBOL to see the full 
+    # mapping between code and symbol
+  end
+```
+
+## Supported Ruby Versions
+
+This library aims to support and is [tested against][build-link]
+the following Ruby  versions:
+
+- Ruby 3.0
+- Ruby 3.1
+- Ruby 3.2
+
+If something doesn't work on one of these versions, it's a bug.
+
+This library may inadvertently work (or seem to work) on other Ruby versions,
+however support will only be provided for the versions listed above.
+
+If you would like this library to support another Ruby version or
+implementation, you may volunteer to be a maintainer. Being a maintainer
+entails making sure all tests run and pass on that implementation. When
+something breaks on your implementation, you will be responsible for providing
+patches in a timely fashion. If critical issues for a particular implementation
+exist at the time of a major release, support for that Ruby version may be
+dropped.
+
+
+## Contributing to http.rb rspec
+
+- Fork http.rb on GitHub
+- Make your changes
+- Ensure all tests pass (`bundle exec rake`)
+- Send a pull request
+- If we like them we'll merge them
+- If we've accepted a patch, feel free to ask for commit access!
+
+
+## Copyright
+
+Copyright © 2011-2023 Tony Arcieri, Alexey V. Zapparov, Erik Michaels-Ober, Zachary Anker, Simon Toivo Telhaug
+See LICENSE.txt for further details.
+
+
+[//]: # (badges)
+
+[gem-image]: https://img.shields.io/gem/v/httprb_status?logo=ruby
+[gem-link]: https://rubygems.org/gems/http_rspec
+[license-image]: https://img.shields.io/badge/license-MIT-blue.svg
+[license-link]: https://github.com/httprb/http-rspec/blob/main/LICENSE.txt
+[build-image]: https://github.com/httprb/http-rspec/workflows/CI/badge.svg
+[build-link]: https://github.com/httprb/http-rspec/actions/workflows/ci.yml
+
+[//]: # (links)
+
+[documentation]: https://github.com/httprb/http-rspec/wiki
+[requests]: https://docs.python-requests.org/en/latest/
+[llhttp]: https://llhttp.org/

data/Rakefile

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new
+
+require "rubocop/rake_task"
+RuboCop::RakeTask.new
+
+require "yardstick/rake/measurement"
+Yardstick::Rake::Measurement.new do |measurement|
+  measurement.output = "measurement/report.txt"
+end
+
+require "yardstick/rake/verify"
+Yardstick::Rake::Verify.new do |verify|
+  verify.require_exact_threshold = false
+  verify.threshold = 55
+end
+
+task :default => %i[spec rubocop verify_measurements]

data/httprb_rspec.gemspec

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "http_rspec/version"
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Simon Toivo Telhaug"]
+  gem.email         = ["bascule@gmail.com"]
+
+  gem.description   = <<-DESCRIPTION.strip.gsub(/\s+/, " ")
+    Include helpfull matchers for mathing statuscodes
+  DESCRIPTION
+
+  gem.summary       = "HTTP Rspec matchers"
+  gem.homepage      = "https://github.com/httprb/http-rspec"
+  gem.licenses      = ["MIT"]
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.name          = "http-rspec"
+  gem.require_paths = ["lib"]
+  gem.version       = HttpRspec::VERSION
+
+  gem.required_ruby_version = ">= 3.0"
+
+  gem.add_runtime_dependency "http", ">= 4.0"
+
+  gem.metadata = {
+    "source_code_uri"       => "https://github.com/httprb/http-rspec",
+    "bug_tracker_uri"       => "https://github.com/httprb/http-rspec/issues",
+    "changelog_uri"         => "https://github.com/httprb/http-rspec/blob/v#{HttpRspec::VERSION}/CHANGES.md",
+    "rubygems_mfa_required" => "true"
+  }
+
+  gem.license = "MIT"
+end

data/lib/http/rspec.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "support/rspec_matchers"

data/lib/http/support/rspec_matchers.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require "http"
+
+module HTTP
+  module Support
+    module RspecMatchers
+      extend RSpec::Matchers::DSL
+
+      STATUS_CODE_TO_SYMBOL = HTTP::Response::Status::REASONS
+                              .transform_values do |name|
+        name.gsub(/[- ]/, "_")
+            .downcase.gsub(/[^a-z_]/, "")
+            .to_sym
+      end
+      STATUS_SYMBOL_TO_CODE = STATUS_CODE_TO_SYMBOL.invert
+
+      matcher :be_an_http_gem_response do |_expected| # rubocop:disable Metrics/BlockLength
+        chain :with do |options|
+          if options[:status]
+            raise ArgumentError, "status is all ready passed in" if @expected_status
+
+            @expected_status = options[:status]
+          end
+        end
+
+        def expected_code
+          case @expected_status
+          when Integer then @expected_status
+          when :success, :successful then 200..299
+          when :redirect then 300..399
+          when :error then 500..599
+          when Symbol
+            STATUS_SYMBOL_TO_CODE.fetch(@expected_status) do
+              raise ArgumentError, "unknown symbol #{@expected_status.inspect}"
+            end
+          else
+            raise ArgumentError, "unknown status value. Should be either a Integer or a symbol"
+          end
+        end
+
+        match do |actual|
+          @actual = actual
+
+          match_response_type && match_status_code
+        end
+
+        def match_response_type = @actual.is_a?(HTTP::Response)
+
+        def match_status_code
+          # without @expected_status we dont have anything to compare against
+          return true unless @expected_status
+
+          case expected_code
+          when Integer
+            expected_code == @actual.status.code
+          when Range
+            expected_code.cover?(@actual.status.code)
+          else
+            raise "Unknown expected code #{expected_code}. Please report this as an issue"
+          end
+        end
+
+        def status_code_to_name(code)
+          STATUS_CODE_TO_SYMBOL.fetch(code, "unkown name")
+        end
+
+        def expected_type
+          case expected_code
+          when Range then "#{expected_code} code"
+          else
+            "#{expected_code} #{status_code_to_name(expected_code).inspect}"
+          end
+        end
+
+        description do
+          "http gem respond"
+            .then { @expected_status ? "#{_1} with #{expected_type}" : _1 }
+        end
+
+        def invalid_response_type_message
+          "expected a HTTP::Response object, but an instance of " \
+            "#{@actual.class} was received"
+        end
+
+        def actual_type
+          "#{actual.status.code} #{status_code_to_name(actual.status.code).inspect}"
+        end
+
+        def failure_message
+          return invalid_response_type_message unless match_response_type
+
+          return "expected the response to have #{expected_type} but it was #{actual_type}" unless match_status_code
+
+          "unknown reason why it fails, please report it"
+        end
+
+        def failure_message_when_negated
+          return invalid_response_type_message unless match_response_type
+
+          return "expected the response not to have #{expected_type} but it was #{actual_type}" if match_status_code
+
+          "unknown reason why it fails, please report it"
+        end
+      end
+    end
+  end
+end

data/lib/http_rspec/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module HttpRspec
+  VERSION = "0.1.0"
+end

data/spec/http/support/rspec_matchers_spec.rb

@@ -0,0 +1,231 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+require "http/support/rspec_matchers"
+
+RSpec.describe HTTP::Support::RspecMatchers do
+  include described_class
+
+  describe "be_an_http_gem_response" do
+    it "raises error if it gets unexpected argument" do
+      matcher = be_an_http_gem_response
+
+      expect(matcher.matches?("response")).to be(false)
+      expect(matcher.failure_message)
+        .to eq("expected a HTTP::Response object, but an instance of String was received")
+    end
+
+    it "description with no other constrains" do
+      matcher = be_an_http_gem_response
+      stub_request(:get, "https://nrk.no/").to_return(:status => 200)
+
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+      expect(matcher.description).to eq("http gem respond")
+    end
+
+    it "description include status" do
+      matcher = be_an_http_gem_response.with(:status => 200)
+      stub_request(:get, "https://nrk.no/").to_return(:status => 200)
+
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+      expect(matcher.description).to eq("http gem respond with 200 :ok")
+    end
+
+    it "has reasonable failure message for 200 ok failure" do
+      matcher = be_an_http_gem_response.with(:status => 200)
+      stub_request(:get, "https://nrk.no/").to_return(:status => 400)
+
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(false)
+      expect(matcher.failure_message)
+        .to eq("expected the response to have 200 :ok but it was 400 :bad_request")
+    end
+
+    it "has reasonable description for negated 200 ok failure" do
+      matcher = be_an_http_gem_response.with(:status => 200)
+      stub_request(:get, "https://nrk.no/").to_return(:status => 200)
+
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+      expect(matcher.failure_message_when_negated)
+        .to eq("expected the response not to have 200 :ok but it was 200 :ok")
+    end
+
+    describe "convert symbol into code" do
+      before do
+        stub_request(:get, "https://nrk.no/").to_return(:status => 299)
+      end
+
+      let(:response) { HTTP.get("https://nrk.no") }
+
+      it "raises for unknown symbol" do
+        expect do
+          matcher = be_an_http_gem_response.with(:status => :ruby)
+          matcher.matches?(response)
+        end
+          .to raise_error(ArgumentError, "unknown symbol :ruby")
+      end
+
+      it "raises for wrong type" do
+        expect do
+          matcher = be_an_http_gem_response.with(:status => "Coty")
+          matcher.matches?(response)
+        end
+          .to raise_error(ArgumentError, "unknown status value. Should be " \
+                                         "either a Integer or a symbol")
+      end
+
+      it "can take :continue and convert in into 100" do
+        matcher = be_an_http_gem_response.with(:status => :continue)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 100 :continue but/)
+      end
+
+      it "can take :switching_protocols and convert in into 101" do
+        matcher = be_an_http_gem_response.with(:status => :switching_protocols)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 101 :switching_protocols but/)
+      end
+
+      it "can take :ok and convert in into 200" do
+        matcher = be_an_http_gem_response.with(:status => :ok)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 200 :ok but/)
+      end
+
+      it "can take :created and convert in into 201" do
+        matcher = be_an_http_gem_response.with(:status => :created)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 201 :created but/)
+      end
+
+      it "can take :non_authoritative_information and convert in into 203" do
+        matcher = be_an_http_gem_response.with(:status => :non_authoritative_information)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 203 :non_authoritative_information but/)
+      end
+
+      it "can take :multi_status and convert in into 207" do
+        matcher = be_an_http_gem_response.with(:status => :multi_status)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 207 :multi_status but/)
+      end
+
+      it "can take :not_found and convert in into 404" do
+        matcher = be_an_http_gem_response.with(:status => :not_found)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 404 :not_found but/)
+      end
+
+      it "can take :uri_too_long and convert in into 414" do
+        matcher = be_an_http_gem_response.with(:status => :uri_too_long)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 414 :uri_too_long but/)
+      end
+
+      it "can take :internal_server_error and convert in into 500" do
+        matcher = be_an_http_gem_response.with(:status => :internal_server_error)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 500 :internal_server_error but/)
+      end
+
+      it "can take :gateway_timeout and convert in into 504" do
+        matcher = be_an_http_gem_response.with(:status => :gateway_timeout)
+        expect(matcher.matches?(response)).to be(false)
+        expect(matcher.failure_message)
+          .to match(/expected the response to have 504 :gateway_timeout but/)
+      end
+    end
+
+    %i[success successful].each do |success_name|
+      it "accepts #{success_name} for all 2xx codes" do
+        matcher = be_an_http_gem_response.with(:status => success_name)
+
+        stub_request(:get, "https://nrk.no/").to_return(:status => 200)
+        response = HTTP.get("https://nrk.no")
+        expect(matcher.matches?(response)).to be(true)
+
+        stub_request(:get, "https://nrk.no/").to_return(:status => 201)
+        response = HTTP.get("https://nrk.no")
+        expect(matcher.matches?(response)).to be(true)
+
+        stub_request(:get, "https://nrk.no/").to_return(:status => 210)
+        response = HTTP.get("https://nrk.no")
+        expect(matcher.matches?(response)).to be(true)
+
+        stub_request(:get, "https://nrk.no/").to_return(:status => 400)
+        response = HTTP.get("https://nrk.no")
+        expect(matcher.matches?(response)).to be(false)
+
+        expect(matcher.failure_message)
+          .to eq("expected the response to have 200..299 code but it was 400 :bad_request")
+      end
+    end
+
+    it "accepts :redirect for all 3xx codes" do
+      matcher = be_an_http_gem_response.with(:status => :redirect)
+
+      stub_request(:get, "https://nrk.no/").to_return(:status => 300)
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+
+      stub_request(:get, "https://nrk.no/").to_return(:status => 301)
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+
+      stub_request(:get, "https://nrk.no/").to_return(:status => 310)
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+
+      stub_request(:get, "https://nrk.no/").to_return(:status => 400)
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(false)
+
+      expect(matcher.failure_message)
+        .to eq("expected the response to have 300..399 code but it was 400 :bad_request")
+    end
+
+    it "accepts :error for all 5xx codes" do
+      matcher = be_an_http_gem_response.with(:status => :error)
+
+      stub_request(:get, "https://nrk.no/").to_return(:status => 500)
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+
+      stub_request(:get, "https://nrk.no/").to_return(:status => 501)
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+
+      stub_request(:get, "https://nrk.no/").to_return(:status => 510)
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(true)
+
+      stub_request(:get, "https://nrk.no/").to_return(:status => 400)
+      response = HTTP.get("https://nrk.no")
+      expect(matcher.matches?(response)).to be(false)
+
+      expect(matcher.failure_message)
+        .to eq("expected the response to have 500..599 code but it was 400 :bad_request")
+    end
+  end
+
+  it "raises if you call it with twice with status" do
+    expect do
+      matcher = be_an_http_gem_response.with(:status => 200).with(:status => 300)
+      matcher.matches?(response)
+    end
+      .to raise_error(ArgumentError, "status is all ready passed in")
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require_relative "support/simplecov"
+require_relative "support/fuubar" unless ENV["CI"]
+
+require "http"
+require "webmock/rspec"
+
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    # be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.filter_run_excluding :flaky if defined?(JRUBY_VERSION) && ENV["CI"]
+  config.run_all_when_everything_filtered = true
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = 0 == ENV["GUARD_RSPEC"].to_i
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = "doc"
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  # config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+end

data/spec/support/fuubar.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "fuubar"
+
+RSpec.configure do |config|
+  # Use Fuubar instafail-alike formatter, unless a formatter has already been
+  # configured (e.g. via a command-line flag).
+  config.default_formatter = "Fuubar"
+
+  # Disable auto-refresh of the fuubar progress bar to avoid surprises during
+  # debugiing. And simply because there's next to absolutely no point in having
+  # this turned on.
+  #
+  # > By default fuubar will automatically refresh the bar (and therefore
+  # > the ETA) every second. Unfortunately this doesn't play well with things
+  # > like debuggers. When you're debugging, having a bar show up every second
+  # > is undesireable.
+  #
+  # See: https://github.com/thekompanee/fuubar#disabling-auto-refresh
+  config.fuubar_auto_refresh = false
+end

data/spec/support/simplecov.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "simplecov"
+
+if ENV["CI"]
+  require "simplecov-lcov"
+
+  SimpleCov::Formatter::LcovFormatter.config do |config|
+    config.report_with_single_file = true
+    config.lcov_file_name          = "lcov.info"
+  end
+
+  SimpleCov.formatter = SimpleCov::Formatter::LcovFormatter
+end
+
+SimpleCov.start do
+  add_filter "/spec/"
+  minimum_coverage 80
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: http-rspec
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Simon Toivo Telhaug
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-08-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: Include helpfull matchers for mathing statuscodes
+email:
+- bascule@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".rubocop/layout.yml"
+- ".rubocop/style.yml"
+- ".yardopts"
+- CHANGES.md
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- httprb_rspec.gemspec
+- lib/http/rspec.rb
+- lib/http/support/rspec_matchers.rb
+- lib/http_rspec/version.rb
+- logo-rspec.png
+- logo.png
+- spec/http/support/rspec_matchers_spec.rb
+- spec/spec_helper.rb
+- spec/support/fuubar.rb
+- spec/support/simplecov.rb
+homepage: https://github.com/httprb/http-rspec
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/httprb/http-rspec
+  bug_tracker_uri: https://github.com/httprb/http-rspec/issues
+  changelog_uri: https://github.com/httprb/http-rspec/blob/v0.1.0/CHANGES.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: HTTP Rspec matchers
+test_files: []