cloudfront 0.0.1 → 1.0

data/lib/cloudfront/distribution/download_distribution.rb

@@ -0,0 +1,54 @@
+# encoding: UTF-8
+
+require 'cloudfront/helpers/download_distribution'
+require_relative 'distribution'
+
+class Cloudfront
+  module Distribution
+    module DownloadDistribution
+      include Distribution
+
+      ::DOWNLOAD_DISTRIBUTION_URL = "/#{Cloudfront::Utils::Api.version}/distribution"
+
+      def download_distribution_create(distribution)
+        distribution_create(DOWNLOAD_DISTRIBUTION_URL, distribution)
+      end
+
+      def download_distribution_list(max_items = 0, marker = "")
+        distribution_list(DOWNLOAD_DISTRIBUTION_URL, max_items, marker)
+      end
+
+      def download_distribution_get(distribution_id)
+        distribution_get(DOWNLOAD_DISTRIBUTION_URL, distribution_id)
+      end
+
+      def download_distribution_get_config(distribution_id)
+        distribution_get_config(DOWNLOAD_DISTRIBUTION_URL, distribution_id)
+      end
+
+      def download_distribution_put_config(distribution_id, distribution, etag)
+        distribution_put_config(DOWNLOAD_DISTRIBUTION_URL, distribution_id, distribution, etag)
+      end
+
+      def download_distribution_enable(distribution_id)
+        distribution_enable(DOWNLOAD_DISTRIBUTION_URL, distribution_id)
+      end
+
+      def download_distribution_disable(distribution_id)
+        distribution_disable(DOWNLOAD_DISTRIBUTION_URL, distribution_id)
+      end
+
+      def download_distribution_delete(distribution_id)
+        distribution_delete(DOWNLOAD_DISTRIBUTION_URL, distribution_id)
+      end
+
+private
+      def get_download_distribution_wrapper(hash)
+        Cloudfront::Helpers::DownloadDistribution.from_hash hash
+      end
+
+    end
+  end
+end
+
+

data/lib/cloudfront/distribution/streaming_distribution.rb

@@ -0,0 +1,53 @@
+# encoding: UTF-8
+
+require 'cloudfront/helpers/streaming_distribution'
+require_relative 'distribution'
+
+class Cloudfront
+  module Distribution
+    module StreamingDistribution
+      include Distribution
+
+      ::STREAMING_DISTRIBUTION_URL = "/#{Cloudfront::Utils::Api.version}/streaming-distribution"
+
+      def streaming_distribution_create(distribution)
+        distribution_create(STREAMING_DISTRIBUTION_URL, distribution)
+      end
+
+      def streaming_distribution_list(max_items = 0, marker = "")
+        distribution_list(STREAMING_DISTRIBUTION_URL, max_items, marker)
+      end
+
+      def streaming_distribution_get(distribution_id)
+        distribution_get(STREAMING_DISTRIBUTION_URL, distribution_id)
+      end
+
+      def streaming_distribution_get_config(distribution_id)
+        distribution_get_config(STREAMING_DISTRIBUTION_URL, distribution_id)
+      end
+
+      def streaming_distribution_put_config(distribution_id, distribution, etag)
+        distribution_put_config(STREAMING_DISTRIBUTION_URL, distribution_id, distribution, etag)
+      end
+
+      def streaming_distribution_enable(distribution_id)
+        distribution_enable(STREAMING_DISTRIBUTION_URL, distribution_id)
+      end
+
+      def streaming_distribution_disable(distribution_id)
+        distribution_disable(STREAMING_DISTRIBUTION_URL, distribution_id)
+      end
+
+      def streaming_distribution_delete(distribution_id)
+        distribution_delete(STREAMING_DISTRIBUTION_URL, distribution_id)
+      end
+
+private
+      def get_streaming_distribution_wrapper(hash)
+        Cloudfront::Helpers::StreamingDistribution.from_hash hash
+      end
+    end
+  end
+end
+
+

data/lib/cloudfront/errors/cloudfront_error.rb

@@ -0,0 +1,13 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class CloudfrontError < StandardError
+      attr_reader :response
+      def initialize(message, response = nil)
+        super(message)
+        @response = response
+      end
+    end
+  end
+end

data/lib/cloudfront/errors/cname_already_exists_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class CNAMEAlreadyExistsError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/distribution_already_exists_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class DistributionAlreadyExistsError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/illegal_update_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class IllegalUpdateError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/invalid_origin_access_identity_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class InvalidOriginAccessIdentityError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/invalid_origin_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class InvalidOriginError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/invalid_required_protocol_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class InvalidRequiredProtocolError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/missing_body_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class MissingBodyError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/precondition_failed_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class PreconditionFailedError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/too_many_distribution_cnames_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class TooManyDistributionCNAMEsError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/too_many_distributions_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class TooManyDistributionsError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/too_many_trusted_signers_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class TooManyTrustedSignersError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/errors/trusted_signer_does_not_exist_error.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Errors
+    class TrustedSignerDoesNotExistError < CloudfrontError; end
+  end
+end

