xenon-http 0.0.4

data/xenon-http/spec/xenon/headers/accept_spec.rb

@@ -0,0 +1,54 @@
+require 'xenon/headers/accept'
+
+describe Xenon::Headers::Accept do
+
+  context '::parse' do
+    it 'can parse a basic accept range' do
+      header = Xenon::Headers::Accept.parse('text/plain; q=0.5')
+      expect(header.media_ranges.size).to eq(1)
+      expect(header.media_ranges[0].to_s).to eq('text/plain; q=0.5')
+    end
+
+    it 'can parse the first example from RFC 7231 § 5.3.2 with the right precedence' do
+      header = Xenon::Headers::Accept.parse('text/plain; q=0.5, text/html, text/x-dvi; q=0.8, text/x-c')
+      expect(header.media_ranges.size).to eq(4)
+      expect(header.media_ranges[0].to_s).to eq('text/html')
+      expect(header.media_ranges[1].to_s).to eq('text/x-c')
+      expect(header.media_ranges[2].to_s).to eq('text/x-dvi; q=0.8')
+      expect(header.media_ranges[3].to_s).to eq('text/plain; q=0.5')
+    end
+
+    it 'can parse the second example from RFC 7231 § 5.3.2 with the right precedence' do
+      header = Xenon::Headers::Accept.parse('text/*, text/plain, text/plain;format=flowed, */*')
+      expect(header.media_ranges.size).to eq(4)
+      expect(header.media_ranges[0].to_s).to eq('text/plain; format=flowed')
+      expect(header.media_ranges[1].to_s).to eq('text/plain')
+      expect(header.media_ranges[2].to_s).to eq('text/*')
+      expect(header.media_ranges[3].to_s).to eq('*/*')
+    end
+
+    it 'can parse the third example from RFC 7231 § 5.3.2 with the right precedence' do
+      header = Xenon::Headers::Accept.parse('text/*;q=0.3, text/html;q=0.7, text/html;level=1, text/html;level=2;q=0.4, */*;q=0.5')
+      expect(header.media_ranges.size).to eq(5)
+      expect(header.media_ranges[0].to_s).to eq('text/html; level=1')
+      expect(header.media_ranges[1].to_s).to eq('text/html; level=2; q=0.4')
+      expect(header.media_ranges[2].to_s).to eq('text/html; q=0.7')
+      expect(header.media_ranges[3].to_s).to eq('text/*; q=0.3')
+      expect(header.media_ranges[4].to_s).to eq('*/*; q=0.5')
+    end
+  end
+
+  context '#merge' do
+    it 'can merge two headers with the right precedence' do
+      h1 = Xenon::Headers::Accept.parse('text/plain; q=0.5, text/html')
+      h2 = Xenon::Headers::Accept.parse('text/x-c, text/x-dvi; q=0.8')
+      header = h1.merge(h2)
+      expect(header.media_ranges.size).to eq(4)
+      expect(header.media_ranges[0].to_s).to eq('text/html')
+      expect(header.media_ranges[1].to_s).to eq('text/x-c')
+      expect(header.media_ranges[2].to_s).to eq('text/x-dvi; q=0.8')
+      expect(header.media_ranges[3].to_s).to eq('text/plain; q=0.5')
+    end
+  end
+
+end

data/xenon-http/spec/xenon/headers/authorization_spec.rb

