richard_iii 0.0.2 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2778cafda0e669461d11038fb18214895b8718f7
-  data.tar.gz: 1011b06506a60f98edaf3d980e37b3d43d143cc6
+  metadata.gz: 434e46a127df3a3f2b582f0f756fa532af1dd7ec
+  data.tar.gz: a001d83f06e97f59587e9d2bb9986f288c53cde1
 SHA512:
-  metadata.gz: 547792d0cf8db701e128bd41ea1de9ad9e7b05caa3751d6811a322556cfbe50efa7aa2ee443a6841ae666030f52e7be8e5ad02d494c0206e9a1be9ac77aca85d
-  data.tar.gz: aa0bd33e8d43f0116cc838c83f2549c119e3dce4548ac288adf1af9ea07ed42276318d6218495b892e88e0260b6e00626439c524372543ca4932d31f92e74c3a
+  metadata.gz: 17c790c383ba196b630152af5e31cd9e1a242f72225352715f9f98b3ad98395e2f3dea20f0576c551ef17f4d879f3c5bca9a816d94a0e636255d20024c3b8775
+  data.tar.gz: cd5010064c3b9b4e3e26c3bf23c44a3c253aa29a5ab10d702ce8787ebaa5bd02f1b3699f703c1d9268cf2c6076f60487dc98ea61fc8fd9701d8cf331eb14b95b

data/.travis.yml

@@ -0,0 +1,11 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+branches:
+  only:
+    - master
+gemfile: Gemfile
+notifications:
+  recipients:
+    - ben.biddington@gmail.com

data/README.md

@@ -1,31 +1,42 @@
-# RichardIii
+# Richard III
 
