defog 0.7.2 → 0.8.0

data/README.md

@@ -1,8 +1,7 @@
 # defog
 
 [<img
-src="https://secure.travis-ci.org/ronen/defog.png"/>](http://travis-ci.org/ron
-en/defog) [<img src="https://gemnasium.com/ronen/defog.png" alt="Dependency
+src="https://secure.travis-ci.org/ronen/defog.png"/>](http://travis-ci.org/ronen/defog) [<img src="https://gemnasium.com/ronen/defog.png" alt="Dependency
 Status" />](https://gemnasium.com/ronen/defog)
 
 Defog wraps the [fog](https://rubygems.org/gems/fog) gem (specifically,
@@ -205,6 +204,20 @@ And it's fair game to delete proxy files outside of Defog, such as via a cron
 job.  Of course in these cases it's up to you to make sure not to
 unintentionally delete a proxy file that's currently open.
 
+### Multiple Defog proxies, prefix, and cache sharing.
+
+Sometimes you may want to have multiple Defog proxies, each scoped to a
+different "subdirectory" of a cloud storage location -- but all of them sharing a single cache in order to limit the max cache size across them all).
+
+That works OK out of the box (as of v0.8.0):  the default `proxy_root` is created without regard for the `prefix` -- but the `proxy_path` for files within the cache does include the prefix.  So it's safe to create multiple defog proxies that differ only in `prefix`, and they will share the cache without colliding with each other.   
+
+Notes:
+
+* Each defog proxy will manage the entire cache based on its own `max_cache_size` setting.  So presumably you would pass the same `max_cache_size` to each.
+
+* Best to avoid multithreading though, as there's no locking around the cache management. So in principle one thread could delete a proxy that another thread is using.
+
+
 ## Accessing Fog
 
 You can access the underlying fog objects as needed:
@@ -218,6 +231,7 @@ You can access the underlying fog objects as needed:
 ## Installation
 
 Gemfile:
+
     gem 'defog'
 
 ## Compatibility
@@ -237,11 +251,12 @@ plus appropriate rspec examples.)
 
 Release Notes:
 
-*   0.7.2 - Bug fix: don't fail when clearing cache if another process clears it first
-*   0.7.1 - Add key info to message if there's an exception when getting file
-*   0.7.0 - Add :query option to Handle#url
-*   0.6.1 - Bug fix (caching)
-*   0.6.0 - Add logging
+* 0.8.0 - Include prefix in proxy_path (thus allowing cache sharing)
+* 0.7.2 - Bug fix: don't fail when clearing cache if another process clears it first
+* 0.7.1 - Add key info to message if there's an exception when getting file
+* 0.7.0 - Add :query option to Handle#url
+* 0.6.1 - Bug fix (caching)
+* 0.6.0 - Add logging
 
 
 ## Copyright

data/lib/defog/handle.rb

@@ -32,7 +32,7 @@ module Defog
     def initialize(proxy, key) #:nodoc:
       @proxy = proxy
       @key = key
-      @proxy_path = Pathname.new("#{@proxy.proxy_root}/#{@key}").expand_path
+      @proxy_path = Pathname.new("#{@proxy.proxy_root}/#{@proxy.prefix}#{@key}").expand_path
     end
 
     def to_s

data/lib/defog/version.rb

@@ -1,3 +1,3 @@
 module Defog
-  VERSION = "0.7.2"
+  VERSION = "0.8.0"
 end

data/spec/handle_spec.rb

@@ -14,6 +14,21 @@ shared_examples "a handle" do |proxyargs|
     @handle.to_s.should include key
   end
 
+  context "proxy path" do
+    it "should start with proxy root" do
+      @handle.proxy_path.to_s.should start_with(@proxy.proxy_root.to_s)
+    end
+
+    it "should end with key" do
+      @handle.proxy_path.to_s.should end_with(key)
+    end
+
+    it "should include prefix" do
+      prefix = "IAmAPrefix"
+      Defog::Proxy.new(proxyargs.merge(:prefix => prefix)).file(key).proxy_path.to_s.should include(prefix.to_s)
+    end
+  end
+
   it "should report exist? true if remote cloud file exists" do
     create_remote("i exist")
     @handle.should be_exist

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: defog
 version: !ruby/object:Gem::Version
-  version: 0.7.2
+  version: 0.8.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-27 00:00:00.000000000 Z
+date: 2013-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fog