invfs 0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2909cffa456fdd3f5b4fc6efdbc4cfaa07f1faf30db565da868af67233bf9635
+  data.tar.gz: f5db8163c2fb5533c7fb72deab583d66c3b54d8bb29058c426d68733d2020821
+SHA512:
+  metadata.gz: e4126c3039e12664d9564ff9877dafc8694777f91d286f3fe800667ed7df2ce8379d2d5488bee2c966bf7b7e8ff600368e6bab47a75ec98ee73faa13a3e1cfba
+  data.tar.gz: 8b05d884e52a39537978f395e886f975f87a946e9ed38dcd04a145e9528c6408c2edf4582aab535d8a9f39a00a59ba1832c0462aab86bdcaa2671bddca9c0e56

data/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2017, dearblue. All rights reserved.
+
+Redistribution and use in source and binary forms, with or
+without modification, are permitted provided that the following
+conditions are met:
+
+ 1. Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,191 @@
+# invfs - customization "require" in VFS support
+
+ruby の ``require`` に仮想ファイルシステム (VFS; Virtual Filesystem) 対応機能を追加します。
+
+  * package name: invfs <https://github.com/dearblue/ruby-invfs>
+  * version: 0.2
+  * production quality: CONCEPT, EXPERIMENTAL, UNSTABLE
+  * license: BSD-2-clause License
+  * author: dearblue <mailto:dearblue@users.noreply.github.com>
+  * report issue to: <https://github.com/dearblue/ruby-invfs/issues>
+  * dependency ruby: ruby-2.2+
+  * dependency ruby gems:
+      * rubyzip-1.2.0 (BSD-2-Clause)
+          * https://github.com/rubyzip/rubyzip
+          * https://rubygems.org/gems/rubyzip
+  * dependency library: (none)
+  * bundled external C library: (none)
+
+
+## How to install (インストールの仕方)
+
+```shell
+# gem install invfs
+```
+
+
+## How to use (使い方)
+
+この例では ``mybox.zip`` という Zip 書庫ファイルの中に ``mybox/core.rb``
+という Ruby スクリプトファイルが存在しているものとして解説を進めていきます。
+
+mybox.zip の中身:
+
+```text
+$ unzip -v mybox.zip
+Archive:  mybox.zip
+ Length   Method    Size  Cmpr    Date    Time   CRC-32   Name
+--------  ------  ------- ---- ---------- ----- --------  ----
+      69  Defl:X       60  13% 01-26-2017 00:24 8d7bd341  mybox/core.rb
+--------          -------  ---                            -------
+      69               60  13%                            1 file
+```
+
+mybox/core.rb の中身:
+
+```text
+$ unzip -p mybox.zip mybox/core.rb
+module MyBox
+  def MyBox.sayhello!
+    puts "Hello, Ruby!"
+  end
+end
+```
+
+Ruby スクリプトで実際に利用する場合は次のようにします:
+
+```ruby:ruby
+require "invfs/zip"           # (1)
+
+$: << InVFS.zip("mybox.zip")  # (2)
+
+require "mybox/core"          # (3)
+
+MyBox.sayhello!
+# => Hello, Ruby!
+```
+
+ 1. ``require "invfs"`` すると、それ以降で VFS を探す機能が利用できるようになります。
+
+    ``require "invfs/zip"`` すると、rubyzip を用いて zip 書庫ファイルから読み込めるようになります。
+
+ 2. ``$:`` に VFS としての機能を持った任意のオブジェクトを追加します。
+
+    ``$: << InVFS.zip("mybox.zip")`` の部分です。
+
+ 3. ``require`` で任意のライブラリを指定します。
+
+    VFS 内から同じ VFS のファイルを指定したい場合、``require_relative`` も利用できます。
+
+
+## VFS オブジェクトについて
+
+VFS オブジェクトは ``$:`` に追加する、利用者定義のロードパスと見せかけるオブジェクトです。
+
+このオブジェクトは、以下のメソッドが要求されます。
+
+  * ``.to_path() -> string``
+  * ``.file?(path) -> true or false``
+  * ``.size(path) -> integer``
+  * ``.read(path) -> string as binary``
+
+実際にどのように定義すればいいのかについては、[lib/invfs/zip.rb](lib/invfs/zip.rb) あるいは [lib/invfs.rb](lib.invfs.rb) で定義されている ``InVFS::UnionFS``、``InVFS::StringMapFS`` を参考にして下さい。
+
+### ``.to_path() -> string``
+
+ロードパスに変換するためのメソッドです。
+
+***文字列を返してください。***
+
+ruby が提供する本来の require の内部や File.join が ``to_path`` して、
+文字列以外を文字列に変換するために呼びます
+(``file.c:rb_get_path_check_to_string``)。
+
+### ``.file?(path) -> true or false``
+
+VFS 内部にファイルが存在するかを確認するためのメソッドです。
+
+***真偽値を返して下さい。***
+
+path に関して発生した例外は出来る限り捕捉して、false を返すべきです。
+
+### ``.size(path) -> integer``
+
+ファイルサイズを取得するためのメソッドです。
+
+***0 以上の整数値を返して下さい。***
+
+### ``.read(path) -> string as binary``
+
+VFS からファイルを読み込むためのメソッドです。
+
+***文字列、または nil を返して下さい。***
+
+
+## Environment Variables (環境変数について)
+
+  * ``RUBY_REQUIRE_INVFS_MAX_LOADSIZE`` :: 読み込みファイルの最大ファイルサイズの指定
+
+    VFS 内における読み込み対象ファイルの最大ファイルサイズを指定することが出来ます。
+
+    数値に続けて接頭辞を付けることが出来ます。以下は 64 MiB とした時の指定です。
+
+    ```shell
+    $ export RUBY_REQUIRE_INVFS_MAX_LOADSIZE=64mib
+    ```
+
+    最小値は 256 KiB、最大値は 64 MiB、既定値は 2 MiB となっています。
+
+
+## 課題
+
+  * セキュリティレベル? なにそれおいしいの?
+
+  * マルチスレッド? なにそれおいしいの?
+
+    複数のスレッドで VFS 内のファイルを指定した場合は、``$LOADED_FEATURES``
+    に不整合が起きる可能性がある。
+
+  * ``require`` / ``require_relative`` の探索速度がとても遅い。
+
+    ``require "invfs"`` しただけで、3倍以上遅くなる。
+
+    VFS 内の ``.so`` ファイルの読み込みにいたっては、10倍以上遅くなる。
+
+  * VFS オブジェクトのシグネチャが変動すると不整合が起きる。
+
+    ``$LOAD_PATH`` に追加された VFS オブジェクトのシグネチャ (``.to_path``)
+    が変動すると、同じライブラリを ``require`` した時に ``$LOADED_FEATURES``
+    と一致しなくなるため、再読み込みしてしまう。
+
+    シグネチャの解決に ``.object_id`` などを用いるべき?
+
+    => ``require_relative`` したファイルの VFS が決定しやすくなるが、ファイルパス名
+    (VFS 名) が暗号みたくなって特定しづらそう。
+
+  * ``require`` した後に ``$LOAD_PATH`` から VFS オブジェクトを除去すると ``require_relative`` で不具合が起きる。
+
+  * パス解決の正確性を向上させるか?
+
+    ライブラリへの指定が相対パスで、シンボリックリンクが絡んでくると不正確になる。
+
+  * ``require`` されたファイルが VFS から取り出されたのかを確認する処理は文字列の比較であるため不正確。
+
+    これは直接 ``require_relative`` する時の VFS を確認する処理に関係してくる。
+
+    ``caller_locations`` で VFS の直接確認が出来るようにするためには ruby の
+    C コードに手を入れなきゃなんないし諦める。
+
+  * ``$:`` にファイルを指定した場合、InVFS の VFS mapper が自動で VFS に置き換えるようにするか?
+
+    実現させると、以下のことが可能となる:
+
+    ```shell
+    $ ruby -I mybox.zip -r invfs/zip -r mybox/core -e '......'
+    ```
+
+    これは、以下と同等である:
+
+    ```shell
+    $ ruby -r invfs/zip -e '$: << InVFS.zip("mybox.zip"); require "mybox/core"; ......'
+    ```

