AssMaintainer::InfoBases

Gem provides infobase classes proper for various use casess.

What is infobase see ass_maintainer-infobase project.

Installation

Add this line to your application's Gemfile:

gem 'ass_maintainer-info_bases'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ass_maintainer-info_bases

Usage

class AssMaintainer::InfoBases::TestInfoBase

Class for testing 1C:Enterprise application.

  require 'ass_maintainer/info_bases/test_info_base'

  PLATFORM_REQUIRE = '~> 8.3.10.0'

  # Build application from xml src
  src = File.expand_path('../app.src')
  fixt = proc do |ib|
    # filling application data ...
  end


  ib = AssMaintainer::InfoBases::TestInfoBase
    .new('test_app', 'File="tmp/test_app"', false,
         template: src, fixtures: fixt, platform_require: PLATFORM_REQUIRE)
  ib.rebuild!(:yes)

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

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

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(cf_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.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/leoniv/ass_maintainer-info_bases.