el_finder_ftp 1.0.0

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/.gitignore

@@ -0,0 +1,5 @@
+*.swp
+pkg/
+Gemfile.lock
+doc/
+.yardoc/

data/.yardopts

@@ -0,0 +1,7 @@
+--no-private
+--title 'elFinder server side connector for Ruby'
+--charset utf-8
+--readme README.md
+-
+README.md
+TODO

data/Gemfile

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

data/README.md

@@ -0,0 +1,115 @@
+## el_finder
+
+* http://elrte.org/redmine/projects/elfinder
+
+## Description:
+
+This is based on Phallstrom's excellent Ruby library to provide server side functionality for 
+elFinder: https://github.com/phallstrom/el_finder
+
+This version provides a Rails backend for elFinder that uses an FTP server as its file storage,
+rather than the local filesystem.  elFinder is an open-source file manager for web, written in 
+JavaScript using jQuery UI.
+
+## 2.x API
+
+This version provides a partial implementation of the 2.x API (the portions that can be used with FTP).
+
+Operations such as archive, copy, duplicate, etc are not possible using FTP.  Needless to say, thumbnails are also not
+supported.
+
+## Requirements:
+
+Net::FTP is used to communicate with the FTP server.
+
+## Install:
+
+* Install elFinder (http://elrte.org/redmine/projects/elfinder/wiki/Install_EN)
+* Do whatever is necessary for your Ruby framework to tie it together.
+
+### Rails 3
+
+* Add `gem 'el_finder_ftp'` to Gemfile
+* % bundle install
+* Switch to using jQuery instead of Prototype
+* Add the following action to a controller of your choosing.
+
+* Use ElFinderFtp::Action and el_finder_ftp, which handles most of the boilerplate for an ElFinderFtp action:
+
+```ruby
+  require 'el_finder_ftp/action'
+
+  class MyController < ApplicationController
+    include ElFinderFtp::Action
+
+    el_finder_ftp(:action_name) do
+      {
+        :server => { host: 'my.ftp.com', username: 'username', password: 'password' },
+        :url: "/ftp",
+        :perms => {
+           /^(Welcome|README)$/ => {:read => true, :write => false, :rm => false},
+           '.' => {:read => true, :write => false, :rm => false}, # '.' is the proper way to specify the home/root directory.
+           /^test$/ => {:read => true, :write => true, :rm => false},
+           'logo.png' => {:read => true},
+           /\.png$/ => {:read => false} # This will cause 'logo.png' to be unreadable.  
+                                        # Permissions err on the safe side. Once false, always false.
+        },
+      }
+    end
+  end
+```
+
+* Add the appropriate route to config/routes.rb such as:
+
+```ruby
+  match 'ftp' => 'my_controller#action_name'
+```
+
+* Add the following to your layout. The paths may be different depending 
+on where you installed the various js/css files.
+
+```erb
+  <%= stylesheet_link_tag 'jquery-ui/base/jquery.ui.all', 'elfinder' %>
+  <%= javascript_include_tag :defaults, 'elfinder/elfinder.min' %>
+```
+
+* Add the following to the view that will display elFinder:
+
+```erb
+  <%= javascript_tag do %>
+    $().ready(function() { 
+      $('#elfinder').elfinder({ 
+        url: '/ftp',
+        lang: 'en'
+      })
+    })
+  <% end %>
+  <div id='elfinder'></div>
+```
+
+* That's it.
+
+## License:
+
+(The MIT License)
+
+Copyright (c) 2010-2013 Chris Micacchi, Philip Hallstrom
+
+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/Rakefile

@@ -0,0 +1,14 @@
+# -*- ruby -*-
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/TODO

@@ -0,0 +1,5 @@
+- Complain if root directory is missing.
+- There's probably a lot of redundancy now between ElFinderFtp::Pathname and ElFinderFtp::FtpPathname, 
+  since this is based off of the preexisting Ruby ElFinder backend, which used the Ruby stdlib's 
+  ::Pathname where I've used ElFinderFtp::Pathname.
+- I deleted all the tests but didn't write new ones yet. I probably should.

data/el_finder_ftp.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "el_finder_ftp/version"
+
+Gem::Specification.new do |s|
+  s.name        = "el_finder_ftp"
+  s.version     = ElFinderFtp::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Chris Micacchi", "Philip Hallstrom"]
+  s.email       = ["cmicacchi@solvco.com", "philip@pjkh.com"]
+  s.homepage    = "https://github.com/Nivio/el_finder_ftp"
+  s.summary     = %q{elFinder server side connector for Ruby, with an FTP backend.}
+  s.description = %q{Ruby library to provide server side functionality for elFinder.  elFinder is an open-source file manager for web, written in JavaScript using jQuery UI.}
+  s.license       = "MIT"
+
+  s.rubyforge_project = "el_finder_ftp"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency('image_size', '>= 1.0.0')
+  s.add_dependency('net-ftp-list', '>= 3.2.5')
+  s.add_dependency('browser', '>= 0.1.6')
+  s.add_development_dependency('yard', '~> 0.8.1')
+  s.add_development_dependency('redcarpet', '~> 2.1.1')
+
+end

data/lib/el_finder_ftp.rb

@@ -0,0 +1,13 @@
+require 'fileutils'
+require 'net/ftp'
+
+require 'el_finder_ftp/railties'
+require 'el_finder_ftp/base64'
+require 'el_finder_ftp/ftp_authentication_error'
+require 'el_finder_ftp/ftp_adapter'
+require 'el_finder_ftp/ftp_pathname'
+require 'el_finder_ftp/pathname'
+require 'el_finder_ftp/mime_type'
+require 'el_finder_ftp/image'
+require 'el_finder_ftp/connector'
+require 'el_finder_ftp/action'

data/lib/el_finder_ftp/action.rb

@@ -0,0 +1,32 @@
+module ElFinderFtp
+  module Action
+    class << self
+      def included(klass)
+        klass.send(:extend, ElFinderFtp::ActionClass)
+      end
+    end
+  end
+
+  module ActionClass
+    def el_finder_ftp(name = :elfinder, &block)
+      self.send(:define_method, name) do
+        h, r = ElFinderFtp::Connector.new(instance_eval(&block)).run(params)
+        headers.merge!(h)
+        if r.include?(:file_data)
+          send_data r[:file_data], type: r[:mime_type], disposition: r[:disposition], filename: r[:filename]
+        else
+          if browser.ie8? || browser.ie9?
+            # IE 8 and IE 9 don't accept application/json as a response to a POST in some cases:
+            # http://blog.degree.no/2012/09/jquery-json-ie8ie9-treats-response-as-downloadable-file/
+            # so we send text/html instead
+            response = (r.empty? ? {:nothing => true} : {:text => r.to_json})
+          else
+            response = (r.empty? ? {:nothing => true} : {:json => r})
+          end
+
+          render response, :layout => false
+        end
+      end
+    end
+  end
+end

data/lib/el_finder_ftp/base64.rb

@@ -0,0 +1,24 @@
+if RUBY_VERSION < '1.9'
+  begin
+    require 'base64'
+  rescue LoadError
+  end
+
+  if defined? ::Base64
+    # The Base64 module provides for the encoding (encode64, strict_encode64, urlsafe_encode64) and decoding (decode64, strict_decode64, urlsafe_decode64) of binary data using a Base64 representation.
+    # @note stdlib module.
+    module ::Base64
+      # Returns the Base64-encoded version of bin. This method complies with "Base 64 Encoding with URL and Filename Safe Alphabet" in RFC 4648. The alphabet uses '-' instead of '+' and '_' instead of '/'.
+      # @note This method will be defined only on ruby 1.8 due to its absence in stdlib.
+      def self.urlsafe_encode64(bin)
+        [bin].pack("m0").tr("+/", "-_")
+      end
+
+      # Returns the Base64-decoded version of str. This method complies with "Base 64 Encoding with URL and Filename Safe Alphabet" in RFC 4648. The alphabet uses '-' instead of '+' and '_' instead of '/'.
+      # @note This method will be defined only on ruby 1.8 due to its absence in stdlib.
+      def self.urlsafe_decode64(str)
+        str.tr("-_", "+/").unpack("m0").first
+      end
+    end
+  end
+end

data/lib/el_finder_ftp/connector.rb

@@ -0,0 +1,618 @@
+#
+# http://elrte.org/redmine/projects/elfinder/wiki/Client-Server_Protocol_EN
+#
+
+require 'logger'
+require 'base64'
+
+module ElFinderFtp
+
+  # Represents ElFinder connector on Rails side.
+  class Connector
+
+    # Valid commands to run.
+    # @see #run
+    VALID_COMMANDS = %w[archive duplicate put file ls tree extract mkdir mkfile open paste ping get rename resize rm tmb upload]
+
+    attr_reader :adapter
+
+    # Default options for instances.
+    # @see #initialize
+    DEFAULT_OPTIONS = {
+      :mime_handler => ElFinderFtp::MimeType,
+      :image_handler => ElFinderFtp::Image,
+      :original_filename_method => lambda { |file| file.original_filename.respond_to?(:force_encoding) ? file.original_filename.force_encoding('utf-8') : file.original_filename },
+      :disabled_commands => ['archive', 'duplicate', 'extract', 'resize', 'tmb'],
+      :allow_dot_files => true,
+      :upload_max_size => '50M',
+      :name_validator => lambda { |name| name.strip != '.' && name =~ /^[^\x00-\x1f\\?*:"><|\/]+$/ },
+      :upload_file_mode => 0644,
+      :archivers => {},
+      :extractors => {},
+      :home => 'Home',
+      :default_perms => { :read => true, :write => true, :locked => false, :hidden => false },
+      :perms => [],
+      :thumbs => false,
+      :thumbs_directory => '.thumbs',
+      :thumbs_size => 48,
+      :thumbs_at_once => 5,
+    }
+
+    # Initializes new instance.
+    # @param [Hash] options Instance options. :url and :server options are required.
+    # @option options [String] :url Entry point of ElFinder router.
+    # @option options [String] :server A hash containing the :host, :username, :password, and, optionally, :port to connect to
+    # @see DEFAULT_OPTIONS
+    def initialize(options)
+      @options = DEFAULT_OPTIONS.merge(options)
+
+      raise(ArgumentError, "Missing required :url option") unless @options.key?(:url) 
+      raise(ArgumentError, "Missing required :server option") unless @options.key?(:server) 
+      raise(ArgumentError, "Mime Handler is invalid") unless mime_handler.respond_to?(:for)
+      raise(ArgumentError, "Image Handler is invalid") unless image_handler.nil? || ([:size, :resize, :thumbnail].all?{|m| image_handler.respond_to?(m)})
+
+      @headers = {}
+      @response = {}
+    end # of initialize
+
+    # Logger is a class property
+    class <<self
+      def logger
+        @logger ||= Logger.new(STDOUT)
+      end
+      def logger=(val)
+        @logger = val
+      end      
+    end
+
+    # Runs request-response cycle.
+    # @param [Hash] params Request parameters. :cmd option is required.
+    # @option params [String] :cmd Command to be performed.
+    # @see VALID_COMMANDS
+    def run(params)
+
+      @adapter = ElFinderFtp::FtpAdapter.new(@options[:server])
+      @root = ElFinderFtp::Pathname.new(adapter)
+
+      begin
+        @params = params.dup
+        @headers = {}
+        @response = {}
+        @response[:errorData] = {}
+
+        if VALID_COMMANDS.include?(@params[:cmd])
+
+          if @options[:thumbs]
+            @thumb_directory = @root + @options[:thumbs_directory]
+            @thumb_directory.mkdir unless @thumb_directory.exist? 
+            raise(RuntimeError, "Unable to create thumbs directory") unless @thumb_directory.directory?
+          end
+
+          @current = @params[:current] ? from_hash(@params[:current]) : nil
+          @target = (@params[:target] and !@params[:target].empty?) ? from_hash(@params[:target]) : nil
+          if params[:targets]
+            @targets = @params[:targets].map{|t| from_hash(t)}
+          end
+
+          begin
+            send("_#{@params[:cmd]}")
+          rescue Net::FTPPermError
+            @response[:error] = 'Access Denied'
+          end
+        else
+          invalid_request
+        end
+
+        @response.delete(:errorData) if @response[:errorData].empty?
+
+        return @headers, @response
+      ensure
+        adapter.close
+      end
+    end # of run
+
+    #
+    def to_hash(pathname)
+      # note that '=' are removed
+      Base64.urlsafe_encode64(pathname.path.to_s).chomp.tr("=\n", "")
+    end # of to_hash
+
+    #
+    def from_hash(hash)
+      # restore missing '='
+      len = hash.length % 4
+      hash += '==' if len == 1 or len == 2
+      hash += '='  if len == 3
+
+      decoded_hash = Base64.urlsafe_decode64(hash)
+      decoded_hash = decoded_hash.respond_to?(:force_encoding) ? decoded_hash.force_encoding('utf-8') : decoded_hash
+      pathname = @root + decoded_hash
+    rescue ArgumentError => e
+      if e.message != 'invalid base64'
+        raise
+      end
+      nil
+    end # of from_hash
+
+    # @!attribute [w] options
+    # Options setter.
+    # @param value [Hash] Options to be merged with instance ones.
+    # @return [Hash] Updated options.
+    def options=(value = {})
+      value.each_pair do |k, v|
+        @options[k.to_sym] = v
+      end
+      @options
+    end # of options=
+
+    ################################################################################
+    protected
+
+    #
+    def _open(target = nil)
+      target ||= @target
+
+      if target.nil?
+        _open(@root)
+        return
+      end
+
+      if perms_for(target)[:read] == false
+        @response[:error] = 'Access Denied'
+        return
+      end
+
+      if target.file?
+        command_not_implemented
+      elsif target.directory?
+        @response[:cwd] = cdc_for(target)
+        files = [target].concat( target.files.reject{ |child| perms_for(child)[:hidden] } )
+
+        if @params[:tree]
+          files = files.concat( tree_for(@root) )
+        else
+          files = files.concat( target.child_directories.reject{ |child| perms_for(child)[:hidden] || child.fullpath == target.fullpath } )
+        end
+
+        @response[:files] = files.map{|e| cdc_for(e)}.compact
+
+        if @params[:init]
+          @response[:api] = 2
+          @response[:uplMaxSize] = @options[:upload_max_size]
+          @response[:options] = {
+            :disabled => @options[:disabled_commands],
+            :dotFiles => @options[:allow_dot_files],
+            :url => @options[:url]
+          }
+        end
+
+      else
+        @response[:error] = "Directory does not exist"
+        _open(@root) if File.directory?(@root)
+      end
+
+    end # of open
+
+    def _ls
+      if @target.directory?
+        files = @target.files.reject{ |child| perms_for(child)[:hidden] }
+
+        @response[:list] = files.map{|e| e.basename.to_s }.compact
+      else
+        @response[:error] = "Directory does not exist"
+      end
+
+    end # of open
+
+    def _tree
+      if @target.directory?
+        @response[:tree] = tree_for(@target).map{|e| cdc_for(e) }.compact
+      else
+        @response[:error] = "Directory does not exist"
+      end
+
+    end # of tree
+
+    #
+    def _mkdir
+      if perms_for(@target)[:write] == false
+        @response[:error] = 'Access Denied'
+        return
+      end
+      unless valid_name?(@params[:name])
+        @response[:error] = 'Unable to create folder'
+        return
+      end
+
+      dir = @target + @params[:name]
+      if !dir.exist? && dir.mkdir
+        @response[:added] = [cdc_for(dir)]
+      else
+        @response[:error] = "Unable to create folder"
+      end
+    end # of mkdir
+
+    #
+    def _mkfile
+      if perms_for(@target)[:write] == false
+        @response[:error] = 'Access Denied'
+        return
+      end
+      unless valid_name?(@params[:name])
+        @response[:error] = 'Unable to create file'
+        return
+      end
+
+      file = @target + @params[:name]
+      if !file.exist? && file.touch
+        @response[:added] = [cdc_for(file)]
+      else
+        @response[:error] = "Unable to create file"
+      end
+    end # of mkfile
+
+    #
+    def _rename
+      unless valid_name?(@params[:name])
+        @response[:error] = "Unable to rename #{@target.ftype}"
+        return
+      end
+
+      to = @target.dirname + @params[:name]
+
+      perms_for_target = perms_for(@target)
+      if perms_for_target[:locked] == true
+        @response[:error] = 'Access Denied'
+        return
+      end
+
+      perms_for_current = perms_for(@target)
+      if perms_for_current[:write] == false
+        @response[:error] = 'Access Denied'
+        return
+      end
+
+      if to.exist?
+        @response[:error] = "Unable to rename #{@target.ftype}. '#{to.basename}' already exists"
+      else        
+        to = @target.rename(to)
+        if to 
+          @response[:added] = [cdc_for(to)]
+          @response[:removed] = [to_hash(@target)] 
+        else
+          @response[:error] = "Unable to rename #{@target.ftype}"
+        end
+      end
+    end # of rename
+
+    #
+    def _upload
+      if perms_for(@target)[:write] == false
+        @response[:error] = 'Access Denied'
+        return
+      end
+      added_list = []
+      @params[:upload].to_a.each do |io|
+        name = @options[:original_filename_method].call(io)
+        unless valid_name?(name)
+          @response[:error] = 'Unable to create file'
+          return
+        end
+        dst = @target + name
+
+        dst.write(io)
+        
+        added_list.push cdc_for(dst)
+      end
+      @response[:added] = added_list unless added_list.empty?
+      _open(@current)
+    end # of upload
+
+    #
+    def _ping
+      @headers['Connection'] = 'Close'
+    end # of ping
+
+    #
+    def _paste
+      if perms_for(from_hash(@params[:dst]))[:write] == false
+        @response[:error] = 'Access Denied'
+        return
+      end
+
+      added_list = []
+      removed_list = []
+      @targets.to_a.each do |src|
+        if perms_for(src)[:read] == false || (@params[:cut].to_i > 0 && perms_for(src)[:locked] == true)
+          @response[:error] ||= 'Some files were not moved.'
+          @response[:errorData][src.basename.to_s] = "Access Denied"
+          return
+        else
+          dst = from_hash(@params[:dst]) + src.basename
+          if dst.exist?
+            @response[:error] ||= 'The target file already exists'
+            @response[:errorData][src.basename.to_s] = "already exists in '#{dst.dirname}'"
+          else
+            if @params[:cut].to_i > 0
+              adapter.move(src, dst)
+
+              added_list.push cdc_for(dst)
+              removed_list.push to_hash(src)
+            else
+              command_not_implemented
+              return
+            end
+          end
+        end
+      end
+
+      @response[:added] = added_list unless added_list.empty?
+      @response[:removed] = removed_list unless removed_list.empty?
+    end # of paste
+
+    #
+    def _rm
+      if @targets.empty?
+        @response[:error] = "No files were selected for removal"
+      else
+        removed_list = []        
+        @targets.to_a.each do |target|
+          removed_list.concat remove_target(target)
+        end
+        @response[:removed] = removed_list unless removed_list.empty?
+      end
+    end # of rm
+
+    #
+    def _duplicate
+      command_not_implemented 
+    end # of duplicate
+
+    # 
+    def _get
+      if perms_for(@target)[:read] == true
+        @response[:content] = @target.read
+      else
+        @response[:error] = 'Access Denied'
+      end
+    end # of get
+
+    # 
+    def _file
+      if perms_for(@target)[:read] == true
+        @response[:file_data] = @target.read
+        @response[:mime_type] = mime_handler.for(@target)
+        @response[:disposition] = 'attachment'
+        @response[:filename] = @target.basename.to_s
+      else
+        @response[:error] = 'Access Denied'
+      end
+    end # of file
+
+    #
+    def _put
+      perms = perms_for(@target)
+      if perms[:read] == true && perms[:write] == true
+        @target.write @params[:content]
+        @response[:changed] = [cdc_for(@target)]
+      else
+        @response[:error] = 'Access Denied'
+      end
+    end # of put
+
+    #
+    def _extract
+      command_not_implemented
+    end # of extract
+
+    #
+    def _archive
+      command_not_implemented
+    end # of archive
+
+    #
+    def _tmb
+      command_not_implemented
+    end # of tmb
+
+    #
+    def _resize
+      command_not_implemented
+    end # of resize
+    
+    ################################################################################
+    private
+
+    #
+    def upload_max_size_in_bytes
+      bytes = @options[:upload_max_size]
+      if bytes.is_a?(String) && bytes.strip =~ /(\d+)([KMG]?)/
+        bytes = $1.to_i
+        unit = $2
+        case unit
+          when 'K'
+            bytes *= 1024
+          when 'M'
+            bytes *= 1024 * 1024
+          when 'G'
+            bytes *= 1024 * 1024 * 1024
+        end
+      end
+      bytes.to_i
+    end
+
+    #
+    def thumbnail_for(pathname)
+      @thumb_directory + "#{to_hash(pathname)}.png"
+    end
+
+    #
+    def remove_target(target)
+      removed = []
+      if target.directory?
+        target.children.each do |child|
+          removed.concat remove_target(child)
+        end
+      end
+      if perms_for(target)[:locked] == true
+        @response[:error] ||= 'Some files/directories were unable to be removed'
+        @response[:errorData][target.basename.to_s] = "Access Denied"
+      else
+        begin
+          removed.push to_hash(target)
+          target.unlink
+          if @options[:thumbs] && (thumbnail = thumbnail_for(target)).file?
+            removed.push to_hash(thumbnail)
+            thumbnail.unlink
+          end
+        rescue Exception => ex
+          @response[:error] ||= 'Some files/directories were unable to be removed'
+          @response[:errorData][target.basename.to_s] = "Remove failed"
+        end
+      end
+
+      removed
+    end
+
+    def mime_handler
+      @options[:mime_handler]
+    end
+
+    #
+    def image_handler
+      @options[:image_handler]
+    end
+
+    def cdc_for(pathname)
+      return nil if @options[:thumbs] && pathname.to_s == @thumb_directory.to_s
+      response = {
+        :name => pathname.is_root? ? "Home" : pathname.basename.to_s,
+        :hash => to_hash(pathname),
+        :date => pathname.mtime.to_s,
+        :ts => pathname.mtime.to_i
+      }
+      response.merge! perms_for(pathname)
+
+      response[:phash] = to_hash(pathname.dirname) unless pathname.is_root?
+
+      if pathname.directory?
+        response.merge!(
+          :size => 0,
+          :mime => 'directory', 
+          :dirs => pathname.child_directories.size
+        )
+
+        response[:volumeid] = 'Home' if pathname.is_root?
+      elsif pathname.file?
+        response.merge!(
+          :size => pathname.size, 
+          :mime => mime_handler.for(pathname),
+          :url => (@options[:url] + '/' + pathname.path.to_s)
+        )
+
+        if pathname.readable? && response[:mime] =~ /image/ && !image_handler.nil?
+          response.merge!(
+            :resize => true,
+            :dim => image_handler.size(pathname)
+          )
+          if @options[:thumbs] 
+            if (thumbnail = thumbnail_for(pathname)).exist?
+              response.merge!( :tmb => (@options[:url] + '/' + thumbnail.path.to_s))
+            else
+              @response[:tmb] = true 
+            end
+          end
+        end
+
+      end
+
+      if pathname.symlink?
+        response.merge!(
+          :link => to_hash(@root + pathname.readlink), # hash of file to which point link
+          :linkTo => (@root + pathname.readlink).relative_to(pathname.dirname.path).to_s, # relative path to
+          :parent => to_hash((@root + pathname.readlink).dirname) # hash of directory in which is linked file 
+        )
+      end
+
+      return response
+    end
+
+    #
+    def tree_for(root)
+
+      # root.child_directories.
+      # reject{ |child| 
+      #   ( @options[:thumbs] && child.to_s == @thumb_directory.to_s ) || perms_for(child)[:hidden]
+      # }.
+      # sort_by{|e| e.basename.to_s.downcase}.
+      # map { |child|
+      #     {:name => child.basename.to_s,
+      #      :hash => to_hash(child),
+      #      :dirs => tree_for(child),
+      #     }.merge(perms_for(child))
+      # }
+
+      children = [root]
+      flattened_tree = []
+      while !children.empty? do
+        child = children.pop
+        unless (@options[:thumbs] && child.to_s == @thumb_directory.to_s ) || perms_for(child)[:hidden] 
+          flattened_tree.push child
+          children.concat child.child_directories
+        end
+      end
+      flattened_tree
+    end # of tree_for
+
+    #
+    def perms_for(pathname, options = {})
+      skip = [options[:skip]].flatten
+      response = {}
+
+      response[:read] = pathname.readable? 
+      response[:read] &&= specific_perm_for(pathname, :read)
+      response[:read] &&= @options[:default_perms][:read] 
+
+      response[:write] = pathname.writable? 
+      response[:write] &&= specific_perm_for(pathname, :write) 
+      response[:write] &&= @options[:default_perms][:write]
+
+      response[:locked] = pathname.is_root?
+      response[:locked] &&= specific_perm_for(pathname, :locked)
+      response[:locked] &&= @options[:default_perms][:locked]
+
+      response[:hidden] = false
+      response[:hidden] ||= specific_perm_for(pathname, :hidden)
+      response[:hidden] ||= @options[:default_perms][:hidden]
+
+      response
+    end # of perms_for
+
+    #
+    def specific_perm_for(pathname, perm)
+      pathname = pathname.path if pathname.is_a?(ElFinderFtp::Pathname)
+      matches = @options[:perms].select{ |k,v| pathname.to_s.send((k.is_a?(String) ? :== : :match), k) }
+      if perm == :hidden
+        matches.one?{|e| e.last[perm] }
+      else
+        matches.none?{|e| e.last[perm] == false}
+      end
+    end # of specific_perm_for
+
+    #
+    def valid_name?(name)
+      @options[:name_validator].call(name)
+    end
+    
+    #
+    def invalid_request
+      @response[:error] = "Invalid command '#{@params[:cmd]}'"
+    end # of invalid_request
+
+    #
+    def command_not_implemented
+      @response[:error] = "Command '#{@params[:cmd]}' not implemented"
+    end # of command_not_implemented
+
+  end # of class Connector
+end # of module ElFinderFtp