ralexa 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ralexa.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Flippa
+
+MIT License
+
+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,131 @@
+Ralexa
+======
+
+Ruby client for Amazon Alexa APIs.
+
+These include [Alexa Top Sites][1] and [Alexa Web Information Service][2].
+
+HTTP transport thanks to `Net::HTTP`,
+with a little help from [addressable][3].
+
+XML parsing courtesy of [Nokogiri][4].
+
+Thorough test coverage provided by `MiniTest::Spec`.
+
+[1]: http://aws.amazon.com/awis/
+[2]: http://aws.amazon.com/alexatopsites/
+[3]: https://github.com/sporkmonger/addressable
+[4]: http://nokogiri.org/
+
+
+Installation
+------------
+
+```sh
+# with bundler
+echo 'gem "ralexa"' >> Gemfile
+bundle
+
+# or just the gem
+gem install ralexa
+```
+
+
+Usage Examples
+--------------
+
+```ruby
+
+# grab a Ralexa::Session instance to hold your credentials.
+session = Ralexa.session("aws_access_key_id", "aws_secret_access_key")
+
+# all countries
+countries = session.top_sites.list_countries
+
+# global top sites
+global = session.top_sites.global
+
+# per-country top sites
+first_by_country = {}
+countries.each do |c|
+  first_by_country[c.name] = session.top_sites.country(c.code).first.url
+end
+
+# individual country lookup
+puts "Top Australian Sites"
+session.top_sites.country("AU").each do |s|
+  puts "#{s.url} (#{s.page_views} pageviews)"
+end
+
+puts "bam!"
+```
+
+
+Status
+------
+
+<table>
+  <tr>
+    <th>Service</th>
+    <th>Action</th>
+    <th>ResponseGroup</th>
+    <th>Supported</th>
+  </tr>
+  <tr>
+    <td rowspan="3">Alexa Top Sites</th>
+    <td>TopSites</th>
+    <td>Global</th>
+    <td>Yes</th>
+  </tr>
+  <tr>
+    <td></th>
+    <td>Country</th>
+    <td>Yes</th>
+  </tr>
+  <tr>
+    <td></th>
+    <td>ListCountries</th>
+    <td>Yes</th>
+  </tr>
+  <tr>
+    <td rowspan="5">Alexa Web Information Services</th>
+    <td>UrlInfo</th>
+    <td>*</th>
+    <td>Send a pull request!</th>
+  </tr>
+  <tr>
+    <td>TrafficHistory</th>
+    <td>*</th>
+    <td>Send a pull request!</th>
+  </tr>
+  <tr>
+    <td>CategoryBrowse</th>
+    <td>*</th>
+    <td>Send a pull request!</th>
+  </tr>
+  <tr>
+    <td>CategoryListings</th>
+    <td>*</th>
+    <td>Send a pull request!</th>
+  </tr>
+  <tr>
+    <td>SitesLinkingIn</th>
+    <td>*</th>
+    <td>Send a pull request!</th>
+  </tr>
+</table>
+
+
+Contributing
+------------
+
+1. Fork it
+2. Create your feature branch (`git checkout -b some-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin some-new-feature`)
+5. Create new Pull Request
+
+License
+-------
+
+(c) 2012 Flippa, The MIT License.

data/Rakefile

@@ -0,0 +1,13 @@
+#!/usr/bin/env rake
+
+task default: :test
+
+# Bundler
+require "bundler/gem_tasks"
+
+# MiniTest
+require "rake/testtask"
+Rake::TestTask.new do |t|
+  # ENV["TESTOPTS"] = "-v"
+  t.pattern = "spec/*_spec.rb"
+end

data/lib/ralexa/abstract_xml_service.rb

@@ -0,0 +1,27 @@
+require "nokogiri"
+
+module Ralexa
+  class AbstractXmlService
+
+    def initialize(client)
+      @client = client
+    end
+
+    private
+
+    # Returns the response as an XML document stripped of namespaces.
+    def dispatch(*params)
+      Nokogiri::XML.parse(
+        @client.get(host, path, merged_params(*params))
+      ).remove_namespaces!
+    end
+
+    # A hash of the provided params hashes merged into the default_params.
+    def merged_params(*params)
+      params.reduce(default_params) do |merged_params, params|
+        merged_params.merge(params)
+      end
+    end
+
+  end
+end

