bfs 0.7.4 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c790272a036559149178dadb5932e424a90bbc535f842a298516457051912310
-  data.tar.gz: 9f673793872f84f34f4cd95fb396cac88d44d7fc338ac20888149303584790f1
+  metadata.gz: 32e754ffdd81a72cc648eb786fc2ca34839c0debe67b80e2ee6256766c8194e4
+  data.tar.gz: 443d181595af99d3b00be21809965d68e2373439435bfefbca35df168bdc1962
 SHA512:
-  metadata.gz: 53547ee9f745695a72196d8eb3d9b09054ea2d6cc106993bce0fe22d563e31cb67f450edc28424de2d9aa6b7f72126235dcd5a31c179b5c15c27ed739da21214
-  data.tar.gz: b6e0927840f82b058d2662e8b29e33fe9a6697b4219cf451c0ce49cb778e79070ce684ab8bc37e4f9dd2756898275fa872cd29d3dd20e175487649a216794f5b
+  metadata.gz: 13cd555372996a1a2050229f57eae18c32215dc0303e83ccbc866ed4e6b3e5d1c8079a827520ed39871c39152cf96a01532bc254ad2f1a9e996cf6a32b5c24c9
+  data.tar.gz: 8ac28da9c0c664810e5665299f1cd97609dba0c789fc42244e9494a95a8587ef799ecee64c38eec40a301c2e1d131bcb98aad89d0ee4d43ab4f66a2db14203c7

data/lib/bfs/blob.rb

@@ -32,6 +32,9 @@ module BFS
     end
 
     # Creates the blob and opens it for writing.
+    # If a block is passed the writer is automatically committed in the end.
+    # If no block is passed, you must manually call #commit to persist the
+    # result.
     def create(**opts, &block)
       @bucket.create(path, **opts, &block)
     end

data/lib/bfs/bucket/abstract.rb

@@ -107,7 +107,7 @@ module BFS
       def norm_meta(meta)
         norm = {}
         meta.each do |key, value|
-          nkey = key.to_s.downcase.split(/-/).map(&:capitalize).join('-')
+          nkey = key.to_s.downcase.split('-').map(&:capitalize).join('-')
           norm[nkey] = value
         end if meta.is_a?(Hash)
         norm

data/lib/bfs/bucket/fs.rb

@@ -42,14 +42,9 @@ module BFS
         full = @root.join(norm_path(path))
         FileUtils.mkdir_p(full.dirname.to_s)
 
-        temp = BFS::TempWriter.new(full, encoding: encoding, perm: perm) {|t| FileUtils.mv t, full.to_s }
-        return temp unless block
-
-        begin
-          yield temp
-        ensure
-          temp.close
-        end
+        BFS::Writer.new(full, encoding: encoding, perm: perm) do |temp|
+          FileUtils.mv temp, full.to_s
+        end.perform(&block)
       end
 
       # Opens an existing file for reading

data/lib/bfs/bucket/in_mem.rb

@@ -1,5 +1,6 @@
 require 'bfs'
 require 'stringio'
+require 'delegate'
 
 module BFS
   module Bucket
@@ -7,6 +8,21 @@ module BFS
     class InMem < Abstract
       Entry = Struct.new(:io, :mtime, :content_type, :metadata)
 
+      class Writer < DelegateClass(::StringIO)
+        include BFS::Writer::Mixin
+
+        def initialize(encoding:, &on_commit)
+          @on_commit = on_commit
+
+          sio = StringIO.new
+          sio.set_encoding(encoding)
+          super sio
+        end
+
+        alias close! close
+        alias commit_ref __getobj__
+      end
+
       def initialize(**opts)
         super(**opts.dup)
         @files = {}
@@ -43,18 +59,9 @@ module BFS
       # @option opts [String] :content_type Custom content type.
       # @option opts [Hash] :metadata Metadata key-value pairs.
       def create(path, encoding: self.encoding, content_type: nil, metadata: nil, **_opts, &block)
-        io = StringIO.new
-        io.set_encoding(encoding)
-
-        entry = Entry.new(io, Time.now, content_type, norm_meta(metadata))
-        @files[norm_path(path)] = entry
-        return io unless block
-
-        begin
-          yield(io)
-        ensure
-          io.close
-        end
+        Writer.new(encoding: encoding) do |wio|
+          @files[norm_path(path)] = Entry.new(wio, Time.now, content_type, norm_meta(metadata))
+        end.perform(&block)
       end
 
       # Opens an existing file for reading

