rfusefs 1.0.2.RC0 → 1.1.0.rc202009.34

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a3be9d9f33c4755ba71b12bce9a95e76e3ddd7f17066a9c39c248d56464638ec
+  data.tar.gz: 69335105b13cc54ae267045f4d8320a715b86680dde02acdb307dc8d7fe8235e
+SHA512:
+  metadata.gz: fae5751cf1389148656db47b801c0d12479ccdd0eab7b0bb9f3a5c7c50661299458637594115b3f1d2076c2a5beb20d3863d8865f1fe33a3b2c81aad5e7de131
+  data.tar.gz: f042fcf45c0da85a3aafdd8bfe9f177aafd005b6286ffd484188631ad8ef8ee2b571f91a065d5e2f21e0464b26058a8d47de8bcdb676b9ab0bbc859addd2bfd4

data/.yardopts

@@ -0,0 +1,2 @@
+-
+CHANGES.md

data/CHANGES.md

@@ -0,0 +1,40 @@
+
+1.1.0 / 2020-10
+---------------
+
+ * With rfuse ~> 1.2
+ * Requires Ruby 2.5+
+ * Release via Travis CI
+
+1.0.3 / 2014-12-22
+----------------------
+
+ * Pushed some internals up to RFuse
+ * Allow filesystems to implement signal handlers
+
+1.0.1 / 2013-12-19
+------------------
+
+ * Add FuseFS.main to create pretty usage messages
+ * Support extended attributes in filesystems
+ * Updates and cleanup of PathMapperFS
+ * Provide SqliteMapperFS
+
+1.0.0 / 2012-08-07
+------------------
+
+ * Depend on new rfuse 1.0.0, Ruby 1.9
+ * API breaking changes
+ * order of arguments to {FuseFS.mount}, {FuseFS.start} changed 
+    to account for better option handling in RFuse
+
+0.8.0 / 2011-02-19
+------------------
+
+* Initial port from fusefs
+
+  * Improved raw methods
+  * new "times" api for including atime,mtime,ctime in stat results
+  * metadir allow mv directories
+  * includes PathMapperFS
+

data/LICENSE

