paperclip-eitheror 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 977bcd0b0e3c7535687ef21d01803b7c616659c6
-  data.tar.gz: fe78f2825400ace39fc663f90d90d4fce0b1388e
+  metadata.gz: 0eaac3a917d3a5ec24a54f230ea46087167b9dde
+  data.tar.gz: 936ba75f84bcb492118e25230f8374bfe5fb2f5a
 SHA512:
-  metadata.gz: bbc423e8ba839df5f6cae5d71c84342b568bd19a67383c79e07ba9bfed32975ea41fe756710adb04480811f5f14debddf810c5568339f164926905d5a2ce18e1
-  data.tar.gz: 8765c21b4b21be2f15d6d7fbf2d3d13551ba873cf59ccf8433db2df9a27523085e557da80f168093c23a6c035f484d6a00bd5d3d44086956528c12c007635daa
+  metadata.gz: 98b2c8152ec72ce8e98dd0d9ae828b6445c764715348de5c6308331498d18895f413d43ceb18112dc516c08becc0ab95f7df2f6d8ee2291f4a37b4346d30d7eb
+  data.tar.gz: c4ae600bb32c35013922744768feff5ef47994be28479f633df03dccf9932b96b6df3c27abc79187354b5ff98b0aeb732a45fea81f3da1f32c2eb683d9dd66da

data/README.md

@@ -1,4 +1,5 @@
 # Paperclip::Eitheror
+
 [![Build Status](https://travis-ci.org/powerhome/paperclip-eitheror.svg?branch=master)](https://travis-ci.org/powerhome/paperclip-eitheror)
 
 A [Paperclip](https://github.com/thoughtbot/paperclip/) Storage which supports a secondary (called 'or') storage as a fallback while using the primary one (called 'either').
@@ -123,7 +124,7 @@ class User < ActiveRecord::Base
 end
 ```
 
-# `:autosync`
+## The `:autosync` Option
 
 You can configure `paperclip-eitheror` to automatically synchronize attachments from the **or** (fallback) storage to **either** (primary).
 
@@ -137,7 +138,30 @@ has_attached_file :avatar, {
 }
 ```
 
-# Method aliasing/overriding
+## Disabling "Either": The `enabled: false` Option
+
+In case you need to set up `paperclip-eitheror` on your app, but are not yet ready to enable the primary storage, you may disable it by using `enabled: false` in the **either** options list, as follows:
+
+```ruby
+has_attached_file :avatar, {
+  storage: :eitheror,
+  either: {
+    storage: :fog,
+    enabled: false,
+    path: ':attachment/:id/:style/:filename',
+    url: ':attachment/:id/:style/:filename'
+  },
+  or: {
+    storage: :filesystem,
+    url: '/api/v1/attachments/:attachment/:id/:style',
+    path: ':rails_root/public/attachments/:class/:attachment/:style/:filename',
+  }
+}
+```
+
+That comes specially handy if you need to enable/disable the primary storage based off a config flag, allowing, for instance, the primary storage to be disabled on a per-environment basis.
+
+## Method Aliasing/Overriding
 
 Different storages provide different ways of accessing attachments.
 For instance, when using `:fog` storage, you have access to methods which only make sense to that particular storage.

data/lib/paperclip/eitheror/version.rb

@@ -1,5 +1,5 @@
 module Paperclip
   module Eitheror
-    VERSION = "0.1.0"
+    VERSION = "0.1.1"
   end
 end

data/lib/paperclip/storage/eitheror.rb

@@ -3,6 +3,7 @@ module Paperclip
     module Eitheror
       def self.extended base
         base.instance_eval do
+          base.options[:either][:enabled] = true if base.options[:either][:enabled].nil?
           @either = Attachment.new(base.name, base.instance, base.options.merge(base.options[:either]))
           @or = Attachment.new(base.name, base.instance, base.options.merge(base.options[:or]))
 
@@ -70,6 +71,7 @@ module Paperclip
       end
 
       def usable_storage
+        return @or unless @either.options[:enabled]
         return @either if !@or.exists? || @either.exists?
         options[:autosync] && sync ? @either : @or
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paperclip-eitheror
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Matheus Abegg
@@ -147,7 +147,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5.1
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Storage for Paperclip which will fallback in case of a file not existing