data/lib/bfs/helpers.rb

@@ -2,21 +2,45 @@ require 'tempfile'
 require 'delegate'
 
 module BFS
-  class TempWriter < DelegateClass(::Tempfile)
-    def initialize(name, tempdir: nil, perm: nil, **opts, &closer)
-      @closer   = closer
-      @tempfile = ::Tempfile.new(File.basename(name.to_s), tempdir, **opts)
-      @tempfile.chmod(perm) if perm
-      super @tempfile
+  class Writer < DelegateClass(::Tempfile)
+    module Mixin
+      def perform
+        return self unless block_given?
+
+        begin
+          yield self
+          commit
+        ensure
+          discard
+        end
+      end
+
+      def commit
+        close
+        return false if @on_commit.nil?
+
+        @on_commit.call(commit_ref)
+        true
+      ensure
+        discard
+      end
+
+      def discard
+        @on_commit = nil
+        close!
+      end
     end
 
-    def close
-      return if closed?
+    include Mixin
+
+    def initialize(name, tempdir: nil, perm: nil, **opts, &on_commit)
+      @on_commit = on_commit
 
-      path = @tempfile.path
-      @tempfile.close
-      @closer&.call(path)
-      @tempfile.unlink
+      tempfile = ::Tempfile.new(File.basename(name.to_s), tempdir, **opts)
+      tempfile.chmod(perm) if perm
+      super tempfile
     end
+
+    alias commit_ref path
   end
 end

data/spec/bfs/blob_spec.rb

@@ -2,12 +2,15 @@ require 'spec_helper'
 
 RSpec.describe BFS::Blob, core: true do
   describe 'default' do
+    subject      { described_class.new('memtest://bucket/path/to/file.txt') }
+
     let(:bucket) { BFS::Bucket::InMem.new }
+
     before       { allow(BFS).to receive(:resolve).and_return(bucket) }
-    subject      { described_class.new('memtest://bucket/path/to/file.txt') }
+
     after        { subject.close }
 
-    it 'should move' do
+    it 'moves' do
       expect(subject.path).to eq('path/to/file.txt')
       expect { subject.mv('/to/other/path.txt') }.to raise_error(BFS::FileNotFound)
 
@@ -16,7 +19,7 @@ RSpec.describe BFS::Blob, core: true do
       expect(subject.path).to eq('to/other/path.txt')
     end
 
-    it 'should write/read' do
+    it 'write/reads' do
       expect { subject.read }.to raise_error(BFS::FileNotFound)
       subject.write('TESTDATA', content_type: 'text/plain', metadata: { 'x-key' => 'val' })
 
@@ -36,12 +39,14 @@ RSpec.describe BFS::Blob, core: true do
   end
 
   describe 'file system' do
+    subject { described_class.new("file:///#{path}") }
+
     let(:tmpdir) { Dir.mktmpdir }
     let(:path)   { "#{tmpdir}/path/to/file.txt".sub('/', '') }
-    after   { FileUtils.rm_rf tmpdir }
-    subject { described_class.new("file:///#{path}") }
 
-    it 'should move' do
+    after { FileUtils.rm_rf tmpdir }
+
+    it 'moves' do
       expect(subject.path).to eq(path)
       expect { subject.mv("#{tmpdir}/to/other/path.txt") }.to raise_error(BFS::FileNotFound)
 
@@ -54,7 +59,7 @@ RSpec.describe BFS::Blob, core: true do
       ]
     end
 
-    it 'should write/read' do
+    it 'write/reads' do
       expect { subject.read }.to raise_error(BFS::FileNotFound)
 
       subject.write('TESTDATA', content_type: 'text/plain', metadata: { 'x-key' => 'val' })

data/spec/bfs/bucket/abstract_spec.rb

@@ -1,7 +1,7 @@
 require 'spec_helper'
 
 RSpec.describe BFS::Bucket::Abstract, core: true do
-  it 'should open with a block' do
+  it 'opens with a block' do
     sub_class = Class.new(described_class) do
       def close
         @closed = true

data/spec/bfs/bucket/fs_spec.rb

