aws-sdk 1.9.1 → 1.9.2

data/lib/aws/core/client.rb

@@ -22,6 +22,8 @@ module AWS
     # Base client class for all of the Amazon AWS service clients.
     class Client
 
+      extend Deprecations
+
       # Raised when a request failed due to a networking issue (e.g.
       # EOFError, IOError, Errno::ECONNRESET, Errno::EPIPE,
       # Timeout::Error, etc)
@@ -59,8 +61,9 @@ module AWS
         @http_handler = @config.http_handler
         @endpoint = config.send(:"#{service_ruby_name}_endpoint")
         @port = config.send(:"#{service_ruby_name}_port")
-        @http_read_timeout = @config.http_read_timeout
 
+        # deprecated attributes
+        @http_read_timeout = @config.http_read_timeout
       end
 
       # @return [Configuration] This clients configuration.
@@ -82,7 +85,9 @@ module AWS
 
       # @return [Integer] The number of seconds before requests made by
       #   this client should timeout if they have not received a response.
+      # @api private
       attr_reader :http_read_timeout
+      deprecated :http_read_timeout, :use => 'config.http_read_timeout'
 
       # @return [String] Returns the service endpoint (hostname) this client
       #   makes requests against.
@@ -528,7 +533,7 @@ module AWS
 
         # configure the http request
         http_request.service_ruby_name = service_ruby_name
-        http_request.default_read_timeout = http_read_timeout
+        http_request.default_read_timeout = @config.http_read_timeout
         http_request.host = endpoint
         http_request.port = port
         http_request.region = config.send(:"#{service_ruby_name}_region")

data/lib/aws/core/configuration.rb

@@ -376,10 +376,6 @@ module AWS
 
         def add_service name, ruby_name, endpoint_pattern = nil, &endpoint_builder
 
-          Region.send(:define_method, ruby_name) do
-            AWS.const_get(name).new(:config => config)
-          end
-
           add_option :"#{ruby_name}_endpoint" do |config,value|
             if value
               value

data/lib/aws/core/deprecations.rb

@@ -0,0 +1,84 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  module Core
+
+    # A utility module that provides a class method that wraps
+    # a method such that it generates a deprecation warning when called.
+    # Given the following class:
+    #
+    #     class Example
+    #
+    #       def do_something
+    #       end
+    #
+    #     end
+    #
+    # If you want to deprecate the `#do_something` method, you can extend
+    # this module and then call `deprecated` on the method (after it
+    # has been defined).
+    #
+    #     class Example
+    #
+    #       extend AWS::Core::Deprecations
+    #
+    #       def do_something
+    #       end
+    #
+    #       def do_something_else
+    #       end
+    #
+    #       deprecated :do_something
+    #
+    #     end
+    #
+    # The `#do_something` method will continue to function, but will
+    # generate a deprecation warning when called.
+    #
+    # @api private
+    module Deprecations
+
+      # @param [Symbol] method The name of the deprecated method.
+      #
+      # @option options [String] :message The warning message to issue
+      #   when the deprecated method is called.
+      #
+      # @option options [Symbol] :use The name of an use
+      #   method that should be used.
+      #
+      def deprecated method, options = {}
+
+        deprecation_msg = options[:message] || begin
+          msg = "DEPRECATION WARNING: called deprecated method `#{method}' "
+          msg << "of #{self.name}"
+          msg << ", try calling #{options[:use]} instead" if options[:use]
+          msg
+        end
+
+        alias_method(:"deprecated_#{method}", method)
+
+        warned = false # we only want to issue this warning once
+
+        define_method(method) do |*args,&block|
+          unless warned
+            warn(deprecation_msg)
+            warned = true
+          end
+          send("deprecated_#{method}", *args, &block)
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/core/region.rb

@@ -29,6 +29,7 @@ module AWS
     # @attr_reader [CloudWatch] cloud_watch
     # @attr_reader [DynamoDB] dynamo_db
     # @attr_reader [DataPipeline] data_pipeline
+    # @attr_reader [DirectConnect] direct_connect
     # @attr_reader [EC2] ec2
     # @attr_reader [ElastiCache] elasticache
     # @attr_reader [ElasticBeanstalk] elastic_beanstalk
@@ -67,6 +68,12 @@ module AWS
       # @return [Configuration]
       attr_reader :config
 
+      AWS::SERVICES.each_pair do |name,service|
+        define_method(service[:ruby_name]) do
+          AWS.const_get(name).new(:config => config)
+        end
+      end
+
     end
   end
 end

data/lib/aws/ec2/subnet.rb

@@ -79,7 +79,7 @@ module AWS
       #   this subnet and its network ACL.
       def network_acl_association
         associations = AWS.memoize { vpc.network_acls.map(&:associations) }.flatten
-        associations.first{|a| a.subnet == self }
+        associations.find{|a| a.subnet == self }
       end
 
       # @return [RouteTable] Returns the route table currently associated

data/lib/aws/elastic_beanstalk.rb

@@ -12,7 +12,7 @@
 # language governing permissions and limitations under the License.
 
 require 'aws/core'