data/lib/cloudfront/exceptions/delete_enabled_distribution_exception.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Exceptions
+    class DeleteEnabledDistributionException < StandardError;end
+  end
+end

data/lib/cloudfront/exceptions/distribution_already_disabled_exception.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Exceptions
+    class DistributionAlreadyDisabledException < StandardError;end
+  end
+end

data/lib/cloudfront/exceptions/distribution_already_enabled_exception.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Exceptions
+    class DistributionAlreadyEnabledException < StandardError;end
+  end
+end

data/lib/cloudfront/exceptions/distribution_configuration_exception.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Exceptions
+    class DistributionConfigurationException < StandardError;end
+  end
+end

data/lib/cloudfront/exceptions/missing_etag_exception.rb

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Exceptions
+    class MissingEtagException < StandardError;end
+  end
+end

data/lib/cloudfront/helpers/aliases.rb

@@ -0,0 +1,71 @@
+# encoding: UTF-8
+
+class Cloudfront
+  module Helpers
+    class Aliases
+      include Cloudfront::Utils::ConfigurationChecker
+      include Cloudfront::Utils::XmlSerializer
+
+      attr_accessor :cnames
+
+      def initialize(&block)
+        #set default values
+        @cnames = []
+
+        #set values from block
+        instance_eval &block if block_given?
+      end
+
+      def validate
+        # some wrapping
+        @cnames = Array.wrap @cnames # wraps single elements into an array and removes nil parasites
+
+
+        # Some additional checking should be done on cnames.
+        for cname in cnames
+          error_messages.push("#{cname} isn't a valid url") unless cname =~  Cloudfront::Utils::Util::URL_REGEXP
+        end
+      end
+
+      # A factory method that creates a Aliases instance from a hash
+      # Input example
+      # hash = {
+      #     "Aliases" => {
+      #         "Quantity" => "number of CNAME cnames",
+      #         "Items" => {
+      #             "CNAME" => "CNAME alias"
+      #         }
+      #     }
+      # }
+      #
+      def self.from_hash(hash)
+        hash = hash["Aliases"] || hash
+        self.new do
+          self.cnames = Array.wrap((hash["Items"] || {})["CNAME"])
+        end
+      end
+
+      # Output example
+      # <Aliases>
+      #   <Quantity>number of CNAME cnames</Quantity>
+      #   <Items>
+      #     <CNAME>CNAME alias</CNAME>
+      #   </Items>
+      # </Aliases>
+      def build_xml(xml)
+        check_configuration
+        xml.Aliases {
+          xml.Quantity @cnames.size
+          if @cnames.size > 0
+            xml.Items {
+              for cname in Array.wrap @cnames
+                xml.CNAME cname
+              end
+            }
+          end
+        }
+      end
+
+    end
+  end
+end

data/lib/cloudfront/helpers/cache_behavior.rb

