tsalzer-richfile 0.0.3 → 0.0.4

data/README.rdoc

@@ -7,10 +7,12 @@ A simple gem which adds some additional methods to File objects.
   gem install tsalzer-richfile --source http://gems.github.com
 
 
-== What is a Richfile?
+== What is Richfile?
 
-Richfile extends the Ruby built-in File instances with some somtimes
+Richfile extends the Ruby built-in File instances with some sometimes
 useful attributes.
+- +size+ attribute to cache the file size in a File object
+- OpenSSL digest attributes like <code>md5</code> and <code>sha1</code> (for all available digests)
 
 Note that there is no built-in magic to keep the once-fetched attributes
 in sync with the effective attributes of the real files.
@@ -25,23 +27,23 @@ Now, every new File object has a list of additional attributes. Whenever you
 access the attributes the first time, the data is pulled from the file system
 and cached in the File object.
 
-If you need to refresh the data, either call +refresh!+, which updates every
-attribute you used before, or +refresh_all!+, which updates each of the cached
+If you need to refresh the data, either call <code>refresh!</code>, which updates every
+attribute you used before, or <code>refresh_all!</code>, which updates each of the cached
 attributes. When you are just interested in a single attribute, call the
-attribute with an added bang (like +size!+).
+attribute with an added bang (like <code>size!</code>).
 
 == Building a new Gem
 
