virtfs 0.0.1

data/spec/file_instance_spec.rb

@@ -0,0 +1,154 @@
+require 'spec_helper' 
+
+describe VirtFS::VFile, "(#{$fs_interface} interface)" do
+  before(:all) do
+    @spec_name   = VfsRealFile.basename(__FILE__, ".rb")
+    @temp_prefix = "#{@spec_name}-"
+
+    @ext        = ".rb"
+    @data1      = "0123456789" * 4
+    @temp_file  = Tempfile.new(["VirtFS-File", @ext])
+    @temp_file.write(@data1)
+    @temp_file.close
+    @full_path  = @temp_file.path
+    @rel_path   = File.basename(@full_path)
+    @parent_dir = File.dirname(@full_path)
+
+    @ext2        = ".c"
+    @temp_file2  = Tempfile.new(["VirtFS-File", @ext2])
+    @temp_file2.close
+    @full_path2  = @temp_file2.path
+    @rel_path2   = File.basename(@full_path2)
+    @parent_dir2 = File.dirname(@full_path2)
+
+    @slink_path  = temp_name(@temp_prefix, ".symlink")
+
+    @root       = File::SEPARATOR
+    @this_dir   = VfsRealDir.getwd
+  end
+
+  before(:each) do
+    reset_context
+
+    @native_fs = nativefs_class.new
+    VirtFS.mount(@native_fs, @root)
+  end
+
+  describe "#atime" do
+    it "should return the same value as the standard File#atime method" do
+      VfsRealFile.open(@full_path) do |rf|
+        VirtFS::VFile.open(@full_path) { |vf| expect(vf.atime).to eq(rf.atime) }
+      end
+    end
+  end
+
+  describe "#chmod" do
+    it "should return 0" do
+      VirtFS::VFile.open(@full_path) do |vf|
+        expect(vf.chmod(0777)).to eq(0)
+      end
+    end
+
+    it "should change the permission bits on the file" do
+      target_mode = 0755
+      expect(VfsRealFile.stat(@full_path).mode & 0777).to_not eq(target_mode)
+      VirtFS::VFile.open(@full_path) do |vf|
+        expect(vf.chmod(target_mode)).to be_zero
+      end
+      expect(VfsRealFile.stat(@full_path).mode & 0777).to eq(target_mode)
+    end
+  end
+
+  describe "#chown" do
+    it "should return 0 on success" do
+      stat = VfsRealFile.stat(@full_path)
+
+      VirtFS::VFile.open(@full_path) do |vf|
+        expect(vf.chown(stat.uid, stat.gid)).to eq(0)
+      end
+    end
+  end
+
+  describe "#ctime" do
+    it "should return the same value as the standard File#ctime method" do
+      VfsRealFile.open(@full_path) do |rf|
+        VirtFS::VFile.open(@full_path) { |vf| expect(vf.ctime).to eq(rf.ctime) }
+      end
+    end
+  end
+
+  describe "#flock" do
+    it "should return 0" do
+      VirtFS::VFile.open(@full_path) do |vf|
+        expect(vf.flock(File::LOCK_EX)).to eq(0)
+      end
+    end
+  end
+
+  describe "#lstat" do
+    before(:each) do
+      VfsRealFile.symlink(@full_path, @slink_path)
+    end
+
+    after(:each) do
+      VfsRealFile.delete(@slink_path)
+    end
+
+    it "should return the stat information for the symlink" do
+      VirtFS::VFile.open(@slink_path) do |sl|
+        expect(sl.lstat.symlink?).to be true
+      end
+    end
+  end
+
+  describe "#mtime" do
+    it "should return the same value as the standard File#mtime method" do
+      VfsRealFile.open(@full_path) do |rf|
+        VirtFS::VFile.open(@full_path) { |vf| expect(vf.mtime).to eq(rf.mtime) }
+      end
+    end
+  end
+
+  describe "#path :to_path" do
+    it "should return full path when opened with full path" do
+      VirtFS::VFile.open(@full_path) { |f| expect(f.path).to eq(@full_path) }
+    end
+
+    it "should return relative path when opened with relative path" do
+      parent, target_file = VfsRealFile.split(@full_path)
+      VirtFS::VDir.chdir(parent)
+      VirtFS::VFile.open(target_file) { |f| expect(f.path).to eq(target_file) }
+    end
+  end
+
+  describe "#size" do
+    it "should return the known size of the file" do
+      VirtFS::VFile.open(@full_path) { |f| expect(f.size).to eq(@data1.bytesize) }
+    end
+
+    it "should return the same value as the standard File#size" do
+      VfsRealFile.open(@full_path) do |rf|
+        VirtFS::VFile.open(@full_path) { |vf| expect(vf.size).to eq(rf.size) }
+      end
+    end
+  end
+
+  describe "#truncate" do
+    it "should return 0" do
+      VirtFS::VFile.open(@full_path, "w") { |f| expect(f.truncate(5)).to eq(0) }
+    end
+
+    it "should raise IOError when file isn't open for writing" do
+      VirtFS::VFile.open(@full_path, "r") do |f|
+        expect { f.truncate(0) }.to raise_error(IOError, "not opened for writing")
+      end
+    end
+
+    it "should truncate the file to the specified size" do
+      tsize = @data1.bytesize / 2
+      expect(VfsRealFile.size(@full_path)).to_not eq(tsize)
+      VirtFS::VFile.open(@full_path, "w") { |f| f.truncate(tsize) }
+      expect(VfsRealFile.size(@full_path)).to eq(tsize)
+    end
+  end
+end

