avm 0.73.1 → 0.75.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7982b293a654555c267bc2f3b8856a40e4e60a5ee2a9bcc08796d4814a811c15
-  data.tar.gz: 6a8ade3bc981708360d1cecdb7e9ee1461d0fad4ff3daa0ae7de1f6636e99e9d
+  metadata.gz: 283b2992d153ecb696d270dca06440c1211ad0986d2bcccbba13d59880ec8241
+  data.tar.gz: df2da2e866a10834d9b2d7c07e921f332de3b64937592bad04eb0c334cd1b3a6
 SHA512:
-  metadata.gz: 32e5a58c320316929d9d954b98a284f40e4231af15b848513cdfcfc91364ad20362b95c05af1fe6c3f4822fc786a981129c8d3878d55104189f2d7af91c442f9
-  data.tar.gz: de0f2e9f63d6bd9e3aac64f36ef505f028494462e6e734b42efc1c88be62bb77041e3c2a8ff31a92293884e4d3e73872a9c95e219fc7e3909d6308de124563cc
+  metadata.gz: 57b1246b460a76df268e0b1021e27e7a38ba6056225b5c363fa8ad53b52d5ec09d092518709060cab4fc8b472cce619d8a8b84ed9ff398e502ee5b827613d40b
+  data.tar.gz: 4552cfce3a392507c560938a8ae956278fe03b335d50c5213e4aecfde007b5beaa66012fc0c32a24ab0736f2dae4b5b85e0b3310c7c803a96c6d74e240fae775

data/lib/avm/data/dumper.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require 'avm/data/performer'
+require 'avm/data/rotate'
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/fs/temp'
+
+module Avm
+  module Data
+    class Dumper < ::Avm::Data::Performer
+      DEFAULT_EXPIRE_TIME = 1.day
+      DEFAULT_OVERWRITE = false
+      DEFAULT_ROTATE = true
+
+      enable_speaker
+      enable_listable
+      immutable_accessor :expire_time, :target_path
+      immutable_accessor :overwrite, :rotate, type: :boolean
+
+      # @return [nil]
+      def cannot_perform_reason
+        nil
+      end
+
+      # @return [Pathname]
+      def default_dump_path
+        r = data_owner.data_default_dump_path
+        include_excludes_path_suffix.if_present(r) do |v|
+          r.basename_sub('.*') { |b| "#{b}#{v}#{r.extname}" }
+        end
+      end
+
+      # @return [Boolean]
+      def target_path_expired?
+        target_path_time.if_present(true) { |v| v >= expire_time }
+      end
+
+      # @return [ActiveSupport::Duration, nil]
+      def target_path_time
+        target_path.exist? ? ::Time.now - ::File.mtime(target_path) : nil
+      end
+
+      protected
+
+      attr_reader :temp_data_path
+
+      # @return [Array<Symbol>]
+      def all_units
+        data_owner.units.keys.sort
+      end
+
+      def build_temp_data_file
+        data_owner.dump(temp_data_path, *include_excludes_arguments)
+        raise "\"#{temp_data_path}\" do not exist" unless temp_data_path.exist?
+        raise "\"#{temp_data_path}\" is not a file" unless temp_data_path.file?
+      end
+
+      # @return [String, nil]
+      def do_rotate
+        return unless target_path.exist?
+        return unless rotate?
+
+        infom "Rotating \"#{target_path}\"..."
+        ::Avm::Data::Rotate.new(target_path).run
+      end
+
+      # @return [Array<Symbol>]
+      def excluded_units
+        excludes.map(&:to_sym).sort
+      end
+
+      # @return [ActiveSupport::Duration]
+      def expire_time_get_filter(value)
+        value || DEFAULT_EXPIRE_TIME
+      end
+
+      # @return [String]
+      def include_excludes_path_suffix
+        return nil unless data_owner.respond_to?(:units)
+
+        r = included_units.any? ? included_units : all_units
+        r -= excluded_units if excluded_units.any?
+        r.any? && r != all_units ? "_#{r.join('-')}" : ''
+      end
+
+      # @return [Array<Symbol>]
+      def included_units
+        includes.map(&:to_sym).sort
+      end
+
+      # @return [self]
+      def internal_perform
+        use_current? ? internal_perform_use_current : internal_perform_new
+      end
+
+      def internal_perform_new
+        on_temp_data_file do
+          build_temp_data_file
+          do_rotate
+          move_data_to_target_path
+        end
+      end
+
+      def internal_perform_use_current
+        infom "Dump \"#{target_path}\" exists and is unexpired"
+      end
+
+      def move_data_to_target_path
+        ::FileUtils.mv(temp_data_path, target_path.assert_parent)
+      end
+
+      def on_temp_data_file
+        ::EacRubyUtils::Fs::Temp.on_file do |file|
+          @temp_data_path = file.to_pathname
+          yield
+        end
+      end
+
+      # @return [Boolean]
+      def overwrite_get_filter(value)
+        value.nil? ? DEFAULT_OVERWRITE : value
+      end
+
+      def rotate_get_filter(value)
+        value.nil? ? DEFAULT_ROTATE : value
+      end
+
+      # @return [Pathname]
+      def target_path_get_filter(value)
+        (value || default_dump_path).to_pathname
+      end
+
+      # @return [Boolean]
+      def use_current?
+        return false unless target_path.exist?
+        return false if overwrite?
+
+        !target_path_expired?
+      end
+    end
+  end
+end

