file-find 0.2.2 → 0.2.3

data/CHANGES

@@ -1,3 +1,8 @@
+== 0.2.3 - 25-Nov-2008
+* Added mtime support. My previous concerns, which I believe stemmed from
+  the find(2) man page on Solaris 10 with regards to atime checks modifying
+  the mtime, appear have been unfounded.
+
 == 0.2.2 - 19-Nov-2008
 * The :user and :group options now accept a name or a numeric id. Thanks go
   to Bill Kleb for the suggestion.

data/README

@@ -19,11 +19,11 @@ library. It is modeled on a typical 'find' command found on most Unix systems.
 
 = Rationale
 The current find module in the standard library is inadequate. It is, quite
-frankly, not much more than a plain Dir.glob call. This package provides an
+frankly, not much more than a plain Dir.glob call. This library provides an
 interface based on options typically available on your command line 'find'
 command, thus allowing you much greater control over how you find your files.
 
-I am aware of the find2 package by Motoyuki Kasahara, but it supports very
+I am aware of the find2 library by Motoyuki Kasahara, but it supports very
 few options, hasn't been updated in over six years and isn't packaged properly.
 
 = Options
@@ -32,13 +32,14 @@ few options, hasn't been updated in over six years and isn't packaged properly.
 * follow
 * ftype
 * inum (except Windows)
-* group
+* group (name or id)
+* mtime
 * name (or 'pattern')
 * path
 * perm (except Windows)
 * prune
 * size
-* user
+* user (name or id)
 
 See the RDoc documentation for more details about these options.
 
@@ -60,21 +61,18 @@ or is just too difficult to implement in a cross platform manner will not be
 supported. These include the following options:
 
 * acl/xattr - Way too difficult to implement in a cross platform manner, and
-  a rarely used option to boot.
+  a rarely used option in practice.
 
-* cpio/ncpio - You can shell out on your own if you want, but I'm not going to
-  do it for you. The same goes for any similar options for 3rd party apps that
-  your particular platform may support.
+* cpio/ncpio - I will not shell out to this or any other 3rd party application.
 
-* ls/print - You can print file names as you see fit on your own. This isn't
-  a shell command replacement.
+* ls/print - Use Ruby's builtin printing methods to print as you see fit.
 
 * ok - This is not interactive software.
 
 = Options I may or may not support
 
 * local/mount/xdev - This will probably not be added until I'm satisfied with
-  the sys-filesystem package.
+  the sys-filesystem library. As of sys-filesystem 0.1.x, I'm not.
   
 = Known Issues
 The 'perm' option does not work on MS Windows, even for its limited subset of
@@ -92,6 +90,7 @@ http://www.rubyforge.org/projects/shards.
 = Acknowledgements
 * Richard Clamp's File::Find::Rule Perl module for additional ideas and
   inspiration.
+* Bill Kleb for ideas regarding name, group and perm enhancements.
 
 = License
 Ruby's

data/lib/file/find.rb

@@ -6,7 +6,7 @@ include Sys
 
 class File::Find
    # The version of this library
-   VERSION = '0.2.2'
+   VERSION = '0.2.3'
 
    # :stopdoc:
    VALID_OPTIONS = %w/
@@ -16,6 +16,7 @@ class File::Find
       ftype
       inum
       group
+      mtime
       name
       pattern
       path
@@ -38,8 +39,7 @@ class File::Find
 
    # Limits searches by file access time, where the value you supply is the
    # number of days back from the time that the File::Find#find method was
-   # called. Note that the File::Find#find method itself alters the access
-   # times.
+   # called.
    #
    attr_accessor :atime
 
@@ -56,8 +56,9 @@ class File::Find
    #
    attr_accessor :group
 
-   # Controls the behavior of how symlinks are followed. If set to true, then
-   # follows the file pointed to. If false, it considers the symlink itself.
+   # Controls the behavior of how symlinks are followed. If set to true (the
+   # default), then follows the file pointed to. If false, it considers the
+   # symlink itself.
    #
    attr_accessor :follow
 
