ass_maintainer-info_bases 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 92fb427c9909385868c7652e9f1f2a8b8f1ab123
-  data.tar.gz: 9d40b97c157d16a587b46feb37aa44b3f815af8a
+  metadata.gz: 95dd835223f6fc962a45aeb6a6f7907e25d805c3
+  data.tar.gz: e3148beb76453ec283e9ee1bc58e33c695dc288a
 SHA512:
-  metadata.gz: b6dcb20352852d448d51ec897f91e5b9138b5827f0252c7f3799475e646c2d001dcefac86ba03050ce37c7e027f69db9f92e9c26842704e50234f0ae6b9a0710
-  data.tar.gz: 6757a6598d58a1560025d59ea8eba7d89bfc857a172dd97b746dd4bb4f77ea44a1d2f059de78673df2a4453256a26b93d86317f9a3151477fca70cf7b3c91c3a
+  metadata.gz: 2df93dd0f5e85f297d3c5af71d86134e47e71f1b3c69f1005d777d0e196fafccd971a55529d0cc6b9d4e7823bbfd74c4c5be329354252fe20a43de63e6543942
+  data.tar.gz: fda580e493c02e258278e2582098f076403935453e0fe2887e9d97e9dacdbc88782fb00de1ab751b3727471aaa03e85a2ffd573d953fbd4d751622b1b71e7f1c

data/README.md

@@ -1,3 +1,4 @@
+[![Gem Version](https://badge.fury.io/rb/ass_maintainer-info_bases.svg)](https://badge.fury.io/rb/ass_maintainer-info_bases)
 # AssMaintainer::InfoBases
 
 Gem provides [infobase](https://github.com/leoniv/ass_maintainer-info_base)
@@ -25,7 +26,9 @@ Or install it yourself as:
 
 ## Usage
 
-### `TestInfoBase`
+### `class AssMaintainer::InfoBases::TestInfoBase`
+
+Class for testing 1C:Enterprise application.
 
 ```ruby
   require 'ass_maintainer/info_bases/test_info_base'
@@ -46,6 +49,88 @@ Or install it yourself as:
 
 ```
 
+### `class AssMaintainer::InfoBases::TmpInfoBase`
+
+Temporary infobase. Proper for cases when require make temporary
+1C application do anything and remove after.
+Temporary infobase is file infobase always. It makes in temporary
+directory.
+
+#### Simple example.
+
+Convers application xml source to `.cf` file
+
+```ruby
+require 'ass_maintainer/info_bases/tmp_info_base'
+
+PLATFORM_REQUIRE = '~> 8.3.10.0'
+
+src = File.expand_path('../app.src', __FILE__)
+
+# Do in the block with auto remove infobase
+AssMaintainer::InfoBases::TmpInfoBase.make_rm src,
+  platform_require: PLATFORM_REQUIRE do |ib|
+  ib.db_cfg.dump('tmp/app.cf')
+end
+
+# Or remove infobase manually
+tmp_ib = AssMaintainer::InfoBases::TmpInfoBase
+  .new(src, platform_require: PLATFORM_REQUIRE)
+tmp_ib.make
+tmp_ib.db_cfg.dump('tmp/app.cf')
+tmp_ib.rm!
+
+# Or do with AssMaintainer::InfoBases::TmpInfoBase::Api
+
+include AssMaintainer::InfoBases::TmpInfoBase::Api
+
+with_tmp_ib src, platform_require: PLATFORM_REQUIRE do |ib|
+  ib.db_cfg.dump('tmp/app.cf')
+end
+
+```
+
+#### More complex example.
+
+Update application `.cf` file up to required version from update files `.cfu`
+
+```ruby
+require 'ass_maintainer/info_bases/tmp_info_base'
+
+class Updater < AssMaintainer::InfoBases::TmpInfoBase
+  def update_to(cfu_file, force = false)
+    designer do
+      _UpdateCfg cfu_file do
+        _Force if force
+      end
+    end.run.wait.result.verify!
+  end
+
+  def self.execute(from_cf, cfu_files, cf_file, force = false)
+    make_rm from_cf do |ib|
+      cfu_files.each do |cfu|
+        ib.update_to(cfu, force)
+      end
+      ib.cfg.dump(cfu_file)
+    end
+  end
+end
+
+from_cf = File.join(templates_root, 'vendor', 'app', '0', '1cv8.cf')
+cf_file = 'tmp/app.v3.cf'
+
+templates_root = 'path/to/1c/updates'
+cfu_files = ['1','2','3'].map do |v|
+  File.join(templates_root, 'vendor', 'app', v, '1cv8.cfu')
+end
+
+Updater.configure do |conf|
+  conf.platform_require = '~> 8.3.10.0'
+end
+
+Updater.execute(from_cf, cfu_files, cf_file)
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/ass_maintainer/info_bases/test_info_base.rb

@@ -1,7 +1,7 @@
 module AssMaintainer
   module InfoBases
     require 'ass_maintainer/info_base'
-    # Class for for testing 1C:Enterprise application.
+    # Class for testing 1C:Enterprise application.
     # It like {https://github.com/leoniv/ass_maintainer-info_base
     # AssMaintainer::InfoBase} but {#initialize} accepts two additional
     # {OPTIONS}:

data/lib/ass_maintainer/info_bases/tmp_info_base.rb

@@ -0,0 +1,137 @@
+module AssMaintainer
+  module InfoBases
+    require 'ass_maintainer/info_bases/test_info_base'
+    require 'ass_maintainer/info_bases/support'
+    # Temporary infobase. Proper for cases when require make temporary
+    # 1C application do anything and remove after.
+    # Temporary infobase is file infobase always. It makes in temporary
+    # directory.
+    # @example Convert application xml source to +.cf+ file
+    #   require 'ass_maintainer/info_bases/tmp_info_base'
+    #
+    #   PLATFORM_REQUIRE = '~> 8.3.10.0'
+    #
+    #   src = File.expand_path('../app.src', __FILE__)
+    #
+    #   # Do in the block with auto remove infobase
+    #   AssMaintainer::InfoBases::TmpInfoBase.make_rm src,
+    #     platform_require: PLATFORM_REQUIRE do |ib|
+    #     ib.db_cfg.dump('tmp/app.cf')
+    #   end
+    #
+    #   # Or remove infobase manually
+    #   tmp_ib = AssMaintainer::InfoBases::TmpInfoBase
+    #     .new(src, platform_require: PLATFORM_REQUIRE)
+    #   tmp_ib.make
+    #   tmp_ib.db_cfg.dump('tmp/app.cf')
+    #   tmp_ib.rm!
+    #
+    # @example Update application +.cf+ file up to required version from update files +.cfu+
+    #    require 'ass_maintainer/info_bases/tmp_info_base'
+    #
+    #    class Updater < AssMaintainer::InfoBases::TmpInfoBase
+    #      def update_to(cfu_file, force = false)
+    #        designer do
+    #          _UpdateCfg cfu_file do
+    #            _Force if force
+    #          end
+    #        end.run.wait.result.verify!
+    #      end
+    #
+    #      def self.execute(from_cf, cfu_files, cf_file, force = false)
+    #        make_rm from_cf do |ib|
+    #          cfu_files.each do |cfu|
+    #            ib.update_to(cfu, force)
+    #          end
+    #          ib.cfg.dump(cfu_file)
+    #        end
+    #      end
+    #    end
+    #
+    #    from_cf = File.join(templates_root, 'vendor', 'app', '0', '1cv8.cf')
+    #    cf_file = 'tmp/app.v3.cf'
+    #
+    #    templates_root = 'path/to/1c/updates'
+    #    cfu_files = ['1','2','3'].map do |v|
+    #      File.join(templates_root, 'vendor', 'app', v, '1cv8.cfu')
+    #    end
+    #
+    #    Updater.configure do |conf|
+    #      conf.platform_require = '~> 8.3.10.0'
+    #    end
+    #
+    #    Updater.execute(from_cf, cfu_files, cf_file)
+    #
+    class TmpInfoBase < AssMaintainer::InfoBases::TestInfoBase
+      include Support::TmpPath
+      extend Support::TmpPath
+
+      # Mixin for convenience to use.
+      # @example Convert application xml source to +.cf+ file
+      #   require 'ass_maintainer/info_bases/tmp_info_base'
+      #
+      #   PLATFORM_REQUIRE = '~> 8.3.10.0'
+      #
+      #   # Convert application xml source to .cf file
+      #   src = File.expand_path('../app.src', __FILE__)
+      #
+      #   include AssMaintainer::InfoBases::TmpInfoBase::Api
+      #
+      #   with_tmp_ib src, platform_require: PLATFORM_REQUIRE do |ib|
+      #     ib.db_cfg.dump('tmp/app.cf')
+      #   end
+      module Api
+        # (see AssMaintainer::InfoBases::TestInfoBase.make_rm)
+        def with_tmp_ib(template = nil, **options, &block)
+          AssMaintainer::InfoBases::TmpInfoBase
+            .make_rm(template, **options, &block)
+        end
+      end
+
+      # Make new tmp infoabse and yield it in block
+      # after block executing remove tmp infobase
+      def self.make_rm(template = nil, **options, &block)
+        fail 'Block require' unless block_given?
+        ib = new(template, **options)
+        ib.make
+        begin
+          yield ib
+        ensure
+          ib.rm!
+        end
+      end
+
+      def initialize(template = nil, **opts)
+        opts_ = opts.dup
+        opts_ = opts_.merge! template: template if template
+        super *ArgsBuilder.new.args, **opts_
+      end
+
+      def rm!(*_)
+        super :yes
+      end
+
+      # @api private
+      class ArgsBuilder
+        include Support::TmpPath
+        include AssLauncher::Api
+        def args
+          [ib_name, ib_connstr, false]
+        end
+
+        def ib_connstr
+          @ib_connstr ||= cs_file(file: ib_path)
+        end
+
+        def ib_name
+          @ib_name ||= File.basename(tmp_path('ib')).gsub('-','_')
+        end
+
+        def ib_path
+          @ib_path ||= File.join(Dir.tmpdir, ib_name)
+        end
+      end
+    end
+  end
+end
+

data/lib/ass_maintainer/info_bases/version.rb

@@ -1,5 +1,5 @@
 module AssMaintainer
   module InfoBases
-    VERSION = "1.0.1"
+    VERSION = "1.0.2"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ass_maintainer-info_bases
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Leonid Vlasov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-01-09 00:00:00.000000000 Z
+date: 2018-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ass_maintainer-info_base
@@ -127,6 +127,7 @@ files:
 - lib/ass_maintainer/info_bases.rb
 - lib/ass_maintainer/info_bases/support.rb
 - lib/ass_maintainer/info_bases/test_info_base.rb
+- lib/ass_maintainer/info_bases/tmp_info_base.rb
 - lib/ass_maintainer/info_bases/version.rb
 homepage: https://github.com/leoniv/ass_maintainer-info_bases
 licenses: []