nozzle 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 574bb2f5aafe5e663ec50b3237cacef48010aeab
+  data.tar.gz: 0b66db6e1d494592209504e2fdd92c94c07ffa83
+SHA512:
+  metadata.gz: a8054882ea0598df4fefabf947fdb5d512ff6d9d135a76c1ecd734fb92f70440a0eb223ca719a11f182df019a43cfbd44615ee2e9cf085244a863a5bc15d0c97
+  data.tar.gz: 7489babd43a467689511eea8d175dfab7107e44b0af0236e5d4efd0da480427b159992df58f732016b42726eb62474aa861963e62083ca2970d7021b6eb789ca

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.rbx
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in nozzle.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 ujifgc
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,32 @@
+[![Build Status](https://travis-ci.org/ujifgc/nozzle.png)](https://travis-ci.org/ujifgc/nozzle)
+[![Code Climate](https://codeclimate.com/github/ujifgc/nozzle.png)](https://codeclimate.com/github/ujifgc/nozzle)
+
+# Nozzle
+
+A gem to store and serve attachments for ruby rack applications
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'nozzle'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install nozzle
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end
+
+task :default => :test

data/lib/nozzle/adapter/base.rb

@@ -0,0 +1,246 @@
+require 'fileutils'
+require 'tempfile'
+require 'nozzle/adapter/outlet'
+
+module Nozzle
+  module Adapter
+    class Base
+      include Nozzle::Adapter::Outlet
+
+      # Initializes internal structure of new adapter.
+      #   outlet_class.new( instance, :avatar, 'image.jpg', :fake => true )
+      def initialize( record, column, filename, options = {} )
+        @record = record
+        @model = record.class
+        @column = column.to_sym
+        @filename = filename
+        settings.merge! options
+      end
+
+      # Sets or gets settings provided by options.
+      #   if instance.avatar.settings[:fake]
+      #     instance.avatar.settings[:fake] = false
+      #   end
+      def settings
+        @settings ||= {}
+      end
+
+      # Constructs an URL which relatively points to the file.
+      #   instance.avatar.url # => '/uploads/Model/avatar/image.jpg'
+      # How it's constructed:
+      #   "#{public_path}/#{filename}"
+      #   "/#{adapter_folder}/#{relative_folder}/#{filename}"
+      #   "/uploads/#{@model}/#{@column}/#{filename}"
+      #   "/uploads/Model/avatar/image.jpg"
+      # Note: if filename is not yet stored, +default_url+ is called.
+      def url
+        File.join '', public_path, filename
+      rescue TypeError
+        default_url
+      end
+
+      # Constructs a filesustem path which absolutely points to stored file.
+      #   instance.avatar.path # => 'public/uploads/Model/avatar/image.jpg'
+      # How it's constructed:
+      #   "/#{system_path}/#{filename}"
+      #   "/#{adapter_path}/#{relative_folder}/#{filename}"
+      #   "#{root}/#{adapter_folder}/#{@model}/#{@column}/#{filename}"
+      #   "public/uploads/#{@model}/#{@column}/#{filename}"
+      #   "public/uploads/Model/avatar/image.jpg"
+      # Note: if filename is not yet stored, nil is returned.
+      def path
+        File.join system_path, filename
+      rescue TypeError
+        nil
+      end
+
+      # Returns intermediate path to the tempfile if the record is not yet
+      # saved and file is not yet stored at path.
+      def access_path
+        @tempfile_path || path
+      end
+
+      # Returns file content_type stored in avatar_content_type column
+      # of the record.
+      def content_type
+        @record.send( :"#{@column}_content_type" )  rescue ''
+      end
+
+      # Returns file size stored in avatar_size column of the record.
+      def size
+        @record.send( :"#{@column}_size" )  rescue -1
+      end
+
+      # Returns stored filename.
+      #   instance.avatar.filename # => 'image.jpg'
+      def filename
+        @filename
+      end
+
+      # Returns nil.
+      # This SHOULD be overridden by subclasses of Nozzle::Adapter::Base.
+      #   instance.avatar.default_url # => nil
+      def default_url
+        nil
+      end
+
+      # Returns root path of application's static assets.
+      #   instance.avatar.root # => 'public'
+      # This MAY be overridden to return an application root different
+      # from the current folder.
+      def root
+        'public'
+      end
+
+      # Returns folder name of the adapter relative to application public.
+      #   instance.avatar.adapter_folder # => 'uploads'
+      # This MAY be overridden to specify where all the files should be stored.
+      def adapter_folder
+        'uploads'
+      end
+
+      # Returns filesystem folder path of the adapter relative to adapter root.
+      #   instance.avatar.adapter_path # => 'public/uploads'
+      # It is constructed from #root, 'public' and #adapter_folder.
+      def adapter_path
+        File.join root, adapter_folder
+      end
+
+      # Returns file's folder relative to #adapter_path.
+      #   instance.avatar.relative_folder # => 'Model/avatar'
+      # It is constructed from object's class name and column name.
+      # This MAY be overridden to place files somwhere other than 'Model/avatar'.
+      def relative_folder
+        File.join @model.to_s, @column.to_s
+      end
+
+      # Returns filesystem folder path relative to adapter root.
+      #   instance.avatar.system_path # => 'public/uploads/Model/avatar'
+      # It is constructed from #adapter_path and #relative_folder
+      def system_path
+        File.join adapter_path, relative_folder
+      end
+
+      # Returns folder path relative to public folder.
+      #   instance.avatar.public_path # => 'uploads/Model/avatar'
+      # It is constructed from #adapter_folder and #relative_folder
+      def public_path
+        File.join adapter_folder, relative_folder
+      end
+
+      # Inspects class name and url of the object.
+      #   instance.avatar.to_s # => 'Model#url: /uploads/Model/avatar/image.jpg'
+      def to_s
+        "#{self.class}#url: #{url}"
+      end
+
+      # Sets adapter to delete stored file on #adapеr_after_save.
+      #   instance.avatar.delete # => nil
+      def delete
+        @record.send(:"#{@column}=", nil)
+      end
+
+      # Returns adapter instance.
+      # It's used in Nozzle::Adapter#avatar after retrieving filename from the object.
+      def load( value )
+        @filename = value
+        self
+      end
+
+      # Fills internal structure of the adapter with new file's path.
+      # It's used in Nozzle::Adapter#avatar= before sending filename to the object.
+      def dump( value )
+        reset
+        @original_path = path
+        return nil  unless value
+
+        new_path = expand_argument value
+        raise Errno::ENOENT, "'#{new_path}'"  unless File.exists?(new_path)
+
+        @tempfile_path = File.expand_path(new_path)
+        detect_properties
+        @filename
+      end
+
+      # Stores temporary filename by the constructed path. Deletes old file.
+      # Note: the file is moved if it's path contains /tmp/ or /temp/, copied
+      # otherwise.
+      def store!
+        unlink! @original_path
+        return nil  unless @tempfile_path
+
+        new_path = path
+        FileUtils.mkdir_p File.dirname(new_path)
+        result = if @tempfile_path =~ /\/te?mp\//
+          FileUtils.move @tempfile_path, new_path
+        else
+          FileUtils.copy @tempfile_path, new_path
+        end
+        File.chmod 0644, new_path
+        reset
+        result
+      end
+
+      # Deletes file by path. Do not use, it will break adapter's integrity.
+      # It's called in #avatar_after_destroy after the object is destroyed.
+      #   unlink!                # deletes path
+      #   unlink! @original_path # deletes @original_path
+      #   unlink! nil            # deletes nothing
+      def unlink!( target = path )
+        delete_file_and_folder! target  if target
+      end
+
+      def as_json
+        { :url => url }
+      end
+
+    private
+
+      # Tries to detect content_type and size of the file.
+      # Note: this method calls `file` system command to detect file content type.
+      def detect_properties
+        @record.send( :"#{@column}_content_type=", `file -bp --mime-type '#{access_path}'`.to_s.strip )
+        @record.send( :"#{@column}_size=", File.size(access_path) )
+      rescue NoMethodError
+        nil
+      end
+
+      # Resets internal paths.
+      def reset
+        @original_path = nil
+        @tempfile_path = nil
+      end
+
+      # Analyzes the value assigned to adapter and fills @filename. Returns
+      # system path where temporary file is located.
+      # The +value+ MUST be File, String, Hash or nil. See Nozzle::Adapter#avatar=.
+      def expand_argument( value )
+        tempfile_path = case value
+        when String
+          value
+        when File, Tempfile
+          value.path
+        when Hash
+          expand_argument( value[:tempfile] || value['tempfile'] )
+        else
+          raise ArgumentError, "#{@model}##{@column}= argument must be kind of String, File, Tempfile or Hash[:tempfile => 'path']"
+        end
+        @filename = value.kind_of?(Hash) && ( value[:filename] || value['filename'] ) || File.basename(tempfile_path)
+        tempfile_path
+      end
+
+      # Deletes the specified file and all empty folders recursively stopping at
+      # #adapter_folder.
+      def delete_file_and_folder!( file_path )
+        FileUtils.rm_f file_path
+        boundary = adapter_path + '/'
+        loop do
+          file_path = File.dirname file_path
+          break  unless file_path.index boundary
+          FileUtils.rmdir file_path
+        end
+      end
+
+    end
+  end
+end

data/lib/nozzle/adapter/image.rb

@@ -0,0 +1,27 @@
+require 'nozzle/adapter/base'
+
+module Nozzle
+  module Adapter
+    class Image < Nozzle::Adapter::Base
+      DEFAULT_SETTINGS = {
+        :thumb_size => '200x150',
+      }.freeze
+      
+      def initialize( record, column, filename = nil, options = {} )
+        @settings = DEFAULT_SETTINGS.dup
+        super( record, column, filename, options )
+      end
+      
+      def default_url
+        '/images/image_missing.png'
+      end
+
+      outlet :thumb do
+        def prepare( original, result )
+          `convert #{original} -thumbnail #{settings[:thumb_size]} #{result}`
+        end
+      end
+
+    end
+  end
+end

data/lib/nozzle/adapter/outlet.rb

@@ -0,0 +1,80 @@
+module Nozzle
+  module Adapter
+    module Outlet
+
+      def self.included(base)
+        base.instance_eval do
+          def outlets
+            @outlets ||= {}
+          end
+        end
+        base.extend(ClassMethods)
+      end
+
+      def outlets
+        return @outlets  if @outlets
+        @outlets = {}
+        self.class.outlets.each do |name, outlet_class|
+          @outlets[name] = outlet_class.new(@record, @column, @filename, @settings)
+        end
+        @outlets
+      end
+
+      # Copies the file from original path to this outlet path.
+      #   prepare( original, result )
+      # This method SHOULD be overridden in the outlet block. Example:
+      #   class NewAdapter < Nozzle::Adapter::Base
+      #     outlet :thumb do
+      #       def prepare( original, result )
+      #         `convert #{original} -thumbnail x96 #{result}`
+      #       end
+      #     end
+      #   end
+      # In the example system +convert+ is called to resize the original file
+      # and save it's smaller version in result path.
+      def prepare( original, result )
+        FileUtils.mkdir_p File.dirname(result)
+        FileUtils.cp original, result
+      end
+
+      def prepare!
+        prepare( @record.send(@column).path, path )
+      end
+
+      def cleanup!
+        delete_file_and_folder!( path )  if respond_to?(:version_name)
+        outlets.each{ |name, outlet| outlet.cleanup! }
+      end
+
+      module ClassMethods
+
+        def outlet( name, &block )
+          class_eval <<-RUBY,__FILE__,__LINE__+1
+            def #{name}
+              outlets[:#{name}]
+            end
+          RUBY
+          outlets[name] = create_outlet( name, &block )
+        end
+
+      private
+
+        def create_outlet( name, &block )
+          new_outlet = Class.new(self)
+          new_outlet.class_eval <<-RUBY,__FILE__,__LINE__+1
+            def version_name
+              (defined?(super) ? super+'_' : '') + "#{name}"
+            end
+            def filename
+              "#{name}_\#{super}"
+            end
+          RUBY
+          new_outlet.class_eval(&block)  if block
+          new_outlet
+        end
+
+      end
+
+    end
+  end
+end

data/lib/nozzle/adapter.rb

@@ -0,0 +1,106 @@
+require 'nozzle/adapter/base'
+
+module Nozzle
+  module Adapter
+    # Installs default or custom adapter to a class.
+    #
+    #   class Example
+    #     attr_accessor :file, :avatar, :thumb
+    #     include Nozzle::Adapter
+    #     install_adapter( :file )
+    #     install_adapter( :avatar, CustomAdapter )
+    #     install_adapter( :thumb, Nozzle::Adapter::Image, :thumb_size => '90x60' )
+    #     def save
+    #       file_after_save; avatar_after_save; thumb_after_save
+    #     end
+    #     def destroy
+    #       file_after_destroy; avatar_after_destroy; thumb_after_destroy
+    #     end
+    #   enc
+    #
+    # The class MUST have readers and writers to install corresponding adapters.
+    # +install_adapter+ overrides these methods and saves the originals in
+    # <tt>original_avatar</tt> and <tt>original_avatar=</tt> aliases.
+    # The originals are called to save and load the filename of stored asset.
+    #
+    # The class MUST call +avatar_after_save+ and +avatar_after_destroy+ after
+    # the corresponding events. +avatar_after_save+ does some IO to move
+    # or copy temporary file. +avatar_after_destroy+ deletes the stored file.
+    #
+    # Note: +options+ are only supported when +adapter+ is specified.
+    def install_adapter( column, adapter = nil, options = {} )
+      attr_accessor :"#{column}_adapter"
+      adapter_classes[column] = adapter || Base
+      adapter_options[column] = options
+
+      class_eval <<-RUBY, __FILE__, __LINE__+1
+        unless instance_methods.map(&:to_s).include?('original_#{column}')
+          alias_method :original_#{column}, :#{column}
+          alias_method :original_#{column}=, :#{column}=
+        end
+
+        def #{column}_adapter
+          @#{column}_adapter ||= self.class.adapter_classes[:#{column}].new(  
+            self, :#{column}, nil, self.class.adapter_options[:#{column}] )   
+        end
+
+        def #{column}
+          #{column}_adapter.load send( :original_#{column} )
+        end
+
+        def #{column}=(value)
+          send( :original_#{column}=, #{column}_adapter.dump(value) )
+        end
+
+        def #{column}_after_save
+          #{column}_adapter.store!
+        end
+
+        def #{column}_after_destroy
+          #{column}
+          #{column}_adapter.cleanup!
+          #{column}_adapter.unlink!
+        end
+      RUBY
+    end
+
+    def adapter_classes # :nodoc:
+      @adapter_classes ||= {}
+    end
+
+    def adapter_options # :nodoc:
+      @adapter_options ||= {}
+    end
+
+    ##
+    # :method: avatar
+    # Returns column adapter instance.
+    #
+    # Note: this method and the following 3 methods are dynamically created by
+    # +install_adapter+. These methods will be named according to the column
+    # name specified in first argument of +install_adapter+ call.
+    # This document explains methods created for column named <tt>:avatar</tt>.
+
+    ##
+    # :method: avatar=
+    #
+    # :call-seq: avatar=(value)
+    #
+    # Calls initialization routines to save file into class instance.
+    #
+    # The +value+ MUST be File, String, Hash or nil
+    #   instance.avatar = File.open('tmp/031337.jpg')
+    #   instance.avatar = 'tmp/031337.jpg'
+    #   instance.avatar = { :filename => 'Cool file.jpg', :tempfile => cool }
+    #   instance.avatar = nil
+    # If +value+ is nil then the stored file is deleted on +avatar_after_save+.
+
+    ##
+    # :method: avatar_after_save
+    # Calls Base#store! to move or copy temporary file to it's new store location.
+
+    ##
+    # :method: avatar_after_destroy
+    # Calls Base#unlink! to cleanup stored files.
+  end
+end

data/lib/nozzle/datamapper.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+
+require 'nozzle'
+require 'dm-core'
+
+module Nozzle
+  module DataMapper
+    include Nozzle::Adapter
+
+    module Property
+      class Filename < ::DataMapper::Property::String
+        length 255
+        def custom?; true; end
+      end
+    end
+
+    def nozzle!( column, adapter = nil )
+      property column,                    Property::Filename     unless properties.named?(column)
+      property :"#{column}_content_type", String, :length => 63  unless properties.named?("#{column}_content_type")
+      property :"#{column}_size",         Integer                unless properties.named?("#{column}_size")
+
+      install_adapter column, adapter
+
+      after :save,    :"#{column}_after_save"
+      after :destroy, :"#{column}_after_destroy"
+    end
+  end
+end
+
+DataMapper::Model.append_extensions(Nozzle::DataMapper)

data/lib/nozzle/version.rb

@@ -0,0 +1,3 @@
+module Nozzle
+  VERSION = "0.1.1"
+end

data/lib/nozzle.rb

@@ -0,0 +1,2 @@
+require 'nozzle/version'
+require 'nozzle/adapter'

data/nozzle.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+$LOAD_PATH << File.expand_path('../lib', __FILE__)
+require 'nozzle/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'nozzle'
+  spec.version       = Nozzle::VERSION
+  spec.description   = 'Attachments for ruby rack'
+  spec.summary       = 'A gem to store and serve attachments for ruby rack applications'
+
+  spec.authors       = ['Igor Bochkariov']
+  spec.email         = ['ujifgc@gmail.com']
+  spec.homepage      = 'https://github.com/ujifgc/nozzle'
+  spec.license       = 'MIT'
+
+  spec.require_paths = ['lib']
+  spec.files         = `git ls-files`.split($/)
+  spec.test_files    = spec.files.grep(%r{^test/})
+
+  spec.add_development_dependency 'bundler', '>= 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'minitest'
+end

data/test/minitest_helper.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'nozzle'
+
+require 'minitest/autorun'

data/test/nozzle_adapter_base_test.rb

@@ -0,0 +1,122 @@
+require 'minitest_helper'
+require 'fileutils'
+
+describe Nozzle::Adapter::Base do
+  # these tests are ordered
+  class << self; define_method :test_order do :alpha end; end
+
+  before do
+    class Klass1
+      attr_accessor :avatar, :avatar_content_type, :avatar_size, :asset
+      def save
+        send :avatar_after_save
+      end
+      def destroy
+        send :avatar_after_destroy
+      end
+    end
+    Klass1.send :extend, Nozzle::Adapter
+    Klass1.install_adapter :avatar
+    Klass1.install_adapter :asset
+  end
+
+  it 'should raise ENOENT on non-existing asset' do
+    inst = Klass1.new
+    lambda do
+      inst.avatar = 'test/fixtures/non-existing.jpg'
+    end.must_raise Errno::ENOENT
+  end
+
+  it 'should raise ArgumentError on bad arguments' do
+    inst = Klass1.new
+    lambda do
+      inst.avatar = ['array']
+    end.must_raise ArgumentError
+    lambda do
+      inst.avatar = :symbol
+    end.must_raise ArgumentError
+  end
+
+  it 'should save file into public folder and destroy it' do
+    public_path = 'public/uploads/Klass1/avatar/test-697x960.jpg'
+
+    inst = Klass1.new
+    inst.avatar = 'test/fixtures/test-697x960.jpg'
+    inst.avatar.filename.must_equal 'test-697x960.jpg'
+
+    inst.save
+    inst.avatar.path.must_equal public_path
+    File.exists?(public_path).must_equal true
+
+    inst.save
+    inst.avatar.path.must_equal public_path
+    File.exists?(public_path).must_equal true
+
+    inst.destroy
+    File.exists?(public_path).must_equal false
+  end
+
+  it 'should detect file properties if the properties are available' do
+    inst = Klass1.new
+    inst.avatar = 'test/fixtures/test-697x960.jpg'
+    inst.avatar.content_type.must_equal 'image/jpeg'
+    inst.avatar.size.must_equal File.size('test/fixtures/test-697x960.jpg')
+
+    inst.asset = 'test/fixtures/test-697x960.jpg'
+    inst.asset.content_type.must_equal ''
+    inst.asset.size.must_equal -1
+  end
+
+  it 'should return intermediate tempfile path or stored path' do
+    inst = Klass1.new
+    inst.avatar = 'test/fixtures/test-697x960.jpg'
+    inst.avatar.access_path.must_equal File.expand_path('test/fixtures/test-697x960.jpg')
+    inst.save
+    inst.avatar.access_path.must_equal 'public/uploads/Klass1/avatar/test-697x960.jpg'
+  end
+
+  it 'should respect custom filename' do
+    public_path = 'public/uploads/Klass1/avatar/girl-and-square.jpg'
+
+    inst = Klass1.new
+    inst.avatar = { :tempfile => 'test/fixtures/test-697x960.jpg', :filename => 'girl-and-square.jpg' }
+    inst.avatar.filename.must_equal 'girl-and-square.jpg'
+
+    inst.save
+    inst.avatar.path.must_equal public_path
+    File.exists?(public_path).must_equal true
+
+    inst.destroy
+    File.exists?(public_path).must_equal false
+  end
+
+  it 'should accept string-keyed hash' do
+    public_path = 'public/uploads/Klass1/avatar/girl-and-square.jpg'
+
+    inst = Klass1.new
+    inst.avatar = { 'tempfile' => 'test/fixtures/test-697x960.jpg', 'filename' => 'girl-and-square.jpg' }
+    inst.avatar.filename.must_equal 'girl-and-square.jpg'
+
+    inst.save
+    inst.avatar.path.must_equal public_path
+    File.exists?(public_path).must_equal true
+
+    inst.destroy
+    File.exists?(public_path).must_equal false
+  end
+
+  it 'should destroy files whit was saved before' do
+    public_path = 'public/uploads/Klass1/avatar/test-697x960.jpg'
+    inst = Klass1.new
+    FileUtils.mkdir_p 'public/uploads/Klass1/avatar'
+    FileUtils.cp 'test/fixtures/test-697x960.jpg', public_path
+    inst.instance_eval('@avatar = "test-697x960.jpg"')
+    inst.destroy
+    File.exists?(public_path).must_equal false
+  end
+
+  after do
+    FileUtils.rm_rf 'public'
+  end
+
+end

data/test/nozzle_adapter_image_test.rb

@@ -0,0 +1,48 @@
+require 'minitest_helper'
+require 'fileutils'
+require 'nozzle/adapter/image'
+
+describe Nozzle::Adapter::Image do
+  # these tests are ordered
+  class << self; define_method :test_order do :alpha end; end
+
+  before do
+    class Klass3
+      def avatar1; @avatar1; end
+      def avatar1=(value); @avatar1 = value; end
+      def avatar2; @avatar2; end
+      def avatar2=(value); @avatar2 = value; end
+      def save
+        send :avatar1_after_save
+        send :avatar2_after_save
+      end
+      def destroy
+        send :avatar1_after_destroy
+        send :avatar2_after_destroy
+      end
+    end
+    Klass3.send :extend, Nozzle::Adapter
+    Klass3.install_adapter :avatar1, Nozzle::Adapter::Image
+    Klass3.install_adapter :avatar2, Nozzle::Adapter::Image, :thumb_size => '90x60'
+  end
+
+  it 'should have default url' do
+    inst = Klass3.new
+    inst.avatar1.url.must_equal '/images/image_missing.png'
+    inst.avatar2.settings[:thumb_size].must_equal '90x60'
+    inst.avatar1.settings[:thumb_size].must_equal '200x150'
+
+    inst.avatar1 = 'test/fixtures/test-697x960.jpg'
+    inst.avatar2 = 'test/fixtures/test-697x960.jpg'
+    inst.save
+    inst.avatar1.thumb.prepare!
+    `identify #{inst.avatar1.thumb.path}`.must_match /JPEG 109x150/
+    inst.avatar2.thumb.prepare!
+    `identify #{inst.avatar2.thumb.path}`.must_match /JPEG 44x60/
+  end
+
+  after do
+    FileUtils.rm_rf 'public'
+  end
+
+end

data/test/nozzle_adapter_outlet_test.rb

@@ -0,0 +1,104 @@
+require 'minitest_helper'
+require 'fileutils'
+
+describe Nozzle::Adapter::Outlet do
+  # these tests are ordered
+  class << self; define_method :test_order do :alpha end; end
+
+  before do
+    class Klass2
+      def avatar
+        @avatar
+      end
+      def avatar=(value)
+        @avatar = value
+      end
+      def save
+        send :avatar_after_save
+      end
+      def destroy
+        send :avatar_after_destroy
+      end
+    end
+    Klass2.send :extend, Nozzle::Adapter
+    class BaseOutlet < Nozzle::Adapter::Base
+      def filename
+        "#{Time.now.strftime('%Y%m%d')}_#{super}"
+      end
+
+      outlet :thumb do
+        def filename
+          'ava_' + super
+        end
+        def prepare( original, result )
+          `convert #{original} -thumbnail x96 #{result}`
+        end
+        outlet :mini
+      end
+      outlet :big do
+        def relative_folder
+          File.join 'big', @model.to_s
+        end
+      end
+    end
+    Klass2.install_adapter :avatar, BaseOutlet
+  end
+
+  it 'should install an adapter with custom filename and outlets' do
+    date = Time.now.strftime('%Y%m%d')
+    inst = Klass2.new
+    inst.avatar = 'test/fixtures/test-697x960.jpg'
+    inst.save
+    inst.avatar.filename.must_equal "#{date}_test-697x960.jpg"
+    inst.avatar.thumb.filename.must_equal "ava_#{date}_test-697x960.jpg"
+    inst.avatar.big.path.must_equal "public/uploads/big/Klass2/big_#{date}_test-697x960.jpg"
+    inst.avatar.thumb.mini.path.must_equal "public/uploads/Klass2/avatar/mini_ava_#{date}_test-697x960.jpg"
+    inst.avatar.respond_to?(:version_name).must_equal false, 'original adapter must not have version name'
+    inst.avatar.thumb.version_name.must_equal 'thumb'
+    inst.avatar.thumb.mini.version_name.must_equal 'thumb_mini'
+
+    inst.avatar.thumb.prepare!
+    `identify #{inst.avatar.thumb.path}`.must_match /JPEG 70x96/
+    inst.avatar.big.prepare!
+    `identify #{inst.avatar.big.path}`.must_match /JPEG 697x960/
+
+    inst.avatar.cleanup!
+    File.exists?(inst.avatar.path).must_equal true, 'outlet must not cleanup the original'
+    File.exists?(inst.avatar.thumb.path).must_equal false, 'outlet must cleanup its cache'
+    File.exists?(inst.avatar.big.path).must_equal false
+    File.exists?(inst.avatar.big.system_path).must_equal false, 'outlet must cleanup its folders'
+
+    inst.avatar.big.prepare!
+    `identify #{inst.avatar.big.path}`.must_match /JPEG 697x960/
+    a,b,a1,b1 = [ inst.avatar.path, inst.avatar.big.path, inst.avatar.system_path, inst.avatar.big.system_path ]
+    inst.destroy
+    File.exists?(a).must_equal false
+    File.exists?(b).must_equal false
+    File.exists?(a1).must_equal false
+    File.exists?(b1).must_equal false
+  end
+
+  it 'should move temporary file' do
+    temporary_path = '/tmp/test-697x960.jpg'
+    FileUtils.cp 'test/fixtures/test-697x960.jpg', temporary_path
+    inst1 = Klass2.new
+    inst1.avatar = temporary_path
+    inst1.save
+    File.exists?(inst1.avatar.path).must_equal true
+    File.exists?(temporary_path).must_equal false
+  end
+
+  it 'should copy non-temporary file' do
+    permanent_path = 'test/fixtures/test-697x960.jpg'
+    inst1 = Klass2.new
+    inst1.avatar = permanent_path
+    inst1.save
+    File.exists?(inst1.avatar.path).must_equal true
+    File.exists?(permanent_path).must_equal true
+  end
+
+  after do
+    FileUtils.rm_rf 'public'
+  end
+
+end

data/test/nozzle_adapter_test.rb

@@ -0,0 +1,40 @@
+require 'minitest_helper'
+
+describe Nozzle::Adapter do
+
+  before do
+    class Klass0
+      def avatar
+        @avatar
+      end
+      def avatar=(value)
+        @avatar = value
+      end
+    end
+    Klass0.send :extend, Nozzle::Adapter
+    Klass0.install_adapter :avatar
+  end
+
+  it 'should be able to install itself' do
+    Klass0.adapter_classes.must_equal :avatar => Nozzle::Adapter::Base
+  end
+
+  it 'should register instance methods' do
+    @inst = Klass0.new
+    @inst.respond_to?(:avatar_adapter).must_equal true
+    @inst.respond_to?(:avatar).must_equal true
+    @inst.respond_to?(:avatar=).must_equal true
+    @inst.respond_to?(:avatar_after_save).must_equal true
+    @inst.respond_to?(:avatar_after_destroy).must_equal true
+    @inst.avatar_adapter.class.must_equal Nozzle::Adapter::Base
+  end
+
+  it 'should register instance methods one and only one time' do
+    Klass0.install_adapter :avatar
+    Klass0.install_adapter :avatar
+    @inst = Klass0.new
+    @inst.avatar.class.must_equal Nozzle::Adapter::Base
+    @inst.original_avatar.class.wont_equal Nozzle::Adapter::Base
+  end
+
+end

data/test/nozzle_test.rb

@@ -0,0 +1,7 @@
+require 'minitest_helper'
+
+describe Nozzle do
+  it 'should have a version' do
+    Nozzle::VERSION.must_match /.+/
+  end
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: nozzle
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Igor Bochkariov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Attachments for ruby rack
+email:
+- ujifgc@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/nozzle.rb
+- lib/nozzle/adapter.rb
+- lib/nozzle/adapter/base.rb
+- lib/nozzle/adapter/image.rb
+- lib/nozzle/adapter/outlet.rb
+- lib/nozzle/datamapper.rb
+- lib/nozzle/version.rb
+- nozzle.gemspec
+- test/fixtures/test-697x960.jpg
+- test/minitest_helper.rb
+- test/nozzle_adapter_base_test.rb
+- test/nozzle_adapter_image_test.rb
+- test/nozzle_adapter_outlet_test.rb
+- test/nozzle_adapter_test.rb
+- test/nozzle_test.rb
+homepage: https://github.com/ujifgc/nozzle
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: A gem to store and serve attachments for ruby rack applications
+test_files:
+- test/fixtures/test-697x960.jpg
+- test/minitest_helper.rb
+- test/nozzle_adapter_base_test.rb
+- test/nozzle_adapter_image_test.rb
+- test/nozzle_adapter_outlet_test.rb
+- test/nozzle_adapter_test.rb
+- test/nozzle_test.rb