-require 'aws/elb/config'
+require 'aws/elastic_beanstalk/config'
 
 module AWS
 

data/lib/aws/elastic_transcoder.rb

@@ -12,7 +12,7 @@
 # language governing permissions and limitations under the License.
 
 require 'aws/core'
-require 'aws/glacier/config'
+require 'aws/elastic_transcoder/config'
 
 module AWS
 

data/lib/aws/version.rb

@@ -13,5 +13,5 @@
 
 module AWS
   # Current version of the AWS SDK for Ruby
-  VERSION = '1.9.1'
+  VERSION = '1.9.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk
 version: !ruby/object:Gem::Version
-  version: 1.9.1
+  version: 1.9.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-18 00:00:00.000000000 Z
+date: 2013-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: uuidtools
@@ -68,7 +68,7 @@ files:
 - ca-bundle.crt
 - rails/init.rb
 - .yardopts
-- README.rdoc
+- README.md
 - LICENSE.txt
 - lib/aws/auto_scaling/activity.rb
 - lib/aws/auto_scaling/activity_collection.rb
@@ -141,6 +141,7 @@ files:
 - lib/aws/core/configuration.rb
 - lib/aws/core/credential_providers.rb
 - lib/aws/core/data.rb
+- lib/aws/core/deprecations.rb
 - lib/aws/core/http/connection_pool.rb
 - lib/aws/core/http/curb_handler.rb
 - lib/aws/core/http/handler.rb
@@ -581,7 +582,6 @@ files:
 - lib/aws.rb
 - lib/aws/api_config/AutoScaling-2011-01-01.yml
 - lib/aws/api_config/CloudFormation-2010-05-15.yml
-- lib/aws/api_config/CloudFront-2012-05-05.yml
 - lib/aws/api_config/CloudFront-2012-07-01.yml
 - lib/aws/api_config/CloudSearch-2011-02-01.yml
 - lib/aws/api_config/CloudWatch-2010-08-01.yml
@@ -590,7 +590,6 @@ files:
 - lib/aws/api_config/DynamoDB-2011-12-05.yml
 - lib/aws/api_config/DynamoDB-2012-08-10.yml
 - lib/aws/api_config/EC2-2013-02-01.yml
-- lib/aws/api_config/ElastiCache-2012-03-09.yml
 - lib/aws/api_config/ElastiCache-2012-11-15.yml
 - lib/aws/api_config/ElasticBeanstalk-2010-12-01.yml
 - lib/aws/api_config/ElasticTranscoder-2012-09-25.yml
@@ -600,10 +599,8 @@ files:
 - lib/aws/api_config/IAM-2010-05-08.yml
 - lib/aws/api_config/ImportExport-2010-06-01.yml
 - lib/aws/api_config/OpsWorks-2013-02-18.yml
-- lib/aws/api_config/RDS-2012-09-17.yml
 - lib/aws/api_config/RDS-2013-02-12.yml
 - lib/aws/api_config/Redshift-2012-12-01.yml
-- lib/aws/api_config/Route53-2012-02-29.yml
 - lib/aws/api_config/Route53-2012-12-12.yml
 - lib/aws/api_config/SimpleDB-2009-04-15.yml
 - lib/aws/api_config/SimpleEmailService-2010-12-01.yml

data/README.rdoc