@@ -0,0 +1,47 @@
+require 'xenon/headers/authorization'
+
+describe Xenon::Headers::Authorization do
+
+  context '::parse' do
+    it 'can parse Basic credentials' do
+      header = Xenon::Headers::Authorization.parse('Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==')
+      expect(header.credentials.class).to eq(Xenon::BasicCredentials)
+      expect(header.credentials.username).to eq('Aladdin')
+      expect(header.credentials.password).to eq('open sesame')
+    end
+
+    it 'can parse Digest credentials' do
+      header = Xenon::Headers::Authorization.parse('Digest username="Mufasa"' +
+        ', realm="testrealm@host.com"' +
+        ', nonce="dcd98b7102dd2f0e8b11d0f600bfb0c093"' +
+        ', uri="/dir/index.html"' +
+        ', qop=auth' +
+        ', nc=00000001' +
+        ', cnonce="0a4f113b"' +
+        ', response="6629fae49393a05397450978507c4ef1"' +
+        ', opaque="5ccc069c403ebaf9f0171e9517f40e41"')
+      expect(header.credentials.class).to eq(Xenon::GenericCredentials)
+      expect(header.credentials.scheme).to eq('Digest')
+      expect(header.credentials.token).to eq(nil)
+      expect(header.credentials.params).to eq(
+        'username' => 'Mufasa',
+        'realm' => 'testrealm@host.com',
+        'nonce' => 'dcd98b7102dd2f0e8b11d0f600bfb0c093',
+        'uri' => '/dir/index.html',
+        'qop' => 'auth',
+        'nc' => '00000001',
+        'cnonce' => '0a4f113b',
+        'response' => '6629fae49393a05397450978507c4ef1',
+        'opaque' => '5ccc069c403ebaf9f0171e9517f40e41')
+    end
+
+    it 'can parse Bearer credentials' do
+      header = Xenon::Headers::Authorization.parse('Bearer eyJhbGciOiJub25lIn0.eyJpc3MiOiJqb2UiLA0KICJleHAiOjEzMDA4MTkzODAsDQogImh0dHA6Ly9leGFtcGxlLmNvbS9pc19yb290Ijp0cnVlfQ.')
+      expect(header.credentials.class).to eq(Xenon::GenericCredentials)
+      expect(header.credentials.scheme).to eq('Bearer')
+      expect(header.credentials.token).to eq('eyJhbGciOiJub25lIn0.eyJpc3MiOiJqb2UiLA0KICJleHAiOjEzMDA4MTkzODAsDQogImh0dHA6Ly9leGFtcGxlLmNvbS9pc19yb290Ijp0cnVlfQ.')    
+      expect(header.credentials.params).to eq({})
+    end
+  end
+
+end

data/xenon-http/spec/xenon/headers/cache_control_spec.rb

@@ -0,0 +1,64 @@
+require 'xenon/headers/cache_control'
+
+describe Xenon::Headers::CacheControl do
+
+  context '::parse' do
+    ['max-age', 'max-stale', 'min-fresh', 's-maxage'].each do |dir|
+      it "can parse the #{dir} directive" do
+        header = Xenon::Headers::CacheControl.parse("#{dir}=5")
+        expect(header.directives.size).to eq(1)
+        expect(header.directives[0].to_s).to eq("#{dir}=5")
+      end
+
+      it "can parse the #{dir} directive with a quoted value" do # should not be sent by clients but is permitted
+        header = Xenon::Headers::CacheControl.parse("#{dir}=\"5\"")
+        expect(header.directives.size).to eq(1)
+        expect(header.directives[0].to_s).to eq("#{dir}=5")
+      end
+    end
+
+    ['no-cache', 'no-store', 'no-transform', 'only-if-cached', 'must-revalidate', 'public', 'proxy-revalidate'].each do |dir|
+      it "can parse the #{dir} directive" do
+        header = Xenon::Headers::CacheControl.parse("#{dir}")
+        expect(header.directives.size).to eq(1)
+        expect(header.directives[0].to_s).to eq("#{dir}")
+      end
+    end
+
+    it "can parse the private directive with no field names" do
+      header = Xenon::Headers::CacheControl.parse('private')
+      expect(header.directives.size).to eq(1)
+      expect(header.directives[0].to_s).to eq('private')
+    end
+
+    # TODO: private directive with field names
+
+    it 'can parse extension directives with quoted string values' do
+      header = Xenon::Headers::CacheControl.parse('ext="hello \"world\""')
+      expect(header.directives.size).to eq(1)
+      expect(header.directives[0].name).to eq('ext')
+      expect(header.directives[0].value).to eq("hello \"world\"")
+    end
+
+    it 'can parse more complex directives' do
+      header = Xenon::Headers::CacheControl.parse('public, max-age=3600, must-revalidate')
+      expect(header.directives.size).to eq(3)
+      expect(header.directives[0].to_s).to eq('public')
+      expect(header.directives[1].to_s).to eq('max-age=3600')
+      expect(header.directives[2].to_s).to eq('must-revalidate')
+    end
+  end
+
+  context '#merge' do
+    it 'can merge two headers and maintain directive order' do
+      h1 = Xenon::Headers::CacheControl.parse('public, max-age=3600')
+      h2 = Xenon::Headers::CacheControl.parse('must-revalidate')
+      header = h1.merge(h2)
+      expect(header.directives.size).to eq(3)
+      expect(header.directives[0].to_s).to eq('public')
+      expect(header.directives[1].to_s).to eq('max-age=3600')
+      expect(header.directives[2].to_s).to eq('must-revalidate')
+    end
+  end
+
+end

