Add end to end test coverage and main entry point for bucket

Add the end-to-end feature test and document the Gem's configuration and usage.
Add main entry point to the buckets and move AWS methods in the correct module

README.md

@@ -20,9 +20,43 @@ Or install it yourself as:
 
     $ gem install defra_ruby_aws
 
+## Configuration
+
+Add a new bucket with:
+
+```
+# config/initializers/defra-ruby-aws.rb
+require "defra-ruby-aws"
+
+DefraRuby::Aws.configure do |config|
+  config.buckets = [{
+    # bucket's name, required
+    name: "defra-ruby-aws",
+    # AWS bucket access credentials, required
+    credentials: {
+      access_key_id: "ACCES_KEY_ID",
+      secret_access_key: "SECRET_ACCESS_KEY"
+    },
+    # optional - Default to "eu-west-1"
+    region: "eu-west-1"
+  }]
+end
+```
+
 ## Usage
 
-TBD
+```
+file_to_upload = Tempfile.new("test-upload-file.csv")
+bucket = DefraRuby::Aws.get_bucket("defra-ruby-aws")
+response = bucket.load(file_to_upload)
+
+if response.successful?
+  # Do something
+else
+  response.error # return the failure error
+  # Do something else
+end
+```
 
 ## Contributing to this project
 

defra_ruby_aws.gemspec

@@ -54,4 +54,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "rubocop"
   spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "webmock"
 end

lib/defra_ruby/aws.rb

@@ -5,3 +5,24 @@
 require_relative "aws/configuration"
 
 require_relative "aws/services/bucket_loader_service"
+
+module DefraRuby
+  module Aws
+    class << self
+      attr_accessor :configuration
+
+      def configure
+        require "aws-sdk-s3"
+
+        self.configuration ||= Configuration.new
+        yield(configuration)
+      end
+
+      def get_bucket(bucket_name)
+        configuration.buckets.select do |bucket|
+          bucket.bucket_name == bucket_name
+        end.first
+      end
+    end
+  end
+end

lib/defra_ruby/aws/configuration.rb

@@ -2,17 +2,6 @@
 
 module DefraRuby
   module Aws
-    class << self
-      attr_accessor :configuration
-    end
-
-    def self.configure
-      require "aws-sdk-s3"
-
-      self.configuration ||= Configuration.new
-      yield(configuration)
-    end
-
     class Configuration
       attr_reader :buckets
 

spec/features/upload_file_to_bucket_spec.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe "Defra Ruby AWS" do
+  it "Upload a file to an AWS bucket" do
+    configure_gem
+    stub_successful_request
+
+    bucket = DefraRuby::Aws.get_bucket("bulk-test")
+    response = bucket.load(Tempfile.new("test-bucket-load.test"))
+
+    expect(response).to be_successful
+  end
+
+  it "fails gracefully" do
+    configure_gem
+    stub_failing_request
+
+    bucket = DefraRuby::Aws.get_bucket("bulk-test")
+    response = bucket.load(Tempfile.new("test-bucket-load.test"))
+
+    expect(response).to_not be_successful
+    expect(response.error).to be_a(Aws::S3::Errors::Forbidden)
+  end
+
+  def configure_gem
+    DefraRuby::Aws.configure do |config|
+      config.buckets = [{
+        name: "bulk-test",
+        credentials: {
+          access_key_id: "ACCESS_KEY_ID",
+          secret_access_key: "SECRET_ACCESS_KEY"
+        }
+      }]
+    end
+  end
+
+  def stub_successful_request
+    stub_request(:put, /https:\/\/bulk-test\.s3\.eu-west-1\.amazonaws\.com\/test-bucket-load\..+/)
+  end
+
+  def stub_failing_request
+    stub_request(
+      :put,
+      /https:\/\/bulk-test\.s3\.eu-west-1\.amazonaws\.com\/test-bucket-load\..+/
+    ).to_return(
+      status: 403
+    )
+  end
+end

spec/spec_helper.rb

@@ -2,6 +2,7 @@
 
 require "pry-byebug"
 require "aws-sdk-s3"
+require "webmock/rspec"
 
 # This file was generated by the `rspec --init` command. Conventionally, all
 # specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.