@@ -1,15 +1,17 @@
 require 'spec_helper'
 
 RSpec.describe BFS::Bucket::FS, core: true do
-  let(:tmpdir) { Dir.mktmpdir }
-  after   { FileUtils.rm_rf tmpdir }
   subject { described_class.new(tmpdir) }
 
+  let(:tmpdir) { Dir.mktmpdir }
+
+  after { FileUtils.rm_rf tmpdir }
+
   it_behaves_like 'a bucket',
                   content_type: false,
                   metadata: false
 
-  it 'should resolve from URL' do
+  it 'resolves from URL' do
     File.open(File.join(tmpdir, 'test.txt'), 'wb') {|f| f.write 'TESTDATA' }
 
     bucket = BFS.resolve("file://#{tmpdir}")
@@ -18,14 +20,14 @@ RSpec.describe BFS::Bucket::FS, core: true do
     bucket.close
   end
 
-  it 'should support custom perms on #initialize' do
+  it 'supports custom perms on #initialize' do
     blob = BFS::Blob.new("file://#{tmpdir}/test.txt?perm=0666")
     blob.create {|w| w.write 'foo' }
     expect(blob.info.mode).to eq(0o666)
     blob.close
   end
 
-  it 'should support custom perms on #create' do
+  it 'supports custom perms on #create' do
     blob = BFS::Blob.new("file://#{tmpdir}/test.txt")
     blob.create(perm: 0o666) {|w| w.write 'foo' }
     expect(blob.info.mode).to eq(0o666)

data/spec/bfs/helpers_spec.rb

@@ -1,22 +1,29 @@
 require 'spec_helper'
 
-RSpec.describe BFS::TempWriter, core: true do
-  let(:closer) { proc {} }
-  subject { described_class.new 'test', &closer }
+RSpec.describe BFS::Writer, core: true do
+  subject { described_class.new 'test', &on_commit }
 
-  it 'should behave like a File' do
-    missing = ::File.public_instance_methods - subject.public_methods
-    expect(missing).to be_empty
-  end
+  let(:on_commit) { proc { true } }
 
-  it 'should support custom params' do
-    subject = described_class.new 'test', perm: 0o640, &closer
+  it 'supports custom params' do
+    subject = described_class.new 'test', perm: 0o640, &on_commit
     expect(subject.stat.mode).to eq(0o100640)
-    expect(subject.close).to be_truthy
+    expect(subject.commit).to be(true)
+  end
+
+  it 'executes a on_commit block' do
+    expect(on_commit).to receive(:call).with(subject.path).once
+    expect(subject.commit).to be(true)
+    expect(subject.commit).to be(false)
+  end
+
+  it 'may skip on_commit block' do
+    expect(on_commit).not_to receive(:call)
+    expect(subject.discard).to be(true)
   end
 
-  it 'should exectute a closer block' do
-    expect(closer).to receive(:call).with(subject.path)
-    expect(subject.close).to be_truthy
+  it 'does not auto-commit on close' do
+    expect(on_commit).not_to receive(:call)
+    expect(subject.close).to be_nil
   end
 end

data/spec/bfs_spec.rb

@@ -1,14 +1,14 @@
 require 'spec_helper'
 
 RSpec.describe BFS, core: true do
-  it 'should resolve' do
-    bucket = BFS.resolve("file://#{Dir.tmpdir}")
+  it 'resolves' do
+    bucket = described_class.resolve("file://#{Dir.tmpdir}")
     expect(bucket).to be_instance_of(BFS::Bucket::FS)
     bucket.close
   end
 
-  it 'should resolve with block' do
-    BFS.resolve("file://#{Dir.tmpdir}") do |bucket|
+  it 'resolves with block' do
+    described_class.resolve("file://#{Dir.tmpdir}") do |bucket|
       expect(bucket).to be_instance_of(BFS::Bucket::FS)
       expect(bucket).to receive(:close)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bfs
 version: !ruby/object:Gem::Version
-  version: 0.7.4
+  version: 0.8.2
 platform: ruby
 authors:
 - Dimitrij Denissenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-26 00:00:00.000000000 Z
+date: 2021-05-04 00:00:00.000000000 Z
 dependencies: []
 description: Minimalist abstraction for bucket storage
 email: dimitrij@blacksquaremedia.com
@@ -51,7 +51,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Multi-platform cloud bucket adapter