data/lib/ralexa/canonicalized_query_string.rb

@@ -0,0 +1,23 @@
+require "uri"
+
+module Ralexa
+  class CanonicalizedQueryString
+
+    def initialize(parameters)
+      @parameters = parameters
+    end
+
+    def to_s
+      @parameters.sort.map do |k, v|
+        "%s=%s" % [ escape_rfc3986(k), escape_rfc3986(v) ]
+      end.join("&")
+    end
+
+    private
+
+    def escape_rfc3986(string)
+      URI.escape(string.to_s, /[^A-Za-z0-9\-_.~]/)
+    end
+
+  end
+end

data/lib/ralexa/client.rb

@@ -0,0 +1,49 @@
+require "addressable/uri"
+require "net/http"
+
+require "ralexa/uri_signer"
+
+module Ralexa
+  class Client
+
+    def initialize(access_key_id, secret_access_key)
+      @access_key_id = access_key_id
+      @secret_access_key = secret_access_key
+    end
+
+    # Dependency injectors.
+    attr_writer :net_http
+
+    def get(host, path, query_values)
+      uri = signed_uri(host, path, query_values)
+      response = net_http.get_response(uri)
+      response.error! unless response.is_a?(Net::HTTPSuccess)
+      response.body
+    end
+
+    private
+
+    def signed_uri(host, path, query_values)
+      uri_signer.sign_uri(
+        Addressable::URI.new(
+          scheme: "http",
+          host: host,
+          path: path,
+          query_values: query_values
+        )
+      )
+    end
+
+    def uri_signer
+      UriSigner.new(@access_key_id, @secret_access_key)
+    end
+
+    ##
+    # Injectable dependencies.
+
+    def net_http
+      @net_http || Net::HTTP
+    end
+
+  end
+end

data/lib/ralexa/session.rb

@@ -0,0 +1,18 @@
+require "ralexa/client"
+require "ralexa/top_sites"
+
+module Ralexa
+  class Session
+
+    def initialize(access_key_id, secret_access_key)
+      @client = Client.new(access_key_id, secret_access_key)
+    end
+
+    # Provides a TopSites instance with an authenticated client.
+    # See: http://docs.amazonwebservices.com/AlexaTopSites/latest/index.html
+    def top_sites
+      TopSites.new(@client)
+    end
+
+  end
+end

data/lib/ralexa/top_sites.rb

@@ -0,0 +1,59 @@
+require "ralexa/abstract_xml_service"
+
+module Ralexa
+  class TopSites < AbstractXmlService
+
+    # A global list of top sites.
+    def global(params = {})
+      top_sites_from_document(dispatch(
+        {"ResponseGroup" => "Country"},
+        params
+      ))
+    end
+
+    # Top sites for the specified two letter country code.
+    def country(code, params = {})
+      top_sites_from_document(dispatch(
+        {"ResponseGroup" => "Country", "CountryCode" => code.to_s.upcase},
+        params
+      ))
+    end
+
+    # All countries that have Alexa top sites.
+    def list_countries(params = {})
+      dispatch(
+        {"ResponseGroup" => "ListCountries"},
+        params
+      ).at("//TopSitesResult/Alexa/TopSites/Countries").elements.map do |node|
+        Country.new(
+          node.at("Name").text,
+          node.at("Code").text,
+          node.at("TotalSites").text.to_i,
+          node.at("PageViews").text.to_f * 1_000_000,
+          node.at("Users").text.to_f * 1_000_000,
+        )
+      end
+    end
+
+    private
+
+    def host; "ats.amazonaws.com" end
+    def path; "/" end
+    def default_params; {"Action" => "TopSites"} end
+
+    def top_sites_from_document(document)
+      document.at("//TopSites/Country/Sites").elements.map do |node|
+        Site.new(
+          node.at("DataUrl").text,
+          node.at("Country/Rank").text.to_i,
+          node.at("Country/Reach/PerMillion").text.to_i * 1_000_000,
+          (node.at("Country/PageViews/PerMillion").text.to_f * 1_000_000).to_i,
+          node.at("Country/PageViews/PerUser").text.to_f
+        )
+      end
+    end
+
+    Country = Struct.new(:name, :code, :total_sites, :page_views, :users)
+    Site = Struct.new(:url, :rank, :reach, :page_views, :page_views_per_user)
+  end
+end

data/lib/ralexa/uri_signer.rb

