fun_with_files 0.0.9 → 0.0.12

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MTc4NmU5MmI0MGZmMWYzNDEzOGFjNDBlZDNkZjM0MTA1ZWI5MWVlNw==
+    YzBiYWRhY2FhYmU2ZjExYzFlOWJmY2QzMjAzZDMyOTkzZTRmYmY0Yw==
   data.tar.gz: !binary |-
-    YWJmODhjZWZhMDdmMjViNTU5ZWI1ZmI5Y2RhZGU3MzRkMTZlOWQ3Zg==
+    YTA2OWE0NTc4NTY1ODk1M2Q2YjAzYTNiYjUyN2E4ODVmYWI4MDViYQ==
 SHA512:
   metadata.gz: !binary |-
-    MzZhNWUyZDhlYmVmZDcwODg0MzJjNzYzZDFlMmZhZDg5NmE3MjJlMWVmM2Qw
-    ODdiNGQ0NzRlNTVmMDE2ODRiY2Q4YzRiZTMzNTRhMmQwNTkxNmJiY2I0NTJm
-    MDMzODdlNTI0ODY0N2NmMTIxZTNkMDY5MTc2NmJjYzU4ZjI4NDE=
+    YWU0NzU0YTU1Y2QxMjU0MDJlMGVhMDBkNTBkNmQzNTYzN2FjMjRmMzRiNGIz
+    YjRhYmJkMjBkNDE5YjBhNTM4ODE1NjA3YjQ4MDY1YWZiOWI2NzExM2M4MTZj
+    MGMwYzRmZDZkMWY2Yjc5ZjAwYmNjZWVmZWEyYjhkMWU3M2YwZDY=
   data.tar.gz: !binary |-
-    NTAzNzg0Y2Y4NDJkZjQ1NjNhY2UyNTk1OTc5OGE0YmJlYWNhOTFmMGJhMzI2
-    MzI3OTRmYzY3OWRmMmU5YTdiZmFhZTE0NGQ3YmViZWNmNzgyYmUxN2IwMTkw
-    YzA2OGQzZDM1NTM2NWUwNzU2MWM0M2Y5MGQ5NTVhZTYxMWU0MDE=
+    ZjVkMmMwYzI0ODJmMmY1NTNkZTFiODlhZjI0NjA5NjIyODA0YmYzYWU4NmEy
+    OTY4OWE2ZjhlMTM2MjExOTdmOGQ2NTI5MjVjOTVkNzk4MWEzZGMyYTNlYjJj
+    MWNhNDU3ZTkzMWNhOTU5MjY0ZGU0Yjc5NmYzZWEwOTkyYmZlZTM=

data/VERSION

@@ -1 +1 @@
-0.0.9
+0.0.12

data/lib/fun_with/files/core_extensions/array.rb

@@ -1,5 +1,12 @@
-class Array
-  def fwf_blank?
-    self.length == 0
+module FunWith
+  module Files
+    module CoreExtensions
+      module Array
+        def fwf_blank?
+          self.length == 0
+        end
+      end
+    end
   end
-end
+end
+

data/lib/fun_with/files/core_extensions/false.rb

@@ -1,5 +1,11 @@
-class FalseClass
-  def fwf_blank?
-    true
+module FunWith
+  module Files
+    module CoreExtensions
+      module FalseClass
+        def fwf_blank?
+          true
+        end
+      end
+    end
   end
-end
+end

data/lib/fun_with/files/core_extensions/hash.rb

@@ -1,5 +1,23 @@
-class Hash
-  def fwf_blank?
-    self.length == 0
+module FunWith
+  module Files
+    module CoreExtensions
+      module Hash
+        def fwf_blank?
+          self.length == 0
+        end
+  
+        # Stolen from: activesupport/lib/active_support/core_ext/hash/reverse_merge.rb, line 12
+        def fwf_reverse_merge( other_hash )
+          other_hash.merge( self )
+        end
+  
+        # File activesupport/lib/active_support/core_ext/hash/reverse_merge.rb, line 17
+        def fwf_reverse_merge!(other_hash)
+          # right wins if there is no left
+          merge!( other_hash ){|key,left,right| left }
+        end
+      end
+    end
   end
