fakefs 2.5.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4a0f94695c0070ec3847b3177acebdf1160f2064ba02d950d04a31385c43207
-  data.tar.gz: bb0e627c6a32b31b8a1068cae3a5d4542b150d2ed06fecc0719a029889a0815c
+  metadata.gz: 765257209fdbaff32e467e7e5f0acbd9d324d6066fe569d5722a0568368a3288
+  data.tar.gz: fe4e318738464fd61e4b4d150a06285ea1a1923c92fc51bf244f27afa31b30a2
 SHA512:
-  metadata.gz: 646053f9768a3a408c3d365ee2230f089131477decf9ccdb4e51bcd6c9080e1fb56bada71f2f661a685fa41866de408cab4b9de7c07cf50df3fe21b2dde09a85
-  data.tar.gz: 87d29cda1d981939b941023104f5b7a1ee6f58ea9ca983ca16e379a4471c55ce1aea045a2a6c560b07bd760dc238d14f56b68dd7881a651991a587ca0294e0f8
+  metadata.gz: 0b2d56c157243b4a95961f35c946697b229358af469692e91e72ac82eec1c0bdb6b97da19215335f26dd0837b731701bf9d072cb41fbb069f14868f7768d66fc
+  data.tar.gz: 46b48334206cd89958b8f3177f0e4050580a7c84891f8027e0e768cdfcc8685c22b5cadf03e0bdccb4ae4b9f7bbf788623be644377c53e6ab9277955b8472d9f

data/README.md

@@ -128,7 +128,6 @@ describe "my spec" do
 end
 ```
 
-
 FakeFs --- `TypeError: superclass mismatch for class File`
 --------------
 
@@ -168,7 +167,7 @@ yourself on the equivalent FakeFS classes. For example,
 [FileMagic](https://rubygems.org/gems/ruby-filemagic) adds `File#content_type`.
 A fake version can be provided as follows:
 
-``` ruby
+```ruby
 FakeFS::File.class_eval do
   def content_type
     'fake/file'
@@ -176,6 +175,15 @@ FakeFS::File.class_eval do
 end
 ```
 
+File.lock
+---------
+
+Warning: experimental and might break if you obtain more that one flock per file using different descriptors
+
+```ruby
+require 'fakefs/flockable_file'
+```
+
 Caveats
 -------
 

data/lib/fakefs/file_system.rb

@@ -56,7 +56,11 @@ module FakeFS
       assert_dir d
       object.name = parts.last
       object.parent = d
-      d[parts.last] ||= object
+      if object.is_a? FakeDir
+        d[parts.last] ||= object
+      else
+        d[parts.last] = object
+      end
     end
 
     # copies directories and files from the real filesystem

data/lib/fakefs/flockable_file.rb

@@ -0,0 +1,46 @@
+require_relative 'file'
+
+module FakeFS
+  # Be careful using this, as it may break things if
+  # you obtain more that one flock per file using
+  # different descriptors.
+  # Real flock call blocks/returns false in that case -
+  # see https://man7.org/linux/man-pages/man2/flock.2.html,
+  # it says it "may be denied", but it does, it fact, deny.
+  # This implementation simply returns 0.
+  # This may also be a problem if you, it fact, are accessing a
+  # real file, which is locked by another process.
+  class File < StringIO
+    # yep, File::LOCK_UN | File::LOCK_NB is allowed
+    FAKE_FS_ALLOWED_FLOCK_MODES = [RealFile::LOCK_EX, RealFile::LOCK_SH, RealFile::LOCK_UN].flat_map do |mode|
+      [mode, mode | RealFile::LOCK_NB]
+    end.freeze
+
+    remove_method :flock
+
+    def flock(mode)
+      # all successful calls - even UN - seem to return 0
+      unless mode.is_a?(Integer)
+        unless mode.respond_to?(:to_int)
+          raise TypeError, "no implicit conversion of #{mode.class} into Integer"
+        end
+        int_mode = mode.to_int
+
+        unless int_mode.is_a?(Integer)
+          raise TypeError, "can't convert Object to Integer (#{mode.class}#to_int gives #{int_mode.class})"
+        end
+        mode = int_mode
+      end
+
+      # real implementation may not fail on `flock 11111` - but fails with `f1.flock 11111111` - or may fail
+      # with another error - `f1.flock 1111111111111` gives `integer 1111111111111 too big to convert to `int'
+      # but I think it's safer to allow only documented modes.
+      unless FAKE_FS_ALLOWED_FLOCK_MODES.include?(mode)
+        # real exception
+        # Invalid argument @ rb_file_flock - filepath (Errno::EINVAL)
+        raise Errno::EINVAL.new(@path, 'rb_file_flock')
+      end
+      0
+    end
+  end
+end

data/lib/fakefs/version.rb

@@ -1,7 +1,7 @@
 module FakeFS
   # Version module
   module Version
-    VERSION = '2.5.0'.freeze
+    VERSION = '2.6.0'.freeze
 
     def self.to_s
       VERSION

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fakefs
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Chris Wanstrath
@@ -12,7 +12,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-05-23 00:00:00.000000000 Z
+date: 2024-12-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bump
@@ -118,6 +118,7 @@ files:
 - lib/fakefs/file_system.rb
 - lib/fakefs/file_test.rb
 - lib/fakefs/fileutils.rb
+- lib/fakefs/flockable_file.rb
 - lib/fakefs/globber.rb
 - lib/fakefs/io.rb
 - lib/fakefs/irb.rb
@@ -146,7 +147,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.0.dev
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: A fake filesystem. Use it in your tests.