data/xenon-http/spec/xenon/headers/if_match_spec.rb

@@ -0,0 +1,73 @@
+require 'xenon/headers/if_match'
+
+describe Xenon::Headers::IfMatch do
+
+  context '::parse' do
+    it 'can parse a single etag' do
+      header = Xenon::Headers::IfMatch.parse('"xyzzy"')
+      expect(header.etags.size).to eq(1)
+      expect(header.etags[0]).to eq(Xenon::ETag.new('xyzzy'))
+    end
+
+    it 'can parse multiple etags' do
+      header = Xenon::Headers::IfMatch.parse('"xyzzy", "r2d2xxxx", "c3piozzzz"')
+      expect(header.etags.size).to eq(3)
+      expect(header.etags[0]).to eq(Xenon::ETag.new('xyzzy'))
+      expect(header.etags[1]).to eq(Xenon::ETag.new('r2d2xxxx'))
+      expect(header.etags[2]).to eq(Xenon::ETag.new('c3piozzzz'))
+    end
+
+    it 'can parse a wildcard header' do
+      header = Xenon::Headers::IfMatch.parse('*')
+      expect(header.etags.size).to eq(0)
+    end
+  end
+
+  context '#merge' do
+    it 'can merge two headers and maintain etag order' do
+      h1 = Xenon::Headers::IfMatch.parse('"xyzzy", "r2d2xxxx"')
+      h2 = Xenon::Headers::IfMatch.parse('"c3piozzzz"')
+      header = h1.merge(h2)
+      expect(header.etags.size).to eq(3)
+      expect(header.etags[0]).to eq(Xenon::ETag.new('xyzzy'))
+      expect(header.etags[1]).to eq(Xenon::ETag.new('r2d2xxxx'))
+      expect(header.etags[2]).to eq(Xenon::ETag.new('c3piozzzz'))
+    end
+
+    it 'raises a protocol error when trying to merge into a wildcard header' do
+      h1 = Xenon::Headers::IfMatch.parse('*')
+      h2 = Xenon::Headers::IfMatch.parse('"c3piozzzz"')
+      expect { h1.merge(h2) }.to raise_error(Xenon::ProtocolError)
+    end
+
+    it 'raises a protocol error when trying to merge a wildcard into a header' do
+      h1 = Xenon::Headers::IfMatch.parse('"xyzzy"')
+      h2 = Xenon::Headers::IfMatch.parse('*')
+      expect { h1.merge(h2) }.to raise_error(Xenon::ProtocolError)
+    end
+
+    it 'raises a protocol error when trying to merge two wildcard headers' do
+      h1 = Xenon::Headers::IfMatch.parse('*')
+      h2 = Xenon::Headers::IfMatch.parse('*')
+      expect { h1.merge(h2) }.to raise_error(Xenon::ProtocolError)
+    end
+  end
+
+  context '#to_s' do
+    it 'returns the string representation a single etag' do
+      header = Xenon::Headers::IfMatch.parse('"xyzzy"')
+      expect(header.to_s).to eq('"xyzzy"')
+    end
+
+    it 'returns the string representation of multiple etags' do
+      header = Xenon::Headers::IfMatch.parse('"xyzzy", "r2d2xxxx", "c3piozzzz"')
+      expect(header.to_s).to eq('"xyzzy", "r2d2xxxx", "c3piozzzz"')
+    end
+
+    it 'returns the string representation of a wildcard header' do
+      header = Xenon::Headers::IfMatch.wildcard
+      expect(header.to_s).to eq('*')
+    end
+  end
+
+end