-TODO: Write a gem description
+[![Build Status](https://secure.travis-ci.org/ben-biddington/richard_iii.png)](http://travis-ci.org/ben-biddington/richard_iii)
 
-## Installation
+Based on [HTTP/1.1](http://www.w3.org/Protocols/rfc2616/rfc2616-sec5.html)
 
-Add this line to your application's Gemfile:
+Here's what we'd like to be able to write about any restful microservice:
 
-```ruby
-gem 'richard_iii'
 ```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install richard_iii
-
-## Usage
-
-TODO: Write usage instructions here
-
-## Contributing
-
-1. Fork it ( https://github.com/[my-github-username]/richard_iii/fork )
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request
+describe "An end-to-end example" do
+  it "lets me see raw text" do
+    when_I_request <<-TEXT 
+      GET /1.1/statuses
+      Host: api.twitter.com
+      Accept: application/json
+    TEXT
+
+   then_I_get <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      content-length: 24
+      content-type: text/plain;charset=utf-8
+      date: Sat, 30 Aug 2014 01:30:43 UTC
+      server: tsa_a
+      set-cookie: guest_id=v1%3A140936224322485447; Domain=.twitter.com; Path=/; Expires=Mon, 29-Aug-2016 01:30:43 UTC
+      strict-transport-security: max-age=631138519
+      x-connection-hash: 7710cb2762e0a47702d21bb7e10d3056
+
+      Bad Authentication data
+    REPLY
+  end
+
+  private
+
+  def when_I_request(text)
+    fail "Not implemented"
+  end
+
+  def then_I_get(what)
+    fail "Not implemented"
+  end
+end
+```

data/Rakefile

@@ -1,2 +1,17 @@
 require "bundler/gem_tasks"
 
+require 'rake/testtask'
+
+namespace :test do 
+  %w{unit integration acceptance}.each do |name|
+    Rake::TestTask.new do |t|
+      t.name = name		   
+      t.test_files = FileList["test/#{name}.tests/**/*.rb"]
+    end
+  end	  
+
+  desc "Run all tests"
+  task :all => ["test:unit", "test:integration", "test:acceptance"]
+end
+
+task :default => "test:unit"

data/lib/richard_iii/curl_reply.rb

@@ -0,0 +1,72 @@
+module Richard
+  class CurlReply
+    attr_reader :missing, :surplus
+
+    def initialize(text)
+      @text = text
+      @missing = @surplus = []
+      @pretty = false
+    end
+
+    def use_pretty_xml
+      @pretty = true;
+    end
+
+    def matches?(expected)
+      actual_lines   = strip(@text)
+      
+      expected_lines = parse(expected)
+   
+      matches = actual_lines.select do |line|
+        expected_lines.any?{|it| it.matches?(line)}
+      end
+
+      expectations_that_did_not_match_anything = expected_lines.select do |expected|
+        actual_lines.none?{|line| expected.matches?(line)}
+      end
+
+      @missing = expectations_that_did_not_match_anything.map(&:text)
+      @surplus = actual_lines - matches
+
+      return matches.size.eql? expected_lines.size
+    end
+
+    def eql?(text)
+      strip(@text).eql? strip(text)
+    end
+
+    def equals?(text); self.eql? text; end
+    def ==(text); self.eql? text; end
+
+    def to_s; @text; end
+    def inspect; to_s; end
+
+    private
+   
+    def parse(text)
+      convert_all strip(text)
+    end
+
+    def strip(text)
+      format(text).map(&:chomp).map(&:strip)
+    end
+    
+    def format(text)
+      return text.lines unless @pretty
+     
+      lines = text.lines
+      
+      body = lines.delete_at(lines.size-1)
+
+      lines += Richard::Internal::XmlFormat.pretty(body)
+
+      lines
+    end
+
+    def convert_all(lines=[])
+      lines.map do |text| 
+        text.start_with?("/") ? Richard::Internal::PatternLine.new(text) : Richard::Internal::TextLine.new(text)
+      end
+    end
+  end
+end

data/lib/richard_iii/internal/curl.rb

@@ -0,0 +1,68 @@
+module Richard
+  module Internal
+    class BasicRequestLineParser
+      class << self
+        def from(text, headers)
+          lines = text.lines.map(&:chomp).map(&:strip)
+
+          verb = lines.first.match(/^(\w+)/)[1]
+          path = lines.first.match(/(\S+)$/)[1]
+          host = headers["Host"]
+
+          is_absolute = path.include?('://')
+
+          fail "Missing host header. When you supply a relative earl you have to supply host header too." if !is_absolute && host.nil?
+
+          earl = is_absolute ? path : "https://#{host}#{path}"
+
+          RequestLine.new(verb, earl)
+        end
+      end
+    end
+
+    class BasicHeaderParser
+      class << self
+        def from(text)
+          lines = text.lines.map(&:chomp).map(&:strip)
+          lines.drop(1).take_while{|line| !line.strip.empty?}.map do |line|
+            name,value = line.split(':')
+            RequestHeader.new name.strip, value.strip
+          end
+        end
+      end
+    end
+
+    class BasicBodyParser
+      class << self
+        def from(text)
+          lines = text.lines.map(&:chomp).map(&:strip)
+          lines.drop_while{|line| !line.strip.empty?}.drop(1).first
+        end
+      end
+    end
+
+    class CurlFormat
+      class << self
+        def as_string(reply)
+          return '' if reply.nil?
+          CurlReply.new((
+            ["HTTP/1.1 #{reply.status}"] + 
+            headers_from(reply) + 
+            ["\n#{reply.body.strip}\n"]
+          ).join("\n"))
+        end
+
+        private
+
+        def headers_from(reply)
+          reply.headers.map do |name, value|
+            "#{name}: #{value}"
+          end.to_a
+        end
+      end
+    end
+
+    RequestLine   = Struct.new 'RequestLine'  , :verb, :uri
+    RequestHeader = Struct.new 'RequestHeader', :name, :value
+  end
+end

data/lib/richard_iii/internal/text_line.rb

@@ -0,0 +1,29 @@
+module Richard
+  module Internal
+    class TextLine
+      attr_reader :text
+      
+      def initialize(text)
+        @text = text || fail("You need to supply some text even if it's empty")
+      end
+
+      def matches?(text)
+        @text.eql?(text)
+      end
+    end
+
+    class PatternLine
+      attr_reader :text
+      
+      def initialize(text)
+        @text = text || fail("You need to supply some text even if it's empty")
+      end
+
+      # [!] expects lines to start and end with /
+      def matches?(text)
+        regex = Regexp.new(@text.slice(1,(@text.size-2)))
+        false == regex.match(text).nil?
+      end
+    end
+  end
+end

data/lib/richard_iii/internal/xml_format.rb

@@ -0,0 +1,17 @@
+module Richard
+  module Internal
+    class XmlFormat 
+      class << self
+        def pretty(text)
+          require 'nokogiri'
+    
+          doc = Nokogiri.XML(text) do |config|
+            config.default_xml.noblanks
+          end
+
+          doc.to_xml(:indent => 2).lines.drop(1)
+        end
+      end
+    end
+  end
+end

data/lib/richard_iii/request_and_response.rb

@@ -0,0 +1,33 @@
+module Richard
+  class Request
+    attr_reader :verb, :uri, :headers, :body
+
+    def initialize(opts={})
+      @verb,@uri,@headers,@body = opts[:verb],opts[:uri],opts[:headers],opts[:body]
+    end
+
+    def eql?(other)
+      self.verb.eql?(other.verb) && self.uri.eql?(other.uri) && self.headers == other.headers && self.body.eql?(other.body)
+    end
+  end
+
+  class Response
+    attr_reader :status, :headers, :body
+
+    def initialize(opts={})
+      @status,@headers,@body = opts[:status],opts[:headers],opts[:body]
+    end
+
+    def eql?(other)
+      self.status.eql?(other.status) && self.headers == other.headers && self.body.eql?(other.body)
+    end
+
+    def each_header(&block)
+      self.headers.each_pair{|k,v| block.call(k,v)}
+    end
+  end
+
+  Status = Struct.new 'Status', :code, :desc do 
+    def to_s; "#{code} #{desc}"; end
+  end
+end

data/lib/richard_iii/version.rb

@@ -1,3 +1,3 @@
 module RichardIii
-  VERSION = "0.0.2"
+  VERSION = "0.1.0"
 end

data/lib/richard_iii.rb

@@ -1,5 +1,48 @@
-require "richard_iii/version"
+module Richard; end
 
-module RichardIii
-  # Your code goes here...
+dir = File.join(File.dirname(__FILE__))
+
+$LOAD_PATH.unshift File.join(dir, 'richard_iii')
+
+Dir.glob(File.join(dir, "richard_iii", "**", "*.rb")).each {|f| require f}
+
+module Richard
+  class III
+    def initialize(opts={})
+      @internet = opts[:internet] || fail("You need to supply :internet")
+    end
+
+    def exec(text)
+      request_line = request_line_from text
+
+      reply = @internet.execute(
+        Richard::Request.new(
+          :verb     => request_line.verb, 
+          :uri      => request_line.uri,
+          :headers  => headers_from(text),
+          :body     => body_from(text)
+        )
+      )
+
+      Internal::CurlFormat.as_string reply
+    end
+
+    private
+    
+    def request_line_from(text)
+      Richard::Internal::BasicRequestLineParser.from text, headers_from(text)
+    end
+
+    def headers_from(text)
+      result = {}
+
+      Internal::BasicHeaderParser.from(text).each{|h| result[h.name] = h.value }
+
+      result
+    end
+
+    def body_from(text)
+      Internal::BasicBodyParser.from(text)
+    end
+  end
 end

data/richard_iii.gemspec

@@ -18,6 +18,8 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_dependency "nokogiri"
+  spec.add_development_dependency "bundler", "~> 1.6"
   spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "tinternet"
 end

data/test/acceptance.tests/an_example.rb

@@ -0,0 +1,34 @@
+require File.join '.', 'test', 'helper'
+
+describe "An end-to-end example" do
+  it "lets me see raw text" do
+    when_I_request <<-TEXT 
+      GET /1.1/statuses
+      Host: api.twitter.com
+      Accept: application/json
+    TEXT
+
+   then_I_get <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      content-length: 24
+      content-type: text/plain;charset=utf-8
+      date: Sat, 30 Aug 2014 01:30:43 UTC
+      server: tsa_a
+      set-cookie: guest_id=v1%3A140936224322485447; Domain=.twitter.com; Path=/; Expires=Mon, 29-Aug-2016 01:30:43 UTC
+      strict-transport-security: max-age=631138519
+      x-connection-hash: 7710cb2762e0a47702d21bb7e10d3056
+
+      Bad Authentication data
+    REPLY
+  end
+
+  private
+
+  def when_I_request(text)
+    fail "Not implemented"
+  end
+
+  def then_I_get(what)
+    fail "Not implemented"
+  end
+end

data/test/helper.rb

@@ -0,0 +1,9 @@
+require 'minitest/autorun'
+require 'minitest/pride'
+require 'richard_iii'
+
+include Richard
+
+dir = File.join(File.dirname(__FILE__))
+
+Dir.glob(File.join(dir, "support", "**", "*.rb")).each {|f| require f}

data/test/integration.tests/adapters/internet.rb

@@ -0,0 +1,19 @@
+require File.join '.', 'test', 'helper'
+
+class SystemInternet
+  class << self
+    def execute(request)
+      require 't'
+      reply = T::Internet.new.execute(T::Request.new(:verb => :get, :uri => "http://api.twitter.com/1.1/statuses"))
+
+      Richard::Response.new :status => reply.code
+    end
+  end
+end
+
+describe "the internet adapter" do
+  it "can be asked to execute a basic get" do
+    reply = SystemInternet.execute Request.new(:verb => "GET", :uri => "http://api.twitter.com/1.1/statuses")
+    reply.status.must_equal 400
+  end
+end

data/test/support/extensions.rb

@@ -0,0 +1,13 @@
+require 'minitest/unit'
+
+Richard::CurlReply.class_eval do
+  include MiniTest::Assertions
+  
+  def must_match(expected)
+    assert(self.matches?(expected), "Expected <#{self}> to match <#{expected}>")
+  end
+
+  def must_not_match(expected)
+    assert(false === self.matches?(expected), "Expected <#{self}> not to match <#{expected}>")
+  end
+end

data/test/support/spy_internet.rb

@@ -0,0 +1,18 @@
+class SpyInternet
+  def initialize
+    @requests = []
+  end
+
+  def execute(request)
+    @requests << request
+    @response
+  end
+
+  def must_have_been_asked_to_execute(what)
+    @requests.any?{|it| it.eql? what}.must_be :==, true, "Unable to locate match for:\n\n#{what.inspect}\n\nin:\n\n#{@requests.inspect}"
+  end
+
+  def always_return(response)
+    @response = response
+  end
+end

data/test/unit.tests/can_conduct_conversations.rb

@@ -0,0 +1,46 @@
+require File.join '.', 'test', 'helper'
+
+describe "Full conversations" do 
+  before do
+    @internet = SpyInternet.new
+
+    @internet.always_return(
+      Response.new(
+        :status  => Status.new(400, 'Bad Request'),
+        :headers => {
+           'content-length'            => 24,
+           'content-type'              => 'text/plain;charset=utf-8',
+           'date'                      => 'Sat, 30 Aug 2014 01:30:43 UTC',
+           'server'                    => 'tsa_a',
+           'set-cookie'                => 'guest_id=v1%3A140936224322485447; Domain=.twitter.com; Path=/; Expires=Mon, 29-Aug-2016 01:30:43 UTC',
+           'strict-transport-security' => 'max-age=631138519',
+           'x-connection-hash'         => '7710cb2762e0a47702d21bb7e10d3056'
+        },
+        :body => 'Bad Authentication data'
+      )
+    )
+
+    richard_iii = Richard::III.new :internet => @internet
+
+    @reply = richard_iii.exec <<-TEXT 
+      GET /1.1/statuses
+      Host: api.twitter.com
+      Accept: application/json
+    TEXT
+  end
+
+  it "can be used to conduct a conversation" do
+    assert_equal @reply, <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      content-length: 24
+      content-type: text/plain;charset=utf-8
+      date: Sat, 30 Aug 2014 01:30:43 UTC
+      server: tsa_a
+      set-cookie: guest_id=v1%3A140936224322485447; Domain=.twitter.com; Path=/; Expires=Mon, 29-Aug-2016 01:30:43 UTC
+      strict-transport-security: max-age=631138519
+      x-connection-hash: 7710cb2762e0a47702d21bb7e10d3056
+
+      Bad Authentication data
+    REPLY
+  end
+end

data/test/unit.tests/can_find_out_why_a_match_failed.rb

@@ -0,0 +1,69 @@
+require File.join '.', 'test', 'helper'
+
+describe "Finding out why a match failed" do 
+  before do
+    @internet = SpyInternet.new
+
+    @internet.always_return(
+      Response.new(
+        :status  => Status.new(400, 'Bad Request'),
+        :headers => {
+           'content-length'            => 24,
+           'content-type'              => 'text/plain;charset=utf-8',
+           'date'                      => 'Sat, 30 Aug 2014 01:30:43 UTC',
+           'server'                    => 'tsa_a',
+           'set-cookie'                => 'guest_id=v1%3A140936224322485447; Domain=.twitter.com; Path=/; Expires=Mon, 29-Aug-2016 01:30:43 UTC',
+           'strict-transport-security' => 'max-age=631138519',
+           'x-connection-hash'         => '7710cb2762e0a47702d21bb7e10d3056'
+        },
+        :body => 'Bad Authentication data'
+      )
+    )
+
+    richard_iii = Richard::III.new :internet => @internet
+
+    @reply = richard_iii.exec <<-TEXT 
+      GET /1.1/statuses
+      Host: api.twitter.com
+      Accept: application/json
+    TEXT
+  end
+
+  it "tells you which expected lines are missing" do
+    expected = <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      content-type: text/plain;charset=utf-8
+
+      xxx_body_differs_xxx
+    REPLY
+
+    @reply.must_not_match expected
+
+    @reply.missing.must_equal ['xxx_body_differs_xxx']
+  end
+
+  it "tells you which lines are present that were not expected, i.e., are surplus" do
+    expected = <<-REPLY 
+      HTTP/1.1 400 Bad Request
+    REPLY
+
+    @reply.matches? expected
+
+    @reply.surplus.must_equal [
+      "content-length: 24", 
+      "content-type: text/plain;charset=utf-8", 
+      "date: Sat, 30 Aug 2014 01:30:43 UTC",
+      "server: tsa_a", 
+      "set-cookie: guest_id=v1%3A140936224322485447; Domain=.twitter.com; Path=/; Expires=Mon, 29-Aug-2016 01:30:43 UTC", 
+      "strict-transport-security: max-age=631138519", 
+      "x-connection-hash: 7710cb2762e0a47702d21bb7e10d3056", 
+      "", 
+      "Bad Authentication data"
+    ]
+  end
+
+  it "both surplus and missing are empty before matching" do
+    @reply.missing.must_equal []
+    @reply.surplus.must_equal []
+  end
+end

data/test/unit.tests/can_match_pretty_formatted_xml_bodies.rb

@@ -0,0 +1,36 @@
+require File.join '.', 'test', 'helper'
+
+describe "Matching pretty-formatted bodies" do
+  before do
+    @curl_reply = CurlReply.new <<-TEXT
+      HTTP/1.1 200 OK
+      Content-Type: text/xml; charset=utf-8
+
+      <?xml version="1.0" encoding="utf-8"?><current><city id="6058560" name="London" /><humidity value="76" unit="%"/><pressure value="1018" unit="hPa"/></current>
+    TEXT
+  end
+
+  it "matches when you have neither pretty formatted" do
+    @curl_reply.must_match <<-TEXT
+      HTTP/1.1 200 OK
+      Content-Type: text/xml; charset=utf-8
+
+      <?xml version="1.0" encoding="utf-8"?><current><city id="6058560" name="London" /><humidity value="76" unit="%"/><pressure value="1018" unit="hPa"/></current>
+    TEXT
+  end
+
+  it "matches when you say yes to pretty bodies" do
+    @curl_reply.use_pretty_xml
+    @curl_reply.must_match <<-TEXT
+      HTTP/1.1 200 OK
+      Content-Type: text/xml; charset=utf-8
+
+      <?xml version="1.0" encoding="utf-8"?>
+      <current>
+        <city id="6058560" name="London"/>
+        <humidity value="76" unit="%"/>
+        <pressure value="1018" unit="hPa"/>
+      </current>
+    TEXT
+  end
+end

data/test/unit.tests/can_partial_match_on_replies.rb

@@ -0,0 +1,75 @@
+require File.join '.', 'test', 'helper'
+
+describe "Partial matching replies" do 
+  before do
+    @internet = SpyInternet.new
+
+    @internet.always_return(
+      Response.new(
+        :status  => Status.new(400, 'Bad Request'),
+        :headers => {
+           'content-length'            => 24,
+           'content-type'              => 'text/plain;charset=utf-8',
+           'date'                      => 'Sat, 30 Aug 2014 01:30:43 UTC',
+           'server'                    => 'tsa_a',
+           'set-cookie'                => 'guest_id=v1%3A140936224322485447; Domain=.twitter.com; Path=/; Expires=Mon, 29-Aug-2016 01:30:43 UTC',
+           'strict-transport-security' => 'max-age=631138519',
+           'x-connection-hash'         => '7710cb2762e0a47702d21bb7e10d3056'
+        },
+        :body => 'Bad Authentication data'
+      )
+    )
+
+    richard_iii = Richard::III.new :internet => @internet
+
+    @reply = richard_iii.exec <<-TEXT 
+      GET /1.1/statuses
+      Host: api.twitter.com
+      Accept: application/json
+    TEXT
+  end
+
+  it "can match partially, so that you can ignore headers like date" do
+    expected = <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      content-type: text/plain;charset=utf-8
+
+      Bad Authentication data
+    REPLY
+
+    @reply.must_match expected
+  end
+
+  it "fails when the response line does not match" do
+    expected = <<-REPLY 
+      HTTP/1.1 XXX_BAD_RESPONSE_LINE
+      content-type: text/plain;charset=utf-8
+
+      Bad Authentication data
+    REPLY
+
+    @reply.must_not_match expected
+  end
+
+  it "fails, for example, when you expected a header that is not present" do
+    expected = <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      xxx: this_one_is_not_present
+
+      Bad Authentication data
+    REPLY
+
+    @reply.must_not_match expected
+  end
+
+  it "fails when the body does not match" do
+    expected = <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      content-type: text/plain;charset=utf-8
+
+      Who says famine has to be depressing
+    REPLY
+
+    @reply.must_not_match expected
+  end
+end

data/test/unit.tests/can_pattern_match_replies.rb

@@ -0,0 +1,37 @@
+require File.join '.', 'test', 'helper'
+
+describe "Pattern matching on reply lines" do
+  before do
+    @curl_reply = CurlReply.new <<-TEXT
+      HTTP/1.1 400 Bad Request
+      
+      content-type: text/plain;charset=utf-8
+      date: Sat, 30 Aug 2014 01:30:43 UTC
+      server: tsa_a
+      set-cookie: guest_id=v1%3A140936224322485447; Domain=.twitter.com; Path=/; Expires=Mon, 29-Aug-2016 01:30:43 UTC
+      strict-transport-security: max-age=631138519
+      x-connection-hash: 7710cb2762e0a47702d21bb7e10d3056
+
+      Bad Authentication data
+    TEXT
+  end
+
+  it "allows you to match part of a dynamic header, for example" do
+    @curl_reply.must_match <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      content-type: text/plain;charset=utf-8
+      /set-cookie: .+Domain=.twitter.com; Path=\/;/
+    REPLY
+  end
+
+  it "another example might be /content-length: \d+/" do 
+    skip("WIP: for some reason the backslash is being dropped")
+    @curl_reply.must_match <<-REPLY 
+      HTTP/1.1 400 Bad Request
+      content-type: text/plain;charset=utf-8
+      /content-length: \d+/
+    REPLY
+  end
+
+  it "how are we going to fail in a way that tells you a pattern match failed?"
+end

data/test/unit.tests/earls_may_be_relative_or_absolute.rb

@@ -0,0 +1,15 @@
+require File.join '.', 'test', 'helper'
+
+describe "Request earls may be absolute or relative" do 
+  it "must have host header when relative" do
+    spy_internet = SpyInternet.new
+
+    richard_iii = Richard::III.new :internet => spy_internet
+
+    err = lambda { richard_iii.exec 'GET /1.1/statuses' }.must_raise RuntimeError
+
+    err.message.must_match /missing host header/i
+  end
+
+  it "ignores host header when earl is absolute -- that is it does not send it"
+end

data/test/unit.tests/the_basics.rb

@@ -0,0 +1,59 @@
+require File.join '.', 'test', 'helper'
+
+describe 'The basics of Richard III' do
+  it "can issue a very simple GET request" do
+    spy_internet = SpyInternet.new
+
+    richard_iii = Richard::III.new :internet => spy_internet
+
+    richard_iii.exec <<-TEXT 
+      GET /1.1/statuses
+      Host: api.twitter.com
+      Accept: application/json
+    TEXT
+
+    spy_internet.must_have_been_asked_to_execute(
+      Request.new(
+        :verb    => 'GET', 
+        :uri     => 'https://api.twitter.com/1.1/statuses',
+        :headers => {
+           'Host'   => 'api.twitter.com',
+           'Accept' => 'application/json'
+        }
+      )
+    )
+  end
+
+  it "can issue a very simple POST request" do
+    spy_internet = SpyInternet.new
+
+    richard_iii = Richard::III.new :internet => spy_internet
+
+    richard_iii.exec <<-TEXT 
+      POST /1.1/statuses/update
+      Host: api.twitter.com
+      Accept: application/json
+      Content-type: application/x-www-form-urlencoded
+
+      status=Who%20says%20famine%20has%20to%20be%20depressing?
+    TEXT
+
+    spy_internet.must_have_been_asked_to_execute(
+      Request.new(
+        :verb    => 'POST', 
+        :uri     => 'https://api.twitter.com/1.1/statuses/update',
+        :headers => {
+           'Host'         => 'api.twitter.com',
+           'Accept'       => 'application/json',
+           'Content-type' => 'application/x-www-form-urlencoded'
+        },
+        :body => 'status=Who%20says%20famine%20has%20to%20be%20depressing?'
+      )
+    )
+  end
+
+  # TEST: quotes are treated literally
+  # TEST: whitespace does not matter
+  # TEST: where does it read the protocol part (HTTP or HTTPS)
+  # TEST: looks like you can either supply absolute uri, or relative AND Host header
+end

metadata

@@ -1,29 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: richard_iii
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.1.0
 platform: ruby
 authors:
 - Ben Biddington
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-31 00:00:00.000000000 Z
+date: 2014-09-16 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: tinternet
+  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'
 description: ''
 email:
 - ben.biddington@gmail.com
@@ -46,15 +74,32 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".travis.yml"
 - Gemfile
 - LICENSE
 - LICENSE.txt
 - README.md
 - Rakefile
 - lib/richard_iii.rb
+- lib/richard_iii/curl_reply.rb
+- lib/richard_iii/internal/curl.rb
+- lib/richard_iii/internal/text_line.rb
+- lib/richard_iii/internal/xml_format.rb
+- lib/richard_iii/request_and_response.rb
 - lib/richard_iii/version.rb
 - richard_iii.gemspec
-- test/the_basics.rb
+- test/acceptance.tests/an_example.rb
+- test/helper.rb
+- test/integration.tests/adapters/internet.rb
+- test/support/extensions.rb
+- test/support/spy_internet.rb
+- test/unit.tests/can_conduct_conversations.rb
+- test/unit.tests/can_find_out_why_a_match_failed.rb
+- test/unit.tests/can_match_pretty_formatted_xml_bodies.rb
+- test/unit.tests/can_partial_match_on_replies.rb
+- test/unit.tests/can_pattern_match_replies.rb
+- test/unit.tests/earls_may_be_relative_or_absolute.rb
+- test/unit.tests/the_basics.rb
 homepage: ''
 licenses:
 - MIT
@@ -80,4 +125,15 @@ signing_key:
 specification_version: 4
 summary: ''
 test_files:
-- test/the_basics.rb
+- test/acceptance.tests/an_example.rb
+- test/helper.rb
+- test/integration.tests/adapters/internet.rb
+- test/support/extensions.rb
+- test/support/spy_internet.rb
+- test/unit.tests/can_conduct_conversations.rb
+- test/unit.tests/can_find_out_why_a_match_failed.rb
+- test/unit.tests/can_match_pretty_formatted_xml_bodies.rb
+- test/unit.tests/can_partial_match_on_replies.rb
+- test/unit.tests/can_pattern_match_replies.rb
+- test/unit.tests/earls_may_be_relative_or_absolute.rb
+- test/unit.tests/the_basics.rb

data/test/the_basics.rb

@@ -1,74 +0,0 @@
-require 'minitest/autorun'
-require 'minitest/pride'
-
-module Richard
-  module Internal
-    class RequestLineParser
-      
-    end
-
-    class RequestLine
-      attr_reader :method, :uri
-      
-      def initialize(opts = {})
-        @method,@uri = opts[:method],opts[:uri]
-      end
-
-      def eql?(other)
-        return self.method == other.method && self.uri == other.uri
-      end
-    end
-  end
-end
-
-module Richard
-  class III
-    def initialize(opts={})
-      @internet = opts[:internet] || fail("You need to supply :internet")
-    end
-
-    def exec(text)
-      lines = text.lines.map(&:chomp)
-
-      verb = lines.first.match(/^(\w+)/)[1]
-      path = lines.first.match(/(\S+)$/)[1]
-      host = lines[1].match(/Host: (.+)$/)[1]
-
-      @internet.execute Request.new(:verb => verb, :uri => "https://#{host}#{path}")
-    end
-  end
-end
-
-class Request
-  attr_reader :verb, :uri
-
-  def initialize(opts={})
-    @verb,@uri = opts[:verb],opts[:uri]
-  end
-
-  def eql?(other)
-    self.verb.eql?(other.verb) && self.uri.eql?(other.uri)
-  end
-end
-
-describe 'The basics of Richard III' do
-  it "can issue a very simple request" do
-    spy_internet = MiniTest::Mock.new
-
-    spy_internet.expect :execute, nil do |actual|
-      actual.first.eql? Request.new(:verb => 'GET', :uri => 'https://api.twitter.com/1.1/statuses')
-    end
-
-    richard_iii = Richard::III.new :internet => spy_internet
-
-    richard_iii.exec <<-TEXT 
-GET /1.1/statuses
-Host: api.twitter.com
-Accept: application/json
-    TEXT
-
-    spy_internet.verify
-  end
-
-  # TEST: where does it read the protocol part (HTTP of HTTPS)
-end