xenon-routing 0.0.4 → 0.0.5

data/xenon-http/lib/xenon/parsers/header_rules.rb

@@ -1,60 +0,0 @@
-require 'xenon/quoted_string'
-require 'xenon/parsers/basic_rules'
-
-module Xenon
-  module Parsers
-
-    module HeaderRules
-      include Parslet, BasicRules
-
-      # http://tools.ietf.org/html/rfc7230#section-3.2.6
-      rule(:list_sep) { str(',') >> sp? }
-      rule(:param_sep) { str(';') >> sp? }
-      rule(:obs_text) { match(/[\u0080-\u00ff]/)}
-      rule(:qdtext) { htab | sp | match(/[\u0021\u0023-\u005b\u005d-\u007e]/) | obs_text }
-      rule(:quoted_pair) { str('\\') >> (htab | sp | vchar | obs_text) }
-      rule(:quoted_string) { (dquote >> (qdtext | quoted_pair).repeat >> dquote).as(:quoted_string) }
-      rule(:ctext) { htab | sp | match(/[\u0021-\u0027\u002a-\u005b\u005d-\u007e]/) | obs_text }
-      rule(:comment) { (str('(') >> (ctext | quoted_pair | comment).repeat >> str(')')).as(:comment) }
-
-      # http://tools.ietf.org/html/rfc7231#section-5.3.1
-      rule(:weight_value) { (digit >> (str('.') >> digit.repeat(0, 3)).maybe).as(:q) }
-      rule(:weight) { param_sep >> str('q') >> sp? >> str('=') >> sp? >> weight_value >> sp? }
-    end
-
-    module AuthHeaderRules
-      include Parslet, HeaderRules
-
-      rule(:token68) { ((alpha | digit | match(/[\-\._~\+\/]/)) >> str('=').repeat).repeat(1).as(:token) }
-      rule(:auth_scheme) { token.as(:auth_scheme) }
-      rule(:name) { token.as(:name) }
-      rule(:value) { token.as(:value) }
-      rule(:auth_param) { (name >> bws >> str('=') >> bws >> (token | quoted_string).as(:value)).as(:auth_param) }
-      rule(:auth_params) { (auth_param.maybe >> (ows >> comma >> ows >> auth_param).repeat).as(:auth_params) }
-    end
-
-    module ETagHeaderRules
-      include Parslet, HeaderRules
-
-      # http://tools.ietf.org/html/rfc7232#section-2.3
-      rule(:wildcard) { str('*').as(:wildcard) }
-      rule(:weak) { str('W/').as(:weak) }
-      rule(:etagc) { str('!') | match(/[\u0023-\u007e#-~]/) | obs_text }
-      rule(:opaque_tag) { dquote >> etagc.repeat.as(:opaque_tag) >> dquote }
-      rule(:etag) { (weak.maybe >> opaque_tag).as(:etag) }
-    end
-
-    class HeaderTransform < BasicTransform
-      using QuotedString
-
-      rule(quoted_string: simple(:qs)) { qs.unquote }
-      rule(comment: simple(:c)) { c.uncomment }
-    end
-
-    class ETagHeaderTransform < HeaderTransform
-      rule(etag: { opaque_tag: simple(:t), weak: simple(:w) }) { Xenon::ETag.new(t, weak: true) }
-      rule(etag: { opaque_tag: simple(:t) }) { Xenon::ETag.new(t) }
-    end
-
-  end
-end

data/xenon-http/lib/xenon/parsers/media_type.rb

@@ -1,53 +0,0 @@
-require 'xenon/parsers/basic_rules'
-
-module Xenon
-  module Parsers
-
-    # note this uses the rules from https://tools.ietf.org/html/rfc6838 not http://tools.ietf.org/html/rfc7231
-    # because the latter is slightly ambiguous, e.g. a token can include * so */json would parse correctly
-    module MediaTypeRules
-      include Parslet, BasicRules
-
-      rule(:restricted_name_first) { match(/[a-zA-Z0-9]/) }
-      rule(:restricted_name_chars) { match(/[a-zA-Z0-9!#\$&\-\^_\.\+]/).repeat(0, 126) }
-      rule(:restricted_name) { restricted_name_first >> restricted_name_chars }
-
-      rule(:type) { restricted_name.as(:type) }
-      rule(:slash) { str('/') }
-      rule(:subtype) { restricted_name.as(:subtype) >> sp? }
-
-      rule(:param_sep) { str(';') >> sp? }
-      rule(:param_name) { restricted_name.as(:param_name) >> sp? }
-      rule(:equals) { str('=') >> sp? }
-      rule(:param_value) { token.as(:param_value) >> sp? } # not quite correct but probably correct enough
-      rule(:param) { param_sep >> param_name >> (equals >> param_value).maybe >> sp? }
-      rule(:params) { param.repeat.as(:params) }
-
-      rule(:media_type) { (type >> slash >> subtype >> params).as(:media_type) >> sp? }
-
-      rule(:wildcard) { str('*') }
-      rule(:wild_media_range) { wildcard.as(:type) >> slash >> wildcard.as(:subtype) >> params }
-      rule(:root_media_range) { type >> slash >> (wildcard.as(:subtype) | subtype) >> params }
-      rule(:media_range) { (wild_media_range | root_media_range).as(:media_range) >> sp? }
-    end
-
-    class MediaType < Parslet::Parser
-      include MediaTypeRules
-      root(:media_type)
-    end
-
-    class MediaRange < Parslet::Parser
-      include MediaTypeRules
-      root(:media_range)
-    end
-
-    class MediaTypeTransform < Parslet::Transform
-      rule(param_name: simple(:n), param_value: simple(:v)) { [n.str, v.str] }
-      rule(param_name: simple(:n)) { [n.str, nil] }
-      rule(type: simple(:t), subtype: simple(:s), params: subtree(:p)) { { type: t.str, subtype: s.str, params: Hash[p] } }
-      rule(media_type: subtree(:mt)) { Xenon::MediaType.new(mt[:type], mt[:subtype], mt[:params])}
-      rule(media_range: subtree(:mr)) { Xenon::MediaRange.new(mr[:type], mr[:subtype], mr[:params])}
-    end
-
-  end
-end

data/xenon-http/lib/xenon/quoted_string.rb

@@ -1,20 +0,0 @@
-module Xenon
-  module QuotedString
-    refine String do
-      def quote
-        qs = gsub(/([\\"])/, '\\\\\1')
-        self == qs ? self : %{"#{qs}"}
-      end
-
-      def unquote
-      	qs = start_with?('"') && end_with?('"') ? self[1..-2] : self
-      	qs.gsub(/\\(.)/, '\1')
-      end
-
-      def uncomment
-      	qs = start_with?('(') && end_with?(')') ? self[1..-2] : self
-      	qs.gsub(/\\(.)/, '\1')
-      end
-    end
-  end
-end

data/xenon-http/spec/xenon/etag_spec.rb

@@ -1,19 +0,0 @@
-require 'xenon/etag'
-
-describe Xenon::ETag do
-
-  describe '::parse' do
-    it 'can parse a strong etag' do
-      etag = Xenon::ETag.parse('"xyzzy"')
-      expect(etag.opaque_tag).to eq 'xyzzy'
-      expect(etag).to be_strong
-    end
-
-    it 'can parse a weak etag' do
-      etag = Xenon::ETag.parse('W/"xyzzy"')
-      expect(etag.opaque_tag).to eq 'xyzzy'
-      expect(etag).to be_weak
-    end
-  end
-
-end

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

@@ -1,31 +0,0 @@
-require 'xenon/headers/accept_charset'
-
-describe Xenon::Headers::AcceptCharset do
-
-  context '::parse' do
-    it 'can parse a basic charset range' do
-      header = Xenon::Headers::AcceptCharset.parse('unicode-1-1;q=0.8')
-      expect(header.charset_ranges.size).to eq(1)
-      expect(header.charset_ranges[0].to_s).to eq('unicode-1-1; q=0.8')
-    end
-
-    it 'can parse the example from RFC 7231 § 5.3.3 with the right precedence' do
-      header = Xenon::Headers::AcceptCharset.parse('iso-8859-5, unicode-1-1;q=0.8')
-      expect(header.charset_ranges.size).to eq(2)
-      expect(header.charset_ranges[0].to_s).to eq('iso-8859-5')
-      expect(header.charset_ranges[1].to_s).to eq('unicode-1-1; q=0.8')
-    end
-  end
-
-  context '#merge' do
-    it 'can merge two headers with the right precedence' do
-      h1 = Xenon::Headers::AcceptCharset.parse('unicode-1-1;q=0.8')
-      h2 = Xenon::Headers::AcceptCharset.parse('iso-8859-5')
-      header = h1.merge(h2)
-      expect(header.charset_ranges.size).to eq(2)
-      expect(header.charset_ranges[0].to_s).to eq('iso-8859-5')
-      expect(header.charset_ranges[1].to_s).to eq('unicode-1-1; q=0.8')
-    end
-  end
-
-end

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

@@ -1,40 +0,0 @@
-require 'xenon/headers/accept_encoding'
-
-describe Xenon::Headers::AcceptEncoding do
-
-  context '::parse' do
-    %w(identity compress x-compress deflate gzip x-gzip *).each do |cc|
-      it "can parse the #{cc} content coding" do
-        header = Xenon::Headers::AcceptEncoding.parse(cc)
-        expect(header.coding_ranges.size).to eq(1)
-        expect(header.coding_ranges[0].to_s).to eq(cc)
-      end
-    end
-
-    it 'can parse the fifth example from RFC 7231 § 5.3.4 with the right precedence' do
-      header = Xenon::Headers::AcceptEncoding.parse('gzip;q=1.0, identity; q=0.5, *;q=0')
-      expect(header.coding_ranges.size).to eq(3)
-      expect(header.coding_ranges[0].to_s).to eq('gzip')
-      expect(header.coding_ranges[1].to_s).to eq('identity; q=0.5')
-      expect(header.coding_ranges[2].to_s).to eq('*; q=0.0')
-    end
-
-    it 'parses an empty header as containing no codings' do
-      header = Xenon::Headers::AcceptEncoding.parse('')
-      expect(header.coding_ranges.size).to eq(0) 
-    end
-  end
-
-  context '#merge' do
-    it 'can merge two headers with the right precedence' do
-      h1 = Xenon::Headers::AcceptEncoding.parse('identity; q=0.5')
-      h2 = Xenon::Headers::AcceptEncoding.parse('gzip;q=1.0, *;q=0')
-      header = h1.merge(h2)
-      expect(header.coding_ranges.size).to eq(3)
-      expect(header.coding_ranges[0].to_s).to eq('gzip')
-      expect(header.coding_ranges[1].to_s).to eq('identity; q=0.5')
-      expect(header.coding_ranges[2].to_s).to eq('*; q=0.0')
-    end
-  end
-
-end

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

@@ -1,33 +0,0 @@
-require 'xenon/headers/accept_language'
-
-describe Xenon::Headers::AcceptLanguage do
-
-  context '::parse' do
-    it 'can parse a basic language range' do
-      header = Xenon::Headers::AcceptLanguage.parse('en-gb;q=0.8')
-      expect(header.language_ranges.size).to eq(1)
-      expect(header.language_ranges[0].to_s).to eq('en-gb; q=0.8')
-    end
-
-    it 'can parse the example from RFC 7231 § 5.3.5 with the right precedence' do
-      header = Xenon::Headers::AcceptLanguage.parse('da, en-gb;q=0.8, en;q=0.7')
-      expect(header.language_ranges.size).to eq(3)
-      expect(header.language_ranges[0].to_s).to eq('da')
-      expect(header.language_ranges[1].to_s).to eq('en-gb; q=0.8')
-      expect(header.language_ranges[2].to_s).to eq('en; q=0.7')
-    end
-  end
-
-  context '#merge' do
-    it 'can merge two headers with the right precedence' do
-      h1 = Xenon::Headers::AcceptLanguage.parse('da, en;q=0.7')
-      h2 = Xenon::Headers::AcceptLanguage.parse('en-gb;q=0.8')
-      header = h1.merge(h2)
-      expect(header.language_ranges.size).to eq(3)
-      expect(header.language_ranges[0].to_s).to eq('da')
-      expect(header.language_ranges[1].to_s).to eq('en-gb; q=0.8')
-      expect(header.language_ranges[2].to_s).to eq('en; q=0.7')
-    end
-  end
-
-end

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

@@ -1,54 +0,0 @@
-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

@@ -1,47 +0,0 @@
-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

@@ -1,64 +0,0 @@
-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

@@ -1,73 +0,0 @@
-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