data/xenon-http/spec/xenon/headers/if_modified_since_spec.rb

@@ -0,0 +1,19 @@
+require 'xenon/headers/if_modified_since'
+
+describe Xenon::Headers::IfModifiedSince do
+
+  context '::parse' do
+    it 'can parse an http date' do
+      header = Xenon::Headers::IfModifiedSince.parse('Sat, 29 Oct 1994 19:43:31 GMT')
+      expect(header.date).to eq(Time.utc(1994, 10, 29, 19, 43, 31))
+    end
+  end
+
+  context '#to_s' do
+    it 'returns the http date format' do
+      header = Xenon::Headers::IfModifiedSince.new(Time.utc(1994, 10, 29, 19, 43, 31))
+      expect(header.to_s).to eq('Sat, 29 Oct 1994 19:43:31 GMT')
+    end
+  end
+
+end

data/xenon-http/spec/xenon/headers/if_none_match_spec.rb

@@ -0,0 +1,79 @@
+require 'xenon/headers/if_none_match'
+
+describe Xenon::Headers::IfNoneMatch do
+
+  context '::parse' do
+    it 'can parse a single strong etag' do
+      header = Xenon::Headers::IfNoneMatch.parse('"xyzzy"')
+      expect(header.etags.size).to eq(1)
+      expect(header.etags[0]).to eq(Xenon::ETag.new('xyzzy'))
+    end
+
+    it 'can parse a single weak etag' do
+      header = Xenon::Headers::IfNoneMatch.parse('W/"xyzzy"')
+      expect(header.etags.size).to eq(1)
+      expect(header.etags[0]).to eq(Xenon::ETag.new('xyzzy', weak: true))
+    end
+
+    it 'can parse multiple etags' do
+      header = Xenon::Headers::IfNoneMatch.parse('"xyzzy", W/"r2d2xxxx", "c3piozzzz"')
+      expect(header.etags.size).to eq(3)
+      expect(header.etags[0]).to eq(Xenon::ETag.new('xyzzy'))
+      expect(header.etags[1]).to eq(Xenon::ETag.new('r2d2xxxx', weak: true))
+      expect(header.etags[2]).to eq(Xenon::ETag.new('c3piozzzz'))
+    end
+
+    it 'can parse a wildcard header' do
+      header = Xenon::Headers::IfNoneMatch.parse('*')
+      expect(header.etags.size).to eq(0)
+    end
+  end
+
+  context '#merge' do
+    it 'can merge two headers and maintain etag order' do
+      h1 = Xenon::Headers::IfNoneMatch.parse('"xyzzy", W/"r2d2xxxx"')
+      h2 = Xenon::Headers::IfNoneMatch.parse('"c3piozzzz"')
+      header = h1.merge(h2)
+      expect(header.etags.size).to eq(3)
+      expect(header.etags[0]).to eq(Xenon::ETag.new('xyzzy'))
+      expect(header.etags[1]).to eq(Xenon::ETag.new('r2d2xxxx', weak: true))
+      expect(header.etags[2]).to eq(Xenon::ETag.new('c3piozzzz'))
+    end
+
+    it 'raises a protocol error when trying to merge into a wildcard header' do
+      h1 = Xenon::Headers::IfNoneMatch.parse('*')
+      h2 = Xenon::Headers::IfNoneMatch.parse('"c3piozzzz"')
+      expect { h1.merge(h2) }.to raise_error(Xenon::ProtocolError)
+    end
+
+    it 'raises a protocol error when trying to merge a wildcard into a header' do
+      h1 = Xenon::Headers::IfNoneMatch.parse('"xyzzy"')
+      h2 = Xenon::Headers::IfNoneMatch.parse('*')
+      expect { h1.merge(h2) }.to raise_error(Xenon::ProtocolError)
+    end
+
+    it 'raises a protocol error when trying to merge two wildcard headers' do
+      h1 = Xenon::Headers::IfNoneMatch.parse('*')
+      h2 = Xenon::Headers::IfNoneMatch.parse('*')
+      expect { h1.merge(h2) }.to raise_error(Xenon::ProtocolError)
+    end
+  end
+
+  context '#to_s' do
+    it 'returns the string representation a single etag' do
+      header = Xenon::Headers::IfNoneMatch.parse('"xyzzy"')
+      expect(header.to_s).to eq('"xyzzy"')
+    end
+
+    it 'returns the string representation of multiple etags' do
+      header = Xenon::Headers::IfNoneMatch.parse('"xyzzy", W/"r2d2xxxx", "c3piozzzz"')
+      expect(header.to_s).to eq('"xyzzy", W/"r2d2xxxx", "c3piozzzz"')
+    end
+
+    it 'returns the string representation of a wildcard header' do
+      header = Xenon::Headers::IfNoneMatch.wildcard
+      expect(header.to_s).to eq('*')
+    end
+  end
+
+end