-end
+end
+

data/lib/fun_with/files/core_extensions/nil.rb

@@ -1,5 +1,12 @@
-class NilClass
-  def fwf_blank?
-    true
+module FunWith
+  module Files
+    module CoreExtensions
+      module NilClass
+        def fwf_blank?
+          true
+        end
+      end
+    end
   end
-end
+end
+

data/lib/fun_with/files/core_extensions/object.rb

@@ -1,9 +1,15 @@
-class Object
-  def fwf_blank?
-    false
-  end
+module FunWith
+  module Files
+    module CoreExtensions
+      module Object
+        def fwf_blank?
+          false
+        end
   
-  def fwf_present?
-    ! self.fwf_blank?
+        def fwf_present?
+          ! self.fwf_blank?
+        end
+      end
+    end
   end
 end

data/lib/fun_with/files/core_extensions/string.rb

@@ -1,9 +1,19 @@
-class String
-  def fwf_blank?
-    self.strip.length == 0
-  end
+module FunWith
+  module Files
+    module CoreExtensions
+      module String
+        def fwf_blank?
+          self.strip.length == 0
+        end
+  
+        def fwf_filepath( *args )
+          FunWith::Files::FilePath.new( self, *args )
+        end
   
-  def fwf_filepath( *args )
-    FunWith::Files::FilePath.new( self, *args )
+        def to_pathname
+          Pathname.new( self )
+        end
+      end
+    end
   end
 end

data/lib/fun_with/files/file_manipulation_methods.rb

@@ -15,17 +15,24 @@ module FunWith
       # ln_s(list, destdir, options)
       # ln_sf(src, dest, options)
       
-      # Opts are same as for FileUtils.cp_r
+      # opts are the last argument, and are passed to FileUtils.cp_r
       # returns the destination path.
       # How to detect failure?  What to return on failure?
+      #
+      # 
       def cp( *args )
         dest, opts = self.destination_and_options( args )
-        FileUtils.cp_r( self, dest, opts )
+        FileUtils.cp_r( self, dest, narrow_options( opts, FileUtils::OPT_TABLE["cp_r"] ) )
         dest.fwf_filepath
       end
       
       alias :copy :cp
       
+      def mv( *args )
+        
+      end
+      
+      
       # self is the target, link is the thing linking to self
       # returns filepath of the new link.  Will fall back to symbolic
       # link if self is a directory
@@ -34,18 +41,21 @@ module FunWith
           symlink = self.directory? || opts[:symbolic] || opts[:sym] || opts[:soft]
         
           if symlink
-            FileUtils.ln_s( self, link, opts )
+            FileUtils.ln_s( self, link, narrow_options( opts, FileUtils::OPT_TABLE["ln_s"] ) )
           else
-            FileUtils.ln( self, link, opts )
+            FileUtils.ln( self, link, narrow_options( opts, FileUtils::OPT_TABLE["ln"] ) )
           end
-        
+          
           link.fwf_filepath
         end
       end
       
+      alias :link :ln
+
+      
       def ln_s( *args )
         link, opts = self.destination_and_options( args )
-        FileUtils.ln_s( self, link, opts )
+        FileUtils.ln_s( self, link, narrow_options( opts, FileUtils::OPT_TABLE["ln_s"] ) )
         link.fwf_filepath
       end
       
@@ -53,6 +63,8 @@ module FunWith
       
       
       def file_gsub( *args, &block )
+        _must_be_a_file
+        
         lines = []
         self.each_line do |line|
           lines << line.gsub( *args, &block )
@@ -62,7 +74,10 @@ module FunWith
       end
       
       def file_gsub!( *args, &block )
-        self.write( self.file_gsub(*args,&block) )
+        _must_be_a_file      # raises error
+        _must_be_writable    # raises error
+        
+        self.write( self.file_gsub( *args, &block ) )
       end
       
       def empty!
@@ -73,8 +88,34 @@ module FunWith
         end
       end
       
+      # TODO: If it's truncated to a longer length than the original file,
+      # pad with zeros?  That's how the UNIX truncate command works.
       def truncate( len )
-        self.write( self.read( len ) )
+        _must_be_a_file     # raises error
+        _must_be_writable   # raises error
+        
+        old_size = self.size
+        padding = len > old_size ? "\0" * (len - old_size) : ""
+        
+        self.write( self.read( len ) + padding )
+      end
+      
+      # File manipulation
+      def rename( filename )
+        raise "NOT WORKING"
+      end
+
+      def rename_all( pattern, gsubbed )
+        raise "NOT WORKING"
+      end
+
+      # pass options?
+      def rm( secure = false )
+        if self.file?
+          FileUtils.rm( self )
+        elsif self.directory?
+          FileUtils.rmtree( self )
+        end
       end
       
       protected
@@ -161,6 +202,7 @@ module FunWith
       # chown(user, group, list, options)
       # chown_R(user, group, list, options)
       # touch(list, options)
+      
     end
   end
 end

data/lib/fun_with/files/file_path.rb

@@ -8,6 +8,8 @@ module FunWith
         super( File.join( *args ) )
       end
 
+      attr_accessor :path
+      
       # If block given, temporary directory is deleted at the end of the block, and the
       # value given by the block is returned.
       # 
@@ -24,15 +26,30 @@ module FunWith
       end
 
       def join( *args, &block )
-        if block_given?
-          yield self.class.new( super(*args) )
-        else
-          self.class.new( super(*args) )
-        end
+        joined_path = self.class.new( super(*args) )
+        yield joined_path if block_given?
+        joined_path
       end
-
+      
+      def join!( *args, &block )
+        @path = self.join( *args, &block ).to_str
+        self
+      end
+      
+      def / arg
+        self.join( arg )
+      end
+      
+      def [] *args
+        self.join(*args)
+      end
+      
       alias :exists? :exist?
       
+      def doesnt_exist?
+        self.exist? == false
+      end
+      
       # If called on a file instead of a directory,
       # has the same effect as path.dirname
       def up
@@ -75,11 +92,13 @@ module FunWith
       # @path.glob( "css", "*.css" )      # Picks up all css files in the css folder
       # @path.glob( "css", :ext => :css ) # same
       # @path.glob                        # Picks up all directories, subdirectories, and files
-      # @path.glob(:all)                  # same. Note: :all cannot be used in conjunction with :ext
+      # @path.glob(:all)                  # same. Note: :all cannot be used in conjunction with :ext or any other arguments.  Which may be a mistake on my part.
       # @path.glob("**", "*")             # same
       # @path.entries                     # synonym for :all, :recursive => false
       # 
-      def glob( *args )
+      # TODO:  depth argument?  depth should override recurse.  When extention given, recursion should default to true?
+      #        the find -depth argument says depth(0) is the root of the searched directory, any files beneath would be depth(1)
+      def glob( *args, &block )
         args.push( :all ) if args.fwf_blank?
         opts = args.last.is_a?(Hash) ? args.pop : {}
         
@@ -93,7 +112,7 @@ module FunWith
         flags = case (flags_given = opts.delete(:flags))
                 when NilClass
                   0
-                when Array      # should be an array of integers
+                when Array      # should be an array of integers or File::FNM_<FLAGNAME>s
                   flags_given.inject(0) do |memo, obj|
                     memo | obj
                   end
@@ -102,7 +121,7 @@ module FunWith
                 end
         
         flags |= File::FNM_DOTMATCH if opts[:dots]
-        flags |= File::FNM_CASEFOLD if opts[:sensitive]
+        flags |= File::FNM_CASEFOLD if opts[:sensitive]   # case sensitive.  Only applies to Windows.
     
         recurse = if all_arg_given
                     if opts[:recursive] == false || opts[:recurse] == false
@@ -145,7 +164,13 @@ module FunWith
         files = Dir.glob( self.join(*args), flags ).map{ |f| class_to_return.new( f ) }
         files.reject!{ |f| f.basename.to_s.match( /^\.\.?$/ ) } unless opts[:parent_and_current]
         
-        files
+        if block_given?
+          for file in files
+            yield file
+          end
+        else
+          files
+        end
       end
       
       def entries
@@ -159,29 +184,40 @@ module FunWith
       # Raises error if self is a file and args present.
       # Raises error if the file is not accessible for writing, or cannot be created.
       # attempts to create a directory
-      def touch( *args )
+      # 
+      # Takes an options hash as the last argument, allowing same options as FileUtils.touch
+      def touch( *args, &block )
+        args, opts = extract_opts_from_args( args )
+        
         raise "Cannot create subdirectory to a file" if self.file? && args.length > 0
         touched = self.join(*args)
+        
         dir_for_touched_file = case args.length
           when 0
             self.up
           when 1
             self
-          when 2..Infinity
+          when 2..Float::INFINITY
             self.join( *(args[0..-2] ) )
           end
         
-        self.touch_dir( dir_for_touched_file ) unless dir_for_touched_file.directory?
-        FileUtils.touch( touched )
+        self.touch_dir( dir_for_touched_file, opts ) unless dir_for_touched_file.directory?
+        FileUtils.touch( touched, narrow_options( opts, FileUtils::OPT_TABLE["touch"] ) )
+        
+        yield touched if block_given?
         return touched
       end
       
+      # Takes the options of both FileUtils.touch and FileUtils.mkdir_p
+      # mkdir_p options will only matter if the directory is being created.
       def touch_dir( *args, &block )
+        args, opts = extract_opts_from_args( args )
+        
         touched = self.join(*args)
         if touched.directory?
-          FileUtils.touch( touched )    # update access time
+          FileUtils.touch( touched, narrow_options( opts, FileUtils::OPT_TABLE["touch"] ) )    # update access time
         else
-          FileUtils.mkdir_p( touched )  # create directory (and any needed parents)
+          FileUtils.mkdir_p( touched, narrow_options( opts, FileUtils::OPT_TABLE["mkdir_p"] ) )  # create directory (and any needed parents)
         end
         
         yield touched if block_given?
@@ -206,17 +242,23 @@ module FunWith
         end
       end
       
-      # Returns a [list] of the lines in the file matching the given file
-      def grep( regex )
+      # Returns a [list] of the lines in the file matching the given file.  Contrast with
+      
+      def grep( regex, &block )
         return [] unless self.file?
         matching = []
         self.each_line do |line|
           matching.push( line ) if line.match( regex )
+          yield line if block_given?
         end
+        
+        
         matching
       end
 
-      # Not the same as zero?
+      # empty? has different meanings depending on whether you're talking about a file
+      # or a directory.  A directory must not have any files or subdirectories.  A file
+      # must not have any data in it.
       def empty?
         raise Exceptions::FileDoesNotExist unless self.exist?
         
@@ -255,7 +297,10 @@ module FunWith
         [self.basename_no_ext, self.ext]
       end
       
+      
+      
       def dirname_and_basename
+        warn("FilePath#dirname_and_basename() is deprecated.  Pathname#split() already existed, and should be used instead.")
         [self.dirname, self.basename]
       end
       
@@ -341,10 +386,19 @@ module FunWith
       end
     
       
-      def timestamp( format = true )
-        self.succ( :timestamp => format )
+      def timestamp( format = true, &block )
+        nxt = self.succ( :timestamp => format )
+        yield nxt if block_given?
+        nxt
       end
     
+      # puts a string between the main part of the basename and the extension
+      # or after the basename if there is no extension.  Used to describe some
+      # file variant. 
+      # Example "/home/docs/my_awesome_screenplay.txt".fwf_filepath.specifier("final_draft")
+      #  => FunWith::Files::FilePath:/home/docs/my_awesome_screenplay.final_draft.txt
+      #
+      # Oh hush.  *I* find it useful.
       def specifier( str )
         str = str.to_s
         chunks = self.to_s.split(".")
@@ -399,25 +453,6 @@ module FunWith
       # TODO: succ_last : find the last existing file of the given sequence.
       # TODO: succ_next : find the first free file of the given sequence
     
-    
-      # File manipulation
-      def rename( filename )
-      
-      end
-    
-      def rename_all( pattern, gsubbed )
-      
-      end
-
-      def rm( secure = false )
-        if self.file?
-          FileUtils.rm( self )
-        elsif self.directory?
-          FileUtils.rmtree( self )
-        end
-      end
-
-      
       def load
         if self.directory?
           self.glob( :recursive => true, :ext => "rb" ).map(&:load)
@@ -496,6 +531,61 @@ module FunWith
           self.up.ascend( &block )
         end
       end