@@ -0,0 +1,166 @@
+# encoding: UTF-8
+
+require_relative 'trusted_signers'
+
+class Cloudfront
+  module Helpers
+    class CacheBehavior
+      include Cloudfront::Utils::ConfigurationChecker
+      include Cloudfront::Utils::XmlSerializer
+
+      attr_accessor :is_default,
+                    :path_pattern,
+                    :target_origin_id,
+                    :query_string_forward,
+                    :cookies_forward_policy,
+                    :cookies_to_forward,
+                    :trusted_signers,
+                    :viewer_protocol_policy,
+                    :min_ttl
+
+      def initialize(&block)
+        #set default values
+        @is_default = false
+        @query_string_forward = true
+        @cookies_forward_policy = "all"
+        @trusted_signers = TrustedSigners.new
+        @viewer_protocol_policy = "allow-all"
+        @min_ttl = 86400 # one day as the default minimum ttl
+
+        #set values from block
+        instance_eval &block if block_given?
+      end
+
+      def validate
+        # some wrapping
+        @cookies_to_forward = Array.wrap @cookies_to_forward
+
+        # Error checking
+        error_messages.push "target_origin_id shouldn't be nil" if @target_origin_id.nil?
+        error_messages.push "query_string_forward must be a boolean" unless !!@query_string_forward == @query_string_forward
+        error_messages.push "cookies_forward_policy should be one of #{Cloudfront::Utils::Util::FORWARD_POLICY_VALUES.join(', ')}" unless Cloudfront::Utils::Util::FORWARD_POLICY_VALUES.include?(@cookies_forward_policy)
+        # trusted signers validation
+        if @trusted_signers.is_a?(TrustedSigners)
+          @trusted_signers.check_configuration
+        else
+          error_messages.push "trusted_signer field should be a TrustedSigners"
+        end
+
+        error_messages.push "viewer_protocol_policy should be one of #{Cloudfront::Utils::Util::VIEWER_PROTOCOL_VALUES.join(', ')}" unless Cloudfront::Utils::Util::VIEWER_PROTOCOL_VALUES.include?(@viewer_protocol_policy)
+        error_messages.push "min_ttl should be a number" unless @min_ttl.is_a? Fixnum
+      end
+
+      def cache_behavior_body(xml)
+        unless @is_default
+          xml.PathPattern @path_pattern
+        end
+        xml.TargetOriginId @target_origin_id
+        xml.ForwardedValues {
+          xml.QueryString @query_string_forward
+          xml.Cookies {
+            xml.Forward @cookies_forward_policy
+            if (@cookies_forward_policy == "whitelist")
+              xml.WhitelistedNames {
+                xml.Quantity @cookies_to_forward.size
+                if (@cookies_to_forward.size > 0)
+                  xml.Items {
+                    for cookie in @cookies_to_forward
+                      xml.Name cookie
+                    end
+                  }
+                end
+              }
+            end
+          }
+        }
+        @trusted_signers.build_xml(xml)
+        xml.ViewerProtocolPolicy @viewer_protocol_policy
+        xml.MinTTL @min_ttl
+      end
+
+      # Creates a CacheBehavior instance from a hash
+      #  {
+      #    "CacheBehavior" => {
+      #        "PathPattern"     => "*",
+      #        "TargetOriginId"  => "id",
+      #        "ForwardedValues" => {
+      #            "QueryString"   => "true",
+      #            "Cookies"       => {
+      #                "Forward"          => "all | whitelist | none",
+      #                "WhitelistedNames" => {
+      #                    "Quantity"       => "0",
+      #                    "Items"          =>
+      #                        {
+      #                            "Name"    => ["name of a cookie to forward to the origin"]
+      #                        }
+      #                }
+      #            }
+      #        },
+      #        "TrustedSigners"       => {},
+      #        "ViewerProtocolPolicy" => "allow-all",
+      #        "MinTTL"                => "86400"
+      #    }
+      #  }
+      def self.from_hash(hash)
+        hash = hash["DefaultCacheBehavior"] || hash["CacheBehavior"] || hash
+        self.new do
+          self.is_default = !hash.has_key?("PathPattern")
+          self.path_pattern = hash["PathPattern"]
+          self.target_origin_id = hash["TargetOriginId"]
+          forwarded_values = hash["ForwardedValues"]
+          if forwarded_values
+            self.query_string_forward = (forwarded_values["QueryString"] || "true").to_bool
+            cookies = forwarded_values["Cookies"]
+            if cookies
+              self.cookies_forward_policy = cookies["Forward"] || "all"
+              white_listed_names = cookies["WhitelistedNames"]
+              if (white_listed_names && white_listed_names["Items"]||{})["Name"]
+                self.cookies_to_forward = Array.wrap white_listed_names["Items"]["Name"]
+              end
+            end
+          end
+          self.trusted_signers = TrustedSigners.from_hash(hash["TrustedSigners"])
+          self.viewer_protocol_policy = hash["ViewerProtocolPolicy"] || "allow-all"
+          self.min_ttl = (hash["MinTTL"] || "86400").to_i
+        end
+      end
+
+      # The cache behavior class container
+      #      <CacheBehavior>
+      #        <PathPattern>pattern that specifies files that this cache behavior applies to</PathPattern>
+      #        <TargetOriginId>ID of the origin that this cache behavior applies to</TargetOriginId>
+      #        <ForwardedValues>
+      #          <QueryString>true | false</QueryString>
+      #          <Cookies>
+      #            <Forward>all | whitelist | none</Forward>
+      #            <!-- Required when Forward = whitelist, omitted otherwise. -->
+      #            <WhitelistedNames>
+      #              <Quantity>number of cookie names to forward to origin</Quantity>
+      #              <Items>
+      #                <Name>name of a cookie to forward to the origin</Name>
+      #              </Items>
+      #            </WhitelistedNames>
+      #          </Cookies>
+      #        </ForwardedValues>
+      #        <TrustedSigners>
+      #          ... see TrustedSigners class
+      #        </TrustedSigners>
+      #        <ViewerProtocolPolicy>allow-all | https-only</ViewerProtocolPolicy>
+      #        <MinTTL>minimum TTL in seconds for files specified by PathPattern</MinTTL>
+      #      </CacheBehavior>
+      def build_xml(xml)
+        check_configuration
+        if @is_default
+          xml.DefaultCacheBehavior {
+            cache_behavior_body(xml)
+          }
+        else
+          xml.CacheBehavior {
+            cache_behavior_body(xml)
+          }
+        end
+      end
+
+    end
+  end
+end