data/xenon-http/spec/xenon/headers/if_range_spec.rb

@@ -0,0 +1,45 @@
+require 'xenon/headers/if_range'
+
+describe Xenon::Headers::IfRange do
+
+  context '::parse' do
+    it 'can parse an http date' do
+      header = Xenon::Headers::IfRange.parse('Sat, 29 Oct 1994 19:43:31 GMT')
+      expect(header.date).to eq(Time.utc(1994, 10, 29, 19, 43, 31))
+    end
+
+    it 'can parse an obsolete RFC 850 date' do
+      header = Xenon::Headers::IfRange.parse('Sunday, 06-Nov-94 08:49:37 GMT')
+      expect(header.date).to eq(Time.utc(1994, 11, 6, 8, 49, 37))
+    end
+
+    it 'can parse an obsolete asctime date' do
+      header = Xenon::Headers::IfRange.parse('Sun Nov  6 08:49:37 1994')
+      expect(header.date).to eq(Time.utc(1994, 11, 6, 8, 49, 37))
+    end
+
+    it 'can parse a strong etag' do
+      header = Xenon::Headers::IfRange.parse('"xyzzy"')
+      expect(header.etag).to_not be_nil
+      expect(header.etag.opaque_tag).to eq 'xyzzy'
+      expect(header.etag).to be_strong
+    end
+
+    it 'should raise a ProtocolError if the etag is weak' do
+      expect { Xenon::Headers::IfRange.parse('W/"xyzzy"') }.to raise_error Xenon::ProtocolError
+    end
+  end
+
+  context '#to_s' do
+    it 'returns the http date format for dates' do
+      header = Xenon::Headers::IfRange.new(Time.utc(1994, 10, 29, 19, 43, 31))
+      expect(header.to_s).to eq('Sat, 29 Oct 1994 19:43:31 GMT')
+    end
+
+    it 'returns the etag format for etags' do
+      header = Xenon::Headers::IfRange.new(Xenon::ETag.new('xyzzy'))
+      expect(header.to_s).to eq('"xyzzy"')
+    end
+  end
+
+end

data/xenon-http/spec/xenon/headers/if_unmodified_since_spec.rb

