paperclip-azure 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 17e6b86faff7b35971eacd5057c1cb931478aced
-  data.tar.gz: 25e9be870ea14459cb3994da22aac9c27cbc503f
+  metadata.gz: a233ac7477aced4158a50fbed0ed87a16be96cc9
+  data.tar.gz: f2fd4c35c33316c5fa8da7bae2e2506b0d8390f5
 SHA512:
-  metadata.gz: 11bfcb5f43ec0e14e0fd11fb38f2b611653d58a8849f34085a65dfbf6948fda11f547ff678cc0b3ef30694a4afa0e45dfc6c131e3b38d26dd3931a0ef21a68dd
-  data.tar.gz: cb22f8a0c5d563e5f4828263ada454d8ca314f37ab0bfa821d8f208090b1caf6fb92d3c8770df69bb37fce8ef420737188339b729e6513e1cc4f2eb9084af8f1
+  metadata.gz: bbf61c97fadc054badbb6f946502458303af5dde02c628ee0dd70acae763799c58b6925b88a8d5e76c59c7fb9e6ed23fe023ecc121abfc2af40e23aa16f2180b
+  data.tar.gz: edaee95e6fbd6a7965fadfc4964d69b696025bdeedc4c3af6d6d12b64d604742c169787dbf6ddbf277c0a3ef9da8b276d45488f26941666f69e37e72b14668da

data/.autotest

@@ -0,0 +1,25 @@
+# -*- ruby -*-
+
+require "autotest/restart"
+
+# Autotest.add_hook :initialize do |at|
+#   at.testlib = "minitest/unit"
+#
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception "vendor"
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2017-07-24
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,12 @@
+.autotest
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/azure/core/auth/shared_access_signature.rb
+lib/paperclip/storage/azure/environment.rb
+lib/paperclip/storage/azure.rb
+lib/paperclip/azure.rb
+lib/paperclip-azure.rb
+spec/paperclip/storage/azure/environment_spec.rb
+spec/spec_helper.rb

data/README.txt