@@ -0,0 +1,89 @@
+require "base64"
+require "digest/sha2"
+require "openssl"
+
+require "ralexa/canonicalized_query_string"
+
+module Ralexa
+  class UriSigner
+
+    SIGNATURE_VERSION = 2
+
+    def initialize(access_key_id, secret_access_key)
+      @access_key_id = access_key_id
+      @secret_access_key = secret_access_key
+    end
+
+    # dependency injectors
+    attr_writer :digest
+    attr_writer :hmac_signer
+    attr_writer :base64_encoder
+    attr_writer :time_utc
+
+    def sign_uri(original_uri)
+      original_uri.dup.tap do |uri|
+        uri.query_values = uri.query_values.merge(
+          "AWSAccessKeyId" => @access_key_id,
+          "Timestamp" => timestamp,
+          "SignatureVersion" => SIGNATURE_VERSION.to_s,
+          "SignatureMethod" => signature_method,
+        )
+        uri.query_values = uri.query_values.merge(
+          "Signature" => signature(uri)
+        )
+      end
+    end
+
+    private
+
+    def string_to_sign(uri)
+      [
+        "GET",
+        uri.host.downcase,
+        uri.path,
+        CanonicalizedQueryString.new(uri.query_values)
+      ].join("\n")
+    end
+
+    def timestamp
+      time_utc.strftime("%Y-%m-%dT%H:%M:%S.000Z")
+    end
+
+    def signature_method
+      "Hmac#{digest.name}"
+    end
+
+    def signature(uri)
+      encode(hmac(string_to_sign(uri)))
+    end
+
+    def hmac(string_to_sign)
+      hmac_signer.digest(digest, @secret_access_key, string_to_sign)
+    end
+
+    def encode(input)
+      base64_encoder.encode64(input).chop
+    end
+
+    ##
+    # Injectable dependencies.
+
+    def digest
+      @digest ||= OpenSSL::Digest::SHA256.new
+    end
+
+    def hmac_signer
+      @hmac_signer || OpenSSL::HMAC
+    end
+
+    def base64_encoder
+      @base64_encoder || Base64
+    end
+
+    def time_utc
+      # don't store in ivar.
+      @time_utc || Time.now.utc
+    end
+
+  end
+end

data/lib/ralexa/version.rb

@@ -0,0 +1,3 @@
+module Ralexa
+  VERSION = "0.0.1"
+end

data/lib/ralexa.rb

@@ -0,0 +1,22 @@
+%w{
+  abstract_xml_service
+  awis
+  canonicalized_query_string
+  client
+  session
+  top_sites
+  uri_signer
+  version
+}.each do |file|
+  require "ralexa/#{file}"
+end
+
+module Ralexa
+
+  # An authenticated Session instance.
+  # Holds credentials, provides access to service instances.
+  def self.session(access_key_id, secret_access_key)
+    Session.new(access_key_id, secret_access_key)
+  end
+
+end

data/ralexa.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/ralexa/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Paul Annesley"]
+  gem.email         = ["paul@annesley.cc"]
+  gem.description   = %q{Ruby client for Amazon Alexa APIs.}
+  gem.summary       = %q{Ruby client for Amazon Alexa APIs such as TopSites.}
+  gem.homepage      = "https://github.com/flippa/ralexa"
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "ralexa"
+  gem.require_paths = ["lib"]
+  gem.version       = Ralexa::VERSION
+
+  gem.add_runtime_dependency "addressable"
+  gem.add_runtime_dependency "nokogiri"
+
+  gem.add_development_dependency "minitest"
+  gem.add_development_dependency "rake"
+end

data/spec/canonicalized_query_string_spec.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+
+require_relative "spec_helper"
+
+require "ralexa/canonicalized_query_string"
+
+module Ralexa
+  describe CanonicalizedQueryString do
+
+    def q(parameters)
+      CanonicalizedQueryString.new(parameters).to_s
+    end
+
+    it "sorts parameters by key into a query string" do
+      q("a" => "3", "c" => "2", "b" => "1").must_equal "a=3&b=1&c=2"
+    end
+
+    it "does not URL-encode RFC 3986 unreserved characters" do
+      q("AZaz09-_.~" => "AZaz09-_.~").must_equal "AZaz09-_.~=AZaz09-_.~"
+    end
+
+    it "percent-encodes other characters" do
+      q("=&/" => "✈").must_equal "%3D%26%2F=%E2%9C%88"
+    end
+
+    it "encodes space as '%20' not '+'" do
+      q("a b" => "c d").must_equal "a%20b=c%20d"
+    end
+
+    it "handles empty parameters" do
+      q("a" => "", "b" => nil).must_equal "a=&b="
+    end
+
+  end
+end