@@ -0,0 +1,19 @@
+require 'xenon/headers/if_unmodified_since'
+
+describe Xenon::Headers::IfUnmodifiedSince do
+
+  context '::parse' do
+    it 'can parse an http date' do
+      header = Xenon::Headers::IfUnmodifiedSince.parse('Sat, 29 Oct 1994 19:43:31 GMT')
+      expect(header.date).to eq(Time.utc(1994, 10, 29, 19, 43, 31))
+    end
+  end
+
+  context '#to_s' do
+    it 'returns the http date format' do
+      header = Xenon::Headers::IfUnmodifiedSince.new(Time.utc(1994, 10, 29, 19, 43, 31))
+      expect(header.to_s).to eq('Sat, 29 Oct 1994 19:43:31 GMT')
+    end
+  end
+
+end

data/xenon-http/spec/xenon/headers/user_agent_spec.rb

@@ -0,0 +1,67 @@
+require 'xenon/headers/user_agent'
+
+describe Xenon::Headers::UserAgent do
+
+  context '::parse' do
+    it 'can parse a user agent with a product name' do
+      header = Xenon::Headers::UserAgent.parse('Mozilla')
+      expect(header.products.size).to eq(1)
+      expect(header.products[0].name).to eq('Mozilla')
+      expect(header.products[0].version).to be_nil
+      expect(header.products[0].comment).to be_nil
+    end
+
+    it 'can parse a user agent with a product name and version' do
+      header = Xenon::Headers::UserAgent.parse('Mozilla/5.0')
+      expect(header.products.size).to eq(1)
+      expect(header.products[0].name).to eq('Mozilla')
+      expect(header.products[0].version).to eq('5.0')
+      expect(header.products[0].comment).to be_nil
+    end
+
+    it 'can parse a user agent with a product name and comment' do
+      header = Xenon::Headers::UserAgent.parse('Mozilla (Macintosh; Intel Mac OS X 10_10_2)')
+      expect(header.products.size).to eq(1)
+      expect(header.products[0].name).to eq('Mozilla')
+      expect(header.products[0].version).to be_nil
+      expect(header.products[0].comment).to eq('Macintosh; Intel Mac OS X 10_10_2')
+    end
+
+    it 'can parse a user agent with a product name, version and comment' do
+      header = Xenon::Headers::UserAgent.parse('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_2)')
+      expect(header.products.size).to eq(1)
+      expect(header.products[0].name).to eq('Mozilla')
+      expect(header.products[0].version).to eq('5.0')
+      expect(header.products[0].comment).to eq('Macintosh; Intel Mac OS X 10_10_2')
+    end
+
+    it 'can parse a user agent with multiple comments' do
+      header = Xenon::Headers::UserAgent.parse('Mozilla/5.0 (Macintosh) (Intel Mac OS X 10_10_2)')
+      expect(header.products.size).to eq(2)
+      expect(header.products[0].name).to eq('Mozilla')
+      expect(header.products[0].version).to eq('5.0')
+      expect(header.products[0].comment).to eq('Macintosh')
+      expect(header.products[1].name).to be_nil
+      expect(header.products[1].version).to be_nil
+      expect(header.products[1].comment).to eq('Intel Mac OS X 10_10_2')
+    end
+
+    it 'can parse a typical Chrome user agent' do
+      header = Xenon::Headers::UserAgent.parse('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.89 Safari/537.36')
+      expect(header.products.size).to eq(4)
+      expect(header.products[0].name).to eq('Mozilla')
+      expect(header.products[0].version).to eq('5.0')
+      expect(header.products[0].comment).to eq('Macintosh; Intel Mac OS X 10_10_2')
+      expect(header.products[1].name).to eq('AppleWebKit')
+      expect(header.products[1].version).to eq('537.36')
+      expect(header.products[1].comment).to eq('KHTML, like Gecko')
+      expect(header.products[2].name).to eq('Chrome')
+      expect(header.products[2].version).to eq('41.0.2272.89')
+      expect(header.products[2].comment).to be_nil
+      expect(header.products[3].name).to eq('Safari')
+      expect(header.products[3].version).to eq('537.36')
+      expect(header.products[3].comment).to be_nil
+    end
+  end
+
+end