filetesthelper 1.0.0 → 1.0.1

data/README.rdoc

@@ -0,0 +1,43 @@
+= FileTestHelper
+
+A simple helper aimed at reducing the setup effort needed to create directories, files and file content in the scope of an integration test case.
+
+== Installation
+  sudo gem install filetesthelper
+  
+== Usage
+  
+  require 'rubygems'
+  require 'filetesthelper'
+  include FileTestHelper
+
+  ...
+  
+  def test_some_code_that_needs_to_manipulate_some_files
+    #Let's say that the current directory here is X
+    
+    with_files('dir1/file1' => 'this is file1 content', 'dir1/file2' => 'this is file2 content') do
+      #Now the current directory changed to Y which is a new directory
+      #created under Dir.tmpdir containing only 'dir1/file1' and 'dir1/file2'.
+
+      #Put some test code here.
+    end
+    
+    #When we finish we are back at directory X and the Y directory is deleted with all its contents
+  end
+
+  def test_some_code_that_uses_a_base_directory_other_than_the_temp_dir
+    #Let's say that the current directory here is X
+    
+    with_files_in_directory('existent_dir', 'dir1/file1' => 'this is file1 content', 'dir1/file2' => 'this is file2 content') do
+      #Now the current directory changed to existent_dir which is some existent directory under your system, absolute paths are allowed.
+      #The directory contents are 'dir1/file1' and 'dir1/file2' plus anything that existed previously.
+
+      #Put some test code here.
+    end
+    
+    #When we finish we are back at directory X and the existent_dir directory has our two test files removed
+  end
+
+See the {specs}[http://filetesthelper.rubyforge.org/specs.html] and the {Rubyforge project homepage}[http://rubyforge.org/projects/filetesthelper] for more details.
+

data/Rakefile.rb

@@ -1,3 +1,4 @@
+# coding: utf-8
 require 'rubygems'
 require 'rubygems/gem_runner'
 require 'rake'
@@ -5,55 +6,26 @@ require "rake/clean"
 require 'rake/rdoctask'
 require 'rake/gempackagetask'
 require 'spec/rake/spectask'
-
-NAME = 'filetesthelper'
-PKGVERSION = '1.0.0'
-is_windows = (PLATFORM =~ /win32|cygwin/)
-SUDO = is_windows ? '' : 'sudo'
-README = "README.txt"
-
-
-##############################################################################
-# Packaging & Installation
-##############################################################################
-
-CLEAN.include ["pkg", "coverage", "doc"]
-
-spec = Gem::Specification.new do |s| 
-  s.name = NAME
-  s.version = PKGVERSION
-  s.author = "Daniel Cadenas Ni�n"
-  s.email = "filetesthelper-devel@rubyforge.org"
-  s.homepage = "http://rubyforge.org/projects/filetesthelper/"
-  s.platform = Gem::Platform::RUBY
-  s.summary = "A simple helper aimed at reducing the setup effort needed to create directories, files and file content in integration test cases."
-  s.description = s.summary
-  s.files = Dir["{spec,lib}/**/*"] + [README, "Rakefile.rb"]
-  s.has_rdoc = true
-  s.extra_rdoc_files = [README]
-  s.require_path = 'lib'
-  s.autorequire = NAME
-#  s.require_paths << ['lib']
+ 
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "filetesthelper"
+    gemspec.summary = "A simple helper aimed at reducing the setup effort needed to create directories, files and file content in integration test cases."
+    gemspec.email = "dcadenas@gmail.com"
+    gemspec.homepage = "http://rubyforge.org/projects/filetesthelper/"
+    gemspec.description = gemspec.summary
+    gemspec.authors = ["Daniel Cadenas Nión"]
+    gemspec.version = '1.0.1'
+    gemspec.platform = Gem::Platform::RUBY
+  #gemspec.files = Dir["{spec,lib}/**/*"] + [README, "Rakefile.rb"]
+    gemspec.require_path = 'lib'
+    gemspec.autorequire = gemspec.name
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
 end
 
-Rake::GemPackageTask.new(spec) do |pkg| 
-  pkg.gem_spec = spec
-end 
-
-desc "Run :package and install the resulting .gem"
-task :install => [:clean, :specs_with_rcov, :rdoc, :package] do
-  Gem::GemRunner.new.run(['install', "pkg/#{NAME}-#{PKGVERSION}.gem", '--no-rdoc', '--no-ri'])
-end
-
-desc "Run :clean and uninstall the .gem"
-task :uninstall => :clean do
-  Gem::GemRunner.new.run(['uninstall', NAME])
-end
-
-
-##############################################################################
-# rSpec & rcov
-##############################################################################
 
 Spec::Rake::SpecTask.new('specs_with_rcov') do |t|
   t.ruby_opts << '-rubygems'
@@ -63,16 +35,4 @@ Spec::Rake::SpecTask.new('specs_with_rcov') do |t|
   t.rcov_opts = ['--text-summary']
 end
 
-
-##############################################################################
-# Documentation
-##############################################################################
-
-Rake::RDocTask.new(:rdoc) do |rd|  
-  rd.rdoc_files = [README] + Dir['lib/**/*']
-  rd.rdoc_dir = 'doc' 
-  rd.title    = NAME
-  rd.options << "-SNm#{README}"
-end
-
-task :default => [:specs_with_rcov, :rdoc]
+task :default => [:specs_with_rcov]

data/VERSION.yml

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

data/filetesthelper.gemspec

@@ -0,0 +1,49 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile.rb, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{filetesthelper}
+  s.version = "1.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Daniel Cadenas Ni\303\263n"]
+  s.autorequire = %q{filetesthelper}
+  s.date = %q{2010-08-24}
+  s.description = %q{A simple helper aimed at reducing the setup effort needed to create directories, files and file content in integration test cases.}
+  s.email = %q{dcadenas@gmail.com}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    "README.rdoc",
+     "Rakefile.rb",
+     "VERSION.yml",
+     "filetesthelper.gemspec",
+     "lib/file_test_helper.rb",
+     "spec/file_test_helper_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://rubyforge.org/projects/filetesthelper/}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{A simple helper aimed at reducing the setup effort needed to create directories, files and file content in integration test cases.}
+  s.test_files = [
+    "spec/file_test_helper_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/lib/file_test_helper.rb

@@ -0,0 +1,81 @@
+require 'tmpdir'
+
+module FileTestHelper
+  include FileUtils
+
+  #Specify the files you need to create in a hash.
+  #The keys of the hash represent the file path and the value represents it's content.
+  #Examples:
+  #* {'a dir/a file' => 'content'} creates the 'a dir' directory containing an 'a file' file which content is 'content'.
+  #* {'another dir/' => ''} creates an empty 'another dir' directory. The value must be an empty string.
+  #Optionally you can specify a different base directory (other than the default tmp) to use as a base directory.
+  #Example:
+  #* 'stylesheets', 'file.txt' => "" will create the file.txt file inside the existent stylesheets directory. The stylesheets directory won't be deleted
+  def with_files(files_with_contents = {})
+    with_files_in_directory(nil, files_with_contents) do
+      yield
+    end
+  end
+
+  def with_files_in_directory(base_dir, files_with_contents)
+    initial_directory = current_directory
+    raise ArgumentError, "The base directory '#{base_dir}' does not exist." if base_dir && !File.exist?(base_dir)
+    working_directory = base_dir || create_working_directory
+
+    begin
+      create_files_in_working_directory(working_directory, files_with_contents)
+      yield
+    ensure
+      cd initial_directory
+      if base_dir.nil?
+        remove_dir(working_directory) if File.exist?(working_directory)
+      else
+        remove_files(base_dir, files_with_contents)
+      end
+    end
+  end
+
+  private
+  def current_directory
+    Dir.pwd
+  end
+
+  def create_working_directory
+    working_directory = File.join(Dir.tmpdir, "__test_dir__#{Process.pid}")
+    mkpath(working_directory)
+    return working_directory 
+  end
+
+  def create_files_in_working_directory(working_directory, files_with_contents)
+    cd working_directory
+
+    return unless files_with_contents
+    files_with_contents.each do |path, file_contents|
+      raise ArgumentError, 'A path is not allowed to start with /' if path =~ /^\//
+      raise ArgumentError, 'A path is not allowed to contain ..' if path =~ /\.\./
+
+      dir, file = path.scan(/(.*[\/])?([^\/]*$)/)[0] 
+      mkpath dir unless(dir.nil? or dir.empty?)
+
+      unless(file.nil? or file.empty?)
+        File.open(path, 'w') do |f|
+          f << file_contents unless file_contents == nil
+        end
+      else
+        raise ArgumentError, 'File content can only be set to files' unless file_contents.nil? or file_contents.empty?
+      end
+    end    
+  end
+
+  def remove_files(base_dir, files_with_contents)
+    initial_dir = Dir.pwd
+    cd base_dir
+    begin
+      files_with_contents.each do |path, file_contents|
+        remove_dir(path.split(File::SEPARATOR).first)
+      end
+    ensure
+      cd initial_dir
+    end
+  end
+end

data/spec/file_test_helper_spec.rb

@@ -0,0 +1,123 @@
+require File.dirname(__FILE__) + "/spec_helper"
+require 'rubygems'
+require 'spec'
+require 'file_test_helper'
+include FileTestHelper
+
+describe FileTestHelper do
+  parameters = {
+    'nil' => nil,
+    'an empty hash' => {},
+    'a hash with only one file' => {'file.txt' => 'file content'}
+  }
+
+  parameters.each do |parameter_name, parameter|
+    describe "when the hash paramater is #{parameter_name}" do
+      it 'should execute the block parameter' do
+        block_runned = false
+        with_files(parameter) {block_runned = true}
+        block_runned.should be_true
+      end
+
+      it 'should not use the current directory' do
+        initial_directory = Dir.pwd
+        with_files(parameter) do
+          Dir.pwd.should_not == initial_directory
+        end
+        Dir.pwd.should == initial_directory
+      end
+
+      it 'should start in an empty working directory' do
+        with_files(parameter) do
+          Dir.glob('**/*').size == 0
+        end
+      end
+
+      it 'should delete the working directory and its contents after running the block' do
+        working_directory_path = ''
+        with_files(parameter) do
+          working_directory_path = Dir.pwd
+        end
+        working_directory_path.should_not be_empty
+        File.exist?(working_directory_path).should be_false
+      end
+    end
+  end
+
+  it 'should create the files and directories that were specified in a hash' do
+    files_to_create = {'a directory/a file.txt' => '', 'a directory/another file.rb' => '', 'an_empty_directory/' => '', 'a_file' => ''}
+    with_files(files_to_create) do
+      files_to_create.each_key{|created_file| File.exist?(created_file).should be_true}
+    end
+  end
+
+  it 'should be possible to define the content of created files' do
+    with_files('filea' => 'content of filea', 'fileb' => 'content of fileb') do
+      File.read('filea').should == 'content of filea'
+      File.read('fileb').should == 'content of fileb'
+    end
+  end
+
+  it 'should interpret a path with an ending / as a directory' do
+    with_files('this is a directory/another dir/' => '') do
+      File.directory?('this is a directory/another dir').should be_true
+    end    
+  end
+
+  it 'should throw an error if trying to set file content to a directory' do
+    lambda { with_files('directory/' => 'imposible content, directories are not files') {}}.should raise_error
+  end
+
+  it 'should throw an error if a path which starts with the "/" character is specified' do
+    lambda { with_files('/directory/filea' => 'content of filea') {}}.should raise_error
+  end
+
+  it 'should throw an error if a path uses ".."' do
+    lambda { with_files('../../dir/filea' => 'content of filea') {}}.should raise_error
+  end
+
+  it 'should not throw an exception when the hash parameter is nil' do
+    lambda { with_files(nil) {}}.should_not raise_error
+  end
+
+  describe "with base_dir" do
+    it "should use the specified base dir instead of the default tmp dir" do
+      initial_directory = Dir.pwd
+      with_files_in_directory(initial_directory, 'somefile.txt' => '') do
+        Dir.pwd.should == initial_directory
+      end
+      Dir.pwd.should == initial_directory
+    end
+
+    it "should not delete the base dir" do
+      base_dir = FileUtils.mkpath("delete_this_dir")
+      begin
+        with_files_in_directory(base_dir, 'somefile.txt' => '') {}
+        File.exist?(base_dir).should be_true
+      ensure
+        FileUtils.remove_dir(base_dir)
+      end
+    end
+
+    it "should delete only the created files" do
+      test_file = 'should_persist_after_test.txt'
+      begin
+        `touch #{test_file}`
+        with_files_in_directory(Dir.pwd, 'dir/somefile.txt' => '', 'anotherfile.txt' => '') {}
+
+        File.exist?('dir/somefile.txt').should be_false
+        File.exist?('anotherfile.txt').should be_false
+        File.exist?('dir').should be_false
+        File.exist?(test_file).should be_true
+      ensure
+        File.delete(test_file)
+      end
+    end
+
+    it "should throw an exception if the specified base dir doesn't exist" do
+      lambda{
+        with_files_in_directory('this_dir_does_not_exist', 'somefile.txt' => '') {}
+      }.should raise_error(ArgumentError)
+    end
+  end
+end

data/spec/spec.opts

@@ -1,6 +1,7 @@
---colour
---format
-profile
+--format
+specdoc
+--format
+html:specs.html
 --timeout
 20
 --diff

metadata

@@ -1,58 +1,75 @@
 --- !ruby/object:Gem::Specification 
 name: filetesthelper
 version: !ruby/object:Gem::Version 
-  version: 1.0.0
+  hash: 21
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 1
+  version: 1.0.1
 platform: ruby
 authors: 
-- "Daniel Cadenas Ni\xF3n"
+- "Daniel Cadenas Ni\xC3\xB3n"
 autorequire: filetesthelper
 bindir: bin
 cert_chain: []
 
-date: 2008-03-08 00:00:00 -02:00
+date: 2010-08-24 00:00:00 -03:00
 default_executable: 
 dependencies: []
 
 description: A simple helper aimed at reducing the setup effort needed to create directories, files and file content in integration test cases.
-email: filetesthelper-devel@rubyforge.org
+email: dcadenas@gmail.com
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- README.txt
+- README.rdoc
 files: 
-- spec/FileTestHelper_spec.rb
+- README.rdoc
+- Rakefile.rb
+- VERSION.yml
+- filetesthelper.gemspec
+- lib/file_test_helper.rb
+- spec/file_test_helper_spec.rb
 - spec/spec.opts
 - spec/spec_helper.rb
-- lib/filetesthelper.rb
-- README.txt
-- Rakefile.rb
 has_rdoc: true
 homepage: http://rubyforge.org/projects/filetesthelper/
-post_install_message: 
-rdoc_options: []
+licenses: []
 
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.0.1
+rubygems_version: 1.3.7
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: A simple helper aimed at reducing the setup effort needed to create directories, files and file content in integration test cases.
-test_files: []
-
+test_files: 
+- spec/file_test_helper_spec.rb
+- spec/spec_helper.rb

data/README.txt

@@ -1,27 +0,0 @@
-= FileTestHelper
-
-A simple helper aimed at reducing the setup effort needed to create directories, files and file content in the scope of an integration test case.
-
-== Example
-  
-  require 'rubygems'
-  require 'filetesthelper'
-  include FileTestHelper
-
-  ...
-  
-  def test_some_code_that_uses_the_file_system
-    #Let's say that the current directory here is X
-    
-    with_files('dir1/file1' => 'this is file1 content', 'dir1/file2' => 'this is file2 content') do
-      #Now the current directory changed to Y which is a new directory
-      #created under Dir.tmpdir containing only 'dir1/file1' and 'dir1/file2'.
-
-      #Put some test code here.
-    end
-    
-    #When we finish we are back at directory X and the Y directory is deleted with all its contents
-  end
-
-See the specs for more details.
-

data/lib/filetesthelper.rb

@@ -1,55 +0,0 @@
-require 'tmpdir'
-
-module FileTestHelper
-  include FileUtils
-  
-  #Specify the files you need to create in a hash.
-  #The keys of the hash represent the file path and the value represents it's content.
-  #Examples:
-  #* {'a dir/a file' => 'content'} creates the 'a dir' directory containing an 'a file' file which content is 'content'.
-  #* {'another dir/' => ''} creates an empty 'another dir' directory. The value must be an empty string.
-  def with_files(files_with_contents = {})
-    begin
-      initial_directory = current_directory()
-      working_directory = create_working_directory()
-      create_files_in_working_directory(working_directory, files_with_contents)
-      yield
-    ensure
-      cd initial_directory
-      remove_dir(working_directory) if File.exist?(working_directory)
-    end
-  end
-
-  private
-  def current_directory
-    Dir.pwd
-  end
-  
-  def create_working_directory
-    process_id = $$
-    working_directory = File.join(Dir.tmpdir, "__test_dir__#{process_id}")
-    mkpath working_directory
-    return working_directory 
-  end
-  
-  def create_files_in_working_directory(working_directory, files_with_contents)
-    cd working_directory
-    files_with_contents.each do |path, file_contents|
-      fail 'A path is not allowed to start with /' if path =~ /^\//
-      fail 'A path is not allowed to contain ..' if path =~ /\.\./
-      
-      dir, file = path.scan(/(.*[\/])?([^\/]*$)/)[0] 
-      unless(dir.nil? or dir.empty?)
-        mkpath dir
-      end
-      
-      unless(file.nil? or file.empty?)
-        File.open(path, 'w') do |f|
-          f << file_contents unless file_contents == nil
-        end
-      else
-        fail 'File content can only be set to files' unless file_contents.nil? or file_contents.empty?
-      end
-    end    
-  end
-end

data/spec/FileTestHelper_spec.rb

@@ -1,62 +0,0 @@
-require File.dirname(__FILE__) + "/spec_helper"
-require 'rubygems'
-require 'spec'
-require 'filetesthelper'
-include FileTestHelper
-
-describe FileTestHelper do
-  it 'should start in an empty working directory' do
-    with_files() do
-      Dir.glob('**/*').size == 0
-    end
-  end
-  
-  it 'should not use the current directory as default' do
-    initial_directory = Dir.pwd
-    with_files() do
-      Dir.pwd.should_not == initial_directory
-    end
-    Dir.pwd.should == initial_directory
-  end
-  
-  it 'should delete the working directory and its contents after use' do
-    working_directory_path = ''
-    with_files() do
-      working_directory_path = Dir.pwd
-    end
-    working_directory_path.should_not be_empty
-    File.exist?(working_directory_path).should be_false
-  end
-  
-  it 'should create the files and directories that were specified in a hash' do
-    files_to_create = {'a directory/a file.txt' => '', 'a directory/another file.rb' => '', 'an_empty_directory/' => '', 'a_file' => ''}
-    with_files(files_to_create) do
-      files_to_create.each_key{|created_file| File.exist?(created_file).should be_true}
-    end
-  end
-  
-  it 'should be possible to define the content of created files' do
-    with_files('filea' => 'content of filea', 'fileb' => 'content of fileb') do
-      File.read('filea').should == 'content of filea'
-      File.read('fileb').should == 'content of fileb'
-    end
-  end
-  
-  it 'should interpret a path with an ending / as a directory' do
-    with_files('this is a directory/another dir/' => '') do
-      File.directory?('this is a directory/another dir').should be_true
-    end    
-  end
-
-  it 'should throw an error if trying to set file content to a directory' do
-    lambda { with_files('directory/' => 'imposible content, directories are not files') {}}.should raise_error
-  end
-  
-  it 'should throw an error if a path which starts with the "/" character is specified' do
-    lambda { with_files('/directory/filea' => 'content of filea') {}}.should raise_error
-  end
-  
-  it 'should throw an error if a path uses ".."' do
-    lambda { with_files('../../dir/filea' => 'content of filea') {}}.should raise_error
-  end
-end