configure-s3-website 1.0.0

data/.gitignore

@@ -0,0 +1,2 @@
+tmp
+pkg

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+- 1.8.7
+- 1.9.2
+- 1.9.3

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/Gemfile.lock

@@ -0,0 +1,54 @@
+PATH
+  remote: .
+  specs:
+    configure-s3-website (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.2)
+    aruba (0.4.11)
+      childprocess (>= 0.2.3)
+      cucumber (>= 1.1.1)
+      ffi (>= 1.0.11)
+      rspec (>= 2.7.0)
+    builder (3.1.4)
+    childprocess (0.3.6)
+      ffi (~> 1.0, >= 1.0.6)
+    crack (0.3.1)
+    cucumber (1.2.1)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.3)
+      gherkin (~> 2.11.0)
+      json (>= 1.4.6)
+    diff-lcs (1.1.3)
+    ffi (1.2.0)
+    gherkin (2.11.5)
+      json (>= 1.4.6)
+    json (1.7.5)
+    rake (0.9.6)
+    rspec (2.10.0)
+      rspec-core (~> 2.10.0)
+      rspec-expectations (~> 2.10.0)
+      rspec-mocks (~> 2.10.0)
+    rspec-core (2.10.1)
+    rspec-expectations (2.10.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.10.1)
+    vcr (2.3.0)
+    webmock (1.8.11)
+      addressable (>= 2.2.7)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba (~> 0.4.0)
+  configure-s3-website!
+  cucumber (~> 1.2.0)
+  rake (~> 0.9.0)
+  rspec (~> 2.10.0)
+  rspec-expectations (~> 2.10.0)
+  vcr (~> 2.3.0)
+  webmock (~> 1.8.0)

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2012 Lauri lehmijoki
+
+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,72 @@
+# Configure-s3-website
+
+[![Build Status](https://secure.travis-ci.org/laurilehmijoki/configure-s3-website.png)](http://travis-ci.org/laurilehmijoki/configure-s3-website)
+[![Gem Version](https://fury-badge.herokuapp.com/rb/configure-s3-website.png)](http://badge.fury.io/rb/configure-s3-website)
+
+Configure an AWS S3 bucket to function as a website. Easily from the
+command-line interface.
+
+The Ruby gem `configure-s3-website` can configure an S3 bucket to function as a
+website. The bucket may or may not exist. If the bucket does not exist,
+`configure-s3-website` will create it.
+
+## Install
+
+    gem install configure-s3-website
+
+## Usage
+
+Create a file that contains the S3 credentials and the name of the bucket:
+
+```yaml
+s3_id: your-aws-access-key
+s3_secret: your-aws-secret-key
+s3_bucket: name-of-your-bucket
+```
+
+Save the file (as *config.yml*, for example). Now you are ready to go. Run the
+following command:
+
+    configure-s3-website --config-file config.yml
+
+Congratulations! You now have an S3 bucket that can act as a website server for
+you.
+
+## How does `configure-s3-website` work?
+
+It calls the [PUT Bucket
+website](http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTwebsite.html)
+API with the following XML:
+
+```xml
+<WebsiteConfiguration xmlns='http://s3.amazonaws.com/doc/2006-03-01/'>
+  <IndexDocument>
+    <Suffix>index.html</Suffix>
+  </IndexDocument>
+  <ErrorDocument>
+    <Key>error.html</Key>
+  </ErrorDocument>
+</WebsiteConfiguration>
+```
+
+Then **it makes all the objects on the bucket visible to the whole world** by
+calling the [PUT Bucket
+policy](http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTpolicy.html)
+API with the following JSON:
+
+```json
+{
+  "Version":"2008-10-17",
+  "Statement":[{
+    "Sid":"PublicReadForGetBucketObjects",
+    "Effect":"Allow",
+    "Principal": { "AWS": "*" },
+    "Action":["s3:GetObject"],
+    "Resource":["arn:aws:s3:::your-bucket-name/*"]
+  }]
+}
+```
+
+## License
+
+See file LICENSE.

data/Rakefile

@@ -0,0 +1,16 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+desc "Build the project"
+task :default => 'test'
+
+desc "Run tests"
+task :test do
+  sh "bundle exec rspec"
+  sh "bundle exec cucumber"
+end
+
+desc 'Run features tagged with @wip'
+task 'cucumber:wip' do
+  sh "bundle exec cucumber --tags @wip"
+end

data/bin/configure-s3-website

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'optparse'
+require 'configure-s3-website'
+
+options = {}
+
+banner = <<END
+Usage: #{File.basename(__FILE__)} arguments
+
+Configure your S3 bucket to function as a web site
+
+Arguments:
+END
+
+optparse = OptionParser.new do |opts|
+  opts.banner = banner
+  opts.on('-f', '--config-file FILE',
+          'Pick credentials and the S3 bucket name from a config file') do
+          |yaml_file_path|
+    options[:config_source] = 
+      ConfigureS3Website::FileConfigSource.new yaml_file_path
+  end
+  opts.on('--help', 'Display this screen') do
+    puts opts
+    exit
+  end
+end
+
+optparse.parse!
+
+ConfigureS3Website::S3Client.configure_website(options[:config_source])

data/configure-s3-website.gemspec

@@ -0,0 +1,24 @@
+require File.join([File.dirname(__FILE__),'lib','configure-s3-website','version.rb'])
+spec = Gem::Specification.new do |s|
+  s.name = 'configure-s3-website'
+  s.version = ConfigureS3Website::VERSION
+  s.author = 'Lauri Lehmijoki'
+  s.email = 'lauri.lehmijoki@iki.fi'
+  s.homepage = 'https://github.com/laurilehmijoki/configure-s3-website'
+  s.platform = Gem::Platform::RUBY
+  s.summary = 'Configure your S3 bucket to function as a web site'
+  s.bindir = 'bin'
+
+  s.add_development_dependency 'rspec', '~> 2.10.0'
+  s.add_development_dependency 'rspec-expectations', '~> 2.10.0'
+  s.add_development_dependency 'cucumber', '~> 1.2.0'
+  s.add_development_dependency 'aruba', '~> 0.4.0'
+  s.add_development_dependency 'rake', '~> 0.9.0'
+  s.add_development_dependency 'vcr', '~> 2.3.0'
+  s.add_development_dependency 'webmock', '~> 1.8.0'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/features/cassettes/cucumber_tags/bucket-does-not-exist.yml

@@ -0,0 +1,159 @@
+---
+http_interactions:
+- request:
+    method: put
+    uri: https://s3.amazonaws.com/name-of-a-new-bucket/?website
+    body:
+      encoding: US-ASCII
+      string: ! "\n        <WebsiteConfiguration xmlns='http://s3.amazonaws.com/doc/2006-03-01/'>\n
+        \         <IndexDocument>\n            <Suffix>index.html</Suffix>\n          </IndexDocument>\n
+        \         <ErrorDocument>\n            <Key>error.html</Key>\n          </ErrorDocument>\n
+        \       </WebsiteConfiguration>\n      "
+    headers:
+      Date:
+      - Sun, 30 Dec 2012 19:59:34 EET
+      Content-Type:
+      - ''
+      Content-Length:
+      - '298'
+      Authorization:
+      - AWS foo
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      X-Amz-Request-Id:
+      - CD16DF6FF66B5922
+      X-Amz-Id-2:
+      - Xu30q0VM0aaYY091koYh8FIUDPB2KWOQLRPqnLulIK3ScIrMWgOwF7M2XRYIi5Vs
+      Content-Type:
+      - application/xml
+      Transfer-Encoding:
+      - chunked
+      Date:
+      - Sun, 30 Dec 2012 17:59:34 GMT
+      Connection:
+      - close
+      Server:
+      - AmazonS3
+    body:
+      encoding: US-ASCII
+      string: ! '<?xml version="1.0" encoding="UTF-8"?>
+
+        <Error><Code>NoSuchBucket</Code><Message>The specified bucket does not exist</Message><BucketName>name-of-a-new-bucket</BucketName><RequestId>CD16DF6FF66B5922</RequestId><HostId>Xu30q0VM0aaYY091koYh8FIUDPB2KWOQLRPqnLulIK3ScIrMWgOwF7M2XRYIi5Vs</HostId></Error>'
+    http_version:
+  recorded_at: Sun, 30 Dec 2012 17:59:37 GMT
+- request:
+    method: put
+    uri: https://s3.amazonaws.com/name-of-a-new-bucket
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Date:
+      - Sun, 30 Dec 2012 19:59:37 EET
+      Content-Type:
+      - ''
+      Content-Length:
+      - '0'
+      Authorization:
+      - AWS foo
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      X-Amz-Id-2:
+      - 7HuGyurBPI/HV8DVtjtRufaMaLRJLU+vCch+BPuBAysYAlE7XS4Eavz7srhB2dTx
+      X-Amz-Request-Id:
+      - 431755651DECBBC5
+      Date:
+      - Sun, 30 Dec 2012 17:59:39 GMT
+      Location:
+      - /name-of-a-new-bucket
+      Content-Length:
+      - '0'
+      Server:
+      - AmazonS3
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version:
+  recorded_at: Sun, 30 Dec 2012 17:59:39 GMT
+- request:
+    method: put
+    uri: https://s3.amazonaws.com/name-of-a-new-bucket/?website
+    body:
+      encoding: US-ASCII
+      string: ! "\n        <WebsiteConfiguration xmlns='http://s3.amazonaws.com/doc/2006-03-01/'>\n
+        \         <IndexDocument>\n            <Suffix>index.html</Suffix>\n          </IndexDocument>\n
+        \         <ErrorDocument>\n            <Key>error.html</Key>\n          </ErrorDocument>\n
+        \       </WebsiteConfiguration>\n      "
+    headers:
+      Date:
+      - Sun, 30 Dec 2012 19:59:39 EET
+      Content-Type:
+      - ''
+      Content-Length:
+      - '298'
+      Authorization:
+      - AWS foo
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      X-Amz-Id-2:
+      - XZE0T/tWFNuRi6/yu1O+O3A7fJ/j2oas8ZqK4p6rLbaRxevXe44K/pAOsrB381ei
+      X-Amz-Request-Id:
+      - 514396AE3C1BB2C1
+      Date:
+      - Sun, 30 Dec 2012 17:59:41 GMT
+      Content-Length:
+      - '0'
+      Server:
+      - AmazonS3
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version:
+  recorded_at: Sun, 30 Dec 2012 17:59:42 GMT
+- request:
+    method: put
+    uri: https://s3.amazonaws.com/name-of-a-new-bucket/?policy
+    body:
+      encoding: US-ASCII
+      string: ! "{\n        \"Version\":\"2008-10-17\",\n        \"Statement\":[{\n
+        \         \"Sid\":\"PublicReadForGetBucketObjects\",\n          \"Effect\":\"Allow\",\n
+        \         \"Principal\": { \"AWS\": \"*\" },\n          \"Action\":[\"s3:GetObject\"],\n
+        \         \"Resource\":[\"arn:aws:s3:::name-of-a-new-bucket/*\"]\n        }]\n
+        \     }"
+    headers:
+      Date:
+      - Sun, 30 Dec 2012 19:59:42 EET
+      Content-Type:
+      - ''
+      Content-Length:
+      - '289'
+      Authorization:
+      - AWS foo
+  response:
+    status:
+      code: 204
+      message: No Content
+    headers:
+      X-Amz-Id-2:
+      - z/XdtqiOW0ihAGadAXwCNCAuE0OLeFisy4TN5e/3OmEI72dQxQjfftyXFSNNwOQN
+      X-Amz-Request-Id:
+      - 82E8EBABB5D150C5
+      Date:
+      - Sun, 30 Dec 2012 17:59:44 GMT
+      Server:
+      - AmazonS3
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version:
+  recorded_at: Sun, 30 Dec 2012 17:59:44 GMT
+recorded_with: VCR 2.3.0

data/features/cassettes/cucumber_tags/bucket-exists.yml

@@ -0,0 +1,78 @@
+---
+http_interactions:
+- request:
+    method: put
+    uri: https://s3.amazonaws.com/name-of-an-existing-bucket/?website
+    body:
+      encoding: US-ASCII
+      string: ! "\n        <WebsiteConfiguration xmlns='http://s3.amazonaws.com/doc/2006-03-01/'>\n
+        \         <IndexDocument>\n            <Suffix>index.html</Suffix>\n          </IndexDocument>\n
+        \         <ErrorDocument>\n            <Key>error.html</Key>\n          </ErrorDocument>\n
+        \       </WebsiteConfiguration>\n      "
+    headers:
+      Date:
+      - Sun, 30 Dec 2012 20:40:12 EET
+      Content-Type:
+      - ''
+      Content-Length:
+      - '298'
+      Authorization:
+      - AWS 
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      X-Amz-Id-2:
+      - IjY5jr731On+Fs4U70tsMf5f6KmYMhe+zCgbrIRBIrVqlRflrm5o9gpPWLzhO9SG
+      X-Amz-Request-Id:
+      - 2675BEDE56DD5A89
+      Date:
+      - Sun, 30 Dec 2012 18:40:14 GMT
+      Content-Length:
+      - '0'
+      Server:
+      - AmazonS3
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version: 
+  recorded_at: Sun, 30 Dec 2012 18:40:14 GMT
+- request:
+    method: put
+    uri: https://s3.amazonaws.com/name-of-an-existing-bucket/?policy
+    body:
+      encoding: US-ASCII
+      string: ! "{\n        \"Version\":\"2008-10-17\",\n        \"Statement\":[{\n
+        \         \"Sid\":\"PublicReadForGetBucketObjects\",\n          \"Effect\":\"Allow\",\n
+        \         \"Principal\": { \"AWS\": \"*\" },\n          \"Action\":[\"s3:GetObject\"],\n
+        \         \"Resource\":[\"arn:aws:s3:::name-of-an-existing-bucket/*\"]\n        }]\n
+        \     }"
+    headers:
+      Date:
+      - Sun, 30 Dec 2012 20:40:14 EET
+      Content-Type:
+      - ''
+      Content-Length:
+      - '295'
+      Authorization:
+      - AWS 
+  response:
+    status:
+      code: 204
+      message: No Content
+    headers:
+      X-Amz-Id-2:
+      - i1+BrkVJ09WJjTMD4FrlD7WU1lDeE3FrTJHs+GPui8JoXcFW0dFWFjykJVnXA+4g
+      X-Amz-Request-Id:
+      - 3959D1657C7E30DC
+      Date:
+      - Sun, 30 Dec 2012 18:40:15 GMT
+      Server:
+      - AmazonS3
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version: 
+  recorded_at: Sun, 30 Dec 2012 18:40:15 GMT
+recorded_with: VCR 2.3.0

data/features/config_file.feature

@@ -0,0 +1,57 @@
+Feature: load credentials and the S3 bucket name from a file
+
+  As an AWS S3 user
+  Who has S3 credentials and the S3 bucket name in a YAML file
+  I would like to configure the bucket to function as a website
+
+  Scenario: config file is missing property "s3_id"
+    Given a directory named "website-project"
+    And a file named "website-project/s3_config.yml" with:
+      """
+      id: key
+      s3_secret: SECRET
+      s3_bucket: my-bucket
+      """
+    When I run `configure-s3-website --config-file website-project/s3_config.yml`
+    Then the output should contain:
+      """
+      website-project/s3_config.yml does not contain the required key(s) s3_id
+      """
+
+  Scenario: config file is missing property "s3_secret"
+    Given a directory named "website-project"
+    And a file named "website-project/s3_config.yml" with:
+      """
+      s3_id: key
+      s3_bucket: my-bucket
+      """
+    When I run `configure-s3-website --config-file website-project/s3_config.yml`
+    Then the output should contain:
+      """
+      website-project/s3_config.yml does not contain the required key(s) s3_secret
+      """
+
+  Scenario: config file is missing property "s3_bucket"
+    Given a directory named "website-project"
+    And a file named "website-project/s3_config.yml" with:
+      """
+      s3_id: key
+      s3_secret: secret
+      """
+    When I run `configure-s3-website --config-file website-project/s3_config.yml`
+    Then the output should contain:
+      """
+      website-project/s3_config.yml does not contain the required key(s) s3_bucket
+      """
+
+  Scenario: config file is missing properties "s3_bucket" and "s3_id"
+    Given a directory named "website-project"
+    And a file named "website-project/s3_config.yml" with:
+      """
+      s3_secret: secret
+      """
+    When I run `configure-s3-website --config-file website-project/s3_config.yml`
+    Then the output should contain:
+      """
+      website-project/s3_config.yml does not contain the required key(s) s3_id, s3_bucket
+      """

data/features/configure_bucket.feature

@@ -0,0 +1,24 @@
+Feature: configure an S3 bucket to function as a website
+
+  @bucket-does-not-exist
+  Scenario: The bucket does not yet exist
+    Given my config file is in "features/support/sample_config_files/s3_config_with_non-existing_bucket.yml"
+    When I run the configure-s3-website command
+    Then the output should be
+      """
+      Created bucket name-of-a-new-bucket
+      Bucket name-of-a-new-bucket now functions as a website
+      Bucket name-of-a-new-bucket is now readable to the whole world
+
+      """
+
+  @bucket-exists
+  Scenario: The bucket already exists
+    Given my config file is in "features/support/sample_config_files/s3_config_with_existing_bucket.yml"
+    When I run the configure-s3-website command
+    Then the output should be
+      """
+      Bucket name-of-an-existing-bucket now functions as a website
+      Bucket name-of-an-existing-bucket is now readable to the whole world
+
+      """

data/features/step_definitions/steps.rb

@@ -0,0 +1,29 @@
+require 'rspec'
+
+Given /^my config file is in "(.*?)"$/ do |config_file_path|
+  @config_file_path = config_file_path
+end
+
+When /^I run the configure-s3-website command$/ do
+  @console_output = capture_stdout {
+    config_source = ConfigureS3Website::FileConfigSource.new(@config_file_path)
+    ConfigureS3Website::S3Client.configure_website(config_source)
+  }
+end
+
+Then /^the output should be$/ do |expected_console_output|
+  @console_output.should eq(expected_console_output)
+end
+
+module Kernel
+  require 'stringio'
+
+  def capture_stdout
+    out = StringIO.new
+    $stdout = out
+    yield
+    out.string
+  ensure
+    $stdout = STDOUT
+  end
+end

data/features/support/env.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+
+Bundler.require
+
+require 'aruba/cucumber'
+require 'cucumber/rspec/doubles'
+
+# Following from 'aruba/cucumber'
+Before do
+  @__aruba_original_paths = (ENV['PATH'] || '').split(File::PATH_SEPARATOR)
+  ENV['PATH'] = ([File.expand_path('bin')] + @__aruba_original_paths).join(File::PATH_SEPARATOR)
+end
+
+After do
+  ENV['PATH'] = @__aruba_original_paths.join(File::PATH_SEPARATOR)
+end
+# End of following from 'aruba/cucumber'

data/features/support/sample_config_files/s3_config_with_existing_bucket.yml

@@ -0,0 +1,3 @@
+s3_id: foo
+s3_secret: foo
+s3_bucket: name-of-an-existing-bucket

data/features/support/sample_config_files/s3_config_with_non-existing_bucket.yml

@@ -0,0 +1,3 @@
+s3_id: foo
+s3_secret: foo
+s3_bucket: name-of-a-new-bucket

data/features/support/vcr.rb

@@ -0,0 +1,11 @@
+require 'vcr'
+
+VCR.configure do |c|
+  c.hook_into :webmock
+  c.cassette_library_dir = 'features/cassettes'
+end
+
+VCR.cucumber_tags do |t|
+  t.tag '@bucket-does-not-exist'
+  t.tag '@bucket-exists'
+end

data/lib/configure-s3-website.rb

@@ -0,0 +1,4 @@
+require 'configure-s3-website/version'
+require 'configure-s3-website/s3_client'
+require 'configure-s3-website/config_source/config_source'
+require 'configure-s3-website/config_source/file_config_source'

data/lib/configure-s3-website/config_source/config_source.rb

@@ -0,0 +1,12 @@
+module ConfigureS3Website
+  class ConfigSource
+    def s3_access_key_id
+    end
+
+    def s3_secret_access_key
+    end
+
+    def s3_bucket_name
+    end
+  end
+end

data/lib/configure-s3-website/config_source/file_config_source.rb

@@ -0,0 +1,38 @@
+require 'yaml'
+require 'erb'
+
+module ConfigureS3Website
+  class FileConfigSource < ConfigSource
+    def initialize(yaml_file_path)
+      @config = parse_config yaml_file_path
+    end
+
+    def s3_access_key_id
+      @config['s3_id']
+    end
+
+    def s3_secret_access_key
+      @config['s3_secret']
+    end
+
+    def s3_bucket_name
+      @config['s3_bucket']
+    end
+
+    private
+
+    def parse_config(yaml_file_path)
+      config = YAML.load(ERB.new(File.read(yaml_file_path)).result)
+      validate_config(config, yaml_file_path)
+      config
+    end
+
+    def validate_config(config, yaml_file_path)
+      required_keys = %w{s3_id s3_secret s3_bucket}
+      missing_keys = required_keys.reject do |key| config.keys.include?key end
+      unless missing_keys.empty?
+        raise "File #{yaml_file_path} does not contain the required key(s) #{missing_keys.join(', ')}"
+      end
+    end
+  end
+end

data/lib/configure-s3-website/s3_client.rb

@@ -0,0 +1,127 @@
+require 'base64'
+require 'openssl'
+require 'digest/sha1'
+require 'digest/md5'
+require 'net/https'
+
+module ConfigureS3Website
+  class S3Client
+    def self.configure_website(config_source)
+      begin
+        enable_website_configuration(config_source)
+        make_bucket_readable_to_everyone(config_source)
+      rescue NoSuchBucketError
+        create_bucket(config_source)
+        retry
+      end
+    end
+
+    private
+
+    def self.enable_website_configuration(config_source)
+      body = %|
+        <WebsiteConfiguration xmlns='http://s3.amazonaws.com/doc/2006-03-01/'>
+          <IndexDocument>
+            <Suffix>index.html</Suffix>
+          </IndexDocument>
+          <ErrorDocument>
+            <Key>error.html</Key>
+          </ErrorDocument>
+        </WebsiteConfiguration>
+      |
+      call_s3_api(
+        path = "/#{config_source.s3_bucket_name}/?website",
+        method = Net::HTTP::Put,
+        body = body,
+        config_source = config_source
+      )
+      puts "Bucket #{config_source.s3_bucket_name} now functions as a website"
+    end
+
+    def self.make_bucket_readable_to_everyone(config_source)
+      policy_json = %|{
+        "Version":"2008-10-17",
+        "Statement":[{
+          "Sid":"PublicReadForGetBucketObjects",
+          "Effect":"Allow",
+          "Principal": { "AWS": "*" },
+          "Action":["s3:GetObject"],
+          "Resource":["arn:aws:s3:::#{config_source.s3_bucket_name}/*"]
+        }]
+      }|
+      call_s3_api(
+        path = "/#{config_source.s3_bucket_name}/?policy",
+        method = Net::HTTP::Put,
+        body = policy_json,
+        config_source = config_source
+      )
+      puts "Bucket #{config_source.s3_bucket_name} is now readable to the whole world"
+    end
+
+    def self.create_bucket(config_source)
+      call_s3_api(
+        path = "/#{config_source.s3_bucket_name}",
+        method = Net::HTTP::Put,
+        body = '',
+        config_source = config_source
+      )
+      puts "Created bucket #{config_source.s3_bucket_name}"
+    end
+
+    def self.call_s3_api(path, method, body, config_source)
+      date = Time.now.strftime("%a, %d %b %Y %H:%M:%S %Z")
+      digest = create_digest(path, method, config_source, date)
+      url = "https://s3.amazonaws.com#{path}"
+      uri = URI.parse(url)
+      req = method.new(uri.to_s)
+      req.initialize_http_header({
+        'Date' => date,
+        'Content-Type' => '',
+        'Content-Length' => body.length.to_s,
+        'Authorization' => "AWS %s:%s" % [config_source.s3_access_key_id, digest]
+      })
+      req.body = body
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      res = http.request(req)
+      if res.code.to_i.between? 200, 299
+        res
+      else
+        raise ConfigureS3Website::ErrorParser.create_error res.body
+      end
+    end
+
+    def self.create_digest(path, method, config_source, date)
+      digest = OpenSSL::Digest::Digest.new('sha1')
+      method_string = method.to_s.match(/Net::HTTP::(\w+)/)[1].upcase
+      can_string = "#{method_string}\n\n\n#{date}\n#{path}"
+      hmac = OpenSSL::HMAC.digest(digest, config_source.s3_secret_access_key, can_string)
+      signature = Base64.encode64(hmac).strip
+    end
+  end
+end
+
+private
+
+module ConfigureS3Website
+  class ErrorParser
+    def self.create_error(amazon_error_xml)
+      error_code = amazon_error_xml.delete('\n').match(/<Code>(.*?)<\/Code>/)[1]
+      begin
+        Object.const_get("#{error_code}Error").new
+      rescue NameError
+        GenericS3Error.new(amazon_error_xml)
+      end
+    end
+  end
+end
+
+class NoSuchBucketError < StandardError
+end
+
+class GenericS3Error < StandardError
+  def initialize(error_message)
+    super("AWS API call failed:\n#{error_message}")
+  end
+end

data/lib/configure-s3-website/version.rb

@@ -0,0 +1,3 @@
+module ConfigureS3Website
+  VERSION = '1.0.0'
+end

data/spec/config_extractor/file_config_extractor_spec.rb

@@ -0,0 +1,11 @@
+require 'rspec'
+require 'configure-s3-website'
+
+describe ConfigureS3Website::FileConfigSource do
+  it 'can parse files that contain eRuby code' do
+    extractor = ConfigureS3Website::FileConfigSource.new('spec/sample_files/_config_file_with_eruby.yml')
+    extractor.s3_access_key_id.should eq('hello world')
+    extractor.s3_secret_access_key.should eq('secret world')
+    extractor.s3_bucket_name.should eq('my-bucket')
+  end
+end

data/spec/sample_files/_config_file_with_eruby.yml

@@ -0,0 +1,3 @@
+s3_id: <%= 'hello world' %>
+s3_secret: <%= 'secret world' %>
+s3_bucket: my-bucket

metadata

@@ -0,0 +1,193 @@
+--- !ruby/object:Gem::Specification
+name: configure-s3-website
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Lauri Lehmijoki
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+- !ruby/object:Gem::Dependency
+  name: rspec-expectations
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.0
+description: 
+email: lauri.lehmijoki@iki.fi
+executables:
+- configure-s3-website
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/configure-s3-website
+- configure-s3-website.gemspec
+- features/cassettes/cucumber_tags/bucket-does-not-exist.yml
+- features/cassettes/cucumber_tags/bucket-exists.yml
+- features/config_file.feature
+- features/configure_bucket.feature
+- features/step_definitions/steps.rb
+- features/support/env.rb
+- features/support/sample_config_files/s3_config_with_existing_bucket.yml
+- features/support/sample_config_files/s3_config_with_non-existing_bucket.yml
+- features/support/vcr.rb
+- lib/configure-s3-website.rb
+- lib/configure-s3-website/config_source/config_source.rb
+- lib/configure-s3-website/config_source/file_config_source.rb
+- lib/configure-s3-website/s3_client.rb
+- lib/configure-s3-website/version.rb
+- spec/config_extractor/file_config_extractor_spec.rb
+- spec/sample_files/_config_file_with_eruby.yml
+homepage: https://github.com/laurilehmijoki/configure-s3-website
+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.24
+signing_key: 
+specification_version: 3
+summary: Configure your S3 bucket to function as a web site
+test_files:
+- features/cassettes/cucumber_tags/bucket-does-not-exist.yml
+- features/cassettes/cucumber_tags/bucket-exists.yml
+- features/config_file.feature
+- features/configure_bucket.feature
+- features/step_definitions/steps.rb
+- features/support/env.rb
+- features/support/sample_config_files/s3_config_with_existing_bucket.yml
+- features/support/sample_config_files/s3_config_with_non-existing_bucket.yml
+- features/support/vcr.rb
+- spec/config_extractor/file_config_extractor_spec.rb
+- spec/sample_files/_config_file_with_eruby.yml