data/spec/file_modes_and_options_spec.rb

@@ -0,0 +1,1556 @@
+require 'spec_helper'
+
+#
+# *args --> mode="r" <,permission> <,options>
+#           mode       --> String or Integer
+#           permission --> Integer
+#           options    --> Hash
+#
+# 1 arg:  <mode | options>
+# 2 args: mode, <permissions | options>
+# 3 args: mode, permissions, options
+#
+# mode string --> file-mode[:external-encoding[:internal-encoding]]
+#
+# file-mode mapped to binary:
+#     "r"  --> File::RDONLY
+#     "r+" --> File::RDWR
+#     "w"  --> File::WRONLY | File::TRUNC  | File::CREAT
+#     "w+" --> File::RDWR   | File::TRUNC  | File::CREAT
+#     "a"  --> File::WRONLY | File::APPEND | File::CREAT
+#     "a+" --> File::RDWR   | File::APPEND | File::CREAT
+#
+# Options:
+#     :autoclose          => If false, the underlying file will not be closed
+#                            when this I/O object is finalized.
+#
+#     :binmode            => Opens the IO object in binary mode if true (same as mode: "b").
+#
+#     :encoding           => Specifies both external and internal encodings
+#                            as "external:internal" (same format used in mode parameter).
+#
+#     :external_encoding  => Specifies the external encoding.
+#
+#     :internal_encoding  => Specifies the internal encoding.
+#
+#     :mode               => Specifies what would have been the mode parameter.
+#
+#     :textmode           => Open the file in text mode (the default).
+#
+describe VirtFS::FileModesAndOptions, "(#{$fs_interface} interface)" do # rubocop:disable Style/GlobalVars
+  before(:each) do
+    reset_context
+  end
+
+  context "modes" do
+    context "default" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDONLY" do
+          expect(@fmo.mode_bits).to eq(File::RDONLY)
+        end
+      end
+
+      describe "external_encoding" do
+        it "should return Encoding.default_external" do
+          expect(@fmo.external_encoding).to eq(Encoding.default_external)
+        end
+      end
+
+      describe "internal_encoding" do
+        it "should return Encoding.default_internal" do
+          expect(@fmo.internal_encoding).to eq(Encoding.default_internal)
+        end
+      end
+
+      describe "permissions" do
+        it "should return nil" do
+          expect(@fmo.permissions).to eq(nil)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return true" do
+          expect(@fmo.rdonly?).to be true
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return false" do
+          expect(@fmo.rdwr?).to be false
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+
+    context "default + binmode = 'b'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("b")
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDONLY" do
+          expect(@fmo.mode_bits).to eq(File::RDONLY)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return true" do
+          expect(@fmo.binmode?).to be true
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return true" do
+          expect(@fmo.rdonly?).to be true
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return false" do
+          expect(@fmo.rdwr?).to be false
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+
+    context "read only = 'r'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("r")
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDONLY" do
+          expect(@fmo.mode_bits).to eq(File::RDONLY)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return true" do
+          expect(@fmo.rdonly?).to be true
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return false" do
+          expect(@fmo.rdwr?).to be false
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+
+    context "read only + binmode = 'rb'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("rb")
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDONLY" do
+          expect(@fmo.mode_bits).to eq(File::RDONLY)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return true" do
+          expect(@fmo.binmode?).to be true
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return true" do
+          expect(@fmo.rdonly?).to be true
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return false" do
+          expect(@fmo.rdwr?).to be false
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+
+    context "read write = 'r+'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("r+")
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDWR" do
+          expect(@fmo.mode_bits).to eq(File::RDWR)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return true" do
+          expect(@fmo.rdwr?).to be true
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+
+    context "read write + binmode = 'r+b'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("r+b")
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDWR" do
+          expect(@fmo.mode_bits).to eq(File::RDWR)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return true" do
+          expect(@fmo.binmode?).to be true
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return true" do
+          expect(@fmo.rdwr?).to be true
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+
+    context "write only, truncate, create = 'w'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("w")
+      end
+
+      describe "mode_bits" do
+        it "should return (File::WRONLY | File::TRUNC  | File::CREAT)" do
+          expect(@fmo.mode_bits).to eq(File::WRONLY | File::TRUNC | File::CREAT)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return true" do
+          expect(@fmo.create?).to be true
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return false" do
+          expect(@fmo.rdwr?).to be false
+        end
+      end
+
+      describe "trunc?" do
+        it "should return true" do
+          expect(@fmo.trunc?).to be true
+        end
+      end
+
+      describe "wronly?" do
+        it "should return true" do
+          expect(@fmo.wronly?).to be true
+        end
+      end
+    end
+
+    context "read write, truncate, create = 'w+'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("w+")
+      end
+
+      describe "mode_bits" do
+        it "should return (File::RDWR | File::TRUNC | File::CREAT)" do
+          expect(@fmo.mode_bits).to eq(File::RDWR | File::TRUNC | File::CREAT)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return true" do
+          expect(@fmo.create?).to be true
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return true" do
+          expect(@fmo.rdwr?).to be true
+        end
+      end
+
+      describe "trunc?" do
+        it "should return true" do
+          expect(@fmo.trunc?).to be true
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+
+    context "write only, append, create = 'a'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("a")
+      end
+
+      describe "mode_bits" do
+        it "should return (File::WRONLY | File::APPEND | File::CREAT)" do
+          expect(@fmo.mode_bits).to eq(File::WRONLY | File::APPEND | File::CREAT)
+        end
+      end
+
+      describe "append?" do
+        it "should return true" do
+          expect(@fmo.append?).to be true
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return true" do
+          expect(@fmo.create?).to be true
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return false" do
+          expect(@fmo.rdwr?).to be false
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return true" do
+          expect(@fmo.wronly?).to be true
+        end
+      end
+    end
+
+    context "read write, append, create = 'a+'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("a+")
+      end
+
+      describe "mode_bits" do
+        it "should return (File::RDWR | File::APPEND | File::CREAT)" do
+          expect(@fmo.mode_bits).to eq(File::RDWR | File::APPEND | File::CREAT)
+        end
+      end
+
+      describe "append?" do
+        it "should return true" do
+          expect(@fmo.append?).to be true
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return true" do
+          expect(@fmo.create?).to be true
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return true" do
+          expect(@fmo.rdwr?).to be true
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+
+    context "with encoding" do
+      context "external encoding" do
+        before(:each) do
+          @fmo = VirtFS::FileModesAndOptions.new("r+:ascii-8bit")
+        end
+
+        it "should set the external encoding to a value other than the default" do
+          new_encoding = Encoding.find("ascii-8bit")
+          expect(new_encoding).not_to eq(Encoding.default_external)
+          expect(@fmo.external_encoding).to eq(new_encoding)
+        end
+
+        describe "mode_bits" do
+          it "should return File::RDWR" do
+            expect(@fmo.mode_bits).to eq(File::RDWR)
+          end
+        end
+
+        describe "append?" do
+          it "should return false" do
+            expect(@fmo.append?).to be false
+          end
+        end
+
+        describe "binmode?" do
+          it "should return false" do
+            expect(@fmo.binmode?).to be false
+          end
+        end
+
+        describe "create?" do
+          it "should return false" do
+            expect(@fmo.create?).to be false
+          end
+        end
+
+        describe "excl?" do
+          it "should return false" do
+            expect(@fmo.excl?).to be false
+          end
+        end
+
+        describe "noctty?" do
+          it "should return false" do
+            expect(@fmo.noctty?).to be false
+          end
+        end
+
+        describe "nonblock?" do
+          it "should return false" do
+            expect(@fmo.nonblock?).to be false
+          end
+        end
+
+        describe "rdonly?" do
+          it "should return false" do
+            expect(@fmo.rdonly?).to be false
+          end
+        end
+
+        describe "rdwr?" do
+          it "should return true" do
+            expect(@fmo.rdwr?).to be true
+          end
+        end
+
+        describe "trunc?" do
+          it "should return false" do
+            expect(@fmo.trunc?).to be false
+          end
+        end
+
+        describe "wronly?" do
+          it "should return false" do
+            expect(@fmo.wronly?).to be false
+          end
+        end
+      end
+
+      context "internal encoding" do
+        before(:each) do
+          @fmo = VirtFS::FileModesAndOptions.new("r+::utf-8")
+        end
+
+        it "should set the internal encoding to a value other than the default" do
+          new_encoding = Encoding.find("utf-8")
+          expect(new_encoding).not_to eq(Encoding.default_internal)
+          expect(@fmo.internal_encoding).to eq(new_encoding)
+        end
+
+        describe "mode_bits" do
+          it "should return File::RDWR" do
+            expect(@fmo.mode_bits).to eq(File::RDWR)
+          end
+        end
+
+        describe "append?" do
+          it "should return false" do
+            expect(@fmo.append?).to be false
+          end
+        end
+
+        describe "binmode?" do
+          it "should return false" do
+            expect(@fmo.binmode?).to be false
+          end
+        end
+
+        describe "create?" do
+          it "should return false" do
+            expect(@fmo.create?).to be false
+          end
+        end
+
+        describe "excl?" do
+          it "should return false" do
+            expect(@fmo.excl?).to be false
+          end
+        end
+
+        describe "noctty?" do
+          it "should return false" do
+            expect(@fmo.noctty?).to be false
+          end
+        end
+
+        describe "nonblock?" do
+          it "should return false" do
+            expect(@fmo.nonblock?).to be false
+          end
+        end
+
+        describe "rdonly?" do
+          it "should return false" do
+            expect(@fmo.rdonly?).to be false
+          end
+        end
+
+        describe "rdwr?" do
+          it "should return true" do
+            expect(@fmo.rdwr?).to be true
+          end
+        end
+
+        describe "trunc?" do
+          it "should return false" do
+            expect(@fmo.trunc?).to be false
+          end
+        end
+
+        describe "wronly?" do
+          it "should return false" do
+            expect(@fmo.wronly?).to be false
+          end
+        end
+      end
+
+      context "external and internal encoding" do
+        before(:each) do
+          @fmo = VirtFS::FileModesAndOptions.new("r+:ascii-8bit:utf-8")
+        end
+
+        it "should set the external and internal encodings to a values other than the default" do
+          new_external_encoding = Encoding.find("ascii-8bit")
+          expect(new_external_encoding).not_to eq(Encoding.default_external)
+          new_internal_encoding = Encoding.find("utf-8")
+          expect(new_internal_encoding).not_to eq(Encoding.default_internal)
+          expect(@fmo.external_encoding).to eq(new_external_encoding)
+          expect(@fmo.internal_encoding).to eq(new_internal_encoding)
+        end
+
+        describe "mode_bits" do
+          it "should return File::RDWR" do
+            expect(@fmo.mode_bits).to eq(File::RDWR)
+          end
+        end
+
+        describe "append?" do
+          it "should return false" do
+            expect(@fmo.append?).to be false
+          end
+        end
+
+        describe "binmode?" do
+          it "should return false" do
+            expect(@fmo.binmode?).to be false
+          end
+        end
+
+        describe "create?" do
+          it "should return false" do
+            expect(@fmo.create?).to be false
+          end
+        end
+
+        describe "excl?" do
+          it "should return false" do
+            expect(@fmo.excl?).to be false
+          end
+        end
+
+        describe "noctty?" do
+          it "should return false" do
+            expect(@fmo.noctty?).to be false
+          end
+        end
+
+        describe "nonblock?" do
+          it "should return false" do
+            expect(@fmo.nonblock?).to be false
+          end
+        end
+
+        describe "rdonly?" do
+          it "should return false" do
+            expect(@fmo.rdonly?).to be false
+          end
+        end
+
+        describe "rdwr?" do
+          it "should return true" do
+            expect(@fmo.rdwr?).to be true
+          end
+        end
+
+        describe "trunc?" do
+          it "should return false" do
+            expect(@fmo.trunc?).to be false
+          end
+        end
+
+        describe "wronly?" do
+          it "should return false" do
+            expect(@fmo.wronly?).to be false
+          end
+        end
+      end
+    end
+  end
+
+  context "options" do
+    context "modes" do
+      context "read write + binmode = :mode => 'r+b'" do
+        before(:each) do
+          @fmo = VirtFS::FileModesAndOptions.new(:mode => "r+b")
+        end
+
+        describe "mode_bits" do
+          it "should return File::RDWR" do
+            expect(@fmo.mode_bits).to eq(File::RDWR)
+          end
+        end
+
+        describe "append?" do
+          it "should return false" do
+            expect(@fmo.append?).to be false
+          end
+        end
+
+        describe "binmode?" do
+          it "should return true" do
+            expect(@fmo.binmode?).to be true
+          end
+        end
+
+        describe "create?" do
+          it "should return false" do
+            expect(@fmo.create?).to be false
+          end
+        end
+
+        describe "excl?" do
+          it "should return false" do
+            expect(@fmo.excl?).to be false
+          end
+        end
+
+        describe "noctty?" do
+          it "should return false" do
+            expect(@fmo.noctty?).to be false
+          end
+        end
+
+        describe "nonblock?" do
+          it "should return false" do
+            expect(@fmo.nonblock?).to be false
+          end
+        end
+
+        describe "rdonly?" do
+          it "should return false" do
+            expect(@fmo.rdonly?).to be false
+          end
+        end
+
+        describe "rdwr?" do
+          it "should return true" do
+            expect(@fmo.rdwr?).to be true
+          end
+        end
+
+        describe "trunc?" do
+          it "should return false" do
+            expect(@fmo.trunc?).to be false
+          end
+        end
+
+        describe "wronly?" do
+          it "should return false" do
+            expect(@fmo.wronly?).to be false
+          end
+        end
+      end
+    end
+
+    context "binmode" do
+      context "read write + binmode = :binmode => true, :mode => 'r+'" do
+        before(:each) do
+          @fmo = VirtFS::FileModesAndOptions.new(:binmode => true, :mode => "r+")
+        end
+
+        describe "mode_bits" do
+          it "should return File::RDWR" do
+            expect(@fmo.mode_bits).to eq(File::RDWR)
+          end
+        end
+
+        describe "append?" do
+          it "should return false" do
+            expect(@fmo.append?).to be false
+          end
+        end
+
+        describe "binmode?" do
+          it "should return true" do
+            expect(@fmo.binmode?).to be true
+          end
+        end
+
+        describe "create?" do
+          it "should return false" do
+            expect(@fmo.create?).to be false
+          end
+        end
+
+        describe "excl?" do
+          it "should return false" do
+            expect(@fmo.excl?).to be false
+          end
+        end
+
+        describe "noctty?" do
+          it "should return false" do
+            expect(@fmo.noctty?).to be false
+          end
+        end
+
+        describe "nonblock?" do
+          it "should return false" do
+            expect(@fmo.nonblock?).to be false
+          end
+        end
+
+        describe "rdonly?" do
+          it "should return false" do
+            expect(@fmo.rdonly?).to be false
+          end
+        end
+
+        describe "rdwr?" do
+          it "should return true" do
+            expect(@fmo.rdwr?).to be true
+          end
+        end
+
+        describe "trunc?" do
+          it "should return false" do
+            expect(@fmo.trunc?).to be false
+          end
+        end
+
+        describe "wronly?" do
+          it "should return false" do
+            expect(@fmo.wronly?).to be false
+          end
+        end
+      end
+    end
+
+    context "external_encoding" do
+      it "should set the external encoding to a value other than the default" do
+        new_encoding = Encoding.find("ascii-8bit")
+        expect(new_encoding).not_to eq(Encoding.default_external)
+        fmo = VirtFS::FileModesAndOptions.new(:external_encoding => "ascii-8bit", :mode => "r+")
+        expect(fmo.external_encoding).to eq(new_encoding)
+      end
+    end
+
+    context "internal_encoding" do
+      it "should set the internal encoding to a value other than the default" do
+        new_encoding = Encoding.find("utf-8")
+        expect(new_encoding).not_to eq(Encoding.default_internal)
+        fmo = VirtFS::FileModesAndOptions.new(:internal_encoding => "utf-8", :mode => "r+")
+        expect(fmo.internal_encoding).to eq(new_encoding)
+      end
+    end
+
+    context "encoding" do
+      it "should set the external encoding to a value other than the default" do
+        new_encoding = Encoding.find("ascii-8bit")
+        expect(new_encoding).not_to eq(Encoding.default_external)
+        fmo = VirtFS::FileModesAndOptions.new(:encoding => "ascii-8bit", :mode => "r+")
+        expect(fmo.external_encoding).to eq(new_encoding)
+        expect(fmo.internal_encoding).to eq(Encoding.default_internal)
+      end
+
+      it "should set the internal encoding to a value other than the default" do
+        new_encoding = Encoding.find("utf-8")
+        expect(new_encoding).not_to eq(Encoding.default_internal)
+        fmo = VirtFS::FileModesAndOptions.new(:encoding => ":utf-8", :mode => "r+")
+        expect(fmo.internal_encoding).to eq(new_encoding)
+        expect(fmo.external_encoding).to eq(Encoding.default_external)
+      end
+
+      it "should set the external and internal encodings to a values other than the default" do
+        new_external_encoding = Encoding.find("ascii-8bit")
+        expect(new_external_encoding).not_to eq(Encoding.default_external)
+        new_internal_encoding = Encoding.find("utf-8")
+        expect(new_internal_encoding).not_to eq(Encoding.default_internal)
+        fmo = VirtFS::FileModesAndOptions.new(:encoding => "ascii-8bit:utf-8", :mode => "r+")
+        expect(fmo.external_encoding).to eq(new_external_encoding)
+        expect(fmo.internal_encoding).to eq(new_internal_encoding)
+      end
+    end
+
+    context "textmode" do
+    end
+  end
+
+  context "permissions" do
+    it "should set permissions when specified after mode" do
+      permissions = 0755
+      fmo = VirtFS::FileModesAndOptions.new("r", permissions)
+      expect(fmo.permissions).to eq(permissions)
+    end
+
+    it "should set permissions when specified after mode and before options" do
+      permissions = 0755
+      fmo = VirtFS::FileModesAndOptions.new("r", permissions, :binmode => true)
+      expect(fmo.permissions).to eq(permissions)
+    end
+  end
+
+  #
+  # Test arg combinations.
+  #
+
+  context "mode, permissions" do
+    context "read write = 'r+' with permissions = 0755" do
+      before(:each) do
+        @permissions = 0755
+        @fmo = VirtFS::FileModesAndOptions.new("r+", @permissions)
+      end
+
+      it "should set permissions accordingly" do
+        expect(@fmo.permissions).to eq(@permissions)
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDWR" do
+          expect(@fmo.mode_bits).to eq(File::RDWR)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return true" do
+          expect(@fmo.rdwr?).to be true
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+  end
+
+  context "mode, options" do
+    context "read write = 'r+' with options: :encoding => 'ascii-8bit:utf-8'" do
+      before(:each) do
+        @fmo = VirtFS::FileModesAndOptions.new("r+", :encoding => "ascii-8bit:utf-8")
+      end
+
+      it "should set the external and internal encodings to a values other than the default" do
+        new_external_encoding = Encoding.find("ascii-8bit")
+        expect(new_external_encoding).not_to eq(Encoding.default_external)
+        new_internal_encoding = Encoding.find("utf-8")
+        expect(new_internal_encoding).not_to eq(Encoding.default_internal)
+        expect(@fmo.external_encoding).to eq(new_external_encoding)
+        expect(@fmo.internal_encoding).to eq(new_internal_encoding)
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDWR" do
+          expect(@fmo.mode_bits).to eq(File::RDWR)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return true" do
+          expect(@fmo.rdwr?).to be true
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+  end
+
+  context "mode, permissions, options" do
+    context "read write = 'r+' with permissions = 0755 and ,options = :encoding => 'ascii-8bit:utf-8'" do
+      before(:each) do
+        @permissions = 0755
+        @fmo = VirtFS::FileModesAndOptions.new("r+", @permissions, :encoding => "ascii-8bit:utf-8")
+      end
+
+      it "should set permissions accordingly" do
+        expect(@fmo.permissions).to eq(@permissions)
+      end
+
+      it "should set the external and internal encodings to a values other than the default" do
+        new_external_encoding = Encoding.find("ascii-8bit")
+        expect(new_external_encoding).not_to eq(Encoding.default_external)
+        new_internal_encoding = Encoding.find("utf-8")
+        expect(new_internal_encoding).not_to eq(Encoding.default_internal)
+        expect(@fmo.external_encoding).to eq(new_external_encoding)
+        expect(@fmo.internal_encoding).to eq(new_internal_encoding)
+      end
+
+      describe "mode_bits" do
+        it "should return File::RDWR" do
+          expect(@fmo.mode_bits).to eq(File::RDWR)
+        end
+      end
+
+      describe "append?" do
+        it "should return false" do
+          expect(@fmo.append?).to be false
+        end
+      end
+
+      describe "binmode?" do
+        it "should return false" do
+          expect(@fmo.binmode?).to be false
+        end
+      end
+
+      describe "create?" do
+        it "should return false" do
+          expect(@fmo.create?).to be false
+        end
+      end
+
+      describe "excl?" do
+        it "should return false" do
+          expect(@fmo.excl?).to be false
+        end
+      end
+
+      describe "noctty?" do
+        it "should return false" do
+          expect(@fmo.noctty?).to be false
+        end
+      end
+
+      describe "nonblock?" do
+        it "should return false" do
+          expect(@fmo.nonblock?).to be false
+        end
+      end
+
+      describe "rdonly?" do
+        it "should return false" do
+          expect(@fmo.rdonly?).to be false
+        end
+      end
+
+      describe "rdwr?" do
+        it "should return true" do
+          expect(@fmo.rdwr?).to be true
+        end
+      end
+
+      describe "trunc?" do
+        it "should return false" do
+          expect(@fmo.trunc?).to be false
+        end
+      end
+
+      describe "wronly?" do
+        it "should return false" do
+          expect(@fmo.wronly?).to be false
+        end
+      end
+    end
+  end
+
+  #
+  # Error handling.
+  #
+
+  context "errors" do
+    it "should raise ArgumentError when third arg is not a hash" do
+      expect do
+        @fmo = VirtFS::FileModesAndOptions.new("r+", 0755, true)
+      end.to raise_error(
+        ArgumentError, "wrong number of arguments (4 for 1..3)"
+      )
+    end
+
+    it "should raise ArgumentError when external encoding specified twice" do
+      expect do
+        @fmo = VirtFS::FileModesAndOptions.new("r+:ascii-8bit", 0755, :external_encoding => "ascii-8bit")
+      end.to raise_error(
+        ArgumentError, "encoding specified twice"
+      )
+    end
+
+    it "should raise ArgumentError when internal encoding specified twice" do
+      expect do
+        @fmo = VirtFS::FileModesAndOptions.new("r+::ascii-8bit", 0755, :internal_encoding => "ascii-8bit")
+      end.to raise_error(
+        ArgumentError, "encoding specified twice"
+      )
+    end
+
+    it "should raise ArgumentError when given invalid access mode" do
+      mode_str = "z+"
+      expect do
+        @fmo = VirtFS::FileModesAndOptions.new(mode_str)
+      end.to raise_error(
+        ArgumentError, "invalid access mode #{mode_str}"
+      )
+    end
+
+    it "should raise ArgumentError when binmode specified twice" do
+      expect do
+        @fmo = VirtFS::FileModesAndOptions.new("rb", :binmode => true)
+      end.to raise_error(
+        ArgumentError, "binmode specified twice"
+      )
+    end
+
+    #
+    # This restriction has been removed.
+    #
+    # it "should raise ArgumentError when mode specified twice" do
+    #   expect do
+    #     @fmo = VirtFS::FileModesAndOptions.new("rb", :mode => "rb")
+    #   end.to raise_error(
+    #     ArgumentError, "mode specified twice"
+    #   )
+    # end
+
+    it "should raise ArgumentError when both binmode and textmode are specified" do
+      expect do
+        @fmo = VirtFS::FileModesAndOptions.new("rb", :textmode => true)
+      end.to raise_error(
+        ArgumentError, "binmode and textmode are mutually exclusive"
+      )
+    end
+  end
+end