@@ -71,6 +72,12 @@ class File::Find
    #
    attr_accessor :inum
 
+   # Limits searches by file modification time, where the value you supply is
+   # the number of days back from the time that the File::Find#find method was
+   # called.
+   #
+   attr_accessor :mtime
+
    # The name pattern used to limit file searches. The patterns that are legal
    # for Dir.glob are legal here. The default is '*', i.e. everything.
    #
@@ -131,6 +138,7 @@ class File::Find
       @group  = nil
       @follow = true
       @inum   = nil
+      @mtime  = nil
       @perm   = nil
       @prune  = nil
       @size   = nil
@@ -228,6 +236,12 @@ class File::Find
                   next unless (date1 - date2).numerator == @ctime
                end
 
+               if @mtime
+                  date1 = Date.parse(Time.now.to_s)
+                  date2 = Date.parse(stat_info.mtime.to_s)
+                  next unless (date1 - date2).numerator == @mtime
+               end
+
                if @ftype
                   next unless File.ftype(file) == @ftype
                end

data/test/test_file_find.rb

@@ -51,7 +51,7 @@ class TC_File_Find < Test::Unit::TestCase
    end
 
    def test_version
-      assert_equal('0.2.2', File::Find::VERSION)
+      assert_equal('0.2.3', File::Find::VERSION)
    end
 
    def test_path
@@ -76,8 +76,8 @@ class TC_File_Find < Test::Unit::TestCase
       rule1 = File::Find.new(:name => "*.rb", :atime => 0)
       rule2 = File::Find.new(:name => "*.rb", :atime => 1)
 
-      assert_equal(false, rule1.find.empty?)
-      assert_equal(true, rule2.find.empty?)
+      assert_false(rule1.find.empty?)
+      assert_true(rule2.find.empty?)
    end
 
    def test_ctime_basic
@@ -90,8 +90,22 @@ class TC_File_Find < Test::Unit::TestCase
       rule1 = File::Find.new(:name => "*.rb", :ctime => 0)
       rule2 = File::Find.new(:name => "*.rb", :ctime => 1)
 
-      assert_equal(false, rule1.find.empty?)
-      assert_equal(true, rule2.find.empty?)
+      assert_false(rule1.find.empty?)
+      assert_true(rule2.find.empty?)
+   end
+
+   def test_mtime
+      rule1 = File::Find.new(:name => "*.rb", :mtime => 0)
+      rule2 = File::Find.new(:name => "*.rb", :mtime => 1)
+
+      assert_false(rule1.find.empty?)
+      assert_true(rule2.find.empty?)
+   end
+
+   def test_mtime_basic
+      assert_respond_to(@rule1, :mtime)
+      assert_respond_to(@rule1, :mtime=)
+      assert_nil(@rule1.mtime)
    end
 
    def test_ftype_basic
@@ -104,8 +118,8 @@ class TC_File_Find < Test::Unit::TestCase
       rule1 = File::Find.new(:name => "*.rb", :ftype => "file")
       rule2 = File::Find.new(:name => "*.rb", :ftype => "characterSpecial")
 
-      assert_equal(false, rule1.find.empty?)
-      assert_equal(true, rule2.find.empty?)
+      assert_false(rule1.find.empty?)
+      assert_true(rule2.find.empty?)
    end
 
    def test_group_basic
@@ -143,7 +157,7 @@ class TC_File_Find < Test::Unit::TestCase
    def test_follow_basic
       assert_respond_to(@rule1, :follow)
       assert_respond_to(@rule1, :follow=)
-      assert_equal(true, @rule1.follow)
+      assert_true(@rule1.follow)
    end
 
    def test_name_basic

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: file-find
 version: !ruby/object:Gem::Version 
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors: 
 - Daniel Berger
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-11-19 00:00:00 -07:00
+date: 2008-11-25 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -70,8 +70,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   version: 
 requirements: []
 
-rubyforge_project: 
-rubygems_version: 1.2.0
+rubyforge_project: shards
+rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
 summary: A better way to find files