defog 0.8.0 → 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 024349bd2d3f5def5bf676cd93b7a222500003ab
+  data.tar.gz: 1636cbfc52043124967d8cd0dd5538ae80b42e0e
+SHA512:
+  metadata.gz: 282ade57688944a3d6b0203faece002aab973f92ddb93c702548ba3de50ae1252932b45a38f608c6acc56d2a0ce8ab83ac3dfb6f8d2d6c48ae4567acbdf131ca
+  data.tar.gz: f4d0323c3ef34a697f7f7bf667f46dd1fb5fd57ec948ce33fa90199cedbe20c8e212bb91c3cc5b1a97cdb89d9ac46a8d6f15fee8d91f699d1b595e006c0f3660

data/.travis.yml

@@ -1,6 +1,7 @@
 rvm:
   - 1.9.2
   - 1.9.3
+  - 2.0.0
 notifications:
   recipients:
     - ronen@barzel.org

data/README.md

@@ -1,11 +1,11 @@
 # defog
 
-[<img
-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)
+[![Gem Version](https://badge.fury.io/rb/defog.png)](http://badge.fury.io/rb/defog)
+[![Build Status](https://secure.travis-ci.org/ronen/defog.png)](http://travis-ci.org/ronen/defog) 
+[![Dependency Status](https://gemnasium.com/ronen/defog.png)](https://gemnasium.com/ronen/defog)
 
 Defog wraps the [fog](https://rubygems.org/gems/fog) gem (specifically,
-[Fog::Storage](http://fog.io/1.3.1/storage/)), providing access to files
+[Fog::Storage](http://fog.io/storage/)), providing access to files
 stored in the cloud via proxy files on the local file system. A proxy file can
 be
 *   Read-only:  A local cached copy of a cloud file.
@@ -24,9 +24,11 @@ Defog also provides a few simple remote-file management methods to minimize
 the need to dig down into the Fog layer; but full access to the underlying fog
 objects is available should it be needed.
 
+Full Rdoc is available at [http://rubydoc.info/gems/defog](Full Rdoc is available at http://rubydoc.info/gems/defog)
+
 ## Usage Summary
 
-Full Rdoc is available at http://rubydoc.info/gems/defog
+
 
 ### Create proxy connection
 
@@ -42,7 +44,7 @@ proxies files in a specific remote location, e.g.:
     defog = Defog::Proxy.new(:provider => :Local,
                              :local_root => "/path/to/directory")
 
-For complete options, see Defog::Proxy.new RDOC
+For complete options, see [Defog::Proxy.new RDOC](http://rubydoc.info/gems/defog/Defog/Proxy)
 
 ### Proxy a file
 
@@ -99,6 +101,7 @@ supports cloud file query and manipulation:
     handle.delete        # deletes the cloud file
     handle.size          # => size of the cloud file
     handle.last_modified # => modification date of the cloud file
+    handle.md5_hash      # => MD5 hash digest of the cloud file
 
 In fact, `defog.file("key", mode, options, &block)` is really just shorthand
 for
@@ -238,19 +241,20 @@ Gemfile:
 
 Defog is currently known to work on:
 
-*   Ruby:  MRI 1.9.2, MRI 1.9.3
+*   Ruby:  MRI 1.9.2, MRI 1.9.3, MRI 2.0.0
 *   Fog Storage: :local, :AWS
 
 
 The above storage providers are what the author uses.  Please fork and add
-others!  (There's just a very small amount of provider-specific code in one
-file, https://github.com/ronen/defog/blob/master/lib/defog/fog_wrapper.rb,
+others!  (There's just a very small amount of provider-specific code in [one
+file](https://github.com/ronen/defog/blob/master/lib/defog/fog_wrapper.rb]),
 plus appropriate rspec examples.)
 
 ## History
 
 Release Notes:
 
+* 0.9.0 - Expose Handle#md5_hash
 * 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

data/lib/defog/handle.rb

@@ -14,19 +14,19 @@ module Defog
   #    end
   #
   # The #proxy_path attribute method returns a <code>Pathname</code>
-  # giving the local proxy file location.  Querying the attribute does 
+  # 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 -- 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.  
+    # Pathname where proxy file is, was, or will be located.
     attr_reader :proxy_path
 
     def initialize(proxy, key) #:nodoc:
@@ -39,7 +39,7 @@ module Defog
       "<#{self.class}: key=#{key}>"
     end
 
-    # Returns true if the remote cloud file exists 
+    # Returns true if the remote cloud file exists
     def exist?
       !!fog_model
     end
@@ -53,13 +53,20 @@ module Defog
     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 the MD5 hash digest of the remote cloud file, or nil if it
+    # doesn't exist
+    #
+    def md5_hash
+      return @proxy.fog_wrapper.get_md5(@key) if exist?
+    end
+
     # Returns a URL to access the remote cloud file.  The options are
     # storage-specific.
     #
@@ -75,7 +82,7 @@ module Defog
     # For :local cloud files, all options are ignored.  If Rails is defined
     # and the file is in Rails app's public directory, returns a path
     # relative to the public directory.  Otherwise returns a
-    # <code>"file://"</code> URL 
+    # <code>"file://"</code> URL
     def url(opts={})
       opts = opts.keyword_args(:expiry => Time.now + 10*60, :query => :optional)
       @proxy.fog_wrapper.url(@key, opts)
@@ -91,7 +98,7 @@ module Defog
       @proxy.fog_wrapper.fog_head(@key)
     end
 
-    # Returns a Defog::File object, which is a specialization of ::File. 
+    # Returns a Defog::File object, which is a specialization of ::File.
     #
     # <code>mode</code> can be the usual "r", "r+", "w", "w+", "a", or "a+" with the
     # usual semantics.  When opened in a readable mode ("r", "r+", "w+",

data/lib/defog/version.rb

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

data/spec/handle_spec.rb

@@ -29,13 +29,29 @@ shared_examples "a handle" do |proxyargs|
     end
   end
 
-  it "should report exist? true if remote cloud file exists" do
-    create_remote("i exist")
-    @handle.should be_exist
+  context "if remote cloud file exists" do
+
+    before(:each) do
+      create_remote("i exist")
+    end
+
+    it "should report exist? true" do
+      @handle.should be_exist
+    end
+
+    it "should return md5 hash" do
+      @handle.md5_hash.should == Digest::MD5.hexdigest("i exist")
+    end
   end
 
-  it "should report exist? false if remote cloud file does not exist" do
-    @handle.should_not be_exist
+  context "if remote cloud file does not exist" do
+    it "should report exist? false" do
+      @handle.should_not be_exist
+    end
+
+    it "should return nil md5 hash" do
+      @handle.md5_hash.should be_nil
+    end
   end
 
   { :size => :content_length,

metadata

@@ -1,142 +1,125 @@
 --- !ruby/object:Gem::Specification
 name: defog
 version: !ruby/object:Gem::Version
-  version: 0.8.0
-  prerelease: 
+  version: 0.9.0
 platform: ruby
 authors:
 - ronen barzel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-14 00:00:00.000000000 Z
+date: 2013-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fog
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: hash_keyword_args
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: fastandand
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: simplecov-gem-adapter
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Wrapper to fog gem, proxying access to cloud files as local files.
@@ -168,27 +151,26 @@ files:
 - spec/support/helpers.rb
 homepage: http://github.com/ronen/defog
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.25
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Wrapper to fog gem, proxying access to cloud files as local files.  Access
   can be read-only (local cache), write-only (upload), or read-write (mirror)
 test_files: