aws-url 0.1.0

data/.gitignore

@@ -0,0 +1,2 @@
+Gemfile.lock
+pkg

data/.travis.yml

@@ -0,0 +1,7 @@
+rvm:
+  - 1.8.7
+  - 1.9.3
+  - jruby-18mode
+  - jruby-19mode
+  - rbx-18mode
+  - rbx-19mode

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+gemspec
+
+gem 'jruby-openssl', :platform => :jruby

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Hakan Ensari
+
+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,17 @@
+# AWS URL
+
+[![travis][status]][travis]
+
+A minimum-viable URL builder for [Amazon Web Services (AWS)][aws].
+
+[Vacuum][vacuum] and [Peddler][peddler] implement AWS URL. [Fog][fog] doesn't.
+
+![bezos][bezos]
+
+[status]:  https://secure.travis-ci.org/hakanensari/aws-url.png
+[travis]:  http://travis-ci.org/hakanensari/aws-url
+[aws]:     http://aws.amazon.com/
+[vacuum]:  https://github.com/hakanensari/vacuum
+[peddler]: https://github.com/hakanensari/peddler
+[fog]:     https://github.com/fog/fog
+[bezos]:   http://www.wired.com/images/article/magazine/1605/mf_amazon_f.jpg

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+desc 'Run all specs in spec directory'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern    = 'spec/**/*_spec.rb'
+end
+
+task :default => [:spec]

data/aws-url.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require File.expand_path('../lib/aws/url/version.rb', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ['Hakan Ensari']
+  gem.email         = ['hakan.ensari@papercavalier.com']
+  gem.description   = %q{A minimum-viable URL builder for Amazon Web Services (AWS)}
+  gem.summary       = %q{Builds an Amazon Web Services URL}
+  gem.homepage      = 'https://github.com/hakanensari/aws-url'
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = 'aws-url'
+  gem.require_paths = ['lib']
+  gem.version       = AWS::URL::VERSION
+
+  gem.add_development_dependency 'rake',     '~> 0.9'
+  gem.add_development_dependency 'rspec',    '~> 2.9'
+end

data/lib/aws-url.rb

@@ -0,0 +1 @@
+require 'aws/url'

data/lib/aws/url.rb

@@ -0,0 +1,93 @@
+require 'base64'
+require 'openssl'
+require 'time'
+require 'uri'
+
+module AWS
+  # A Signed Amazon Web Services (AWS) URL.
+  #
+  # Currently supports Signature Version 2.
+  #
+  # Note to self: Do not touch this code unless you have a compelling reason.
+  class URL
+    # The SHA256 hash algorithm.
+    SHA256 = OpenSSL::Digest::SHA256.new
+
+    # Initializes a new URL.
+    #
+    # base_url - The String base URL, including scheme, host and path, of the
+    #            AWS endpoint.
+    # key      - The String AWS access key id.
+    # secret   - The String AWS secret key.
+    def initialize(base_url, key, secret)
+      @base_url = URI base_url
+      @key      = key
+      @secret   = secret
+      @params   = {}
+    end
+
+    # Builds a signed URL for specified HTTP method.
+    #
+    # method - A String-like HTTP method.
+    #
+    # Returns a String URL.
+    def build(method)
+      # Build an unsigned query string.
+      query = params.sort.map { |k, v| "#{k}=#{ percent_encode v }" }.join '&'
+
+      # Build the signature.
+      string_to_sign = [
+        method.to_s.upcase,
+        @base_url.host,
+        @base_url.path,
+        query
+      ].join "\n"
+      signature = sign string_to_sign
+
+      "#{@base_url}?#{query}&Signature=#{percent_encode signature}"
+    end
+
+    # Returns the Hash AWS parameters.
+    def params
+      default_params.merge @params
+    end
+
+    # Updates the AWS parameters.
+    #
+    # hash - A Hash.
+    #
+    # Returns nothing.
+    def update(hash)
+      hash.each do |key, val|
+        # Syntactic sugar: Camelize symbol keys.
+        if key.is_a? Symbol
+          key = key.to_s.split('_').map(&:capitalize).join
+        end
+
+        @params[key] = val
+      end
+    end
+
+    private
+
+    def percent_encode(value)
+      value.to_s.gsub(/([^\w.~-]+)/) do
+        '%' + $1.unpack('H2' * $1.bytesize).join('%').upcase
+      end
+    end
+
+    def default_params
+      {
+        'AWSAccessKeyId'   => @key,
+        'SignatureVersion' => '2',
+        'SignatureMethod'  => 'HmacSHA256',
+        'Timestamp'        => Time.now.utc.iso8601
+      }
+    end
+
+    def sign(message)
+      digest = OpenSSL::HMAC.digest SHA256, @secret, message
+      Base64.encode64(digest).chomp
+    end
+  end
+end

data/lib/aws/url/version.rb

@@ -0,0 +1,5 @@
+module AWS
+  class URL
+    VERSION = '0.1.0'
+  end
+end

data/spec/aws/url_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+module AWS
+  describe URL do
+
+    before do
+      @base_url = 'http://example.com/path'
+      @url = URL.new @base_url, 'key', 'secret'
+    end
+
+    describe '#build' do
+      subject { @url.build :get }
+
+      it 'includes the base URL' do
+        should { include @base_url }
+      end
+
+      it 'is signed' do
+        should { match /Signature=[^&]+$/ }
+      end
+    end
+
+    describe '#params' do
+      subject { @url.params }
+
+      it 'includes a key' do
+        should { include 'AWSAccessKeyId' }
+      end
+
+      it 'includes a signature version' do
+        should { include 'SignatureVersion' }
+      end
+
+      it 'includes a signature method' do
+        should { include 'SignatureMethod' }
+      end
+
+      it 'includes a timestamp' do
+        should { include 'Timestamp' }
+      end
+    end
+
+    describe '#update' do
+      it 'updates the parameters' do
+        @url.update 'Foo' => 'bar'
+        @url.params.should include 'Foo'
+      end
+
+      it 'camelizes symbol keys' do
+        @url.update :foo => 'bar'
+        @url.params.should include 'Foo'
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+# Test where the risk is.
+
+require 'rspec'
+begin
+  require 'pry'
+rescue LoadError
+end
+
+require 'aws-url'

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: aws-url
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Hakan Ensari
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70355690895500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: *70355690895500
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70355690894780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :development
+  prerelease: false
+  version_requirements: *70355690894780
+description: A minimum-viable URL builder for Amazon Web Services (AWS)
+email:
+- hakan.ensari@papercavalier.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- aws-url.gemspec
+- lib/aws-url.rb
+- lib/aws/url.rb
+- lib/aws/url/version.rb
+- spec/aws/url_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/hakanensari/aws-url
+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: Builds an Amazon Web Services URL
+test_files:
+- spec/aws/url_spec.rb
+- spec/spec_helper.rb
+has_rdoc: