fast 0.0.1 → 0.0.2

data/fast.gemspec

@@ -15,6 +15,9 @@ Gem::Specification.new do |s|
   s.rubyforge_project = "fast"
   
   s.add_dependency "metafun"
+  
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "zucker"
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")

data/lib/fast.rb

@@ -1,6 +1,7 @@
 require "metafun/delegator"
 
 require "fast/file"
+require "fast/dir"
 
 module Fast
   # Returns the list of entries in the directory
@@ -13,7 +14,7 @@ module Fast
     if options
       if options[:extension]
         filtered = []
-        Dir.entries(path).each do |entry|
+        ::Dir.entries(path).each do |entry|
           if entry.end_with? ".#{options[:extension]}"
             if options[:strip_extension]
               filtered << entry[0..-("#{options[:extension]}".length)-2]
@@ -25,7 +26,7 @@ module Fast
         return filtered
       end
     else
-      Dir.entries path
+      ::Dir.entries path
     end
   end
   
@@ -51,10 +52,9 @@ module Fast
     def self.mkdir path
       path.split("/").each do |part|
         route ||= part
-        Dir.mkdir route unless route == "" || ::File.directory?( route )
+        ::Dir.mkdir route unless route == "" || ::File.directory?( route )
         route += "/#{path}"
       end
-      # Dir.mkdir path # It seems this was redundant
     end
 end
 

data/lib/fast/dir.rb

@@ -0,0 +1,16 @@
+module Fast
+  # Directory handling class
+  class Dir
+    # .call -> like Fast::File.call
+    
+    # #list
+    
+    # #files
+    
+    # #dirs
+    
+    # #create
+  
+    # #exist?
+  end
+end

data/lib/fast/file.rb

@@ -2,21 +2,39 @@ module Fast
   # File handling class.
   class File
     # Appends the passed content to the file `path`
+    # Creates the file if it doesn't exist.
+    # Creates all the necesary folders if they don't exist
     def append path, content
-      ::File.open path, "a" do |handler|
+      @path = normalize path
+      Fast.dir! ::File.dirname @path if ::File.dirname(@path) != "."
+      ::File.open @path, "a" do |handler|
         handler.write content
       end
+      @path
     end
     
     # Deletes the file (wrapper for `File.unlink <path>`)
     def delete path
-      ::File.unlink path
+      @path = normalize path
+      ::File.unlink @path
+      @path
     end
   
     alias :destroy :delete
     alias :unlink :delete
     alias :del :delete
     
+    # Touches the file passed. Like bash `touch`, but creates
+    # all required directories if they don't exist
+    def touch path
+      @path = normalize path
+      Fast.dir! ::File.dirname @path if ::File.dirname(@path) != "."
+      ::File.open @path, "a+" do |file|
+        file.gets; file.write ""
+      end
+      @path
+    end
+    
     def self.call *args
       if args.empty?
         File.new
@@ -24,5 +42,10 @@ module Fast
         ::File.read args.shift
       end
     end
+    
+    private
+      def normalize path
+        "#{path}"
+      end
   end
 end

data/lib/fast/version.rb

@@ -1,3 +1,3 @@
 module Fast
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/spec/fast/dir_spec.rb

@@ -0,0 +1,35 @@
+require "fast"
+
+describe Fast::Dir do
+  describe "#list" do 
+    it "should return a list of all items in the directory"
+  end
+  
+  describe "#files" do
+    it "should return a list of all files in the directory"
+    
+    context "args :extension => 'txt'" do
+      it "should return a list of all files with .txt as extension in the directory"
+    end
+  end
+  
+  describe "#dirs" do
+    it "should return a list containing all dirs in the directory"
+    
+    context "args :skip => :dots" do
+      it "should return a list of dirs excluding '.' and '..'"
+    end
+  end
+  
+  describe "#create" do
+    context "is a simple path" do
+      it "should create the dir"
+  
+      it "should return the directory path"
+    end
+    
+    context "it is nested within dirs" do
+      it "should create the directory tree"
+    end
+  end
+end

data/spec/fast/file_spec.rb

@@ -0,0 +1,178 @@
+require "fast"
+require "zucker/os"
+
+# Just in case, delete the demo.txt
+::File.unlink "demo.txt" if ::File.exist? "demo.txt"
+
+describe Fast::File do
+  describe "#append" do
+    it "should create the file if it does not exist" do
+      ::File.should_not exist "demo.txt"
+      Fast::File.new.append "demo.txt", "some text"
+      ::File.should exist "demo.txt"
+      ::File.unlink "demo.txt"
+    end
+    
+    it "should not erase the content of the file if it has some" do
+      ::File.open "demo.txt", "w" do |file|
+        file.write "some demo content"
+      end
+      
+      Fast::File.new.append "demo.txt", "\nmore demo content"
+      
+      ::File.read( "demo.txt" ).should match /^some demo content/
+      ::File.unlink "demo.txt"
+    end
+    
+    it "should append the new content last in the file" do
+      ::File.open "demo.txt", "w" do |file|
+        file.write "This comes first: "
+      end
+      Fast::File.new.append "demo.txt", "and this comes after."
+      
+      ::File.read( "demo.txt" ).should match /and this comes after.$/
+      ::File.unlink "demo.txt"
+    end
+    
+    it "should update the modification time" do
+      ::File.open "demo.txt", "w" do |file|
+        file.write "Written earlier"
+      end
+      mtime = ::File.mtime "demo.txt"
+      
+      sleep 1
+      Fast::File.new.append "demo.txt", "\nWritten later"
+      ::File.mtime( "demo.txt" ).should > mtime
+      
+      ::File.unlink "demo.txt"
+    end
+    
+    it "should return the path to the file" do
+      Fast::File.new.append( "demo.txt", "Hola." ).should == "demo.txt"
+      ::File.unlink "demo.txt" 
+    end
+    
+    it "should work even when a symbol is passed as argument" do
+      Fast::File.new.append :demo_txt, "Hola."
+      ::File.should exist "demo_txt"
+      ::File.unlink "demo_txt"
+    end
+
+    context "the file is inside a non existing directory" do
+      it "should create the directory aswell as the file" do
+        ::File.should_not be_directory "demo"
+        Fast::File.new.append "demo/demo.txt", "Nice content!"
+        ::File.should be_directory "demo"
+        ::File.unlink "demo/demo.txt"
+        ::Dir.unlink "demo"
+      end
+    end
+  end
+  
+
+  shared_examples_for "any deletion" do
+    it "should delete the file" do
+      ::File.open "demo.txt", "w" do |file|
+        file.write "Hola."
+      end
+      
+      Fast::File.new.delete "demo.txt"
+      ::File.should_not exist "demo.txt"
+    end
+    
+    it "should return the path of the deleted file" do
+      ::File.open "demo.txt", "w" do |file|
+        file.write "Hola."
+      end
+      
+      Fast::File.new.delete( "demo.txt" ).should == "demo.txt"
+    end
+    
+    it "should be possible to use a symbol" do
+      ::File.open "demo_txt", "w" do |file|
+        file.write "Hola."
+      end
+      
+      Fast::File.new.delete :demo_txt
+      ::File.should_not exist "demo.txt"
+    end
+  end
+  
+  describe "#delete" do it_behaves_like "any deletion" end
+  describe "#unlink" do it_behaves_like "any deletion" end
+  describe "#del" do it_behaves_like "any deletion" end
+  describe "#destroy" do it_behaves_like "any deletion" end
+  
+  describe "#touch" do
+    context "in current folder" do
+      it "should create the file if it does not exist" do
+        ::File.should_not exist "demo.txt"
+        Fast::File.new.touch "demo.txt"
+        ::File.should exist "demo.txt"
+        ::File.unlink "demo.txt"
+      end
+      
+    end
+    
+    context "the file is inside a directory" do
+      it "should create the file if it does not exist" do
+        ::Dir.mkdir "demo" unless ::File.directory? "demo"
+        ::File.should_not exist "demo/demo.txt"
+        Fast::File.new.touch "demo/demo.txt"
+        ::File.should exist "demo/demo.txt"
+        ::File.unlink "demo/demo.txt"
+        ::Dir.unlink "demo"
+      end
+    end
+    
+    context "the file is inside a non existing directory" do
+      it "should create the directory aswell as the file" do
+        ::File.should_not be_directory "demo"
+        Fast::File.new.touch "demo/demo.txt"
+        ::File.should exist "demo/demo.txt"
+        ::File.unlink "demo/demo.txt"
+        ::Dir.unlink "demo"
+      end
+    end
+    
+    it "should not rise any error if the file already exists" do
+      ::File.open "demo.txt", "w" do |file|
+        file.write "something"
+      end
+      Fast::File.new.touch "demo.txt"
+      ::File.unlink "demo.txt"
+    end
+    
+    it "should change its atime if already exists" do
+      unless OS.windows?
+        ::File.open "demo.txt", "w" do |file|
+          file.write "Some content."
+        end
+        atime = ::File.atime "demo.txt"
+        sleep 1
+        Fast::File.new.touch "demo.txt"
+        ::File.atime( "demo.txt" ).should > atime
+        ::File.unlink "demo.txt"
+      else
+        pending "This is for POSIX only."
+      end
+    end
+
+    it "should be empty if it did not exist" do
+      ::File.should_not exist "demo.txt"
+      Fast::File.new.touch "demo.txt"
+      ::File.read( "demo.txt" ).should == ""
+      ::File.unlink "demo.txt"
+    end
+    
+    it "should return the path to the file" do
+      Fast::File.new.touch( "demo.txt" ).should == "demo.txt"
+      ::File.unlink "demo.txt"
+    end
+    
+    it "should accept a symbol as an argument" do
+      Fast::File.new.touch :demo_txt
+      ::File.unlink "demo_txt"
+    end
+  end  
+end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Xavier Via
@@ -29,6 +29,30 @@ dependencies:
         version: "0"
   type: :runtime
   version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: zucker
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
 description: DSL for file system interaction
 email: 
 - xavierviacanel@gmail.com
@@ -44,8 +68,11 @@ files:
 - Rakefile
 - fast.gemspec
 - lib/fast.rb
+- lib/fast/dir.rb
 - lib/fast/file.rb
 - lib/fast/version.rb
+- spec/fast/dir_spec.rb
+- spec/fast/file_spec.rb
 has_rdoc: true
 homepage: ""
 licenses: []