@@ -0,0 +1,24 @@
+(The MIT License)
+
+*   Copyright (c) 2005 Greg Millam. (FuseFS)
+*   Copyright (c) 2009 Kyle Maxwell. (FuseFS)
+*   Copyright (c) 2012 - 2020 Grant Gardner. (RFuseFS)
+
+
+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,83 @@
+# rfusefs
+
+*   https://rubygems.org/gems/rfusefs
+*   https://github.com/lwoggardner/rfusefs
+
+[<img src="https://badge.fury.io/rb/rfusefs.png" alt="Gem Version"
+/>](http://badge.fury.io/rb/rfusefs)
+## DESCRIPTION
+
+RFuseFS is a port of the [FuseFS](http://rubygems.org/gems/fusefs/) library
+aimed at allowing Ruby programmers to quickly and easily create virtual
+filesystems with little more than a few lines of code.
+
+RFuseFS is api compatible with FuseFS (0.7.0)
+
+## SYNOPSIS
+
+FuseFS provides a layer of abstraction to a programmer who wants to create a
+virtual filesystem via FUSE.
+
+First define a virtual directory by subclassing {FuseFS::FuseDir}
+
+See samples under /samples and also the following starter classes
+
+*   {FuseFS::FuseDir}
+*   {FuseFS::MetaDir}
+*   {FuseFS::DirLink}
+*   {FuseFS::PathMapperFS}
+*   {FuseFS::SqliteMapperFS}
+
+
+Then start your filesystem with
+
+*   {FuseFS.main} or {FuseFS.start}
+
+
+Finally to use the filesystem open up your favourite file browser/terminal and
+explore the contents under <mountpoint>
+
+Happy Filesystem Hacking!
+
+### the hello world filesystem in 14 LOC
+
+    require 'rfusefs'
+
+    class HelloDir
+
+      def contents(path)
+        ['hello.txt']
+      end
+
+      def file?(path)
+        path == '/hello.txt'
+      end
+
+      def read_file(path)
+        "Hello, World!\n"
+      end
+
+    end
+
+    # Usage: #{$0} mountpoint [mount_options]
+    FuseFS.main() { |options| HelloDir.new }
+
+## REQUIREMENTS:
+
+*   FUSE (http://fuse.sourceforge.net)
+*   Ruby (>= 2.5)
+*   rfuse (~> 1.2)
+
+
+## INSTALL:
+
+*   gem install rfusefs
+
+## DEVELOPERS:
+
+After checking out the source, run:
+
+    $ bundle install # install dependencies
+    $ rake spec # run tests
+    $ rake yard # generate docs
+

data/TODO.md

@@ -0,0 +1,7 @@
+
+TODO
+--------------
+
+ * Test (or remove) samples
+
+

data/lib/rfusefs.rb

@@ -45,28 +45,14 @@ module FuseFS
     #   end
     #
     def FuseFS.main(argv=ARGV,options=[],option_usage="",device=nil,exec=File.basename($0))
-        options = RFuse.parse_options(argv,*options)
-
-        if options[:mountpoint]
-            begin
-                fs = yield options
-            rescue StandardError => ex
-                puts ex.message
-                puts ex.backtrace.join("\n")
-            end
-
-            puts RFuse.usage(device,exec) if options[:help] || !fs
-            puts "Options:\n"  if options[:help]
-
-            FuseFS.start(fs,*argv) if fs || options[:help] 
-
-            puts option_usage if options[:help]
-        else
-            puts "rfusefs: failed, no mountpoint provided",RFuse.usage(device,exec)
+        RFuse.main(argv,options,option_usage,device,exec) do |options,argv|
+            root = yield options
+            FuseFS.set_root(root)
+            FuseFS.mount_under(*argv)
         end
     end
 
-    # Start the FuseFS root at mountpoint with opts. 
+    # Start the FuseFS root at mountpoint with opts.
     #
     # If not previously set, Signal traps for "TERM" and "INT" are added
     # to exit the filesystem
@@ -77,7 +63,6 @@ module FuseFS
     # @note RFuseFS extension
     # @return [void]
     def FuseFS.start(root,mountpoint,*opts)
-        set_default_traps("TERM","INT") { FuseFS.exit }
         FuseFS.set_root(root)
         begin
             FuseFS.mount_under(mountpoint,*opts)
@@ -88,7 +73,7 @@ module FuseFS
     end
 
     # Forks {FuseFS.start} so you can access your filesystem with ruby File
-    # operations (eg for testing). 
+    # operations (eg for testing).
     # @note This is an *RFuseFS* extension
     # @return [void]
     def FuseFS.mount(root,mountpoint,*opts)
@@ -126,43 +111,40 @@ module FuseFS
         end
     end
 
-    # Set the root virtual directory 
+    # Set the root virtual directory
     # @param root [Object] an object implementing a subset of {FuseFS::API}
     # @return [void]
     def FuseFS.set_root(root)
-        @fs=RFuseFS.new(root)
+        @fs=Fuse::Root.new(root)
     end
 
     # This will cause FuseFS to virtually mount itself under the given path. {set_root} must have
     # been called previously.
     # @param [String] mountpoint an existing directory where the filesystem will be virtually mounted
     # @param [Array<String>] args
+    # @return [Fuse] the mounted fuse filesystem
     #  These are as expected by the "mount" command. Note in particular that the first argument
     #  is expected to be the mount point. For more information, see http://fuse.sourceforge.net
     #  and the manual pages for "mount.fuse"
-    def FuseFS.mount_under(mountpoint, *args)    
-        @fuse = RFuse::FuseDelegator.new(@fs,mountpoint,*args)
+    def FuseFS.mount_under(mountpoint, *args)
+        @fuse = Fuse.new(@fs,mountpoint,*args)
     end
 
-    # This is the main loop waiting on then executing filesystem operations from the
-    # kernel. 
-    #    
+    # This is the main loop waiting on, then executing, filesystem operations from the
+    # kernel.
+    #
     # Note: Running in a separate thread is generally not useful. In particular
-    #       you cannot access your filesystem using ruby File operations.
+    #       you cannot use Ruby File operations to access your filesystem from
+    #       within the ruby process that calls run.
     # @note RFuseFS extension
     def FuseFS.run
-        @fs.mounted()
-        @fuse.loop if @fuse.mounted? 
-    ensure
-        @fs.unmounted()
+        @fuse.run()
     end
 
-    #  Exit the run loop and teardown FUSE   
-    #  Most useful from Signal.trap() or Kernel.at_exit()  
+    #  Exit the run loop and teardown FUSE
+    #  Most useful from Signal.trap() or Kernel.at_exit()
     def FuseFS.exit
-        if @fuse
-            @fuse.exit
-        end
+        @fuse.exit if @fuse
     end
 
     # @return [Fixnum] the calling process uid
@@ -177,23 +159,16 @@ module FuseFS
         Thread.current[:fusefs_reader_gid]
     end
 
-    # Not supported in RFuseFS (yet). The original FuseFS had special handling for editor
-    # swap/backup but this does not seem to be required, eg for the demo filesystems.
-    # If it is required it can be implemented in a filesystem
+    # Not supported in RFuseFS.
+    #
+    # The original FuseFS had special handling for editor swap/backup files
+    # which appears to be a workaround for a bug where zero length files
+    # where never written to. This "bug" is fixed since RFuseFS 1.0.2
+    #
     # @deprecated
     def self.handle_editor(bool)
         #do nothing
     end
 
-    private
-    
-    def self.set_default_traps(*signals,&block)
-        signals.each do |sig|
-            old_proc = Signal.trap(sig,block)
-            unless "DEFAULT".eql?(old_proc)
-                Signal.trap(sig,old_proc)
-            end
-        end
-    end
 end
 

metadata

@@ -1,175 +1,164 @@
 --- !ruby/object:Gem::Specification
 name: rfusefs
 version: !ruby/object:Gem::Version
-  version: 1.0.2.RC0
-  prerelease: 6
+  version: 1.1.0.rc202009.34
 platform: ruby
 authors:
 - Grant Gardner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-02 00:00:00.000000000 Z
+date: 2020-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rfuse
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.4
+        version: '1.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.4
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
-    none: false
     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: sys-filesystem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: ffi-xattr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
 description: A more Ruby like way to write FUSE filesystems - inspired by (compatible
   with) FuseFS, implemented over RFuse
 email:
 - grant@lastweekend.com.au
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- CHANGES.md
 files:
-- .gitignore
-- .travis.yml
-- Gemfile
-- History.rdoc
-- README.rdoc
-- Rakefile
-- TODO.txt
-- lib/fuse/fusedir.rb
-- lib/fuse/rfusefs-fuse.rb
+- ".yardopts"
+- CHANGES.md
+- LICENSE
+- README.md
+- TODO.md
 - lib/fusefs.rb
-- lib/fusefs/dirlink.rb
-- lib/fusefs/metadir.rb
-- lib/fusefs/pathmapper.rb
-- lib/fusefs/sqlitemapper.rb
 - lib/rfusefs.rb
-- lib/rfusefs/version.rb
-- rfusefs.gemspec
-- samples/demo.rb
-- samples/dictfs.rb
-- samples/hello.rb
-- samples/openurifs.rb
-- samples/railsfs.rb
-- samples/sqlfs.rb
-- samples/yamlfs.rb
-- spec-fusefs/fusefs_spec.rb
-- spec/metadir_spec.rb
-- spec/mount_unmount_spec.rb
-- spec/pathmapper_spec.rb
-- spec/rfusefs_spec.rb
-- spec/sample_spec.rb
-- spec/spec_helper.rb
-- spec/sqlitemapper_spec.rb
 homepage: http://rubygems.org/gems/rfusefs
-licenses: []
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>'
+  - - ">"
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 3.0.8
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Filesystem in Ruby Userspace
 test_files: []
-has_rdoc: yard