defog 0.1.0 → 0.1.1

data/README.rdoc

@@ -82,18 +82,21 @@ closing (e.g. via <code>File.unlink(file.path)</code>) or pass
 
 === Proxy handle
 
-Calling Defog::Proxy#file without a mode returns a Defog::Handle object that supports remote file query and manipulation:
+Calling Defog::Proxy#file without a mode returns a Defog::Handle object that supports cloud file query and manipulation:
 
-    proxy.file("key").exist?  # => returns true if the remove file exists
-    proxy.file("key").delete  # => deletes the remote file
+    handle = defog.file("key")
+    handle.exist?        # => true if the cloud file exists
+    handle.delete        # deletes the cloud file
+    handle.size          # => size of the cloud file
+    handle.last_modified # => modification date of the cloud file
 
-In fact, <code>proxy.file("key", mode, options, &block)</code> is really just shorthand for
+In fact, <code>defog.file("key", mode, options, &block)</code> is really just shorthand for
 
-    proxy.file("key").open(mode, options, &block)
+    defog.file("key").open(mode, options, &block)
 
 In addition, the handle allows you to look up the path where the local proxy file will be if/when you open the proxy (but without actually doing the proxying).
 
-    proxy.file("key").proxy_path  # returns pathname where proxy file will be when you open
+    defog.file("key").proxy_path  # => Pathname where proxy file is, was, or will be
 
 === Persistence
 

data/defog.gemspec

@@ -17,6 +17,7 @@ Gem::Specification.new do |gem|
 
   gem.add_dependency 'fog'
   gem.add_dependency 'hash_keyword_args'
+  gem.add_dependency 'fastandand'
 
   gem.add_development_dependency 'rake'
   gem.add_development_dependency 'rspec'

data/lib/defog/handle.rb

@@ -1,3 +1,5 @@
+require "fastandand"
+
 module Defog
   # Create a Defog::Handle proxy instance via Defog::Proxy#file, such as
   #
@@ -14,13 +16,17 @@ module Defog
   # The #proxy_path attribute method returns a <code>Pathname</code>
   # giving the local proxy file location.  Querying the attribute does 
   # <i>not</i> upload, download, synchronize, or otherwise interact with
-  # the cloud or local proxy file in any way -- just returns a constructed
-  # a Pathname.
+  # the cloud or local proxy file in any way -- it just returns a constructed
+  # Pathname.  The <code>proxy_path</code> is a deterministic function of the
+  # cloud key and Defog::Proxy#proxy_root, so you can rely on it not
+  # changing between independent accesses to a cloud file.
   #  
   class Handle
 
     attr_reader :key
     attr_reader :proxy #:nodoc:
+
+    # Pathname where proxy file is, was, or will be located.  
     attr_reader :proxy_path
 
     def initialize(proxy, key) #:nodoc:
@@ -31,12 +37,23 @@ module Defog
 
     # Returns true if the remote cloud file exists 
     def exist?
-      !!@proxy.fog_wrapper.fog_head(@key)
+      !!fog_model
     end
 
-    # Deletes the remote cloud file
+    # Deletes the remote cloud file if it exists
     def delete
-      @proxy.fog_wrapper.fog_head(@key).destroy
+      fog_model.andand.destroy
+    end
+
+    # Returns the size of the remote cloud file, or nil if it doesn't exist
+    def size
+      fog_model.andand.content_length
+    end
+    
+    # Returns the modification date of the remote cloud file, or nil if it
+    # doesn't exist
+    def last_modified
+      fog_model.andand.last_modified
     end
 
     # Returns a URL to access the remote cloud file.

data/lib/defog/proxy.rb

@@ -39,7 +39,7 @@ module Defog
       @fog_wrapper = FogWrapper.connect(opts)
 
       @proxy_root ||= case
-                      when defined?(Rails) then Rails.root
+                      when defined?(Rails) then Rails.root + "tmp"
                       else Pathname.new(Dir.tmpdir)
                       end + "defog" + provider.to_s + location
 

data/lib/defog/version.rb

@@ -1,3 +1,3 @@
 module Defog
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/spec/handle_spec.rb

@@ -10,15 +10,31 @@ shared_examples "a handle" do |proxyargs|
     @handle = @proxy.file(key)
   end
 
-  it "should report exist? true if remode cloud file exists" do
+  it "should report exist? true if remote cloud file exists" do
     create_remote("i exist")
     @handle.should be_exist
   end
 
-  it "should report exist? false if remode cloud file does not exists" do
+  it "should report exist? false if remote cloud file does not exist" do
     @handle.should_not be_exist
   end
 
+  { :size => :content_length,
+    :last_modified => :last_modified,
+    :delete => :destroy }.each do |method, fog_method|
+
+    it "should delegate #{method.inspect} to the fog model #{fog_method.inspect}if the remote file exists" do
+      create_remote("delegate me")
+      @handle.fog_model.class.any_instance.should_receive(fog_method).and_return { "dummy" }
+      @handle.send(method).should == "dummy"
+    end
+
+    it "should return nil from #{method} if the remote file does not exist" do
+      @handle.send(method).should be_nil
+    end
+
+  end
+
   it "should delete a remote cloud file" do
     create_remote("delete me")
     remote_exist?.should be_true

data/spec/proxy_spec.rb

@@ -10,7 +10,7 @@ shared_examples "a proxy" do |args|
   it "should default proxy root to Rails.root" do
     with_rails_defined do
       proxy = Defog::Proxy.new(args)
-      proxy.proxy_root.should == Rails.root + "defog" + proxy.provider.to_s + proxy.location
+      proxy.proxy_root.should == Rails.root + "tmp/defog" + proxy.provider.to_s + proxy.location
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: defog
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-26 00:00:00.000000000 Z
+date: 2012-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fog
-  requirement: &70310792245820 !ruby/object:Gem::Requirement
+  requirement: &70159750978980 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70310792245820
+  version_requirements: *70159750978980
 - !ruby/object:Gem::Dependency
   name: hash_keyword_args
-  requirement: &70310792245400 !ruby/object:Gem::Requirement
+  requirement: &70159750978560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,21 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70310792245400
+  version_requirements: *70159750978560
+- !ruby/object:Gem::Dependency
+  name: fastandand
+  requirement: &70159750978140 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70159750978140
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70310792244960 !ruby/object:Gem::Requirement
+  requirement: &70159750977700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70310792244960
+  version_requirements: *70159750977700
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70310792244520 !ruby/object:Gem::Requirement
+  requirement: &70159750977280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70310792244520
+  version_requirements: *70159750977280
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &70310792243920 !ruby/object:Gem::Requirement
+  requirement: &70159750976820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +76,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70310792243920
+  version_requirements: *70159750976820
 - !ruby/object:Gem::Dependency
   name: simplecov-gem-adapter
-  requirement: &70310792243380 !ruby/object:Gem::Requirement
+  requirement: &70159750976360 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,7 +87,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70310792243380
+  version_requirements: *70159750976360
 description: Wrapper to fog gem, proxying access to cloud files as local files.
 email:
 - ronen@barzel.org