+    
+      def to_pathname
+        Pathname.new( @path )
+      end
+
+      # TODO :  Not working as intended.
+      # def separator( s = nil )
+      #   # If s is nil, then we're asking for the separator
+      #   if s.nil?
+      #     @separator || File::SEPARATOR
+      #   else
+      #     @separator = s
+      #   end
+      #   # otherwise we're installing a separator
+      # end
+      
+      protected
+      # TODO: Need a separate API for user to call
+      def _must_be_a_file
+        unless self.file?
+          calling_method = caller[0][/`.*'/][1..-2]
+          raise Errno::EACCESS.new( "Can only call FunWith::Files::FilePath##{calling_method}() on an existing file.")
+        end
+      end
+      
+      def _must_be_a_directory
+        unless self.directory?
+          calling_method = caller[0][/`.*'/][1..-2]
+          raise Errno::EACCESS.new( "Can only call FunWith::Files::FilePath##{calling_method}() on an existing directory.")
+        end
+      end
+      
+      def _must_be_writable
+        unless self.writable?
+          calling_method = caller[0][/`.*'/][1..-2]
+          raise Errno::EACCESS.new( "Error in FunWith::Files::FilePath##{calling_method}(): #{@path} not writable.")
+        end
+      end
+      
+      def narrow_options( opts, keys )
+        opts.keep_if{ |k,v| keys.include?( k ) }
+      end
+      
+      def extract_opts_from_args( args )
+        if args.last.is_a?( Hash )
+          [args[0..-2], args.last ]
+        else
+          [args, {}]
+        end
+      end
+      
+      def yield_and_return( obj, &block )
+        yield obj if block_given?
+        obj
+      end
     end
   end
 end

data/lib/fun_with/files/file_permission_methods.rb

@@ -14,8 +14,8 @@ module FunWith
         File.executable?( self )
       end
       
-      def chmod( mode, options )
-        FileUtils.chmod( mode, self, options = {} )
+      def chmod( mode, opts = {} )
+        FileUtils.chmod( mode, self, narrow_options( opts, FileUtils::OPT_TABLE["chmod"] ) )
       end
     end
   end

data/lib/fun_with/files/file_requirements.rb

@@ -0,0 +1,24 @@
+module FunWith
+  module Files
+    module FileRequirements
+      def _raise_error_if_not test, msg, error_class
+        if test
+          raise error_class.new( msg + "(file: #{self})" )
+        end
+      end
+      
+      def needs_to_be_a_file error_msg = "Path is not a file"
+        _raise_error_if_not self.file?, error_msg, Errno::ENOENT
+      end
+      
+      def needs_to_be_writable error_msg = "Path is not writable"
+        _raise_error_if_not self.writable?, error_msg, Errno::ENOENT
+      end
+      
+      def needs_to_be_empty error_msg = "Path needs to point to"
+        _raise_error_if_not self.empty?, error_msg, Errno::ENOENT
+      end
+    end
+  end
+end
+

data/lib/fun_with/files/gem_api.rb

@@ -0,0 +1,10 @@
+module FunWith
+  module Files
+    module GemAPI
+      def version
+        self.root("VERSION").read
+      end
+    end
+  end
+end
+    

data/lib/fun_with/files/string_extensions.rb

@@ -0,0 +1,2 @@
+class String
+end

data/lib/fun_with_files.rb

@@ -8,22 +8,31 @@ for fil in ["string", "array", "false", "hash", "nil", "object"]
   require_relative File.join( "fun_with", "files", "core_extensions", fil )
 end
 
-for fil in ["file_path", "string_behavior", "file_manipulation_methods", "file_permission_methods", "digest_methods"]
+for klass in ["String", "Object", "NilClass", "Hash", "FalseClass", "Array"]
+  Kernel.const_get(klass).send( :include, FunWith::Files::CoreExtensions.const_get(klass))  
+end
+
+
+for fil in ["file_path", "string_behavior", "file_manipulation_methods", "file_permission_methods", "digest_methods", "file_requirements"]
   require_relative File.join( "fun_with", "files", fil )
 end
 
+
 # These have some FilePath methods required by .requir()
-for moduul in [ FunWith::Files::StringBehavior,
-                FunWith::Files::FileManipulationMethods, 
-                FunWith::Files::FilePermissionMethods, 
-                FunWith::Files::DigestMethods ]
-  FunWith::Files::FilePath.send( :include, moduul )
+for mod in [ FunWith::Files::StringBehavior,
+             FunWith::Files::FileManipulationMethods, 
+             FunWith::Files::FilePermissionMethods, 
+             FunWith::Files::DigestMethods,
+             FunWith::Files::FileRequirements ]
+  FunWith::Files::FilePath.send( :include, mod )
 end
 
-lib_dir = File.join( File.dirname(__FILE__), "fun_with" ).fwf_filepath
+lib_dir = File.dirname(__FILE__).fwf_filepath( "fun_with" )
 
 # And requir() everything else
 lib_dir.requir
 
 FunWith::Files::RootPath.rootify( FunWith::Files, __FILE__.fwf_filepath.dirname.up )
 FunWith::Files::FilePath.extend( FunWith::Files::FilePathClassMethods )
+
+FunWith::Files.extend( FunWith::Files::GemAPI )

data/test/helper.rb

@@ -1,6 +1,3 @@
-# require 'rubygems'
-# require 'bundler'
-# require 'debugger'
 require 'fun_with_testing'
 
 
@@ -35,10 +32,23 @@ class FunWith::Files::TestCase < FunWith::Testing::TestCase
   end
   
   def empty_temp_directory
-    tmp = FunWith::Files.root("test", "tmp")
+    tmp = FunWith::Files.root( "test", "tmp" )
     tmp.empty!
     assert_directory tmp
     puts tmp.glob(:all)
     assert_empty_directory tmp
   end
+  
+  def if_internet_works( &block )
+    `ping -c 1 google.com 2>&1 >> /dev/null`  # TODO: Portability issue
+    connection_detected = $?.success?
+      
+    if block_given?
+      if connection_detected   # TODO:  How to tell difference between "no internet" and "no ping utility?"
+        yield
+      else
+        puts "No internet connection.  Skipping."
+      end
+    end
+  end
 end

data/test/test_core_extensions.rb

@@ -0,0 +1,31 @@
+require 'helper'
+
+class TestCoreExtensions < FunWith::Files::TestCase
+  context "testing hash" do
+    should "fwf_reverse_merge nicely" do
+      h = { "1" => 1, "2" => 2 }.fwf_reverse_merge( "3" => 3, "1" => 0 )
+      
+      assert_equal 1, h["1"]
+      assert_equal 2, h["2"]
+      assert_equal 3, h["3"]
+      
+      h.fwf_reverse_merge!( "1" => "one", "2" => "two", "3" => "three" )
+      
+      assert_equal 1, h["1"]
+      assert_equal 2, h["2"]
+      assert_equal 3, h["3"]
+      
+      h.fwf_reverse_merge!( "1" => "one", "2" => "two", "3" => "three", "4" => "four" )
+
+      assert_equal 1, h["1"]
+      assert_equal 2, h["2"]
+      assert_equal 3, h["3"]
+      assert_equal "four", h["4"]
+    end
+    
+    should "fwf_blank? nicely." do
+      assert_equal false, { 1 => 2 }.fwf_blank?
+      assert_equal true, {}.fwf_blank?
+    end
+  end
+end

data/test/test_directory_builder.rb

@@ -64,19 +64,21 @@ class TestDirectoryBuilder < FunWith::Files::TestCase
     end
     
     should "download random crap from all over the Internet" do
-      DirectoryBuilder.tmpdir do |b|
-        gist_url = "http://bannedsorcery.com/downloads/testfile.txt"
-        gist_text = "This is a file\n==============\n\n**silent**: But _bold_! [Link](http://slashdot.org)\n"
-        b.download( gist_url, "gist.txt" )
+      if_internet_works do
+        DirectoryBuilder.tmpdir do |b|
+          gist_url = "http://bannedsorcery.com/downloads/testfile.txt"
+          gist_text = "This is a file\n==============\n\n**silent**: But _bold_! [Link](http://slashdot.org)\n"
+          b.download( gist_url, "gist.txt" )
         
-        b.file( "gist.txt.2" ) do
-          b.download( gist_url )
-        end
+          b.file( "gist.txt.2" ) do
+            b.download( gist_url )
+          end
         
-        assert b.current_file.nil?
-        assert b.current_path.join("gist.txt").exist?
-        assert b.current_path.join("gist.txt.2").exist?
-        assert_equal gist_text, b.current_path.join("gist.txt").read
+          assert b.current_file.nil?
+          assert b.current_path.join("gist.txt").exist?
+          assert b.current_path.join("gist.txt.2").exist?
+          assert_equal gist_text, b.current_path.join("gist.txt").read
+        end
       end
     end
   

data/test/test_file_manipulation.rb

@@ -95,5 +95,11 @@ class TestFileManipulation < FunWith::Files::TestCase
       
       assert_file_contents( clone_of_clone, /This is the/ )
     end
+    
+    should "do nothing when opts[:noop]" do
+      file = @dir.join( "not_exist.txt" )
+      file.touch( :noop => true, :this_invalid_option_is_ignored => true, :also_this_one => "also ignored" )
+      assert_no_file file
+    end
   end
 end

data/test/test_file_path.rb

@@ -192,6 +192,7 @@ class TestFilePath < FunWith::Files::TestCase
       nilhashhash = "74be16979710d4c4e7c6647856088456" 
       
       empty = @tmp_dir.join("empty.dat")
+      
       empty.touch
       assert_equal( nilhash, empty.md5 )
       

data/test/test_fun_with_files.rb

@@ -24,6 +24,9 @@ class TestFunWithFiles < FunWith::Files::TestCase
     
     should "respond to api" do
       assert_respond_to( FunWith::Files, :root )
+      assert_respond_to( FunWith::Files, :version )
+      
+      assert_equal "0.0.11", FunWith::Files.version   # Gotta change with every point release.  Ick.
     end
   end
 end

data/test/test_globbing.rb

@@ -3,9 +3,10 @@ require 'helper'
 class TestGlobbing < FunWith::Files::TestCase
   context "testing globbing" do
     setup do
-      @loadable_dir = FunWith::Files.root("test", "loadable_dir")
+      @loadable_dir = FunWith::Files.root "test", "loadable_dir"
+      @glob_dir     = FunWith::Files.root "test", "glob_dir" 
       assert @loadable_dir.directory?
-    
+      assert @glob_dir.directory?
     end
   
     should "glob some ruby files from the test/loadable_dir directory" do
@@ -33,5 +34,30 @@ class TestGlobbing < FunWith::Files::TestCase
       globs = @loadable_dir.glob( :recurse => true, :ext => :rb )
       assert_equal( 8, globs.length )
     end
+    
+    should "not search subdirectories when :recurse => false" do
+      globs = @loadable_dir.glob( :recurse => false, :ext => :rb )
+      assert_length 0, globs
+    end
+    
+    should "NOT search subdirectories when :recurse is unspecified" do
+      globs = @loadable_dir.glob :ext => :rb
+      assert_length 0, globs
+    end
+    
+    should "glob a dot file" do
+      globs = @glob_dir.glob( :recurse => false, :dots => true )
+      assert_length 1, globs
+    end
+    
+    should "not glob a dot file when :dots => false" do
+      globs = @glob_dir.glob( :recurse => false, :dots => false )
+      assert_length( 0, globs )
+    end
+    
+    should "ignore a dot file by default" do
+      globs = @glob_dir.glob( :recurse => false )  # no dots by default
+      assert_length( 0, globs )
+    end
   end
 end

data/test/test_symlinking.rb

@@ -0,0 +1,23 @@
+require 'helper'
+
+class TestTouching < FunWith::Files::TestCase
+  context "inside a tmpdir" do
+    setup do
+      @dir = FilePath.tmpdir
+    end
+    
+    teardown do
+      @dir.rm
+      assert_equal false, @dir.directory?
+    end
+    
+    should "create a file and link to it" do
+      file = @dir.touch( "Movies", "Basketball", "Shaquille", "cryptohash.dat" )
+      assert_fwf_filepath file.directory
+      assert_empty_file file
+      
+      link = file.link( file.up.up.up.join( "hash.dat"), :soft => true )
+      assert link.symlink?
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fun_with_files
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.0.12
 platform: ruby
 authors:
 - Bryce Anderson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-31 00:00:00.000000000 Z
+date: 2015-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xdg
@@ -67,10 +67,13 @@ files:
 - ./lib/fun_with/files/file_path.rb
 - ./lib/fun_with/files/file_path_class_methods.rb
 - ./lib/fun_with/files/file_permission_methods.rb
+- ./lib/fun_with/files/file_requirements.rb
+- ./lib/fun_with/files/gem_api.rb
 - ./lib/fun_with/files/pathname_extensions.rb
 - ./lib/fun_with/files/remote_path.rb
 - ./lib/fun_with/files/root_path.rb
 - ./lib/fun_with/files/string_behavior.rb
+- ./lib/fun_with/files/string_extensions.rb
 - ./lib/fun_with/files/xdg_extensions.rb
 - ./lib/fun_with_files.rb
 - ./test/data/empty.txt
@@ -88,6 +91,7 @@ files:
 - ./test/loadable_dir/dir5/c.rb
 - ./test/loadable_dir/dir5/d.rb
 - ./test/test_copying.rb
+- ./test/test_core_extensions.rb
 - ./test/test_descent.rb
 - ./test/test_digest.rb
 - ./test/test_directory_builder.rb
@@ -97,6 +101,7 @@ files:
 - ./test/test_globbing.rb
 - ./test/test_loading.rb
 - ./test/test_root_path.rb
+- ./test/test_symlinking.rb
 - ./test/test_touching.rb
 - Gemfile
 - LICENSE.txt