data/lib/avm/data/loader.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'avm/data/performer'
+require 'avm/data/rotate'
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/fs/temp'
+
+module Avm
+  module Data
+    class Loader < ::Avm::Data::Performer
+      immutable_accessor :source_path
+
+      # @return [String, nil]
+      def cannot_perform_reason
+        return 'Source path not set' if source_path.blank?
+        return "\"#{source_path}\" is not a file" unless source_path.file?
+
+        nil
+      end
+
+      protected
+
+      def internal_perform
+        data_owner.load(source_path, *include_excludes_arguments)
+      end
+    end
+  end
+end

data/lib/avm/data/package/dump.rb

@@ -1,109 +1,43 @@
 # frozen_string_literal: true
 
+require 'avm/data/package/base_performer'
 require 'avm/data/package/build_directory'
-require 'avm/data/rotate'
 require 'eac_ruby_utils/core_ext'
 require 'minitar'
 
 module Avm
   module Data
     class Package
-      class Dump
-        enable_speaker
-        enable_listable
+      class Dump < ::Avm::Data::Package::BasePerformer
+        enable_method_class
         include ::Avm::Data::Package::BuildDirectory
 
-        DEFAULT_EXPIRE_TIME = 1.day
+        attr_reader :target_path
 
-        attr_reader :package, :data_file_path, :existing
-
-        lists.add_string :existing, :denied, :overwrite, :rotate, :rotate_expired
-
-        def initialize(package, data_file_path, options = {})
-          @package = package
-          @data_file_path = data_file_path
-          options = options.to_options_consumer
-          @existing, @expire_time = options.consume(:existing, :expire_time)
-          options.validate
-          self.class.lists.existing.value_validate!(@existing)
-        end
-
-        def runnable?
-          cannot_run_reason.blank?
-        end
-
-        def cannot_run_reason
-          return nil if !data_file_exist? ||
-                        [EXISTING_OVERWRITE, EXISTING_ROTATE].include?(existing)
-
-          if existing == EXISTING_DENIED
-            'Data exist and overwriting is denied'
-          elsif existing == EXISTING_ROTATE_EXPIRED && !data_file_expired?
-            'Data exist and yet is not expired'
-          end
+        def initialize(package, target_path, options = {})
+          super(package, options)
+          @target_path = target_path.to_pathname
         end
 
-        def run
-          raise "Cannot run: #{cannot_run_reason}" unless runnable?
-
-          package_file = on_build_directory do
+        # @return [void]
+        def result
+          on_build_directory do
             dump_units_to_build_directory
             create_package_file
           end
-          rotate
-          move_download_to_final_dest(package_file)
-        end
-
-        def data_file_exist?
-          ::File.exist?(data_file_path)
-        end
-
-        def data_file_time
-          data_file_exist? ? ::Time.now - ::File.mtime(data_file_path) : nil
-        end
-
-        def data_file_expired?
-          data_file_time.if_present(false) { |v| v >= expire_time }
-        end
-
-        def expire_time
-          @expire_time || DEFAULT_EXPIRE_TIME
-        end
-
-        private
-
-        def move_download_to_final_dest(download_path)
-          ::FileUtils.mkdir_p(::File.dirname(data_file_path))
-          ::FileUtils.mv(download_path, data_file_path)
-        end
-
-        def rotate
-          return unless data_file_exist?
-          return unless existing == EXISTING_ROTATE
-
-          infom "Rotating \"#{data_file_path}\"..."
-          ::Avm::Data::Rotate.new(data_file_path).run
         end
 
-        def new_build_path
-          f = ::Tempfile.new(self.class.name.parameterize + '-download')
-          path = f.path
-          f.close
-          f.unlink
-          path
-        end
+        protected
 
         def dump_units_to_build_directory
