aws_tools 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2010 Christopher Meiklejohn
+
+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/Manifest

@@ -0,0 +1,6 @@
+MIT-LICENSE
+Manifest
+README.rdoc
+Rakefile
+lib/aws_tools.rb
+lib/aws_tools/s3.rb

data/README.rdoc

@@ -0,0 +1,66 @@
+= Introduction
+
+AwsTools aims to provide an interface to some common administration tasks.
+
+= Installation 
+
+To install, run
+    
+    $ sudo gem install aws_tools
+
+= Examples
+
+    require 'rubygems'
+    require 'right_aws'
+    require 'aws_tools'
+
+    # Connect to S3 and synchronize all buckets.
+    AwsTools::S3::Synchronize.new(RightAws::S3.new(access_key,
+                                                   secret_access_key,
+                                                   :backup_suffix => "-dr",
+                                                   :backup_location => :eu)
+
+    View the documentation for more information.
+
+= Documentation 
+
+You can generate documentation if you have the source by typing:
+
+    rake doc
+
+= Release Notes
+
+First release.
+
+= Credits
+
+AwsTools is maintained by {Christopher Meiklejohn}[mailto:cmeik@me.com].  Contact me if you'd like to request any features or have any questions or feedback.
+
+= License
+
+AwsTools is Copyright 2010 Christopher Meiklejohn.  
+
+It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file, which is attached below:
+  
+  Copyright (c) 2010 Christopher Meiklejohn
+
+  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/Rakefile

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('aws_tools', '0.0.1') do |p|
+  p.description = "A library to help simplify common AWS tasks."
+  p.url = "http://github.com/cmeiklejohn/aws_tools"
+  p.author = "Christopher Meiklejohn"
+  p.email = "cmeik@me.com"
+end

data/aws_tools.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{aws_tools}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Christopher Meiklejohn"]
+  s.date = %q{2010-02-25}
+  s.description = %q{A library to help simplify common AWS tasks.}
+  s.email = %q{cmeik@me.com}
+  s.extra_rdoc_files = ["README.rdoc", "lib/aws_tools.rb", "lib/aws_tools/s3.rb"]
+  s.files = ["MIT-LICENSE", "Manifest", "README.rdoc", "Rakefile", "lib/aws_tools.rb", "lib/aws_tools/s3.rb", "aws_tools.gemspec"]
+  s.homepage = %q{http://github.com/cmeiklejohn/aws_tools}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Aws_tools", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{aws_tools}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{A library to help simplify common AWS tasks.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/aws_tools/s3.rb

@@ -0,0 +1,144 @@
+#!/usr/bin/ruby 
+
+require 'rubygems'
+require 'right_aws'
+
+module AwsTools
+  class S3
+    # Bucket class.
+    #
+    # Knows how to perform synchronization of all assets 
+    # in one bucket.
+    class Bucket
+      # Synchronize.
+      #
+      # Performs the synchronization of one bucket.
+      class Synchronize
+        attr_accessor :bucket, :backup_bucket
+
+        def initialize(options = {})
+          puts "AwsTools::S3::Bucket::Synchronize called."
+
+          options.each_pair do |key, value| 
+            self.send("#{key}=", value)
+          end
+
+          perform_synchronization
+        end
+
+        private 
+
+        # Peform synchronization of one bucket.
+        def perform_synchronization
+          puts "AwsTools::S3::Bucket::Synchronize synchronizing #{bucket.name} to " +
+               "#{backup_bucket.name}"
+
+          bucket.keys.each do |source_key| 
+
+            # Look for destination key.
+            destination_key = RightAws::S3::Key.create(backup_bucket, source_key.to_s)
+    
+            # If it exists...
+            if destination_key.exists?
+
+              puts "AwsTools::S3::Bucket::Synchronize destination file #{source_key.to_s} " + 
+                   "already exists"
+
+              # Grab headers.
+              source_key.head
+              destination_key.head
+
+              # Get last modified
+              source_date = Time.parse(source_key.headers["last-modified"])
+              destination_date = Time.parse(destination_key.headers["last-modified"])
+
+              # Copy if the destination is older than the source
+              if source_date > destination_date 
+                puts "AwsTools::S3::Bucket::Synchronize destination file #{source_key.to_s} " + 
+                     "is older"
+
+                # Perform a copy of the object.
+                source_key.copy(destination_key)
+       
+                # Check if it worked...
+                if destination_key.exists?
+                  puts "AwsTools::S3::Bucket::Synchronize destination file #{source_key.to_s} " + 
+                       "replaced with newer copy"
+                end
+              else 
+                puts "AwsTools::S3::Bucket::Synchronize destination file #{source_key.to_s} " + 
+                     "is up to date"
+              end
+
+            else
+
+              # Perform a copy of the object.
+              source_key.copy(destination_key)
+       
+              # Check if it worked...
+              if destination_key.exists?
+                puts "AwsTools::S3::Bucket::Synchronize destination file #{source_key.to_s} " + 
+                     "successfully created"
+              end
+
+            end
+
+          end
+
+        end
+      end
+    end
+
+    # Synchronize class.
+    #
+    # Performs synchronization of every bucket in an S3 account.
+    #
+    # Assume that you will be synchronizing to a bucket with a suffix located 
+    # in another zone (since names need to be unique across all zones.
+    class Synchronize
+      attr_accessor :backup_suffix, :backup_location
+
+      def initialize(s3, options = {}) 
+        puts "AwsTools::S3::Synchronize called."
+
+        @s3 = s3
+
+        options.each_pair do |key, value| 
+          self.send("#{key}=", value)
+        end
+
+        perform_synchronization
+      end
+
+      private 
+
+      # Retrieve all buckets, and synchronize them one by one.
+      def perform_synchronization
+        # Retrieve bucket list.
+        @s3.buckets.each do |bucket| 
+          puts "AwsTools::S3::Synchronize assesing bucket #{bucket.name}"
+
+          # If the bucket is located in the normal zone, assume this
+          # is a bucket we want to create a backup of.
+          if bucket.location.empty?
+            
+            # Backup bucket.
+            backup_bucket_name = "#{bucket.name}#{backup_suffix}"
+           
+            puts "AwsTools::S3::Synchronize #{bucket.name} will be synchronized " + 
+                 "to #{backup_bucket_name} in #{backup_location}"
+
+            backup_bucket = @s3.bucket("#{backup_bucket_name}",
+                                       true,
+                                       'public-read',
+                                       :location => backup_location)
+
+            AwsTools::S3::Bucket::Synchronize.new(:bucket => bucket, 
+                                                  :backup_bucket => backup_bucket)
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/aws_tools.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/ruby 
+#
+# AwsTools
+#
+# Provides an interface to make some AWS administration tools easier.
+#
+# Author:: Christopher Meiklejohn (cmeik@me.com)
+# Copyright:: Copyright (c) 2010 Christopher Meiklejohn
+# License:: Distributes under the terms specified in the MIT-LICENSE file.
+#
+# Usage example:
+#
+# # Connect to S3 and synchronize all buckets.
+# AwsTools::S3::Synchronize.new(RightAws::S3.new(access_key,
+#                                                secret_access_key,
+#                                                :backup_suffix => "-dr",
+#                                                :backup_location => :eu)
+#
+#
+require 'rubygems'
+require 'right_aws'
+
+$:.unshift(File.dirname(__FILE__))
+require 'aws_tools/s3'
+
+module AwsTools #:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY = 1
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: aws_tools
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Christopher Meiklejohn
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-25 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: A library to help simplify common AWS tasks.
+email: cmeik@me.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- lib/aws_tools.rb
+- lib/aws_tools/s3.rb
+files: 
+- MIT-LICENSE
+- Manifest
+- README.rdoc
+- Rakefile
+- lib/aws_tools.rb
+- lib/aws_tools/s3.rb
+- aws_tools.gemspec
+has_rdoc: true
+homepage: http://github.com/cmeiklejohn/aws_tools
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Aws_tools
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: aws_tools
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A library to help simplify common AWS tasks.
+test_files: []
+