fedora-fs 0.3.2

data/README.markdown

@@ -0,0 +1,105 @@
+# FedoraFS -- FUSE Filesystem for Fedora Commons Repositories
+
+## Introduction
+
+FedoraFS is a Ruby class that creates a [FUSE (Filesystem in USErspace)](http://fuse.sourceforce.net/) filesystem on top of 
+a [Fedora Commons](http://fedora-commons.org/) repository. Features include:
+
+* Resource Index (risearch) discovery of repository objects
+* Read/Write access to datastream content
+* Ability to expose object/datastream attributes as __*datastream*.profile.xml__ files
+* Namespace-specific PID splitting for creation of manageable directory hierarchies
+
+## Usage
+
+Usage:
+
+    mount_fedora [options]
+        -C, --config-file FILE           Load defaults from FILE
+        -a, --attribute-xml              Include object/datastream attribute XML files
+                                         in directory listings
+        -c, --cert-file FILE             Use client certificate from FILE
+        -D, --no-daemon                  Run in the foreground (for debugging)
+        -f, --fedora-url URL             Use Fedora instance at URL
+        -k, --key-file FILE              Use client key from FILE
+            --log-file FILE              Send logging output to FILE
+            --log-level LEVEL            Set the logging level (0-5; 0 = most verbose)
+        -m, --mount-point DIR            Mount filesystem on DIR
+        -p, --key-pass STRING            Password for client key
+        -R, --read-only                  Don't allow editing of datastream content
+        -r, --refresh SECONDS            Refresh directory structure every SECONDS seconds
+        -u, --user USER                  Authenticate to Fedora as USER
+        -v, --volname NAME               Mount the volume as NAME
+        -w, --password PASS              Authenticate to Fedora using PASS
+        -z, --cache-size                 Number of objects to hold in memory
+        -s, --save FILE                  Save options to FILE
+        -h, --help                       Show this help message
+
+Example:
+
+    mount_fedora -f http://localhost:8983/fedora -m /Volumes/fedora -u fedoraAdmin -w fedoraAdmin
+
+## Volume Layout
+
+### Directories
+
+The root directory of the mounted volume contains all of the PID namespaces that exist within the repository (e.g.,
+a default Fedora installation with the demo objects loaded will have "demo" and "fedora-system" directories, and
+possibly "changeme"). Each namespace directory contains a number of PID trees pointing to the actual objects. By
+default, the directory structure is flat -- each namespace directory simply contains one directory for each PID within
+its namespace. However, to make large numbers of PIDs more manageable, the configuration file can define a splitter for
+each namespace.
+
+### Splitters
+
+A splitter is simply a regular expression that defines to turn a PID into a directory layout.
+
+For example, the `sample_config.yml` file defines splitters for the `local:*` and `druid:*` namespaces:
+
+    local: /(..?)/
+    druid: /([a-z]{2})([0-9]{3})([a-z]{2})([0-9]{4})/
+    
+The directories under `local`, therefore, will be split into groups of two characters, while the `druid` PIDs will
+be grouped into directories of two lowercase letters, followed by three digits, then two more lowercase letters, and
+finally four digits. As a result, the content for the object with the PID `local:abcdefg` will be in `local/ab/cd/ef/g`,
+while `druid:ab123cd4567` will be in `druid/ab/123/cd/4567`.
+
+`FedoraFS` itself defines a splitter for the `fedora-system:*` namespace, as well as one called `:default`. Either of 
+these can be overridden by a configuration file. The `:default` splitter is used when no other splitter is defined for 
+a given PID's namespace.
+
+### Object Files
+
+Each object's directory contains a file called `foxml.xml`, containing the full FOXML representation of the object. In 
+addition, there will be one file for each datastream, with an extension generated by the datastream's MIME type. If the
+`--attribute-xml` switch was specified on the command line or in a loaded configuration file, there is also a read-only
+*datastream*.profile.xml file containing the datastream's attributes, as well as a profile.xml file containing the object's
+attributes. **(Note: Because the filesystem has to compute size information for each of these files, the `--attribute-xml` 
+option will slow down directory listings considerably.)**
+
+### Special Files
+
+The root directory of the volume contains a number of hidden special files that show (or change) information about the
+FedoraFS filesystem:
+
+    last_refresh.txt  (ro) - DateTime of last PID tree refresh from the Fedora repository
+    next_refresh.txt  (ro) - DateTime of next PID tree refresh
+    refresh_time.txt  (rw) - Time (in seconds) between PID tree refreshes
+    object_cache.txt  (ro) - A dump of the LRU cache used to keep the most recently accessed Fedora
+                             objects in memory
+    object_count.txt  (ro) - How many objects are in the PID tree
+    log_level.txt     (rw) - The current logging level, from 0 to 5 (0 = most verbose)
+    read_only.txt     (rw) - Contains "true" if datastreams are read-only; "false" if they can be written
+    attribute_xml.txt (rw) - Contains "true" if *.profile.xml files should be included in directory
+                             listings; "false" if they should be hidden
+
+## History
+
+* **0.3.2** - Remove non-sample config files from gemspec
+* **0.3.1** - Add tests; fix write_to() datastream bug
+* **0.3.0** - Initial documented release
+
+## Copyright
+
+Copyright (c) 2011 Michael B. Klein. See LICENSE.txt for further details.
+

data/bin/mount_fedora

@@ -0,0 +1,136 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+begin
+  require 'bundler/setup'
+rescue LoadError
+  # Try to run without bundler
+end
+require 'fedorafs'
+require 'fusefs-patch'
+require 'daemons'
+require 'logger'
+require 'yaml'
+
+daemonize = true
+init_opts = { 
+  :url => nil,
+  :user => nil,
+  :password => nil, 
+  :mount_point => nil,
+  :attribute_xml => false,
+  :ssl_client_cert => nil, 
+  :ssl_client_key => nil, 
+  :key_file => nil, 
+  :key_pass => '', 
+  :log_level => Logger::INFO,
+  :read_only => false,
+  :vol_name => 'Fedora'
+}
+
+optparse = OptionParser.new do |opts|
+  opts.banner = "Usage: #{File.basename($0)} [options]"
+ 
+  opts.on_head('-C', '--config-file FILE', "Load defaults from FILE") do |filename|
+    stored_opts = YAML.load(File.read(filename))
+    init_opts.merge!(stored_opts)
+  end
+  
+  opts.on('-a', '--attribute-xml', "Include object/datastream attribute XML files","in directory listings") do
+    init_opts[:attribute_xml] = true
+  end
+  
+  opts.on('-c', '--cert-file FILE', "Use client certificate from FILE") do |filename|
+    init_opts[:cert_file] = File.expand_path(filename)
+  end
+
+  opts.on('-D', '--no-daemon', "Run in the foreground (for debugging)") do
+    daemonize = false
+  end
+  
+  opts.on('-f', '--fedora-url URL', "Use Fedora instance at URL") do |val|
+    init_opts[:url] = val
+  end
+
+  opts.on('-k', '--key-file FILE', "Use client key from FILE") do |filename|
+    init_opts[:key_file] = File.expand_path(filename)
+  end
+
+  opts.on('--log-file FILE', "Send logging output to FILE") do |logfile|
+    init_opts[:log_file] = File.expand_path(logfile)
+  end
+  
+  opts.on('--log-level LEVEL', Integer, "Set the logging level (0-5; 0 = most verbose)") do |level|
+    init_opts[:log_level] = level.to_i
+  end
+  
+  opts.on('-m', '--mount-point DIR', "Mount filesystem on DIR") do |val|
+    init_opts[:mount_point] = val
+  end
+  
+  opts.on('-p', '--key-pass STRING', "Password for client key") do |val|
+    init_opts[:key_pass] = val
+  end
+
+  opts.on('-R', '--read-only', "Don't allow editing of datastream content") do
+    init_opts[:read_only] = true
+  end
+  
+  opts.on('-r', '--refresh SECONDS', "Refresh directory structure every SECONDS seconds") do |val|
+    init_opts[:refresh_time] = val
+  end
+
+  opts.on('-u', '--user USER', "Authenticate to Fedora as USER") do |val|
+    init_opts[:user] = val
+  end
+  
+  opts.on('-v', '--volname NAME', "Mount the volume as NAME") do |val|
+    init_opts[:vol_name] = val
+  end
+
+  opts.on('-w', '--password PASS', "Authenticate to Fedora using PASS") do |val|
+    init_opts[:password] = val
+  end
+  
+  opts.on('-z', '--cache-size', "Number of objects to hold in memory") do |size|
+    init_opts[:cache_size] = size.to_i
+  end
+  
+  opts.on_tail('-s', '--save FILE', "Save options to FILE") do |filename|
+    File.open(filename, 'w') { |f| YAML.dump(init_opts, f) }
+  end
+  
+  opts.on_tail('-h', '--help', "Show this help message") do
+    puts opts
+    exit
+  end
+
+end
+
+optparse.parse!
+
+def setup(init_opts)
+  dirname = init_opts.delete(:mount_point)
+  volume_name = init_opts.delete(:vol_name)
+
+  unless File.directory?(dirname)
+    if File.exists?(dirname)
+      puts "Usage: #{dirname} is not a directory."
+      exit
+    else
+      FileUtils.mkdir_p(dirname)
+    end
+  end
+
+  root = FedoraFS.new(init_opts)
+  root.logger.info("Mounting #{init_opts[:url]} as #{volume_name} on #{dirname}")
+  # Set the root FuseFS
+  FuseFS.set_root(root)
+  FuseFS.mount_under(dirname, 'noappledouble', 'noapplexattr', 'nolocalcaches', %{volname=#{volume_name}})
+  return root
+end
+
+group = Daemons::ApplicationGroup.new("fedorafs:#{init_opts[:vol_name]}", :ontop => !daemonize)
+group.new_application(:mode => :proc, :proc => lambda {
+  setup(init_opts)
+  FuseFS.run
+}).start

data/config/sample_config.yml

@@ -0,0 +1,13 @@
+--- 
+:url: https://example.edu/fedora
+:cert_file: /path/to/ssl.crt
+:key_file: /path/to/ssl.key
+:key_pass: "ssl_key_password"
+:user: fedoraAdmin
+:password: fedoraAdmin
+:splitters: 
+  local: /(..?)/
+  druid: /([a-z]{2})([0-9]{3})([a-z]{2})([0-9]{4})/
+:vol_name: fedora
+:mount_point: /Volumes/fedora
+:profile_xml: false

data/lib/fedorafs.rb

@@ -0,0 +1,414 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'fileutils'
+require 'fusefs'
+require 'json'
+require 'logger'
+require 'nokogiri'
+require 'optparse'
+require 'ostruct'
+require 'rest-client'
+require 'rufus/lru'
+require 'mime/types'
+require 'traceable'
+
+class FedoraFS < FuseFS::FuseDir
+  include FuseFS
+  include Traceable
+
+  class PathError < Exception; end
+
+  FOXML_XML = 'foxml.xml'
+  PROPERTIES_XML = 'profile.xml'
+  RISEARCH_CONTENTS_PARAMS = { :query => "select $object from <#ri> where $object <info:fedora/fedora-system:def/model#label> $label", :type => 'tuples', :lang => 'itql', :format => 'CSV' }
+  SPECIAL_FILES = {
+    :attributes => ["last_refresh", "next_refresh", "object_cache", "object_count"],
+    :signals    => ["log_level", "read_only", "attribute_xml", "refresh_time"]
+  }
+  DEFAULT_OPTS = {
+    :url => 'http://localhost:8983/fedora/', :user => nil, :password => nil,
+    :cert_file => nil, :key_file => nil, :key_pass => '',
+    :logdev => $stderr, :log_level => Logger::INFO,
+    :cache_size => 1000, :refresh_time => 120,
+    :attribute_xml => false, :read_only => false,
+    :splitters => {},
+  }
+  DEFAULT_SPLITTERS = { :default => /.+/, 'fedora-system' => /.+/ }
+    
+  attr_reader :repo, :last_refresh, :logger, :opts
+  attr_accessor :read_only, :attribute_xml, :refresh_time
+  
+  def initialize(init_opts = {})
+    traceables = Array(init_opts.delete(:trace_methods))
+    self.class.trace(*traceables) unless traceables.empty?
+
+    @opts = OpenStruct.new(DEFAULT_OPTS.merge(init_opts))
+
+    rest_opts = { :user => opts.user, :password => opts.password }
+    unless opts.cert_file.nil?
+      rest_opts[:ssl_client_cert] = OpenSSL::X509::Certificate.new(File.read(opts.cert_file))
+    end
+    unless opts.key_file.nil?
+      rest_opts[:ssl_client_key] = OpenSSL::PKey::RSA.new(File.read(opts.key_file), opts.key_pass)
+    end
+    @repo = RestClient::Resource.new(opts.url, rest_opts)
+    
+    @last_refresh = nil
+    @cache = LruHash.new(opts.cache_size)
+    @pids = nil
+    
+    opts.splitters = DEFAULT_SPLITTERS.merge(opts.splitters)
+    opts.splitters.each_pair do |k,v| 
+      if v.is_a?(String)
+        opts.splitters[k] = Regexp.compile(v.gsub(/^\/|\/$/,''))
+      end
+    end
+  end
+  
+  def contents(path)
+    parts = scan_path(path)
+    if parts.empty?
+      return pid_tree.keys
+    else
+      current_dir, dir_part, parts, pid = traverse(parts)
+      if current_dir.nil?
+        files = [FOXML_XML]
+        files << PROPERTIES_XML if attribute_xml
+        with_exception_logging([]) do
+          datastreams(pid).each do |ds|
+            mime = MIME::Types[ds_properties(pid,ds)['dsmime']].first
+            files << (mime.nil? ? ds : "#{ds}.#{mime.extensions.first}")
+            files << "#{ds}.#{PROPERTIES_XML}" if attribute_xml
+          end
+        end
+        if parts.empty?
+          files
+        else
+          fname = parts.shift
+          files.select { |f| f == fname }
+        end
+      else
+        return current_dir.keys
+      end
+    end
+  end
+  
+  def directory?(path)
+    return false if path =~ /\._/
+    return false if is_attribute_file?(path)
+    parts = scan_path(path)
+    return true if parts.empty?
+    current_dir, dir_part, parts, pid = begin
+      traverse(parts)
+    rescue PathError
+      return false
+    end
+    if current_dir.nil?
+      return parts.empty?
+    else
+      return true
+    end
+  end
+  
+  def file?(path)
+    return false if path =~ /\._/
+    return true if is_attribute_file?(path) or is_signal_file?(path)
+    parts = scan_path(path)
+    current_dir, dir_part, parts, pid = begin
+      traverse(parts)
+    rescue PathError
+      return false
+    end
+    if parts.empty?
+      return true
+    else
+      file = parts.last
+      list = contents(File.dirname(path))
+      list.any? { |entry| entry == file or PROPERTIES_XML == file or File.basename(entry,File.extname(entry))+'.'+PROPERTIES_XML == file }
+    end
+  end
+  
+  def size(path)
+    return false if path =~ /\._/
+    if is_attribute_file?(path) or is_signal_file?(path)
+      return read_file(path).length
+    elsif write_stack.has_key?(path)
+      write_stack[path].length
+    else
+      parts = scan_path(path)
+      current_dir, dir_part, parts, pid = begin
+        traverse(parts)
+      rescue PathError
+        return false
+      end
+
+      if parts.last == FOXML_XML
+        read_file(path).length
+      elsif parts.last =~ /#{PROPERTIES_XML}$/
+        read_file(path).length
+      else
+        dsid = dsid_from_filename(parts.last)
+        ds_properties(pid, dsid)['dssize'].to_i
+      end
+    end
+  end
+  
+  # atime, ctime, mtime, and utime aren't implemented in FuseFS yet
+  def atime(path)
+    utime(path)
+  end
+
+  def ctime(path)
+    utime(path)
+  end
+  
+  def mtime(path)
+    utime(path)
+  end
+  
+  def utime(path)
+    parts = scan_path(path)
+    current_dir, dir_part, parts, pid = traverse(parts)
+    dsid = dsid_from_filename(parts.last)
+    Time.parse(ds_properties(pid, dsid)['dscreatedate'])
+  end
+  
+  def read_file(path)
+    return '' if path =~ /\._/
+    unless write_stack[path].nil?
+      write_stack[path]
+    else
+      with_exception_logging do
+        if is_attribute_file?(path) or is_signal_file?(path)
+          accessor = File.basename(path,File.extname(path)).sub(/^\.+/,'').to_sym
+          content = self.send(accessor)
+          "#{content.to_s}\n"
+        else
+          parts = scan_path(path)
+          current_dir, dir_part, parts, pid = traverse(parts)
+          fname = parts.last
+          if fname == FOXML_XML
+            @repo["objects/#{pid}/export"].get
+          elsif fname == PROPERTIES_XML
+            @repo["objects/#{pid}?format=xml"].get
+          elsif fname =~ /^(.+)\.#{PROPERTIES_XML}$/
+            dsid = $1
+            @repo["objects/#{pid}/datastreams/#{dsid}.xml"].get
+          else
+            dsid = dsid_from_filename(fname)
+            @repo["objects/#{pid}/datastreams/#{dsid}/content"].get
+          end
+        end
+      end
+    end
+  end
+  
+  def can_write?(path)
+    if is_signal_file?(path) or (path =~ /\._/) # We'll fake it out in #write_to()
+      return true
+    elsif read_only or is_attribute_file?(path)
+      return false
+    else
+      parts = scan_path(path)
+      return (file?(path) and (parts.last != FOXML_XML) and (parts.last !~ /#{PROPERTIES_XML}$/))
+    end
+  end
+  
+  def write_to(path,content)
+    if content.empty? and write_stack[path].nil?
+      write_stack[path] = content
+    else
+      write_stack.delete(path)
+      with_exception_logging do
+        if is_signal_file?(path)
+          logger.debug("Setting #{File.basename(path)} to #{content.chomp.inspect}")
+          accessor = "#{File.basename(path)}=".to_sym
+          self.send(accessor, content)
+        else
+          unless read_only or (path =~ /\._/) or (path =~ /#{FOXML_XML}$/) or (path =~ /#{PROPERTIES_XML}$/)
+            parts = scan_path(path)
+            current_dir, dir_part, parts, pid = traverse(parts)
+            fname = parts.last
+            dsid = dsid_from_filename(fname)
+            mime = ds_properties(pid,dsid)['dsmime'] || 'application/octet-stream'
+            resource = @repo["objects/#{pid}/datastreams/#{dsid}?logMessage=Fedora+FUSE+FS"]
+            resource.put(content, :content_type => mime)
+          end
+        end
+      end
+    end
+    return content
+  end
+  
+  def can_mkdir?(path)
+    return false
+  end
+
+  def can_rmdir?(path)
+    return false
+  end
+  
+  def can_delete?(path)
+    return true # We're never actually going to delete anything, though.
+  end
+
+  # Attribute accessors
+  def attribute_xml
+    opts.attribute_xml
+  end
+  
+  def attribute_xml=(value)
+    opts.attribute_xml = bool(value)
+  end
+  
+  def cache(pid)
+    unless @cache.has_key?(pid)
+      @cache[pid] = {}
+    end
+    @cache[pid]
+  end
+
+  def log_level
+    logger.level
+  end
+  
+  def log_level=(value)
+    logger.level = opts.log_level = value.to_i
+  end
+  
+  def logger
+    @logger ||= Logger.new(opts.logdev)
+    @logger.level = opts.log_level
+    @logger
+  end
+  
+  def next_refresh
+    @last_refresh.nil? ? Time.now : (@last_refresh + opts.refresh_time)
+  end
+  
+  def object_cache
+    @cache.to_json
+  end
+  
+  def object_count(hash = @pids)
+    result = 0
+    hash.each_pair { |k,v| result += v.nil? ? 1 : object_count(v) }
+    result
+  end
+  
+  def read_only
+    opts.read_only
+  end
+  
+  def read_only=(value)
+    opts.read_only = bool(value)
+  end
+  
+  def refresh_time
+    opts.refresh_time
+  end
+  
+  def refresh_time=(value)
+    opts.refresh_time = value.to_i
+  end
+  
+  private
+  # Convenience methods
+  def bool(value)
+    if value.is_a?(String)
+      value.empty? ? value : value.chomp == 'true'
+    else
+      value ? true : false
+    end
+  end
+  
+  def with_exception_logging(default = nil)
+    begin
+      return yield
+    rescue Exception => e
+      logger.error(e.message)
+      logger.debug(e.backtrace)
+      return default
+    end
+  end
+  
+  def write_stack
+    @write_stack ||= {}
+  end
+  
+  # Content methods
+  def dsid_from_filename(filename)
+    File.basename(filename,File.extname(filename))
+  end
+  
+  def is_attribute_file?(path)
+    File.dirname(path) == '/' and SPECIAL_FILES[:attributes].include?(File.basename(path))
+  end
+
+  def is_signal_file?(path)
+    File.dirname(path) == '/' and SPECIAL_FILES[:signals].include?(File.basename(path))
+  end
+  
+  def datastreams(pid)
+    return [] unless pid =~ /^[^\.].+:.+$/
+    obj = cache(pid)
+    unless obj[:datastreams]
+      resource = @repo["objects/#{pid}/datastreams.xml"]
+      doc = Nokogiri::XML(resource.get)
+      obj[:datastreams] = doc.search('/objectDatastreams/datastream').collect { |ds| ds['dsid'] }
+    end
+    obj[:datastreams]
+  end
+  
+  def ds_properties(pid, dsid)
+    return [] unless pid =~ /^[^\.].+:.+$/ and dsid !~ /^\./
+    obj = cache(pid)
+    unless obj.has_key?(dsid)
+      resource = @repo["objects/#{pid}/datastreams/#{dsid}.xml"]
+      doc = Nokogiri::XML(resource.get)
+      obj[dsid] = Hash[doc.search('/datastreamProfile/*').collect { |node| [node.name.downcase, node.text] }]
+    end
+    obj[dsid]
+  end
+  
+  def pid_tree
+    if @pids.nil? or (Time.now >= next_refresh)
+      @pids = {}
+      response = @repo['risearch'].post(RISEARCH_CONTENTS_PARAMS)
+      pids = response.split(/\n/).collect { |pid| pid.sub(%r{^info:fedora/},'') }
+      pids.shift
+      pids.each do |pid|
+        namespace, id = pid.split(/:/,2)
+        splitter = opts.splitters[namespace] || opts.splitters[:default]
+        stem = @pids[namespace] ||= {}
+        pidtree = id.scan(splitter).flatten
+        until pidtree.empty?
+          pid_part = pidtree.shift
+          stem = stem[pid_part] ||= pidtree.empty? ? nil : {}
+        end
+      end
+      @last_refresh = Time.now
+    end
+    @pids
+  end
+
+  def traverse(parts)
+    dir_part = parts.shift
+    pid = "#{dir_part}:"
+    current_dir = pid_tree[dir_part]
+    if current_dir.nil?
+      raise PathError, "Path not found: #{File.join(*parts)}"
+    end
+    until parts.empty? or current_dir.nil?
+      dir_part = parts.shift
+      if current_dir.has_key?(dir_part)
+        pid += dir_part
+        current_dir = current_dir[dir_part]
+      else
+        raise PathError, "Path not found: #{File.join(*parts)}"
+      end
+    end
+    return([current_dir, dir_part, parts, pid])
+  end
+end

data/lib/fusefs-patch.rb

@@ -0,0 +1,14 @@
+# FuseFS is a little broken. We can fix it here until it's
+# fixed in the distribution
+def FuseFS.run
+  fd = FuseFS.fuse_fd
+  begin
+    io = IO.for_fd(fd)
+  rescue Errno::EBADF
+    raise "fuse is not mounted"
+  end
+  while @running
+    reads, foo, errs = IO.select([io],nil,[io])
+    break unless FuseFS.process
+  end
+end

data/lib/traceable.rb

@@ -0,0 +1,45 @@
+module Traceable
+  
+  def self.included(mod)
+    mod.module_eval do
+      def output_trace_msg(msg)
+        logdev = respond_to?(:logger) ? logger : $stderr
+        if logdev.respond_to?(:debug)
+          logdev.debug(msg)
+        elsif logdev.respond_to?(:puts)
+          logdev.puts(msg)
+        else
+          logdev << msg
+        end
+      end
+      
+      def self.trace(*method_names)
+        method_names.each { |method_name|
+          unless self.instance_methods.include?("__TRACE_#{method_name.to_s}__")
+            self.class_eval do
+              alias_method :"__TRACE_#{method_name.to_s}__", method_name
+              define_method method_name do |*args, &block|
+                output_trace_msg("TRACE : #{method_name}(#{args.collect { |a| a.inspect }.join(',')})")
+                result = self.send(:"__TRACE_#{method_name.to_s}__", *args, &block)
+                output_trace_msg("RESULT: #{result.inspect}")
+                result
+              end
+            end
+          end
+        }
+      end
+      
+      def self.untrace(*method_names)
+        method_names.each { |method_name|
+          if self.instance_methods.include?("__TRACE_#{method_name.to_s}__")
+            self.class_eval do
+              alias_method method_name, :"__TRACE_#{method_name.to_s}__"
+              undef_method :"__TRACE_#{method_name.to_s}__"
+            end
+          end
+        }
+      end
+    end
+  end
+    
+end

metadata

@@ -0,0 +1,273 @@
+--- !ruby/object:Gem::Specification 
+name: fedora-fs
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 2
+  version: 0.3.2
+platform: ruby
+authors: 
+- Michael B. Klein
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-05 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: daemons
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: fusefs-osx
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: json_pure
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rufus-lru
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 49
+        segments: 
+        - 0
+        - 8
+        - 7
+        version: 0.8.7
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: rdoc
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id009
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
+        version: "2.0"
+  type: :development
+  version_requirements: *id010
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id011
+- !ruby/object:Gem::Dependency 
+  name: redcarpet
+  prerelease: false
+  requirement: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id012
+- !ruby/object:Gem::Dependency 
+  name: ruby-debug
+  prerelease: false
+  requirement: &id013 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id013
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id014 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id014
+description: Mounts a Fedora Commons repository as a FUSE filesystem
+email: 
+- mbklein@stanford.edu
+executables: 
+- mount_fedora
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/fedorafs.rb
+- lib/fusefs-patch.rb
+- lib/traceable.rb
+- bin/mount_fedora
+- config/sample_config.yml
+- README.markdown
+has_rdoc: true
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: FUSE filesystem for Fedora Commons repositories
+test_files: []
+