-To create a new gem, you need to install the echoe gem (see
-http://blog.evanweaver.com/files/doc/fauna/echoe/files/README.html).
-Next, edit the Rakefile to reflect your changes, then run:
+To create a new gem, you need to install the jeweler gem (see
+http://github.com/technicalpickles/jeweler/tree/master). If this is done, you can
+easily build a new gemspec with
 
-  rake clobber        # remove generated stuff for a clean manifest
-  rake manifest       # only needed if you changed the file set
-  rake build_gemspec  # update the gemspec
+  rake gemspec
+  gem build richfile.gemspec
 
-Now, you can either publish the gem, or build a gem package. See rake -T for
-available targets.
+This would create a new richfile-x.y.z.gem, which can easily be installed via
+
+  gem install richfile-x.y.z.gem
 
 == License
 

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
-:major: 0
 :minor: 0
-:patch: 3
+:patch: 4
+:major: 0

data/lib/richfile.rb

@@ -1,2 +1,4 @@
-require "#{File.dirname(__FILE__)}/richfile/base"
+require "richfile/base"
+require "richfile/digests"
+require "richfile/mimetype"
 Richfile.install

data/lib/richfile/base.rb

@@ -1,55 +1,17 @@
-require 'openssl'
-
 # Extension to File.
 module Richfile
-  if OpenSSL::OPENSSL_VERSION_NUMBER > 0x00908000
-    DIGESTS = %w(DSS1 MD2 MD4 MD5 RIPEMD160 SHA SHA1 SHA224 SHA256 SHA384 SHA512)
-  else
-    DIGESTS = %w(DSS1 MD2 MD4 MD5 RIPEMD160 SHA SHA1)
-  end
   
-  def self.digest_variants(digest)
-    digest_downcase = digest.downcase
-    digest_symbol = digest_downcase.to_sym
-    digest_bang = "#{digest_downcase}!".to_sym
-    digest_variable = "@#{digest_downcase}".to_sym
-    return digest_downcase, digest_symbol, digest_bang, digest_variable
-  end
-
 # Methods to be included in File objects.  
 module Base
   # size of the file in bytes.
   attr_reader :size
   
-  # define attributes for all the digests in Richfile::DIGEST.
-  Richfile::DIGESTS.each do |digest|
-    d_downcase, d_sym, d_bang, d_var = Richfile.digest_variants(digest)
-    
-    # message digest #{digest}
-    attr_reader d_sym
-    
-    define_method d_sym do
-      instance_variable_set(d_var, File.open(path, 'r') do |f|
-        d = OpenSSL::Digest.new(digest)
-        d << f.read
-        d.hexdigest
-      end) unless instance_variable_get(d_var)
-      instance_variable_get(d_var)
-    end
-    define_method d_bang do
-      instance_variable_set(d_var, nil)
-      send d_sym
-    end
-  end
-  
   # refresh the Richfile added attributes.
   # All the attributes referred once are loaded.
   def refresh!
     self.size! if @size
-    DIGESTS.each do |digest|
-      d_downcase, d_sym, d_bang, d_var = Richfile.digest_variants(digest)
-      send d_bang if (instance_variable_get(d_var))
-    end
+    refresh_digests! if respond_to?(:refresh_all_digests!)
+    self.mimetype! if @mimetype
     self
   end
   
@@ -58,10 +20,8 @@ module Base
   # You will most probably never need this method.
   def refresh_all!
     self.size!
-    DIGESTS.each do |digest|
-      d_downcase, d_sym, d_bang, d_var = Richfile.digest_variants(digest)
-      send d_bang
-    end
+    refresh_all_digests! if respond_to?(:refresh_all_digests!)
+    self.mimetype!
     self
   end
   
@@ -88,6 +48,8 @@ end#Base
 # include the Richfile::Base module into the File class.
 def self.install
   File.send :include, Richfile::Base
+  File.send :include, Richfile::Digests::Base
+  File.send :include, Richfile::Mimetype::Base
 end
 
 end#Richfile

data/lib/richfile/digests.rb

@@ -0,0 +1,280 @@
+require 'openssl'
+
+module Richfile
+
+# Digest related functionality.
+module Digests
+
+  if OpenSSL::OPENSSL_VERSION_NUMBER > 0x00908000
+    # all known digests for OpenSSL > 0.9.8
+    DIGESTS = %w(DSS1 MD2 MD4 MD5 RIPEMD160 SHA SHA1 SHA224 SHA256 SHA384 SHA512)
+  else
+    # all known digests for OpenSSL up to 0.9.8
+    DIGESTS = %w(DSS1 MD2 MD4 MD5 RIPEMD160 SHA SHA1)
+  end
+  
+  def self.each_digest_symbols(&blk) #:nodoc:
+    DIGESTS.each do |digest|
+      digest_downcase = digest.downcase
+      digest_bang = "#{digest_downcase}!".to_sym
+      digest_variable = "@#{digest_downcase}".to_sym
+      
+      blk.call(digest_bang, digest_variable)
+    end
+  end
+
+# Digest-related methods and attributes to be included in File objects.  
+module InstanceMethods
+  # DSS1 message digest.
+  attr_reader :dss1
+  # caching getter for DSS1 message digest.
+  def dss1
+    @dss1 = self.class.dss1(path) unless @dss1
+    @dss1
+  end
+  # getter for DSS1 message digest.
+  # This getter forces the digest to be reloaded.
+  def dss1!
+    @dss1 = nil
+    dss1
+  end
+  
+  # MD2 message digest.
+  attr_reader :md2
+  # caching getter for MD2 message digest.
+  def md2
+    @md2 = self.class.md2(path) unless @md2
+    @md2
+  end
+  # getter for MD2 message digest.
+  # This getter forces the digest to be reloaded.
+  def md2!
+    @md2 = nil
+    md2
+  end
+  
+  # MD4 message digest.
+  attr_reader :md4
+  # caching getter for MD4 message digest.
+  def md4
+    @md4 = self.class.md4(path) unless @md4
+    @md4
+  end
+  # getter for MD4 message digest.
+  # This getter forces the digest to be reloaded.
+  def md4!
+    @md4 = nil
+    md4
+  end
+  
+  # MD5 message digest.
+  attr_reader :md5
+  # caching getter for MD5 message digest.
+  def md5
+    @md5 = self.class.md5(path) unless @md5
+    @md5
+  end
+  # getter for MD5 message digest.
+  # This getter forces the digest to be reloaded.
+  def md5!
+    @md5 = nil
+    md5
+  end
+  
+  # RIPEMD160 message digest.
+  attr_reader :ripemd160
+  # caching getter for RIPEMD160 message digest.
+  def ripemd160
+    @ripemd160 = self.class.ripemd160(path) unless @ripemd160
+    @ripemd160
+  end
+  # getter for RIPEMD160 message digest.
+  # This getter forces the digest to be reloaded.
+  def ripemd160!
+    @ripemd160 = nil
+    ripemd160
+  end
+  
+  # SHA message digest.
+  attr_reader :sha
+  # caching getter for SHA message digest.
+  def sha
+    @sha = self.class.sha(path) unless @sha
+    @sha
+  end
+  # getter for SHA message digest.
+  # This getter forces the digest to be reloaded.
+  def sha!
+    @sha = nil
+    sha
+  end
+  
+  # SHA1 message digest.
+  attr_reader :sha1
+  # caching getter for SHA1 message digest.
+  def sha1
+    @sha1 = self.class.sha1(path) unless @sha1
+    @sha1
+  end
+  # getter for SHA1 message digest.
+  # This getter forces the digest to be reloaded.
+  def sha1!
+    @sha1 = nil
+    sha1
+  end
+  
+  # SHA224 message digest.
+  attr_reader :sha224
+  # caching getter for SHA224 message digest.
+  def sha224
+    @sha224 = self.class.sha224(path) unless @sha224
+    @sha224
+  end
+  # getter for SHA224 message digest.
+  # This getter forces the digest to be reloaded.
+  def sha224!
+    @sha224 = nil
+    sha224
+  end
+  
+  # SHA256 message digest.
+  attr_reader :sha256
+  # caching getter for SHA256 message digest.
+  def sha256
+    @sha256 = self.class.sha256(path) unless @sha256
+    @sha256
+  end
+  # getter for SHA256 message digest.
+  # This getter forces the digest to be reloaded.
+  def sha256!
+    @sha256 = nil
+    sha256
+  end
+  
+  # SHA384 message digest.
+  attr_reader :sha384
+  # caching getter for SHA384 message digest.
+  def sha384
+    @sha384 = self.class.sha384(path) unless @sha384
+    @sha384
+  end
+  # getter for SHA384 message digest.
+  # This getter forces the digest to be reloaded.
+  def sha384!
+    @sha384 = nil
+    sha384
+  end
+  
+  # SHA512 message digest.
+  attr_reader :sha512
+  # caching getter for SHA512 message digest.
+  def sha512
+    @sha512 = self.class.sha512(path) unless @sha512
+    @sha512
+  end
+  # getter for SHA512 message digest.
+  # This getter forces the digest to be reloaded.
+  def sha512!
+    @sha512 = nil
+    sha512
+  end
+  
+  # refresh the Richfile added attributes.
+  # All the attributes referred once are loaded.
+  def refresh_digests!
+    Richfile::Digests::each_digest_symbols do |d_bang, d_var|
+      send d_bang if (instance_variable_get(d_var))
+    end
+    self
+  end
+  # refresh all attributes.
+  # All attributes wil be loaded, so all digests will be calculated.
+  # You will most probably never need this method.
+  def refresh_all_digests!
+    Richfile::Digests::each_digest_symbols do |d_bang, d_var|
+      send d_bang
+    end
+    self
+  end
+end#InstanceMethods
+
+# Digest-related methods to be included into File class.
+module ClassMethods
+  # compute the DSS1 digest of a file.
+  def dss1(path)
+    hexdigest('DSS1', path)
+  end
+  # compute the DSS1 digest of a file.
+  # uses digest with 'DSS1' as digest to be used.
+  def md2(path)
+    hexdigest('MD2', path)
+  end
+  # compute the MD4 digest of a file.
+  # uses digest with 'MD4' as digest to be used.
+  def md4(path)
+    hexdigest('MD4', path)
+  end
+  # compute the MD5 digest of a file.
+  # uses digest with 'MD5' as digest to be used.
+  def md5(path)
+    hexdigest('MD5', path)
+  end
+  # compute the RIPEMD160 digest of a file.
+  # uses digest with 'RIPEMD160' as digest to be used.
+  def ripemd160(path)
+    hexdigest('RIPEMD160', path)
+  end
+  # compute the SHA digest of a file.
+  # uses digest with 'SHA' as digest to be used.
+  def sha(path)
+    hexdigest('SHA', path)
+  end
+  # compute the SHA1 digest of a file.
+  # uses digest with 'SHA1' as digest to be used.
+  def sha1(path)
+    hexdigest('SHA1', path)
+  end
+  # compute the SHA224 digest of a file.
+  # uses digest with 'SHA224' as digest to be used.
+  def sha224(path)
+    hexdigest('SHA224', path)
+  end
+  # compute the SHA256 digest of a file.
+  # uses digest with 'SHA256' as digest to be used.
+  def sha256(path)
+    hexdigest('SHA256', path)
+  end
+  # compute the SHA384 digest of a file.
+  # uses digest with 'SHA384' as digest to be used.
+  def sha384(path)
+    hexdigest('SHA384', path)
+  end
+  # compute the SHA512 digest of a file.
+  # uses digest with 'SHA512' as digest to be used.
+  def sha512(path)
+    hexdigest('SHA512', path)
+  end
+  
+  # compute a digest for a given file.
+  # - digest: the OpenSSL digest name
+  # - path: the file path
+  # - returns: hexdigest of the content of the file at the given path
+  def hexdigest(digest, path)
+    File.open(path, 'r') do |f|
+      d = OpenSSL::Digest.new(digest)
+      d << f.read
+      d.hexdigest
+    end
+  end
+end#DigestClassmethods
+
+module Base #:nodoc:
+  def self.included(mod) #:nodoc:
+    mod.extend(Richfile::Digests::ClassMethods)
+    mod.class_eval { include(Richfile::Digests::InstanceMethods) }
+  end
+end#Base
+
+end#Digests
+
+end#Richfile

data/lib/richfile/mimetype.rb

@@ -0,0 +1,54 @@
+#require 'mime/types'
+
+module Richfile
+
+# Mimetype functionality for attributes for File objects.
+# Currently, this works only for Unix-like OS, since it uses the file system
+# utility.
+module Mimetype
+
+# Methods made available for instances.
+module InstanceMethods
+  # the MIME type.
+  attr_reader :mimetype
+  # get the MIME type.
+  def mimetype
+    @mimetype = self.class.mimetype(path) unless @mimetype
+    @mimetype
+  end
+  # re-fetch the MIME type.
+  def mimetype!
+    @mimetype = nil
+    self.mimetype
+  end
+end#InstanceMethods
+
+# Methods implanted into the File class itself.
+module ClassMethods
+  # get the MIME type from a file using Richfile::Mimetype.mimetype_using_file.
+  def mimetype(path)
+    Richfile::Mimetype.mimetype_using_file(path).first
+  end
+end#ClassMethods
+
+  # determinate the MimeType using the file system utility.
+  # This is probably only available on Unix-like systems, but is usually
+  # quite reliable.
+  #
+  # - path: the full path of the file
+  # - returns: the mimetype string
+  def self.mimetype_using_file(path)
+    mimestring = `file --mime -b "#{path}"`.gsub(/\n/,"")
+    mimetype, encoding = /(\w+\/\w+); (.+)/.match(mimestring)[1,2]
+    return mimetype, encoding
+  end
+
+module Base #:nodoc:
+  def self.included(mod) #:nodoc:
+    mod.extend(Richfile::Mimetype::ClassMethods)
+    mod.class_eval { include(Richfile::Mimetype::InstanceMethods) }
+  end
+end#Base
+
+end#Mimetype
+end#Richfile

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: tsalzer-richfile
 version: !ruby/object:Gem::Version 
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors: 
 - Till Salzer
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-03-26 00:00:00 -07:00
+date: 2009-04-02 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -26,6 +26,8 @@ files:
 - VERSION.yml
 - lib/richfile
 - lib/richfile/base.rb
+- lib/richfile/digests.rb
+- lib/richfile/mimetype.rb
 - lib/richfile.rb
 has_rdoc: true
 homepage: http://github.com/tsalzer/richfile