data/spec/client_spec.rb

@@ -0,0 +1,32 @@
+require_relative "spec_helper"
+
+require "ralexa/client"
+
+module Ralexa
+  describe Client do
+
+    let(:client) do
+      Client.new("id", "secret").tap do |c|
+        c.net_http = net_http
+      end
+    end
+
+    let(:net_http) { MiniTest::Mock.new }
+    let(:response) { MiniTest::Mock.new }
+
+    it "returns the response body of HTTP GET to a signed URI" do
+      net_http.expect :get_response, response, [ %r{^http://example.org/test\?.*Signature=} ]
+      response.expect :is_a?, true, [ Net::HTTPSuccess ]
+      response.expect :body, "<xml/>"
+      client.get("example.org", "/test", "a" => "b").must_equal "<xml/>"
+    end
+
+    it "raises an error if the HTTP request failed" do
+      net_http.expect :get_response, response, [ %r{^http://example.org/test\?.*Signature=} ]
+      response.expect :is_a?, false, [ Net::HTTPSuccess ]
+      def response.error!; raise Net::HTTPError.new("", self); end
+      ->{ client.get("example.org", "/test", "a" => "b") }.must_raise Net::HTTPError
+    end
+
+  end
+end

data/spec/fixtures/global.xml

@@ -0,0 +1,45 @@
+<?xml version="1.0"?>
+<aws:TopSitesResponse xmlns:aws="http://alexa.amazonaws.com/doc/2005-10-05/"><aws:Response xmlns:aws="http://ats.amazonaws.com/doc/2005-11-21"><aws:OperationRequest><aws:RequestId>8a6c3a3f-a3c8-48d8-4775-3914d8f36e88</aws:RequestId></aws:OperationRequest><aws:TopSitesResult><aws:Alexa>
+  
+  <aws:TopSites>
+    <aws:Country>
+      <aws:CountryName>GLOBAL</aws:CountryName>
+      <aws:CountryCode>*</aws:CountryCode>
+      <aws:TotalSites>366720</aws:TotalSites>
+      <aws:Sites>
+        <aws:Site>
+          <aws:DataUrl>wikipedia.org</aws:DataUrl>
+          <aws:Country>
+            <aws:Rank>6</aws:Rank>
+            <aws:Reach>
+              <aws:PerMillion>143000</aws:PerMillion>
+            </aws:Reach>
+            <aws:PageViews>
+              <aws:PerMillion>5219</aws:PerMillion>
+              <aws:PerUser>3.88</aws:PerUser>
+            </aws:PageViews>
+          </aws:Country>
+          <aws:Global>
+            <aws:Rank>6</aws:Rank>
+          </aws:Global>
+        </aws:Site>
+        <aws:Site>
+          <aws:DataUrl>bbc.co.uk</aws:DataUrl>
+          <aws:Country>
+            <aws:Rank>52</aws:Rank>
+            <aws:Reach>
+              <aws:PerMillion>20540</aws:PerMillion>
+            </aws:Reach>
+            <aws:PageViews>
+              <aws:PerMillion>898.5</aws:PerMillion>
+              <aws:PerUser>4.65</aws:PerUser>
+            </aws:PageViews>
+          </aws:Country>
+          <aws:Global>
+            <aws:Rank>52</aws:Rank>
+          </aws:Global>
+        </aws:Site>
+      </aws:Sites>
+    </aws:Country>
+  </aws:TopSites>
+</aws:Alexa></aws:TopSitesResult><aws:ResponseStatus xmlns:aws="http://alexa.amazonaws.com/doc/2005-10-05/"><aws:StatusCode>Success</aws:StatusCode></aws:ResponseStatus></aws:Response></aws:TopSitesResponse>

data/spec/fixtures/list_countries.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0"?>
+<aws:TopSitesResponse xmlns:aws="http://alexa.amazonaws.com/doc/2005-10-05/"><aws:Response xmlns:aws="http://ats.amazonaws.com/doc/2005-11-21"><aws:OperationRequest><aws:RequestId>a914be78-f2cf-71be-97dd-6e51501050b2</aws:RequestId></aws:OperationRequest><aws:TopSitesResult><aws:Alexa>
+
+  <aws:TopSites>
+    <aws:Countries>
+      <aws:Country>
+        <aws:Name>Australia</aws:Name>
+        <aws:Code>AU</aws:Code>
+        <aws:TotalSites>42920</aws:TotalSites>
+        <aws:PageViews>1.074</aws:PageViews>
+        <aws:Users>1.148</aws:Users>
+      </aws:Country>
+      <aws:Country>
+        <aws:Name>United States</aws:Name>
+        <aws:Code>US</aws:Code>
+        <aws:TotalSites>484842</aws:TotalSites>
+        <aws:PageViews>18.023</aws:PageViews>
+        <aws:Users>18.998</aws:Users>
+      </aws:Country>
+    </aws:Countries>
+  </aws:TopSites>
+</aws:Alexa></aws:TopSitesResult><aws:ResponseStatus xmlns:aws="http://alexa.amazonaws.com/doc/2005-10-05/"><aws:StatusCode>Success</aws:StatusCode></aws:ResponseStatus></aws:Response></aws:TopSitesResponse>

data/spec/ralexa_spec.rb

@@ -0,0 +1,13 @@
+require_relative "spec_helper"
+
+require "ralexa"
+
+describe Ralexa do
+
+  describe ".session" do
+    it "returns a Ralexa::Session" do
+      Ralexa.session("id", "secret").must_be_kind_of ::Ralexa::Session
+    end
+  end
+
+end

data/spec/session_spec.rb

@@ -0,0 +1,15 @@
+require_relative "spec_helper"
+
+require "ralexa/session"
+
+module Ralexa
+  describe Session do
+
+    describe ".top_sites" do
+      it "returns a Ralexa::TopSites instance" do
+        Session.new("id", "secret").top_sites.must_be_kind_of ::Ralexa::TopSites
+      end
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+gem "minitest"
+require "minitest/autorun"
+$LOAD_PATH.unshift "./lib"
+
+def fixture(filename)
+  File.read("#{File.dirname(__FILE__)}/fixtures/#{filename}")
+end

data/spec/top_sites_spec.rb

@@ -0,0 +1,87 @@
+require_relative "spec_helper"
+
+require "ralexa/top_sites"
+
+module Ralexa
+  describe TopSites do
+
+    let(:top_sites) { TopSites.new(client) }
+    let(:client) { MiniTest::Mock.new }
+
+    describe "#global" do
+      before do
+        expect_parameters = {
+          "Action" => "TopSites",
+          "ResponseGroup" => "Country",
+        }
+        client.expect :get, fixture("global.xml"),
+          ["ats.amazonaws.com", "/", expect_parameters]
+      end
+      it "fetches, parses and returns top sites" do
+        top_sites_match_fixture(top_sites.global)
+      end
+    end
+
+    describe "#country" do
+      before do
+        expect_parameters = {
+          "Action" => "TopSites",
+          "ResponseGroup" => "Country",
+          "CountryCode" => "AU",
+        }
+        client.expect :get, fixture("global.xml"),
+          ["ats.amazonaws.com", "/", expect_parameters]
+      end
+      it "fetches, parses and returns top sites for specified country" do
+        top_sites_match_fixture(top_sites.country("AU"))
+      end
+    end
+
+    describe "#list_countries" do
+      before do
+        expect_parameters = {
+          "Action" => "TopSites",
+          "ResponseGroup" => "ListCountries",
+        }
+        client.expect :get, fixture("list_countries.xml"),
+          ["ats.amazonaws.com", "/", expect_parameters]
+      end
+
+      it "fetches, parses and returns countries" do
+        countries = top_sites.list_countries
+        countries.size.must_equal 2
+        a, u = countries
+
+        u.name.must_equal "United States"
+        u.code.must_equal "US"
+        u.total_sites.must_equal 484842
+        u.page_views.must_equal 18_023_000
+        u.users.must_equal 18_998_000
+
+        a.name.must_equal "Australia"
+        a.code.must_equal "AU"
+        a.total_sites.must_equal 42920
+        a.page_views.must_equal 1_074_000
+        a.users.must_equal 1_148_000
+      end
+    end
+
+    def top_sites_match_fixture(sites)
+        sites.size.must_equal 2
+        w, b = sites
+
+        w.url.must_equal "wikipedia.org"
+        w.rank.must_equal 6
+        w.reach.must_equal 143_000_000_000
+        w.page_views.must_equal 5_219_000_000
+        w.page_views_per_user.must_equal 3.88
+
+        b.url.must_equal "bbc.co.uk"
+        b.rank.must_equal 52
+        b.reach.must_equal 20_540_000_000
+        b.page_views.must_equal 898_500_000
+        b.page_views_per_user.must_equal 4.65
+    end
+
+  end
+end

data/spec/uri_signer_spec.rb

@@ -0,0 +1,62 @@
+require_relative "spec_helper"
+
+require "addressable/uri"
+require "ralexa/uri_signer"
+
+module Ralexa
+  describe UriSigner do
+
+    let(:time_utc) { Time.now.utc }
+    let(:digest) { MiniTest::Mock.new }
+    let(:hmac_signer) { MiniTest::Mock.new }
+    let(:base64_encoder) { MiniTest::Mock.new }
+
+    def signer
+      UriSigner.new("id", "secret").tap do |rs|
+        rs.digest = digest
+        rs.hmac_signer = hmac_signer
+        rs.base64_encoder = base64_encoder
+        rs.time_utc = time_utc
+      end
+    end
+
+    describe "for http://example.org/path?b=c&a=b" do
+
+      let(:uri) { Addressable::URI.parse("http://example.org/path?b=c&a=b") }
+      let(:signed_uri) { signer.sign_uri(uri) }
+      let(:timestamp) { time_utc.strftime("%Y-%m-%dT%H:%M:%S.000Z") }
+
+      before do
+        ts = URI.escape(timestamp, /:/)
+        combined = [
+          "GET",
+          "example.org",
+          "/path",
+          "AWSAccessKeyId=id&SignatureMethod=HmacFAKE&SignatureVersion=2&Timestamp=#{ts}&a=b&b=c"
+        ].join("\n")
+        hmac_signer.expect :digest, "the_hmac", [ digest, "secret", combined ]
+        base64_encoder.expect :encode64, "base64_encoded\n", [ "the_hmac" ]
+        digest.expect :name, "FAKE"
+      end
+
+      it "returns a signed URL" do
+        signed_uri.host.must_equal "example.org"
+        signed_uri.path.must_equal "/path"
+        signed_uri.query_values.must_equal(
+          "b" => "c",
+          "a" => "b",
+          "AWSAccessKeyId" => "id",
+          "Signature" => "base64_encoded",
+          "SignatureMethod" => "HmacFAKE",
+          "SignatureVersion" => "2",
+          "Timestamp" => timestamp,
+        )
+      end
+
+      it "does not modify the passed uri" do
+        signed_uri.wont_be_same_as uri
+      end
+    end
+
+  end
+end

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: ralexa
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Paul Annesley
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: &70290636275640 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70290636275640
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &70290636275220 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70290636275220
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: &70290636274800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70290636274800
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70290636274380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70290636274380
+description: Ruby client for Amazon Alexa APIs.
+email:
+- paul@annesley.cc
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/ralexa.rb
+- lib/ralexa/abstract_xml_service.rb
+- lib/ralexa/canonicalized_query_string.rb
+- lib/ralexa/client.rb
+- lib/ralexa/session.rb
+- lib/ralexa/top_sites.rb
+- lib/ralexa/uri_signer.rb
+- lib/ralexa/version.rb
+- ralexa.gemspec
+- spec/canonicalized_query_string_spec.rb
+- spec/client_spec.rb
+- spec/fixtures/global.xml
+- spec/fixtures/list_countries.xml
+- spec/ralexa_spec.rb
+- spec/session_spec.rb
+- spec/spec_helper.rb
+- spec/top_sites_spec.rb
+- spec/uri_signer_spec.rb
+homepage: https://github.com/flippa/ralexa
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Ruby client for Amazon Alexa APIs such as TopSites.
+test_files:
+- spec/canonicalized_query_string_spec.rb
+- spec/client_spec.rb
+- spec/fixtures/global.xml
+- spec/fixtures/list_countries.xml
+- spec/ralexa_spec.rb
+- spec/session_spec.rb
+- spec/spec_helper.rb
+- spec/top_sites_spec.rb
+- spec/uri_signer_spec.rb
+has_rdoc: