carrierwave 0.3.2 → 0.3.3

data/cucumber.yml

@@ -0,0 +1,2 @@
+default: --format pretty --no-source
+html: --format html --out features.html

data/features/caching.feature

@@ -0,0 +1,28 @@
+Feature: uploader with file storage
+  In order to be able to temporarily store files to disk
+  As a developer using CarrierWave
+  I want to cache files
+  
+  Scenario: cache a file
+    Given an uploader class that uses the 'file' storage
+    And an instance of that class
+    When I cache the file 'fixtures/bork.txt'
+    Then there should be a file called 'bork.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'bork.txt' in a subdirectory of 'public/uploads/tmp' should be identical to the file at 'fixtures/bork.txt'
+  
+  Scenario: cache two files in succession
+    Given an uploader class that uses the 'file' storage
+    And an instance of that class
+    When I cache the file 'fixtures/bork.txt'
+    Then there should be a file called 'bork.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'bork.txt' in a subdirectory of 'public/uploads/tmp' should be identical to the file at 'fixtures/bork.txt'
+    When I cache the file 'fixtures/monkey.txt'
+    Then there should be a file called 'monkey.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'monkey.txt' in a subdirectory of 'public/uploads/tmp' should be identical to the file at 'fixtures/monkey.txt'
+  
+  Scenario: retrieving a file from cache
+    Given an uploader class that uses the 'file' storage
+    And an instance of that class
+    And the file 'fixtures/bork.txt' is cached file at 'public/uploads/tmp/20090212-2343-8336-0348/bork.txt'
+    When I retrieve the cache name '20090212-2343-8336-0348/bork.txt' from the cache
+    Then the uploader should have 'public/uploads/tmp/20090212-2343-8336-0348/bork.txt' as its current path

data/features/file_storage.feature

@@ -0,0 +1,37 @@
+Feature: uploader with file storage
+  In order to be awesome
+  As a developer using CarrierWave
+  I want to upload files to the filesystem
+  
+  Background:
+    Given an uploader class that uses the 'file' storage
+    And an instance of that class    
+  
+  Scenario: store a file
+    When I store the file 'fixtures/bork.txt'
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+  
+  Scenario: store two files in succession
+    When I store the file 'fixtures/bork.txt'
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+    When I store the file 'fixtures/monkey.txt'
+    Then there should be a file at 'public/uploads/monkey.txt'
+    And the file at 'public/uploads/monkey.txt' should be identical to the file at 'fixtures/monkey.txt'
+  
+  Scenario: cache a file and then store it
+    When I cache the file 'fixtures/bork.txt'
+    Then there should be a file called 'bork.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'bork.txt' in a subdirectory of 'public/uploads/tmp' should be identical to the file at 'fixtures/bork.txt'
+    And there should not be a file at 'public/uploads/bork.txt'
+    When I store the file
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+  
+  Scenario: retrieving a file from cache then storing
+    Given the file 'fixtures/bork.txt' is cached file at 'public/uploads/tmp/20090212-2343-8336-0348/bork.txt'
+    When I retrieve the cache name '20090212-2343-8336-0348/bork.txt' from the cache
+    And I store the file
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'

data/features/file_storage_overridden_filename.feature

@@ -0,0 +1,38 @@
+Feature: uploader with file storage and overriden filename
+  In order to be awesome
+  As a developer using CarrierWave
+  I want to upload files to the filesystem with an overriden filename
+  
+  Background:
+    Given an uploader class that uses the 'file' storage
+    And that the uploader reverses the filename
+    And an instance of that class 
+  
+  Scenario: store a file
+    When I store the file 'fixtures/bork.txt'
+    Then there should be a file at 'public/uploads/txt.krob'
+    And the file at 'public/uploads/txt.krob' should be identical to the file at 'fixtures/bork.txt'
+  
+  Scenario: store two files in succession
+    When I store the file 'fixtures/bork.txt'
+    Then there should be a file at 'public/uploads/txt.krob'
+    And the file at 'public/uploads/txt.krob' should be identical to the file at 'fixtures/bork.txt'
+    When I store the file 'fixtures/monkey.txt'
+    Then there should be a file at 'public/uploads/txt.yeknom'
+    And the file at 'public/uploads/txt.yeknom' should be identical to the file at 'fixtures/monkey.txt'
+  
+  Scenario: cache a file and then store it
+    When I cache the file 'fixtures/bork.txt'
+    Then there should be a file called 'bork.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'bork.txt' in a subdirectory of 'public/uploads/tmp' should be identical to the file at 'fixtures/bork.txt'
+    And there should not be a file at 'public/uploads/txt.krob'
+    When I store the file
+    Then there should be a file at 'public/uploads/txt.krob'
+    And the file at 'public/uploads/txt.krob' should be identical to the file at 'fixtures/bork.txt'
+  
+  Scenario: retrieving a file from cache then storing
+    Given the file 'fixtures/bork.txt' is cached file at 'public/uploads/tmp/20090212-2343-8336-0348/bork.txt'
+    When I retrieve the cache name '20090212-2343-8336-0348/bork.txt' from the cache
+    And I store the file
+    Then there should be a file at 'public/uploads/txt.krob'
+    And the file at 'public/uploads/txt.krob' should be identical to the file at 'fixtures/bork.txt'

data/features/file_storage_overridden_store_dir.feature

@@ -0,0 +1,38 @@
+Feature: uploader with file storage and overridden store dir
+  In order to be awesome
+  As a developer using CarrierWave
+  I want to upload files to the filesystem
+  
+  Background:
+    Given an uploader class that uses the 'file' storage
+    And that the uploader has the store_dir overridden to 'public/monkey/llama'
+    And an instance of that class    
+  
+  Scenario: store a file
+    When I store the file 'fixtures/bork.txt'
+    Then there should be a file at 'public/monkey/llama/bork.txt'
+    And the file at 'public/monkey/llama/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+  
+  Scenario: store two files in succession
+    When I store the file 'fixtures/bork.txt'
+    Then there should be a file at 'public/monkey/llama/bork.txt'
+    And the file at 'public/monkey/llama/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+    When I store the file 'fixtures/monkey.txt'
+    Then there should be a file at 'public/monkey/llama/monkey.txt'
+    And the file at 'public/monkey/llama/monkey.txt' should be identical to the file at 'fixtures/monkey.txt'
+  
+  Scenario: cache a file and then store it
+    When I cache the file 'fixtures/bork.txt'
+    Then there should be a file called 'bork.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'bork.txt' in a subdirectory of 'public/uploads/tmp' should be identical to the file at 'fixtures/bork.txt'
+    And there should not be a file at 'public/monkey/llama/bork.txt'
+    When I store the file
+    Then there should be a file at 'public/monkey/llama/bork.txt'
+    And the file at 'public/monkey/llama/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+  
+  Scenario: retrieving a file from cache then storing
+    Given the file 'fixtures/bork.txt' is cached file at 'public/uploads/tmp/20090212-2343-8336-0348/bork.txt'
+    When I retrieve the cache name '20090212-2343-8336-0348/bork.txt' from the cache
+    And I store the file
+    Then there should be a file at 'public/monkey/llama/bork.txt'
+    And the file at 'public/monkey/llama/bork.txt' should be identical to the file at 'fixtures/bork.txt'

data/features/file_storage_reversing_processor.feature

@@ -0,0 +1,43 @@
+Feature: uploader with file storage and a processor that reverses the file
+  In order to be awesome
+  As a developer using CarrierWave
+  I want to upload files to the filesystem
+  
+  Background:
+    Given an uploader class that uses the 'file' storage
+    And an instance of that class
+    And the class has a method called 'reverse' that reverses the contents of a file 
+    And the class will process 'reverse'
+  
+  Scenario: store a file
+    When I store the file 'fixtures/bork.txt'
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should not be identical to the file at 'fixtures/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be the reverse of the file at 'fixtures/bork.txt'
+  
+  Scenario: store two files in succession
+    When I store the file 'fixtures/bork.txt'
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should not be identical to the file at 'fixtures/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be the reverse of the file at 'fixtures/bork.txt'
+    When I store the file 'fixtures/monkey.txt'
+    Then there should be a file at 'public/uploads/monkey.txt'
+    And the file at 'public/uploads/monkey.txt' should not be identical to the file at 'fixtures/monkey.txt'
+    And the file at 'public/uploads/monkey.txt' should be the reverse of the file at 'fixtures/monkey.txt'
+  
+  Scenario: cache a file and then store it
+    When I cache the file 'fixtures/bork.txt'
+    Then there should be a file called 'bork.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'bork.txt' in a subdirectory of 'public/uploads/tmp' should not be identical to the file at 'fixtures/bork.txt'
+    And there should not be a file at 'public/uploads/bork.txt'
+    When I store the file
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should not be identical to the file at 'fixtures/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be the reverse of the file at 'fixtures/bork.txt'
+  
+  Scenario: retrieving a file from cache then storing
+    Given the file 'fixtures/bork.txt' is cached file at 'public/uploads/tmp/20090212-2343-8336-0348/bork.txt'
+    When I retrieve the cache name '20090212-2343-8336-0348/bork.txt' from the cache
+    And I store the file
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'

data/features/fixtures/bork.txt

@@ -0,0 +1 @@
+this is a file

data/features/fixtures/monkey.txt

@@ -0,0 +1 @@
+this is another file

data/features/mount_activerecord.feature

@@ -0,0 +1,46 @@
+Feature: Mount an Uploader on ActiveRecord class
+  In order to easily attach files to a form
+  As a web developer using CarrierWave
+  I want to mount an uploader on an ActiveRecord class
+
+  Background:
+    Given an uploader class that uses the 'file' storage
+    And an activerecord class that uses the 'users' table
+    And the uploader class is mounted on the 'avatar' column
+    And an instance of the activerecord class
+
+  Scenario: assign a file
+    When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+    Then there should be a file called 'bork.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'bork.txt' in a subdirectory of 'public/uploads/tmp' should be identical to the file at 'fixtures/bork.txt'
+
+  Scenario: assign a file and save the record
+    When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+    And I save the active record
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+    And the url for the column 'avatar' should be '/uploads/bork.txt'
+
+  Scenario: assign a file and retrieve it from cache
+    When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+    And I retrieve the file later from the cache name for the column 'avatar'
+    And I save the active record
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+    And the url for the column 'avatar' should be '/uploads/bork.txt'
+
+  Scenario: store a file and retrieve it later
+    When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+    And I retrieve the file later from the cache name for the column 'avatar'
+    And I save the active record
+    Then there should be a file at 'public/uploads/bork.txt'
+    When I reload the active record
+    Then the url for the column 'avatar' should be '/uploads/bork.txt'
+
+  Scenario: store a file and delete the record
+    When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+    And I retrieve the file later from the cache name for the column 'avatar'
+    And I save the active record
+    Then there should be a file at 'public/uploads/bork.txt'
+    When I delete the active record
+    Then there should not be a file at 'public/uploads/bork.txt'

data/features/mount_datamapper.feature

@@ -0,0 +1,46 @@
+Feature: Mount an Uploader on ActiveRecord class
+  In order to easily attach files to a form
+  As a web developer using CarrierWave
+  I want to mount an uploader on an ActiveRecord class
+
+  Background:
+    Given an uploader class that uses the 'file' storage
+    And a datamapper class that has a 'avatar' column
+    And the uploader class is mounted on the 'avatar' column
+    And an instance of the datamapper class
+
+  Scenario: assign a file
+    When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+    Then there should be a file called 'bork.txt' somewhere in a subdirectory of 'public/uploads/tmp'
+    And the file called 'bork.txt' in a subdirectory of 'public/uploads/tmp' should be identical to the file at 'fixtures/bork.txt'
+
+  Scenario: assign a file and save the record
+    When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+    And I save the datamapper record
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+    And the url for the column 'avatar' should be '/uploads/bork.txt'
+
+  Scenario: assign a file and retrieve it from cache
+    When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+    And I retrieve the file later from the cache name for the column 'avatar'
+    And I save the datamapper record
+    Then there should be a file at 'public/uploads/bork.txt'
+    And the file at 'public/uploads/bork.txt' should be identical to the file at 'fixtures/bork.txt'
+    And the url for the column 'avatar' should be '/uploads/bork.txt'
+
+  # Scenario: store a file and retrieve it later
+  #   When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+  #   And I retrieve the file later from the cache name for the column 'avatar'
+  #   And I save the datamapper record
+  #   Then there should be a file at 'public/uploads/bork.txt'
+  #   When I reload the datamapper record
+  #   Then the url for the column 'avatar' should be '/uploads/bork.txt'
+  # 
+  # Scenario: store a file and delete the record
+  #   When I assign the file 'fixtures/bork.txt' to the 'avatar' column
+  #   And I retrieve the file later from the cache name for the column 'avatar'
+  #   And I save the datamapper record
+  #   Then there should be a file at 'public/uploads/bork.txt'
+  #   When I delete the datamapper record
+  #   Then there should not be a file at 'public/uploads/bork.txt'

data/features/step_definitions/activerecord_steps.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+
+Given /^an activerecord class that uses the '([^\']*)' table$/ do |name|
+  @mountee_klass = Class.new(ActiveRecord::Base)
+  @mountee_klass.table_name = name
+end
+
+Given /^an instance of the activerecord class$/ do
+  @instance = @mountee_klass.new
+end
+
+When /^I save the active record$/ do
+  @instance.save!
+end
+
+When /^I reload the active record$/ do
+  @instance = @instance.class.find(@instance.id)
+end
+
+When /^I delete the active record$/ do
+  @instance.destroy
+end

data/features/step_definitions/caching_steps.rb

@@ -0,0 +1,14 @@
+# encoding: utf-8
+
+Given /^the file '(.*?)' is cached file at '(.*?)'$/ do |file, cached|
+  FileUtils.mkdir_p(File.dirname(file_path(cached)))
+  FileUtils.cp(file_path(file), file_path(cached))
+end
+
+When /^I cache the file '(.*?)'$/ do |file|
+  @uploader.cache!(File.open(file_path(file)))
+end
+
+When /^I retrieve the cache name '(.*?)' from the cache$/ do |name|
+  @uploader.retrieve_from_cache!(name)
+end

data/features/step_definitions/datamapper_steps.rb

@@ -0,0 +1,29 @@
+# encoding: utf-8
+
+Given /^a datamapper class that has a '([^\']*)' column$/ do |column|
+  @mountee_klass = Class.new do
+    include DataMapper::Resource
+
+    storage_names[:default] = 'users'
+    
+    property :id, Integer, :key => true
+    property column.to_sym, String
+  end
+  @mountee_klass.auto_migrate!
+end
+
+Given /^an instance of the datamapper class$/ do
+  @instance = @mountee_klass.new
+end
+
+When /^I save the datamapper record$/ do
+  @instance.save
+end
+
+When /^I reload the datamapper record$/ do
+  @instance = @instance.class.first(:id => @instance.key)
+end
+
+When /^I delete the datamapper record$/ do
+  @instance.destroy
+end

data/features/step_definitions/file_steps.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+
+###
+# EXISTENCE
+
+Then /^there should be a file at '(.*?)'$/ do |file|
+  File.exist?(file_path(file)).should be_true
+end
+
+Then /^there should not be a file at '(.*?)'$/ do |file|
+  File.exist?(file_path(file)).should be_false
+end
+
+Then /^there should be a file called '(.*?)' somewhere in a subdirectory of '(.*?)'$/ do |file, directory|
+  Dir.glob(File.join(file_path(directory), '**', file)).any?.should be_true
+end
+
+###
+# IDENTICAL
+
+Then /^the file at '(.*?)' should be identical to the file at '(.*?)'$/ do |one, two|
+  File.read(file_path(one)).should == File.read(file_path(two))
+end
+
+Then /^the file at '(.*?)' should not be identical to the file at '(.*?)'$/ do |one, two|
+  File.read(file_path(one)).should_not == File.read(file_path(two))
+end
+
+Then /^the file called '(.*?)' in a subdirectory of '(.*?)' should be identical to the file at '(.*?)'$/ do |file, directory, other|
+  File.read(Dir.glob(File.join(file_path(directory), '**', file)).first).should == File.read(file_path(other))
+end
+
+Then /^the file called '(.*?)' in a subdirectory of '(.*?)' should not be identical to the file at '(.*?)'$/ do |file, directory, other|
+  File.read(Dir.glob(File.join(file_path(directory), '**', file)).first).should_not == File.read(file_path(other))
+end
+
+###
+# REVERSING
+
+Then /^the file at '(.*?)' should be the reverse of the file at '(.*?)'$/ do |one, two|
+  File.read(file_path(one)).should == File.read(file_path(two)).reverse
+end

data/features/step_definitions/general_steps.rb

@@ -0,0 +1,80 @@
+# encoding: utf-8
+
+Given /^an uploader class that uses the 'file' storage$/ do
+  @klass = Class.new(CarrierWave::Uploader::Base)
+end
+
+Given /^an instance of that class$/ do
+  @uploader = @klass.new
+end
+
+Given /^that the uploader reverses the filename$/ do
+  @klass.class_eval do
+    def filename
+      super.reverse unless super.blank?
+    end
+  end
+end
+
+Given /^that the uploader has the filename overridden to '(.*?)'$/ do |filename|
+  @klass.class_eval do
+    define_method(:filename) do
+      filename
+    end
+  end
+end
+
+Given /^that the uploader has the store_dir overridden to '(.*?)'$/ do |store_dir|
+  @klass.class_eval do
+    define_method(:store_dir) do
+      file_path(store_dir)
+    end
+  end
+end
+
+Given /^that the version '(.*?)' has the store_dir overridden to '(.*?)'$/ do |version, store_dir|
+  @klass.versions[version.to_sym].class_eval do
+    define_method(:store_dir) do
+      file_path(store_dir)
+    end
+  end
+end
+
+Given /^that the uploader class has a version named '(.*?)'$/ do |name|
+  @klass.version(name)
+end
+
+Given /^yo dawg, I put a version called '(.*?)' in your version called '(.*?)'$/ do |v2, v1|
+  @klass.version(v1) do
+    version(v2)
+  end
+end
+
+Given /^the class has a method called 'reverse' that reverses the contents of a file$/ do
+  @klass.class_eval do
+    def reverse
+      text = File.read(current_path)
+      File.open(current_path, 'w') { |f| f.write(text.reverse) }
+    end
+  end
+end
+
+Given /^the class will process '([a-zA-Z0-9\_\?!]*)'$/ do |name|
+  @klass.process name.to_sym
+end
+
+Then /^the uploader should have '(.*?)' as its current path$/ do |path|
+  @uploader.current_path.should == file_path(path)
+end
+
+Then /^the uploader should have the url '(.*?)'$/ do |url|
+  @uploader.url.should == url
+end
+
+Then /^the uploader's version '(.*?)' should have the url '(.*?)'$/ do |version, url|
+  @uploader.versions[version.to_sym].url.should == url
+end
+
+Then /^the uploader's nested version '(.*?)' nested in '(.*?)' should have the url '(.*?)'$/ do |v2, v1, url|
+  @uploader.versions[v1.to_sym].versions[v2.to_sym].url.should == url
+end