@@ -1,197 +0,0 @@
-= Links of Interest
-
-* {API Documentation}[http://docs.aws.amazon.com/AWSRubySDK/latest/frames.html]
-* {Issues}[http://github.com/aws/aws-sdk-ruby/issues]
-* {Release Notes}[http://aws.amazon.com/releasenotes/Ruby]
-* {Forums}[https://forums.aws.amazon.com/forum.jspa?forumID=125]
-* {License}[http://aws.amazon.com/apache2.0/]
-
-= Getting Started with the AWS SDK for Ruby {<img src="https://secure.travis-ci.org/aws/aws-sdk-ruby.png?branch=master" alt="Build Status" />}[http://travis-ci.org/aws/aws-sdk-ruby]
-
-The AWS SDK for Ruby helps you to get started building applications
-using AWS infrastructure services, including Amazon Simple Storage
-Service (Amazon S3), Amazon Elastic Compute Cloud (Amazon EC2), Amazon
-SimpleDB, and more. This guide shows how you can start building Ruby
-and Rails applications on the Amazon Web Services platform with the
-AWS Ruby gem.
-
-= Get Set Up
-
-To get set up, you must sign up for Amazon Web Services, get your AWS
-credentials, and set up your environment.
-
-== Sign Up for AWS Products
-
-Before you can begin, you must sign up for each AWS product you want
-to use. The sample included in the SDK uses Amazon S3, so we'll use
-that product as an example here.
-
-=== To sign up for a product
-
-1. Go to the home page for the product, for example
-   http://aws.amazon.com/s3.
-
-   *Tip:* Go to http://aws.amazon.com/products for a list of links to all our products.
-
-2. Click the sign-up button on the top right corner of the page.
-
-3. Follow the on-screen instructions. If you don't already have an AWS
-   account, you are prompted to create one as part of the sign-up
-   process.
-
-AWS sends you a confirmation e-mail after the sign-up process is
-complete. You can view your current account activity or manage your
-account at any time, by going to http://aws.amazon.com and clicking
-the *Account* tab.
-
-== Get Your Credentials
-
-To use the AWS SDK for Ruby, you need your AWS Access Key ID and Secret Access Key.
-
-=== To get your AWS Access Key ID and Secret Access Key
-
-1. Go to http://aws.amazon.com.
-
-2. Click *Account* and then click <b>Security Credentials</b>.
-   The Security Credentials page displays (you might be prompted to log in).
-
-3. Scroll down to Access Credentials and make sure the <b>Access Keys</b> tab
-   is selected.  The AWS Access Key ID appears in the Access Key column.
-
-4. To view the Secret Access Key, click *Show*.
-
-   *Important!* Your Secret Access Key is a secret, which only you and
-   AWS should know. It is important to keep it confidential to protect
-   your account. Store it securely in a safe place. Never include it in
-   your requests to AWS, and never e-mail it to anyone. Do not share it
-   outside your organization, even if an inquiry appears to come from AWS
-   or Amazon.com. No one who legitimately represents Amazon will ever ask
-   you for your Secret Access Key.
-
-== Set Up Your Environment
-
-The AWS Ruby gem runs on Ruby 1.8.7 and later. If you have an older
-version of Ruby, RVM is a great way to get started using the latest
-version.
-
-= Install the SDK
-
-To install the AWS Ruby gem, just enter:
-
-  gem install aws-sdk
-
-= Run the Samples
-
-Now that you've installed the gem, you can run the samples, which you
-can find in our GitHub repository:
-
-  $ git clone git://github.com/aws/aws-sdk-ruby
-  $ cd aws-sdk-ruby/samples/
-
-The subdirectories of the +samples+ directory contain several code
-samples that you can run.  These samples demonstrate basic usage of
-the SDK features.
-
-== To run the Amazon S3 Sample
-
-1. Create a file named config.yml in the samples directory as follows:
-
-     # Fill in your AWS Access Key ID and Secret Access Key
-     # http://aws.amazon.com/security-credentials
-     access_key_id: REPLACE_WITH_ACCESS_KEY_ID
-     secret_access_key: REPLACE_WITH_SECRET_ACCESS_KEY
-
-2. Run a sample script with the Ruby interpreter. For example, to run
-   the s3/upload_file.rb sample:
-
-     $ echo "Hello, World!" > helloworld.txt
-     $ ruby s3/upload_file.rb unique-bucket-name helloworld.txt
-
-== To use the AWS ORM in a Rails 3 application
-
-1. Install the gem:
-
-     $ gem install aws-sdk
-
-2. Start a new Rails project:
-
-     $ gem install rails
-     $ rails new myapp
-     $ cd myapp/
-
-3. Add the following line to your Gemfile:
-
-     gem 'aws-sdk'
-
-4. Install dependencies:
-
-     $ bundle install
-
-5. Create config/aws.yml as follows:
-
-     # Fill in your AWS Access Key ID and Secret Access Key
-     # http://aws.amazon.com/security-credentials
-     access_key_id: REPLACE_WITH_ACCESS_KEY_ID
-     secret_access_key: REPLACE_WITH_SECRET_ACCESS_KEY
-
-6. Create config/initializers/aws.rb as follows:
-
-     # load the libraries
-     require 'aws-sdk'
-     # log requests using the default rails logger
-     AWS.config(:logger => Rails.logger)
-     # load credentials from a file
-     config_path = File.expand_path(File.dirname(__FILE__)+"/../aws.yml")
-     AWS.config(YAML.load(File.read(config_path)))
-
-7. Create app/models/my_record.rb as follows:
-
-     class MyRecord < AWS::Record::Base
-       string_attr :name
-     end
-
-8. Create the SimpleDB domain:
-
-     $ rails console
-     > MyRecord.create_domain
-
-Now, you can play around with the model by creating some records and querying them:
-
-  > MyRecord.find(:all).to_a
-  => []
-  > MyRecord.new(:name => "The first one").save
-  => true
-  > MyRecord.new(:name => "The second one").save
-  => true
-  > MyRecord.where('name like ?', "%first%").count
-  => 1
-
-Exit the rails console before continuing to the next step:
-
-  > exit
-
-9. Generate a scaffold controller for your model:
-
-     $ rails generate scaffold_controller MyRecord name:string
-     $ rails server
-
-10. Add a route to your scaffold controller in config/routes.rb:
-
-      Myapp::Application.routes.draw do
-        # add this line:
-        resources :my_records
-      end
-
-11. Now, you can create records in the browser at http://localhost:3000/my_records.
-
-= Where Do I Go from Here?
-
-For more information about the AWS SDK for Ruby, including a complete
-list of supported AWS products, go to
-http://aws.amazon.com/sdkforruby.
-
-The SDK reference documentation provides information about both the
-AWS Ruby gem and AWS Rails integration gem. You can find it at
-http://docs.amazonwebservices.com/AWSRubySDK/latest.
-
-Licensed under Apache 2.0. See {file:LICENSE.txt} and {file:NOTICE.txt} files.