-          package.dump_units_to_directory(build_directory)
+          package.dump_units_to_directory(build_directory, selected_units)
         end
 
         def create_package_file
-          package_path = new_build_path
-          infom "Creating package \"#{package_path}\" from \"#{build_directory}\"..."
+          infom "Creating package \"#{target_path}\" from \"#{build_directory}\"..."
           ::Dir.chdir(build_directory.to_path) do
-            ::Minitar.pack('.', File.open(::File.expand_path(package_path), 'wb'))
+            ::Minitar.pack('.', ::File.open(target_path, 'wb'))
           end
-          package_path
         end
       end
     end

data/lib/avm/data/package/load.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'avm/data/package/base_performer'
 require 'avm/data/package/build_directory'
 require 'eac_ruby_utils/core_ext'
 require 'minitar'
@@ -7,37 +8,27 @@ require 'minitar'
 module Avm
   module Data
     class Package
-      class Load
+      class Load < ::Avm::Data::Package::BasePerformer
+        enable_method_class
         enable_speaker
         include ::Avm::Data::Package::BuildDirectory
 
-        common_constructor :package, :data_file_path
+        attr_reader :source_path
 
-        def runnable?
-          cannot_run_reason.blank?
+        def initialize(package, source_path, options = {})
+          super(package, options)
+          @source_path = source_path.to_pathname
         end
 
-        def cannot_run_reason
-          return nil if data_file_exist?
-
-          "Data file \"#{data_file_path}\" does not exist"
-        end
-
-        def run
-          raise "Cannot run: #{cannot_run_reason}" unless runnable?
-
+        def result
           on_build_directory do
             extract_packages_to_build_directory
-            package.load_units_from_directory(build_directory)
+            package.load_units_from_directory(build_directory, selected_units)
           end
         end
 
-        def data_file_exist?
-          ::File.exist?(data_file_path)
-        end
-
         def extract_packages_to_build_directory
-          ::Minitar.unpack(data_file_path, build_directory.to_path)
+          ::Minitar.unpack(source_path.to_path, build_directory.to_path)
         end
       end
     end

data/lib/avm/data/package.rb

@@ -32,23 +32,19 @@ module Avm
         DATA_FILE_EXTENSION
       end
 
-      def dump(data_path, options = {})
-        ::Avm::Data::Package::Dump.new(self, data_path, options)
-      end
-
-      def load(data_path)
-        ::Avm::Data::Package::Load.new(self, data_path)
-      end
-
-      def dump_units_to_directory(directory)
+      def dump_units_to_directory(directory, selected_units = nil)
         run_callbacks :dump do
-          units.each { |identifier, unit| unit.dump_to_directory(directory, identifier) }
+          (selected_units || units).each do |identifier, unit|
+            unit.dump_to_directory(directory, identifier)
+          end
         end
       end
 
-      def load_units_from_directory(directory)
+      def load_units_from_directory(directory, selected_units = nil)
         run_callbacks :load do
-          units.each { |identifier, unit| unit.load_from_directory(directory, identifier) }
+          (selected_units || units).each do |identifier, unit|
+            unit.load_from_directory(directory, identifier)
+          end
         end
       end
 

data/lib/avm/data/performer.rb

@@ -19,7 +19,7 @@ module Avm
 
       # @return [self]
       def perform
-        raise "Cannot run: #{cannot_run_reason}" unless performable?
+        raise "Cannot run: #{cannot_perform_reason}" unless performable?
 
         internal_perform
 

data/lib/avm/instances/data/package.rb

@@ -12,6 +12,11 @@ module Avm
           @instance = instance
           super options
         end
+
+        # @return [Pathname]
+        def data_default_dump_path
+          instance.data_default_dump_path.to_pathname
+        end
       end
     end
   end

data/lib/avm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Avm
-  VERSION = '0.73.1'
+  VERSION = '0.75.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: avm
 version: !ruby/object:Gem::Version
-  version: 0.73.1
+  version: 0.75.0
 platform: ruby
 authors:
 - Eduardo H. Bogoni
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-21 00:00:00.000000000 Z
+date: 2023-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aranha-parsers
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.19'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.19'
 - !ruby/object:Gem::Dependency
   name: eac_cli
   requirement: !ruby/object:Gem::Requirement
@@ -233,6 +233,8 @@ files:
 - lib/avm/applications/base/stereotype.rb
 - lib/avm/data/callbacks.rb
 - lib/avm/data/clearer.rb
+- lib/avm/data/dumper.rb
+- lib/avm/data/loader.rb
 - lib/avm/data/package.rb
 - lib/avm/data/package/base_performer.rb
 - lib/avm/data/package/build_directory.rb