@@ -0,0 +1,110 @@
+= paperclip-azure
+
+home  :: https://github.com/supportify/paperclip-azure
+code  :: https://github.com/supportify/paperclip-azure
+rdoc  :: https://www.rubydoc.info/docs/paperclip-azure
+bugs  :: https://github.com/supportify/paperclip-azure/issues
+
+== DESCRIPTION:
+
+Paperclip-Azure is a [Paperclip](https://github.com/thoughtbot/paperclip) storage driver for storing files in a Microsoft Azure Blob.
+
+== FEATURES/PROBLEMS:
+
+* FIX (list of features or problems)
+
+== SYNOPSIS:
+
+The Azure storage engine has been developed to work as similarly to S3 storage configuration as is possible.  This gem can be configured in a Paperclip initializer or environment file as follows:
+
+    Paperclip::Attachment.default_options[:storage] = :azure
+    Paperclip::Attachment.default_options[:url] = ':azure_path_url'
+    Paperclip::Attachment.default_options[:path] = ":class/:attachment/:id/:style/:filename"
+    Paperclip::Attachment.default_options[:storage] = :azure
+    Paperclip::Attachment.default_options[:azure_credentials] = {
+        storage_account_name: ENV['AZURE_STORAGE_ACCOUNT'],
+        access_key:           ENV['AZURE_ACCESS_KEY'],
+        container:            ENV['AZURE_CONTAINER_NAME']
+    }
+
+Or, at the level of the model such as in the following example:
+
+    has_attached_file :download,
+                      storage: :azure,
+                      azure_credentials: {
+                        storage_account_name: ENV['AZURE_STORAGE_ACCOUNT'],
+                        access_key:           ENV['AZURE_ACCESS_KEY'],
+                        container:            ENV['AZURE_CONTAINER_NAME']
+                      }
+
+=== Private Blob Access
+
+In the even that are using a Blob that has been configured for Private access, you will need to use the Shared Access Signature functionality of Azure.  This functionality has been baked in to the `Attachment#expiring_url` method. Simply specify a time and a style and you will get a proper URL as follows:
+
+    object.attachment.expiring_url(30.minutes.since, :thumb)
+
+For more information about Azure Shared Access Signatures, please refer to [here](http://azure.microsoft.com/en-us/documentation/articles/storage-dotnet-shared-access-signature-part-1/).
+
+=== Azure Environments
+
+Microsoft offers specialized Azure implementations for special circumstances should the need arise.  As of the most recent update of this gem, the AzureChinaCloud, AzureUSGovernment, and AzureGermanCloud environments all offer specific storage URL's that differ from those of the standard AzureCloud.  These regions can be specified via the `:region` key of the `:azure_credentials` dictionary by using the symbols `:cn`, `:usgovt`, and `:de` respectively.  When working with one of these environments, simply update your credentials to include the region as follows:
+
+    Paperclip::Attachment.default_options[:azure_credentials] = {
+        storage_account_name: ENV['AZURE_STORAGE_ACCOUNT'],
+        access_key:           ENV['AZURE_ACCESS_KEY'],
+        container:            ENV['AZURE_CONTAINER_NAME'],
+        region:               :de
+    }
+
+Or, in the instance where the credentials are specified at the model level:
+
+    has_attached_file :download,
+                      storage: :azure,
+                      azure_credentials: {
+                        storage_account_name: ENV['AZURE_STORAGE_ACCOUNT'],
+                        access_key:           ENV['AZURE_ACCESS_KEY'],
+                        container:            ENV['AZURE_CONTAINER_NAME'],
+                        region:               :cn
+                      }
+
+== REQUIREMENTS:
+
+* An Azure storage account.
+
+== INSTALL:
+
+Add this line to your application's Gemfile after the Paperclip gem:
+
+    gem 'paperclip-azure', '~> 1.0'
+
+And then execute:
+
+    $ bundle install
+
+== DEVELOPERS:
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* After checking out the source, run:
+
+      $ rake newb
+
+  This task will install any missing dependencies, run the tests/specs, and generate the RDoc.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+* Submit a pull request for the finished product's integration.
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2017 Supportify, Inc.
+
+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,24 @@
+# -*- ruby -*-
+
+require "rubygems"
+require "hoe"
+
+Hoe.plugin :bundler
+Hoe.plugin :debug
+Hoe.plugin :git
+Hoe.plugin :gemspec
+Hoe.plugin :rubygems
+
+Hoe.spec "paperclip-azure" do
+  developer("hireross.com", "help@hireross.com")
+  license "MIT" # this should match the license in the README
+
+  extra_deps << ['azure', '~> 0.7']
+  extra_deps << ['hashie', '~> 3.5']
+  extra_deps << ['addressable', '~> 2.5']
+
+  extra_dev_deps << ['rspec', '~> 3.0']
+  extra_dev_deps << ['simplecov', '~> 0.14']
+end
+
+# vim: syntax=ruby

data/lib/paperclip-azure.rb

@@ -8,8 +8,8 @@ module Azure
     BlobService.class_eval do
       def initialize(signer=Core::Auth::SharedKey.new, account_name=Azure.config.storage_account_name)
         super(signer, account_name)
-        @host = "http://#{account_name}.blob.core.windows.net"
+        @host = Paperclip::Storage::AzureRegion.url_for account_name
       end
     end
   end
-end
+end

data/lib/paperclip/azure.rb

@@ -0,0 +1,5 @@
+module Paperclip; end
+
+class Paperclip::Azure
+  VERSION = "1.0.0"
+end

data/lib/paperclip/storage/azure.rb

@@ -1,3 +1,5 @@
+require 'paperclip/storage/azure/environment'
+
 module Paperclip
   module Storage
     # Azure's container file hosting service is a scalable, easy place to store files for
@@ -49,6 +51,7 @@ module Paperclip
     #   to interpolate. Keys should be unique, like filenames, and despite the fact that
     #   Azure (strictly speaking) does not support directories, you can still use a / to
     #   separate parts of your file name.
+    # * +region+: Depending on the region, different base urls are used. Supported values :global, :de
 
     module Azure
       def self.extended base
@@ -122,14 +125,14 @@ module Paperclip
 
       def obtain_azure_instance_for(options)
         instances = (Thread.current[:paperclip_azure_instances] ||= {})
-        
+
         unless instances[options]
           signer = ::Azure::Core::Auth::SharedKey.new options[:storage_account_name], options[:access_key]
           service = ::Azure::BlobService.new(signer, options[:storage_account_name])
 
-          require 'azure/core/http/retry_policy' # For Some Reason, All Other Loading Locations Fail          
+          require 'azure/core/http/retry_policy' # For Some Reason, All Other Loading Locations Fail
           service.filters << ::Azure::Core::Http::RetryPolicy.new do |response, retry_data|
-            status_code = case 
+            status_code = case
                           when !response.nil?
                             response.status_code
                           when !retry_data[:error].nil?
@@ -137,9 +140,9 @@ module Paperclip
                           else
                             500
                           end
-            status_code = 500 if status_code == 0 
+            status_code = 500 if status_code == 0
             retry_data[:count] ||= 0
-            
+
             if  (!response.nil? && response.success? && retry_data[:error].nil?) ||
                 (status_code >= 300 && status_code < 500 && status_code != 408) ||
                 status_code == 501 ||
@@ -149,7 +152,7 @@ module Paperclip
               retry_data[:count] = 0
             else
               retry_data[:count] += 1
-          
+
               sleep (retry_data[:count] - 1) * 5
             end
 
@@ -159,7 +162,7 @@ module Paperclip
           instances[options] = service
         end
 
-        instances[options] 
+        instances[options]
       end
 
       def azure_uri(style_name = default_style)
@@ -167,9 +170,9 @@ module Paperclip
       end
 
       def azure_base_url
-        "https://#{azure_account_name}.blob.core.windows.net"
+        Environment.url_for azure_account_name, @azure_credentials[:region]
       end
-      
+
       def azure_container
         @azure_container ||= azure_interface.get_container_properties container_name
       end
@@ -218,7 +221,7 @@ module Paperclip
             if e.status_code == 404
               create_container
               retry
-            else 
+            else
               raise
             end
           ensure
@@ -264,7 +267,7 @@ module Paperclip
 
       def copy_to_local_file(style, local_dest_path)
         log("copying #{path(style)} to local file #{local_dest_path}")
-        
+
         blob, content = azure_interface.get_blob(container_name, path(style).sub(%r{\A/},''))
 
         ::File.open(local_dest_path, 'wb') do |local_file|
@@ -272,7 +275,7 @@ module Paperclip
         end
       rescue ::Azure::Core::Http::HTTPError => e
         raise unless e.status_code == 404
-        
+
         warn("#{e} - cannot copy #{path(style)} to local file #{local_dest_path}")
         false
       end

data/lib/paperclip/storage/azure/environment.rb

@@ -0,0 +1,19 @@
+module Paperclip
+  module Storage
+    module Azure
+      class Environment
+
+        ENVIRONMENT_SUFFIX = {
+          global: 'core.windows.net',
+          cn: 'core.chinacloudapi.cn',
+          de: "core.cloudapi.de",
+          usgovt: 'core.usgovcloudapi.net'
+        }
+
+        def self.url_for(account_name, region = :global)
+          "#{account_name}.blob.#{ENVIRONMENT_SUFFIX[region]}"
+        end
+      end
+    end
+  end
+end

data/spec/paperclip/storage/azure/environment_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+require 'paperclip/storage/azure/environment'
+
+describe 'Paperclip::Storage::Azure::Environment' do
+  subject { Paperclip::Storage::Azure::Environment }
+
+  describe '#url_for' do
+    let(:account_name) { 'foo' }
+
+    describe 'when the region is not supplied' do
+      it { expect(subject.url_for(account_name)).to eq("#{account_name}.blob.core.windows.net")}
+    end
+
+    describe 'when the region is China' do
+      it { expect(subject.url_for(account_name, :cn)).to eq("#{account_name}.blob.core.chinacloudapi.cn")}
+    end
+
+    describe 'when the region is Germany' do
+      it { expect(subject.url_for(account_name, :de)).to eq("#{account_name}.blob.core.cloudapi.de")}
+    end
+
+    describe 'when the region is the US Govt' do
+      it { expect(subject.url_for(account_name, :usgovt)).to eq("#{account_name}.blob.core.usgovcloudapi.net")}
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,30 @@
+require 'simplecov'
+require 'rspec'
+
+ROOT = Pathname(File.expand_path(File.join(File.dirname(__FILE__), '..')))
+
+module SimpleCov::Configuration
+  def clean_filters
+    @filters = []
+  end
+end
+
+SimpleCov.configure do
+  clean_filters
+  load_adapter 'test_frameworks'
+end
+
+ENV["COVERAGE"] && SimpleCov.start do
+  add_filter "/.rvm/"
+end
+
+$LOAD_PATH << File.join(ROOT, 'lib')
+$LOAD_PATH << File.join(ROOT, 'lib', 'paperclip')
+require File.join(ROOT, 'lib', 'paperclip-azure.rb')
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir[File.join(ROOT, 'spec', 'support', '**', '*.rb')].each{|f| require f }
+
+RSpec.configure do |config|
+end

metadata

@@ -1,177 +1,161 @@
 --- !ruby/object:Gem::Specification
 name: paperclip-azure
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
-- Jordan Yaker
-- Supportify, Inc.
+- hireross.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-30 00:00:00.000000000 Z
+date: 2017-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: azure
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: hashie
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.5'
 - !ruby/object:Gem::Dependency
   name: addressable
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.5'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.8.0
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.8.0
+        version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.14'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '3.12'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '3.12'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: jeweler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.1
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.1
+        version: '4.0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: hoe
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: An Azure Blob Storage implementation for Paperclip.
-email: help@supportify.io
+        version: '3.16'
+description: Paperclip-Azure is a [Paperclip](https://github.com/thoughtbot/paperclip)
+  storage driver for storing files in a Microsoft Azure Blob.
+email:
+- help@hireross.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- LICENSE.txt
-- README.md
+- History.txt
+- Manifest.txt
+- README.txt
 files:
-- LICENSE.txt
-- README.md
+- ".autotest"
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
 - lib/azure/core/auth/shared_access_signature.rb
 - lib/paperclip-azure.rb
+- lib/paperclip/azure.rb
 - lib/paperclip/storage/azure.rb
-homepage: http://github.com/supportify/paperclip-azure
+- lib/paperclip/storage/azure/environment.rb
+- spec/paperclip/storage/azure/environment_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/supportify/paperclip-azure
 licenses:
 - MIT
 metadata: {}
 post_install_message: 
-rdoc_options: []
+rdoc_options:
+- "--main"
+- README.txt
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.8
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
-summary: An Azure Blob Storage implementation for Paperclip.
+summary: Paperclip-Azure is a [Paperclip](https://github.com/thoughtbot/paperclip)
+  storage driver for storing files in a Microsoft Azure Blob.
 test_files: []

data/LICENSE.txt

@@ -1,20 +0,0 @@
-Copyright (c) 2015 Jordan Yaker
-
-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

@@ -1,63 +0,0 @@
-# paperclip-azure
-
-Paperclip-Azure is a [Paperclip](https://github.com/thoughtbot/paperclip) storage driver for storing files in a Microsoft Azure Blob.
-
-## Installation
-
-Add this line to your application's Gemfile after the Paperclip gem:
-
-    gem 'paperclip-azure'
-
-And then execute:
-
-    $ bundle
-
-## Usage
-
-The Azure storage engine has been developed to work as similarly to S3 storage configuration as is possible.  This gem can be configured in a Paperclip initializer as follows:
-
-    Paperclip::Attachment.default_options[:storage] = :azure
-    Paperclip::Attachment.default_options[:url] = ':azure_path_url'
-    Paperclip::Attachment.default_options[:path] = ":class/:attachment/:id/:style/:filename"
-    Paperclip::Attachment.default_options[:storage] = :azure
-    Paperclip::Attachment.default_options[:azure_credentials] = {
-        storage_account_name: ENV['AZURE_STORAGE_ACCOUNT'],
-        access_key:           ENV['AZURE_ACCESS_KEY'],
-        container:            ENV['AZURE_CONTAINER_NAME']
-    }
-
-Or, at the level of the model such as in the following example:
-
-    has_attached_file :download, 
-                      storage: :azure,
-                      azure_credentials: {
-                        storage_account_name: ENV['AZURE_STORAGE_ACCOUNT'],
-                        access_key:           ENV['AZURE_ACCESS_KEY'],
-                        container:            ENV['AZURE_CONTAINER_NAME']
-                      }
-
-
-## Private Blob Access
-
-In the even that are using a Blob that has been configured for Private access, you will need to use the Shared Access Signature functionality of Azure.  This functionality has been baked in to the `Attachment#expiring_url` method. Simply specify a time and a style and you will get a proper URL as follows:
-
-    object.attachment.expiring_url(30.minutes.since, :thumb)
-
-For more information about Azure Shared Access Signatures, please refer to [here](http://azure.microsoft.com/en-us/documentation/articles/storage-dotnet-shared-access-signature-part-1/).
-
-## Contributing to paperclip-azure
- 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
-* Fork the project.
-* Start a feature/bugfix branch.
-* Commit and push until you are happy with your contribution.
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-* Submit a pull request for the finished product's integration.
-
-## Copyright
-
-Copyright (c) 2015. See [LICENSE](LICENSE.txt) for
-further details.
-