data/Rakefile

@@ -0,0 +1,212 @@
+
+require "pathname"
+require "rake/clean"
+
+docnames = "{README,LICENSE,CHANGELOG,Changelog,HISTORY}"
+doctypes = "{,.txt,.rd,.rdoc,.md,.markdown}"
+cexttypes = "{c,C,cc,cxx,cpp,h,H,hh}"
+
+DOC = FileList["#{docnames}{,.ja}#{doctypes}"] +
+      FileList["{contrib,ext}/**/#{docnames}{,.ja}#{doctypes}"] +
+      FileList["ext/**/*.#{cexttypes}"]
+EXT = FileList["ext/**/*"]
+BIN = FileList["bin/*"]
+LIB = FileList["lib/**/*.rb"]
+SPEC = FileList["spec/**/*"]
+TEST = FileList["test/**/*"]
+EXAMPLE = FileList["examples/**/*"]
+GEMSTUB_SRC = "gemstub.rb"
+RAKEFILE = [File.basename(__FILE__), GEMSTUB_SRC]
+EXTRA = []
+EXTCONF = FileList["ext/**/extconf.rb"]
+EXTCONF.reject! { |n| !File.file?(n) }
+EXTMAP = {}
+
+load GEMSTUB_SRC
+
+EXTMAP.dup.each_pair do |dir, name|
+  EXTMAP[Pathname.new(dir).cleanpath.to_s] = Pathname.new(name).cleanpath.to_s
+end
+
+GEMSTUB.extensions += EXTCONF
+GEMSTUB.executables += FileList["bin/*"].map { |n| File.basename n }
+GEMSTUB.executables.sort!
+
+PACKAGENAME = "#{GEMSTUB.name}-#{GEMSTUB.version}"
+GEMFILE = "#{PACKAGENAME}.gem"
+GEMSPEC = "#{PACKAGENAME}.gemspec"
+
+GEMSTUB.files += DOC + EXT + EXTCONF + BIN + LIB + SPEC + TEST + EXAMPLE + RAKEFILE + EXTRA
+GEMSTUB.files.sort!
+if GEMSTUB.rdoc_options.nil? || GEMSTUB.rdoc_options.empty?
+  readme = %W(.md .markdown .rd .rdoc .txt #{""}).map { |ext| "README#{ext}" }.find { |m| DOC.find { |n| n == m } }
+  GEMSTUB.rdoc_options = %w(--charset UTF-8) + (readme ? %W(-m #{readme}) : [])
+end
+GEMSTUB.extra_rdoc_files += DOC + LIB + EXT.reject { |n| n.include?("/externals/") || !%w(.h .hh .c .cc .cpp .cxx).include?(File.extname(n)) }
+GEMSTUB.extra_rdoc_files.sort!
+
+GEMSTUB_TRYOUT = GEMSTUB.dup
+GEMSTUB_TRYOUT.version = "#{GEMSTUB.version}#{Time.now.strftime(".TRYOUT.%Y%m%d.%H%M%S")}"
+PACKAGENAME_TRYOUT = "#{GEMSTUB.name}-#{GEMSTUB_TRYOUT.version}"
+GEMFILE_TRYOUT = "#{PACKAGENAME_TRYOUT}.gem"
+GEMSPEC_TRYOUT = "#{PACKAGENAME_TRYOUT}.gemspec"
+
+CLEAN << GEMSPEC << GEMSPEC_TRYOUT
+CLOBBER << GEMFILE
+
+task :default => :tryout do
+  $stderr.puts <<-EOS
+#{__FILE__}:#{__LINE__}:
+\ttype ``rake release'' to build release package.
+  EOS
+end
+
+desc "build tryout package"
+task :tryout
+
+desc "build release package"
+task :release => :all
+
+unless EXTCONF.empty?
+  RUBYSET ||= (ENV["RUBYSET"] || "").split(",")
+
+  if RUBYSET.nil? || RUBYSET.empty?
+    $stderr.puts <<-EOS
+#{__FILE__}:
+|
+| If you want binary gem package, launch rake with ``RUBYSET`` enviroment
+| variable for set ruby interpreters by comma separated.
+|
+|   e.g.) $ rake RUBYSET=ruby
+|     or) $ rake RUBYSET=ruby21,ruby22,ruby23
+|
+    EOS
+  else
+    platforms = RUBYSET.map { |ruby| `#{ruby} --disable-gems -e "puts RUBY_PLATFORM"`.chomp }
+    platforms1 = platforms.uniq
+    unless platforms1.size == 1 && !platforms1[0].empty?
+      abort <<-EOS
+#{__FILE__}:#{__LINE__}: different platforms:
+#{RUBYSET.zip(platforms).map { |ruby, platform| "%24s => %s" % [ruby, platform] }.join("\n")}
+ABORTED.
+      EOS
+    end
+    PLATFORM = platforms1[0]
+
+    RUBY_VERSIONS = RUBYSET.map do |ruby|
+      ver = `#{ruby} --disable-gems -e "puts RUBY_VERSION"`.slice(/\d+\.\d+/)
+      raise "failed ruby checking - ``#{ruby}''" unless $?.success?
+      [ver, ruby]
+    end
+
+    SOFILES_SET = RUBY_VERSIONS.map { |(ver, ruby)|
+      EXTCONF.map { |extconf|
+        extdir = Pathname.new(extconf).cleanpath.dirname.to_s
+        case
+        when soname = EXTMAP[extdir.sub(/^ext\//i, "")]
+          soname = soname.sub(/\.so$/i, "")
+        when extdir == "ext" || extdir == "."
+          soname = GEMSTUB.name
+        else
+          soname = File.basename(extdir)
+        end
+
+        [ruby, File.join("lib", "#{soname.sub(/(?<=\/)|^(?!.*\/)/, "#{ver}/")}.so"), extconf]
+      }
+    }.flatten(1)
+    SOFILES = SOFILES_SET.map { |(ruby, sopath, extconf)| sopath }
+
+    GEMSTUB_NATIVE = GEMSTUB.dup
+    GEMSTUB_NATIVE.files += SOFILES
+    GEMSTUB_NATIVE.platform = Gem::Platform.new(PLATFORM).to_s
+    GEMSTUB_NATIVE.extensions.clear
+    GEMFILE_NATIVE = "#{GEMSTUB_NATIVE.name}-#{GEMSTUB_NATIVE.version}-#{GEMSTUB_NATIVE.platform}.gem"
+    GEMSPEC_NATIVE = "#{GEMSTUB_NATIVE.name}-#{GEMSTUB_NATIVE.platform}.gemspec"
+
+    task :all => ["native-gem", GEMFILE]
+
+    desc "build binary gem package"
+    task "native-gem" => GEMFILE_NATIVE
+
+    desc "generate binary gemspec"
+    task "native-gemspec" => GEMSPEC_NATIVE
+
+    file GEMFILE_NATIVE => DOC + EXT + EXTCONF + BIN + LIB + SPEC + TEST + EXAMPLE + SOFILES + RAKEFILE + [GEMSPEC_NATIVE] do
+      sh "gem build #{GEMSPEC_NATIVE}"
+    end
+
+    file GEMSPEC_NATIVE => RAKEFILE do
+      File.write(GEMSPEC_NATIVE, GEMSTUB_NATIVE.to_ruby, mode: "wb")
+    end
+
+    desc "build c-extension libraries"
+    task "sofiles" => SOFILES
+
+    SOFILES_SET.each do |(ruby, soname, extconf)|
+      sodir = File.dirname(soname)
+      makefile = File.join(sodir, "Makefile")
+
+      CLEAN << GEMSPEC_NATIVE << sodir
+      CLOBBER << GEMFILE_NATIVE
+
+      directory sodir
+
+      desc "generate Makefile for binary extension library"
+      file makefile => [sodir, extconf] do
+        rel_extconf = Pathname.new(extconf).relative_path_from(Pathname.new(sodir)).to_s
+        cd sodir do
+          sh *%W"#{ruby} #{rel_extconf} --ruby=#{ruby} #{ENV["EXTCONF"]}"
+        end
+      end
+
+      desc "build binary extension library"
+      file soname => [makefile] + EXT do
+        cd sodir do
+          sh "make"
+        end
+      end
+    end
+  end
+end
+
+
+task :all => GEMFILE
+task :tryout => GEMFILE_TRYOUT
+
+desc "generate local rdoc"
+task :rdoc => DOC + LIB do
+  sh *(%w(rdoc) + GEMSTUB.rdoc_options + DOC + LIB)
+end
+
+desc "launch rspec"
+task rspec: :all do
+  sh "rspec"
+end
+
+desc "build gem package"
+task gem: GEMFILE
+
+desc "generate gemspec"
+task gemspec: GEMSPEC
+
+desc "print package name"
+task "package-name" do
+  puts PACKAGENAME
+end
+
+file GEMFILE => DOC + EXT + EXTCONF + BIN + LIB + SPEC + TEST + EXAMPLE + RAKEFILE + [GEMSPEC] do
+  sh "gem build #{GEMSPEC}"
+end
+
+file GEMFILE_TRYOUT => DOC + EXT + EXTCONF + BIN + LIB + SPEC + TEST + EXAMPLE + RAKEFILE + [GEMSPEC_TRYOUT] do
+#file GEMFILE_TRYOUT do
+  sh "gem build #{GEMSPEC_TRYOUT}"
+end
+
+file GEMSPEC => RAKEFILE do
+  File.write(GEMSPEC, GEMSTUB.to_ruby, mode: "wb")
+end
+
+file GEMSPEC_TRYOUT => RAKEFILE do
+  File.write(GEMSPEC_TRYOUT, GEMSTUB_TRYOUT.to_ruby, mode: "wb")
+end

data/gemstub.rb

@@ -0,0 +1,11 @@
+GEMSTUB = Gem::Specification.new do |s|
+  s.name = "invfs"
+  s.version = File.read("README.md").slice(/^\s*\*\s*version\s*:+.+/).partition(/version\s*:+\s*/i)[2]
+  s.author = "dearblue"
+  s.license = "BSD-2-Clause"
+  s.email = "dearblue@users.noreply.github.com"
+  s.homepage = "https://github.com/dearblue/ruby-invfs"
+  s.summary = %(customization for "require" in VFS support)
+  s.description = %(Customization for "require" in Virtual Filesystem (VFS) support)
+  s.add_runtime_dependency "rubyzip", "~> 1.2"
+end

data/lib/invfs.rb

@@ -0,0 +1,366 @@
+#!ruby
+
+module InVFS
+end
+
+InVFS::TOPLEVEL_BINDING = binding.freeze
+
+require "pathname"
+require "tempfile"
+
+module InVFS
+  module Extensions
+    unless Numeric.method_defined?(:clamp)
+      refine Numeric do
+        def clamp(min, max)
+          case
+          when self < min
+            min
+          when self > max
+            max
+          else
+            self
+          end
+        end
+      end
+    end
+
+    unless String.method_defined?(:to_path)
+      refine String do
+        alias to_path to_s
+      end
+    end
+
+    refine String do
+      def to_i_with_unit
+        case strip
+        when /^(\d+(\.\d+)?)(?:([kmg])i?)?b?/i
+          unit = 1 << (10 * " kmgtp".index(($3 || " ").downcase))
+          ($1.to_f * unit).round
+        else
+          to_i
+        end
+      end
+    end
+
+    refine Integer do
+      alias to_i_with_unit to_i
+    end
+
+    refine Numeric do
+      def KiB
+        self * (1 << 10)
+      end
+
+      def MiB
+        self * (1 << 20)
+      end
+
+      def GiB
+        self * (1 << 30)
+      end
+    end
+
+    refine BasicObject do
+      def __native_file_path?
+        nil
+      end
+    end
+
+    [::String, ::File, ::Dir, ::Pathname].each do |klass|
+      refine klass do
+        def __native_file_path?
+          true
+        end
+      end
+    end
+
+    [::String, ::File, ::Dir].each do |klass|
+      refine klass do
+        def file?(path)
+          File.file?(File.join(self, path))
+        end
+      end
+    end
+
+    refine Object do
+      if Object.const_defined?(:DEBUGGER__)
+        BREAKPOINT_SET = {}
+
+        def __BREAKHERE__
+          locate = caller_locations(1, 1)[0]
+          __BREAKPOINT__(locate.path, locate.lineno + 1)
+        end
+
+        def __BREAKPOINT__(base, pos)
+          case base
+          when Module
+            pos = String(pos.to_sym)
+          when String
+            base = "#{base}".freeze
+            pos = pos.to_i
+          else
+            raise ArgumentError
+          end
+
+          key = [base, pos]
+          unless BREAKPOINT_SET[key]
+            BREAKPOINT_SET[key] = true
+            DEBUGGER__.break_points.push [true, 0, base, pos]
+          end
+
+          nil
+        end
+      else
+        def __BREAKHERE__
+          nil
+        end
+
+        def __BREAKPOINT__(base, pos)
+          nil
+        end
+      end
+    end
+  end
+
+  using Extensions
+
+  DEFAULT_MAX_LOADSIZE =   2.MiB
+  MINIMAL_MAX_LOADSIZE = 256.KiB
+  MAXIMAM_MAX_LOADSIZE =  64.MiB
+  maxloadsize = (ENV["RUBY_REQUIRE_INVFS_MAX_LOADSIZE"] || DEFAULT_MAX_LOADSIZE).to_i_with_unit
+  MAX_LOADSIZE = maxloadsize.clamp(MINIMAL_MAX_LOADSIZE, MAXIMAM_MAX_LOADSIZE)
+
+  #
+  # +$LOADED_FEATURES+ に追加される接頭辞
+  #
+  LOADED_PREFIX = "<inVFS>:".freeze
+
+  def InVFS.findlib(vfs, lib, relative)
+    if relative
+      if vfs.file?(lib)
+        lib
+      else
+        nil
+      end
+    else
+      case
+      when vfs.file?(lib)
+        lib
+      when vfs.file?(librb = lib + ".rb")
+        librb
+      when vfs.file?(libso = lib + ".so")
+        libso
+      else
+        nil
+      end
+    end
+  end
+
+  def InVFS.findvfs(lib, relative)
+    findpath(lib, relative) do |vfs, sub|
+      next unless sub = findlib(vfs, sub, relative)
+      return nil if vfs.__native_file_path?
+      next if vfs.size(sub) > MAX_LOADSIZE
+      return [vfs, sub]
+    end
+  end
+
+  #
+  # call-seq:
+  #   findpath(absolute_lib_path, relative) { |vfs, subpath| ... }
+  #
+  def InVFS.findpath(lib, relative)
+    if relative || Pathname(lib).absolute?
+      # 絶対パス表記でのライブラリ指定、または require_relative の呼び出し元
+
+      # NOTE: LOAD_PATH ($:) の順序を優先するか?
+      # NOTE: 一致するティレクトリ階層の深さを優先するか?
+      # NOTE: => とりあえずは順序を優先しておく
+
+      $:.each do |vfs|
+        #__BREAKHERE__
+        dir = String(vfs.to_path)
+        dir += "/" unless dir.empty? || dir[-1] == "/"
+        (a, b, c) = lib.partition(dir)
+        next unless a.empty? && !b.empty? && !c.empty?
+        yield(vfs, c)
+      end
+    else
+      $:.each { |vfs| yield(vfs, lib) }
+    end
+
+    nil
+  end
+
+  def InVFS.loaded?(vfs, lib)
+    !!$".include?(LOADED_PREFIX + File.join(vfs, lib))
+  end
+
+  def InVFS.require_in(vfs, path)
+    code = String(vfs.read(path))
+    loadpath = File.join(vfs, path)
+    unless File.extname(path) == ".so"
+      unless code.encoding == Encoding::UTF_8
+        code = code.dup if code.frozen?
+        code.force_encoding(Encoding::UTF_8)
+      end
+
+      eval code, InVFS::TOPLEVEL_BINDING.dup, loadpath, 1
+    else
+      Dir.mktmpdir do |dir|
+        tempname = File.join(dir, File.basename(path))
+        mode = File::CREAT | File::WRONLY | File::EXCL | File::BINARY
+        File.open(tempname, mode, 0700) { |fd| fd << code }
+        require! tempname
+        $".pop # 偽装したライブラリパスであるため、削除
+      end
+    end
+
+    $" << (LOADED_PREFIX + loadpath)
+
+    true
+  end
+
+  module Kernel
+    private
+    def require(lib)
+      __BREAKHERE__
+      (vfs, sub) = InVFS.findvfs(Pathname(lib).cleanpath.to_path, false)
+      if vfs
+        return false if InVFS.loaded?(vfs, sub)
+        InVFS.require_in(vfs, sub)
+      else
+        super lib
+      end
+    end
+
+    private
+    def require_relative(lib)
+      __BREAKHERE__
+      base = caller_locations(1, 1)[0]
+      (vfs, sub) = InVFS.findvfs(base.path, true)
+      if vfs
+        sub = (Pathname(sub) + ".." + lib).cleanpath.to_path
+        sub = InVFS.findlib(vfs, sub, false)
+        raise LoadError, "cannot load such file - #{lib}" unless sub
+        return false if InVFS.loaded?(vfs, sub)
+        InVFS.require_in(vfs, sub)
+      else
+        eval <<-"REQUIRE_RELATIVE", binding, base.path, base.lineno
+          super lib
+        REQUIRE_RELATIVE
+      end
+    end
+  end
+
+  class UnionFS
+    attr_reader :dirs
+
+    def initialize(*dirs)
+      @dirs = dirs
+    end
+
+    def file?(lib)
+      dirs.each do |dir|
+        path = File.join(dir, lib)
+        return true if File.file?(path)
+      end
+
+      false
+    end
+
+    def size(lib)
+      dirs.each do |dir|
+        path = File.join(dir, lib)
+        return File.size(path) if File.file?(path)
+      end
+
+      raise Errno::ENOENT, lib
+    end
+
+    def read(lib)
+      dirs.each do |dir|
+        path = File.join(dir, lib)
+        return File.binread(path) if File.file?(path)
+      end
+
+      raise Errno::ENOENT, lib
+    end
+
+    def to_path
+      %(#<#{self.class} #{dirs.map { |d| "<#{d}>" }.join(", ")}>)
+    end
+
+    def to_s
+      to_path
+    end
+
+    def inspect
+      to_s
+    end
+
+    def pretty_print(q)
+      q.group(2, "#<#{self.class}", ">") do
+        dirs.each_with_index do |d, i|
+          q.text "," if i > 0
+          q.breakable " "
+          d.pretty_print q
+        end
+      end
+    end
+  end
+
+  MultipleDirectory = UnionFS
+
+  class StringMapFS
+    attr_reader :map
+
+    def initialize(*map)
+      @map = Hash[*map]
+    end
+
+    def to_path
+      sprintf %(#<%s 0x%08x>) % [self.class, object_id]
+    end
+
+    def file?(path)
+      !!map.has_key?(path)
+    end
+
+    def size(path)
+      (map[path] or return nil).bytesize
+    end
+
+    def read(path)
+      (map[path] or return nil).to_s
+    end
+  end
+end
+
+module InVFS
+  origin = Object.method(:require)
+  define_singleton_method(:require!, ->(lib) {
+    origin.call lib
+  })
+end
+
+module InVFS
+  origin = Object.method(:require_relative)
+  define_singleton_method(:require_relative!, ->(lib, base) {
+    eval <<-REQUIRE, nil, base.path, base.lineno
+      origin.call lib
+    REQUIRE
+  })
+end
+
+module Kernel
+  prepend InVFS::Kernel
+end
+
+#
+# あらためて Object に Kernel を include する必要がある
+;
+class Object
+  include Kernel
+end

data/lib/invfs/zip.rb

@@ -0,0 +1,75 @@
+#!ruby
+
+require "zip/filesystem"
+require_relative "../invfs"
+
+def InVFS.zip(*args)
+  InVFS::Zip.new(*args)
+end
+
+class InVFS::Zip
+  attr_reader :path, :zip, :zipfile
+
+  def initialize(path)
+    @path = String(path)
+    @zip = Zip::File.open(@path)
+    @zipfile = @zip.file
+  end
+
+  #
+  # call-seq:
+  #   to_path -> string
+  #
+  # REQUIRED method for VFS.
+  #
+  # This value MUST be not modifying in each objects.
+  #
+  def to_path
+    path
+  end
+
+  #
+  # call-seq:
+  #   file?(path) -> true OR false (OR nil)
+  #
+  # REQUIRED method for VFS.
+  #
+  def file?(path)
+    zipfile.file?(path)
+  end
+
+  #
+  # call-seq:
+  #   size(path) -> integer for file size
+  #
+  # REQUIRED method for VFS.
+  #
+  def size(path)
+    zipfile.size(path)
+  end
+
+  #
+  # call-seq:
+  #   read(path) -> string
+  #
+  # REQUIRED method for VFS.
+  #
+  def read(path)
+    zipfile.read(path)
+  end
+
+  #
+  # optional method for VFS.
+  #
+  def to_s
+    %(#{path} (#{self.class}))
+  end
+
+  def inspect
+    %(#<#{self.class}:#{path}>)
+  end
+
+  def pretty_print(q)
+    q.text inspect
+  end
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: invfs
+version: !ruby/object:Gem::Version
+  version: '0.2'
+platform: ruby
+authors:
+- dearblue
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-01-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+description: Customization for "require" in Virtual Filesystem (VFS) support
+email: dearblue@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+- lib/invfs.rb
+- lib/invfs/zip.rb
+files:
+- LICENSE
+- README.md
+- Rakefile
+- gemstub.rb
+- lib/invfs.rb
+- lib/invfs/zip.rb
+homepage: https://github.com/dearblue/ruby-invfs
+licenses:
+- BSD-2-Clause
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--charset"
+- UTF-8
+- "-m"
+- README.md
+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.7.4
+signing_key: 
+specification_version: 4
+summary: customization for "require" in VFS support
+test_files: []