ass_maintainer-info_base 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 662be0fd5b4c3cdcb6a262d14467d36a5edbd8f4
+  data.tar.gz: bcfed5068d14bab47917ebd22ca351d586de79b1
+SHA512:
+  metadata.gz: b6527c21fd7322dd9613b65145f62304b7b6bfcad13d38a4bc5e0758fda6da0cc6e54bcd1c87595fb3a3b522449fff3e211602afc58d008386ca777dcf904e5b
+  data.tar.gz: 5e55ee0aa79f601fc393a9e9440645671af14f9fd1f1a7ac55661f9a003ae79b35a1d92c5ee3e548938ec4042420fcf29b1007afdd231d6e2c6c677fa961abeb

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.simplecov

@@ -0,0 +1 @@
+SimpleCov.start if ENV['SIMPLECOV']

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.0.0
+before_install: gem install bundler -v 1.10.5

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ass_maintainer-info_base.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Leonid Vlasov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,85 @@
+# AssMaintainer::InfoBase
+
+
+Gem provides features for manipulate with 1C:Enterprise applications as easy
+as possible.
+
+Main thing of this gem `class AssMaintainer::InfoBase` provides
+some methods for manipulate with information base;
+
+## Realase note
+
+### v.0.1.0
+
+- Not support infobases deployed on 1C:Enterprise server
+- Not support configuration extensions
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ass_maintainer-info_base'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ass_maintainer-info_base
+
+## Usage
+
+Small example:
+
+```ruby
+reqiure 'ass_maintainer/info_base'
+
+# As infobase admin you should make backups of infobase
+
+# Describe connection string
+connection_string = 'File="infobase_path";'
+
+# Get InfoBase instance
+ib = AssMaintainer::InfoBase.new('infobase_name', connection_string, read_only)
+
+# Dump data
+ib.dump(dump_path)
+
+
+# As 1C application developer you should make dump of infobase configuration
+
+# Dump configuration
+ib.cfg.dump(cf_dump_path)
+
+# ... etc
+
+```
+
+For more examples see [examples](./test/ass_maintainer/examples_test.rb)
+
+## Test
+
+For running tests require installs 1C:Enterprise platform version defined in constant
+`PLATFORM_REQUIRE` from
+[test_helper.rb](./test/test_helper.rb)
+
+    $export SIMPLECOV=YES && rake test
+
+## 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. Run `bundle exec ass_maintainer-info_base` to use the gem in this directory, ignoring other installed copies of this gem.
+
+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](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/leoniv/ass_maintainer-info_base.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/ass_maintainer-info_base.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ass_maintainer/info_base/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ass_maintainer-info_base"
+  spec.version       = AssMaintainer::InfoBase::VERSION
+  spec.authors       = ["Leonid Vlasov"]
+  spec.email         = ["leoniv.vlasov@gmail.com"]
+
+  spec.summary       = %q{Manipulate with 1C:Enterprise application instances}
+  spec.description   = %q{Classes and utils for manipulate with 1C:Enterprise application instances also known as "InfoBase" or "Information Base"}
+  spec.homepage      = "https://github.com/leoniv/ass_maintainer-info_base"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "ass_launcher", "~> 0.2.0"
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "mocha"
+
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "ass_maintainer/info_base"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+require "pry"
+Pry.start
+
+# require "irb"
+# IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/examples/describe_infobase.rb

@@ -0,0 +1,52 @@
+require 'ass_tests/info_bases'
+
+AssTests::InfoBases.describe do
+  file :empty_ib do
+  # DescribeOptions
+    template nil # Путь к шаблону ИБ
+    fixtures nil # Объект реализующий интрфейс AssTests::FixturesInterface для
+     # заполнения ИБ
+    maker nil # Объект реализующий интерфейс AssTests::IbMakerInterface создающий
+     # ИБ
+    destroyer nil # Объект реализующий интерфейс AssTests::IbDistroyerInterface
+     # уничтожающий ИБ
+    platform_require ENV['ASS_PLATFORM']
+    before_make ->(ib) { puts "Before make #{ib.name}"}
+    after_make ->(ib) { puts "After make #{ib.name}"}
+    before_rm ->(ib) { puts "Before rm #{ib.name}"}
+    after_rm ->(ib) { puts "After rm #{ib.name}"}
+  # CommonDescriber
+    locale nil
+    user 'name'
+    password 'password'
+  # FileIb
+    directory File.expand_path('../../tmp', __FILE__)
+  end
+
+  server :empty_server_ib do
+  # DescribeOptions
+    template nil
+    fixtures nil
+    maker nil
+    destroyer nil
+    platform_require '~> 8.3.8'
+    before_make nil
+    after_make nil
+    before_rm nil
+    after_rm nil
+  # CommonDescriber
+    locale nil
+    user 'name'
+    password 'password'
+  # ServerIb
+    agent ENV['ASS_SERVER_AGENT'] # --host 'host:port' --user 'admin' --password 'password'
+    claster ENV['ASS_CLASTER'] # --host 'host:port' --user 'admin' --password 'password'
+    # db ['EMPTY_DATA_BASE'] # --host 'host:port' --dbms 'MSSQLServer' --db-name 'db_name' --user 'admin' --password 'password' --create-db
+    db "--host 'host:port' --dbms 'MSSQLServer' --db-name 'db_name' --user 'admin' --password 'password' --create-db"
+    schjobdn # Запрет заданий см строка соединения
+  end
+
+  external :acc30, ENV['ACC30_IB_CONNECTION_STRING'] do
+    platform_require '>= 8.3'
+  end
+end

data/exe/ass_maintainer-info_base

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+require "ass_maintainer/info_base"

data/lib/ass_maintainer/info_base.rb

@@ -0,0 +1,339 @@
+require 'ass_maintainer/info_base/version'
+require 'ass_launcher'
+
+module AssMaintainer
+  # rubocop:disable Metrics/ClassLength
+
+  # Class for manipulate with 1C:Enterprise application instance aka
+  # +information base+ or +infobase+
+  #
+  # Instances of this class have dinamicly generated interfaece
+  #
+  # 1C:Enterprise application may be deployed as file (aka file infobase) or
+  # on a 1C:Enterprise server (aka server infobase). In the {#initialize}
+  # instance of this class will be extended suitable module:
+  # - server infobase instance will be extend module {ServerIb}
+  # - file infobase instance will be exten module {FileIb}
+  #
+  # Both instance type inherits methods from {Interfaces::InfoBaseWrapper}
+  #
+  # All instances get methods wrappers for access to {#options} see
+  # {.build_options_wrapper}
+  class InfoBase
+    extend AssLauncher::Api
+    require 'ass_maintainer/info_base/config'
+    require 'ass_maintainer/info_base/interfaces'
+    require 'ass_maintainer/info_base/file_ib'
+    require 'ass_maintainer/info_base/server_ib'
+    require 'ass_maintainer/info_base/cfg'
+    require 'ass_maintainer/info_base/default_maker'
+
+    # :nodoc:
+    class MethodDenied < StandardError
+      def initialize(m)
+        super "Infobase is read only. Method #{m} denied!"
+      end
+    end
+
+    # Deafult port for connect to 1C:Enterprise serever agent
+    DEFAULT_SAGENT_PORT = '1540'
+
+    # Hooks before and after make and remove infobase. Hooks may be passed as
+    # options or seted later see {#add_hook}
+    HOOKS = {
+      before_make: ->(ib) {},
+      after_make: ->(ib) {},
+      before_rm: ->(ib) {},
+      after_rm: ->(ib) {}
+    }
+
+    # On default for make and remove infobase uses {DefaultMaker} and
+    # {FileIb::FileBaseDestroyer} or {ServerIb::ServerBaseDestroyer}
+    # but we can pass custom maker and destroyer as {#options}.
+    # Maker and destroyer must implements {Interfaces::IbMaker} and
+    # {Interfaces::IbDestroyer}
+    WORKERS = {
+      maker: nil,
+      destroyer: nil
+    }
+
+    # - +:latform_require+ Required 1C:Enterprise version
+    # - +:agent_host+ Host name of 1C:Enterprise server agent
+    # - +:agent_port+ TCP port of 1C:Enterprise server agent on
+    #   default {DEFAULT_SAGENT_PORT}
+    # - +:agent_usr+ Admin for 1C:Enterprise server agent
+    # - +:agent_pwd+ Admin password for 1C:Enterprise server agent
+    # - +:laster_usr+ Admin for 1C:Enterprise claster.
+    #   See {ServerIb#claster_usr}
+    # - +:laster_pwd+ Pasword Admin for 1C:Enterprise claster.
+    #   See {ServerIb#claster_pwd}
+    # - +:nlock_code+ Code for connect to locked infobase aka "/UC" parameter
+    ARGUMENTS = {
+      platform_require: nil,
+      sagent_host: nil,
+      sagent_port: nil,
+      sagent_usr: nil,
+      sagent_pwd: nil,
+      claster_usr: nil,
+      claster_pwd: nil,
+      unlock_code: nil
+    }
+
+    OPTIONS = (ARGUMENTS.merge HOOKS).merge WORKERS
+
+    # Dinamicaly builds of options wrappers
+    def self.build_options_wrapper
+      OPTIONS.each_key do |key|
+        next if WORKERS.keys.include? key
+        define_method key do
+          options[key]
+        end
+
+        next if HOOKS.keys.include? key
+        define_method "#{key}=".to_sym do |arg|
+          options[key] = arg
+        end
+      end
+    end
+
+    build_options_wrapper
+
+    # see {#initialize} +name+
+    attr_reader :name
+    # see {#initialize} +connection_string+
+    attr_reader :connection_string
+    # see {#initialize} +options+
+    attr_reader :options
+    # InfoBase is read only
+    # destructive methods will be fail with {MethodDenied} error
+    attr_reader :read_only
+    alias_method :read_only?, :read_only
+
+    # @param name [String] name of infobase
+    # @param connection_string [String AssLauncher::Support::ConnectionString]
+    # @param read_only [true false] infobse is read only or not
+    # @param options [Hash] see {OPTIONS}
+    def initialize(name, connection_string, read_only = true, **options)
+      @name = name
+      @connection_string = self.class.cs(connection_string.to_s)
+      @read_only = read_only
+      @options = OPTIONS.merge(options)
+      case self.connection_string.is
+      when :file then extend FileIb
+      when :server then extend ServerIb
+      else fail ArgumentError
+      end
+      yield self if block_given?
+    end
+
+    # Add hook. In all hook whill be passed +self+
+    # @raise [ArgumentError] if invalid hook name or not block given
+    # @param hook [Symbol] hook name
+    def add_hook(hook, &block)
+      fail ArgumentError, "Invalid hook `#{hook}'" unless\
+        HOOKS.keys.include? hook
+      fail ArgumentError, 'Block require' unless block_given?
+      options[hook] = block
+    end
+
+    # Requrement 1C version
+    # @return [String]
+    def platform_require
+      options[:platform_require] || self.class.config.platform_require
+    end
+
+    # Rebuild infobse first call {#rm!} second call {#make}
+    # @raise (see #rm!)
+    def rebuild!(sure = :no)
+      rm! sure
+      make
+    end
+
+    # (see #make_infobase!)
+    def make
+      make_infobase! unless exists?
+      self
+    end
+
+    # Make new empty infobase
+    # wrpped in +before_make+ and +after_make+ hooks
+    # @raise [MethodDenied] if infobase {#read_only?}
+    def make_infobase!
+      fail MethodDenied, :make_infobase! if read_only?
+      before_make.call(self)
+      maker.execute(self)
+      after_make.call(self)
+      self
+    end
+    private :make_infobase!
+
+    # (see #rm_infobase!)
+    def rm!(sure = :no)
+      fail 'If you are sure pass :yes value' unless sure == :yes
+      return unless exists?
+      rm_infobase!
+      nil
+    end
+
+    # Remove infobase
+    # wrpped in +before_rm+ and +after_rm+ hooks
+    # @raise [MethodDenied] if infobase {#read_only?}
+    def rm_infobase!
+      fail MethodDenied, :rm_infobase! if read_only?
+      before_rm.call(self)
+      destroyer.execute(self)
+      after_rm.call(self)
+    end
+    private :rm_infobase!
+
+    # Returns type of infobase
+    # @return [Symbol] +:file+ or +:server+
+    def is
+      connection_string.is
+    end
+
+    # Check type of infobase
+    # @param type [Symbol] +:file+ or +:server+
+    def is?(type)
+      connection_string.is?(type)
+    end
+
+    # Set user name
+    def usr=(user_name)
+      connection_string.usr = user_name
+    end
+
+    # User name
+    # @return [String]
+    def usr
+      connection_string.usr
+    end
+
+    # Set locale
+    # @param l [String] locale code +en+, +ru+ etc
+    def locale=(l)
+      connection_string.locale = l
+    end
+
+    # Get locale
+    # @return [String]
+    def locale
+      connection_string.locale
+    end
+
+    # Set user password
+    def pwd=(password)
+      connection_string.pwd = password
+    end
+
+    # User password
+    # @return [String]
+    def pwd
+      connection_string.pwd
+    end
+
+    # @return [AssLauncher::Enterprise::BinaryWrapper::ThickClient]
+    def thick
+      self.class.thicks(platform_require).last ||
+        fail("Platform 1C #{platform_require} not found")
+    end
+
+    # @return [AssLauncher::Enterprise::BinaryWrapper::ThinClient]
+    def thin
+      self.class.thins(platform_require).last ||
+        fail("Platform 1C #{platform_require} not found")
+    end
+
+    # Get ole connector specified in +type+ parameter
+    # @param type [Symbol] see +AssLauncher::Api#ole+
+    def ole(type)
+      self.class.ole(type, ole_requirement)
+    end
+
+    def ole_requirement
+      "= #{thick.version}"
+    end
+    private :ole_requirement
+
+    def fail_if_not_exists
+      fail 'Infobase not exists' unless exists?
+    end
+    private :fail_if_not_exists
+
+    # Build command for run designer
+    # block will be passed to arguments builder
+    # @return [AssLauncher::Support::Shell::Command]
+    def designer(&block)
+      command(:thick, :designer, &block)
+    end
+
+    # Build command for run enterprise
+    # block will be passed to arguments builder
+    # @param client [Symbol] +:thin+ or +thick+ client
+    # @return [AssLauncher::Support::Shell::Command]
+    def enterprise(client, &block)
+      command(client, :enterprise, &block)
+    end
+
+    def command(client, mode, &block)
+      fail_if_not_exists
+      case client
+      when :thin then
+        thin.command(connection_string.to_args + common_args, &block)
+      when :thick then
+        thick.command(mode, connection_string.to_args + common_args,
+                      &block)
+      else
+        fail ArgumentError, "Invalid client #{client}"
+      end
+    end
+    private :command
+
+    # Common arguments for all commands
+    def common_args
+      r = []
+      r += ['/L', locale] if locale
+      r += ['/UC', unlock_code] if unlock_code
+      r
+    end
+
+    # Dump infobase to +.dt+ file
+    def dump(path)
+      designer do
+        dumpIB path
+      end.run.wait.result.verify!
+      path
+    end
+
+    # Restore infobase from +.dt+ file
+    # @raise [MethodDenied] if {#read_only?}
+    def restore!(path)
+      fail MethodDenied, :restore! if read_only?
+      designer do
+        restoreIB path
+      end.run.wait.result.verify!
+      path
+    end
+
+    # Returns instance for manipuate with
+    # InfoBase database. If infobase not
+    # exists returns nil
+    # @return [Dbase nil]
+    def db_cfg
+      @db_cfg ||= DbCfg.new(self) if exists?
+    end
+
+    # Returns instance for manipuate with
+    # databse configuration. If infobase not
+    # exists returns nil
+    # @return [Cfg nil]
+    def cfg
+      @cfg ||= Cfg.new(self) if exists?
+    end
+
+    extend Forwardable
+    def_delegators :infobase_wrapper,
+                   *Interfaces::InfoBaseWrapper.instance_methods
+  end
+  # rubocop:enable Metrics/ClassLength
+end

data/lib/ass_maintainer/info_base/cfg.rb

@@ -0,0 +1,81 @@
+module AssMaintainer
+  class InfoBase
+    # @abstract
+    class AbstractCfg
+      attr_reader :infobase
+      # @param infobase [InfoBase]
+      def initialize(infobase)
+        @infobase = infobase
+      end
+    end
+
+    # Object for manipuate whith infobase configuration
+    class Cfg < AbstractCfg
+      # Dump configuration to +XML+ files
+      # @param path [String]
+      # @return [String] path
+      def dump_xml(path)
+        infobase.designer do
+          dumpConfigToFiles path
+        end.run.wait.result.verify!
+        path
+      end
+
+      # Dump configuration to +.cf+ file
+      # @param path [String]
+      # @return [String] path
+      def dump(path)
+        infobase.designer do
+          dumpCfg path
+        end.run.wait.result.verify!
+        path
+      end
+
+      # Load configuration from +XML+ files
+      # @param path [String]
+      # @return [String] path
+      def load_xml(path)
+        fail MethodDenied, :load_xml if infobase.read_only?
+        infobase.designer do
+          loadConfigFromFiles path
+        end.run.wait.result.verify!
+        path
+      end
+
+      # Load configuration from +.cf+ file
+      # @param path [String]
+      # @return [String] path
+      def load(path)
+        fail MethodDenied, :load_cf if infobase.read_only?
+        infobase.designer do
+          loadCfg path
+        end.run.wait.result.verify!
+        path
+      end
+    end
+
+    # Object for manipuate whith database configuration
+    class DbCfg < AbstractCfg
+      # Update database configuration from infobase
+      # configuration
+      def update
+        fail MethodDenied, :update if infobase.read_only?
+        infobase.designer do
+          updateDBCfg do
+            warningsAsErrors
+          end
+        end.run.wait.result.verify!
+      end
+
+      # Dump configuration to +.cf+ file
+      # @param path [String]
+      # @return [String] path
+      def dump(path)
+        infobase.designer do
+          dumpDBCfg path
+        end.run.wait.result.verify!
+        path
+      end
+    end
+  end
+end

data/lib/ass_maintainer/info_base/config.rb

@@ -0,0 +1,28 @@
+module AssMaintainer
+  #
+  class InfoBase
+    ASS_PLATFORM_REQUIRE = ENV['ASS_PLATFORM_REQUIRE'] || '> 0'
+
+    # Settings for {InfoBase}
+    class Config
+      # Set reqirement for version of 1C:Enterprise
+      attr_writer :platform_require
+      # Reqirement for version of 1C:Enterprise
+      # @return [String]
+      def platform_require
+        @platform_require ||= ASS_PLATFORM_REQUIRE
+      end
+    end
+
+    # Make settings
+    def self.configure
+      yield config
+    end
+
+    # Get settings
+    # @return [Config]
+    def self.config
+      @config ||= Config.new
+    end
+  end
+end

data/lib/ass_maintainer/info_base/default_maker.rb

@@ -0,0 +1,16 @@
+module AssMaintainer
+  class InfoBase
+    # Default infobase maker
+    class DefaultMaker
+      include Interfaces::IbMaker
+      # :hodoc:
+      def entry_point
+        infobase.thick
+          .command(:createinfobase,
+                   infobase.connection_string.createinfobase_args +
+                   infobase.common_args)
+          .run.wait.result.verify!
+      end
+    end
+  end
+end

data/lib/ass_maintainer/info_base/file_ib.rb

@@ -0,0 +1,76 @@
+module AssMaintainer
+  class InfoBase
+    # Mixins for file deployed infobase
+    module FileIb
+      # Default destroyer for file infobase
+      class FileBaseDestroyer
+        include Interfaces::IbDestroyer
+        def entry_point
+          FileUtils.rm_r infobase.connection_string.path.to_s
+        end
+      end
+
+      # True if infobase exists
+      def exists?
+        File.file?("#{connection_string.path}/1Cv8.1CD")
+      end
+
+      def maker
+        options[:maker] || InfoBase::DefaultMaker.new
+      end
+      private :maker
+
+      def destroyer
+        options[:destroyer] || FileBaseDestroyer.new
+      end
+      private :destroyer
+
+      # Connection string fore createinfobase
+      def make_connection_string
+        connection_string
+      end
+
+      # Dummy infobase wrupper
+      # @return [InfoBaseWrapper]
+      def infobase_wrapper
+        @infobase_wrapper = InfoBaseWrapper.new(self)
+      end
+
+      # (see Interfaces::InfoBaseWrapper)
+      class InfoBaseWrapper
+        include Interfaces::InfoBaseWrapper
+        attr_accessor :infobase
+        def initialize(infobase)
+          self.infobase = infobase
+        end
+
+        # (see Interfaces::InfoBaseWrapper#sessions)
+        def sessions
+          []
+        end
+
+        # (see Interfaces::InfoBaseWrapper#lock)
+        def lock
+        end
+
+        # (see Interfaces::InfoBaseWrapper#unlock)
+        def unlock
+        end
+
+        # (see Interfaces::InfoBaseWrapper#unlock!)
+        def unlock!
+        end
+
+        # (see Interfaces::InfoBaseWrapper#locked?)
+        def locked?
+          false
+        end
+
+        # (see Interfaces::InfoBaseWrapper#locked_we?)
+        def locked_we?
+          false
+        end
+      end
+    end
+  end
+end

data/lib/ass_maintainer/info_base/interfaces.rb

@@ -0,0 +1,78 @@
+module AssMaintainer
+  class InfoBase
+    # Define absract Interfaces
+    # for worker classes
+    module Interfaces
+      # Interface for class which make new InfoBase
+      # Class must implement +#entry_point+ methodmodule Fixtures
+      module IbMaker
+        attr_reader :infobase
+        def execute(infobase)
+          @infobase = infobase
+          entry_point
+        end
+
+        def entry_point
+          fail NotImplementedError
+        end
+      end
+
+      # Interface for class which destroy InfoBase
+      # Class must implement +#entry_point+ methodmodule Fixtures
+      module IbDestroyer
+        attr_reader :infobase
+        def execute(infobase)
+          @infobase = infobase
+          entry_point
+        end
+
+        def entry_point
+          fail NotImplementedError
+        end
+      end
+
+      # Interface for {FileIb::InfoBaseWrapper} and
+      # {ServerIb::InfoBaseWrapper} classes
+      module InfoBaseWrapper
+        # Returns array of infobase sessions
+        # For file infobase returns empty array
+        # @return [Array <Session>]
+        def sessions
+          fail NotImplementedError
+        end
+
+        # Lock infobase. It work for server infobase only.
+        # For file infobase it do nothing
+        def lock
+          fail NotImplementedError
+        end
+
+        # Unlock infobase which {#locked_we?}.
+        # It work for server infobase only.
+        # For file infobase it do nothing
+        def unlock
+          fail NotImplementedError
+        end
+
+        # Unlock infobase.
+        # It work for server infobase only.
+        # For file infobase it do nothing
+        def unlock!
+          fail NotImplementedError
+        end
+
+        # Lock infobase. It work for server infobase only.
+        # For file infobase it return +false+
+        def locked?
+          fail NotImplementedError
+        end
+
+        # True if infobase locked this
+        # For file infobase it return +false+
+        def locked_we?
+          fail NotImplementedError
+        end
+      end
+    end
+  end
+end

data/lib/ass_maintainer/info_base/server_ib.rb

@@ -0,0 +1,98 @@
+module AssMaintainer
+  class InfoBase
+    # Mixins for infobase deployed on 1C:Eneterprise server
+    module ServerIb
+      require 'ass_maintainer/info_base/server_ib/helpers'
+      # Defauld destroyer for serever infobase
+      class ServerBaseDestroyer
+        include Interfaces::IbDestroyer
+        def entry_point
+          fail NotImplementedError
+        end
+      end
+
+      def maker
+        options[:maker] || InfoBase::DefaultMaker.new
+      end
+      private :maker
+
+      # True if infobase exists
+      def exists?
+        infobase_wrapper.exists?
+      end
+
+      def destroyer
+        options[:destroyer] || ServerBaseDestroyer.new
+      end
+      private :destroyer
+
+      # @return (see #def_server_agent)
+      def server_agent
+        @server_agent ||= def_server_agent
+      end
+
+      # @return [EnterpriseServers::ServerAgent]
+      def def_server_agent
+        host = sagent_host || connection_string.servers[0].host
+        port = sagent_port || InfoBase::DEFAULT_SAGENT_PORT
+        EnterpriseServers::ServerAgent.new("#{host}:#{port}",
+                                           sagent_usr,
+                                           sagent_pwd)
+      end
+      private :def_server_agent
+
+      # @param a [EnterpriseServers::ServerAgent]
+      def server_agent=(a)
+        fail ArgumentError unless a.instance_of? ServerAgent
+        @server_agent = a
+      end
+
+      # Set claster user name
+      # @param user_name [String]
+      def cluster_usr=(user_name)
+        connection_string.susr = user_name
+      end
+
+      # Claster user name
+      def claster_usr
+        connection_string.susr || (self.claster_usr = options[:claster_usr])
+      end
+
+      # Set claster user password
+      # @param password [String]
+      def cluster_pwd=(password)
+        connection_string.spwd = password
+      end
+
+      # Claster user password
+      def claster_pwd
+        connection_string.spwd || (self.claster_pwd = options[:claster_pwd])
+      end
+
+      # @return [EnrepriseServers::Claster]
+      def claster
+        EnterpriseServers::Claster.from_cs(connection_string)
+      end
+
+      def filled?(fields)
+        fields.each do |f|
+          return false if connection_string[f].nil?
+        end
+        true
+      end
+      private :filled?
+
+      # Connection string fore createinfobase
+      def make_connection_string
+        fields = [:dbsrvr, :db, :dbms]
+        fail "Required fields #{fields} must be filled" unless filled?(fields)
+        AssLauncher::Support::ConnectionString.new(connection_string.to_s)
+      end
+
+      # @return {InfoBaseWrapper}
+      def infobase_wrapper
+        @infobase_wrapper = InfoBaseWrapper.new(self, server_agent, claster)
+      end
+    end
+  end
+end

data/lib/ass_maintainer/info_base/server_ib/helpers.rb

@@ -0,0 +1,50 @@
+module AssMaintainer
+  class InfoBase
+    module ServerIb
+      module EnterpriseServers
+        # Mixins for serever connection describers {Claster} {ServerAgent}
+        module ServerConnection
+          attr_reader :host_port, :user, :password
+          def initialize(host_port, user, password)
+            fail ArgumentError, 'Host name require' if host_port.to_s.empty?
+            @host_port = host_port.to_s
+            @user = user
+            @password = password
+          end
+        end
+
+        # Object descrbed 1C server agent connection
+        class ServerAgent
+          include ServerConnection
+        end
+
+        # Object descrbed 1C claster connection
+        class Claster
+          include ServerConnection
+          def self.from_cs(cs)
+            new cs.srvr, cs.susr, cs.spwd
+          end
+        end
+      end
+
+      # Wrapper for manipulate
+      # with real information base deployed in 1C:Enterprise server
+      # ower the 1C Ole classes
+      class InfoBaseWrapper
+        include Interfaces::InfoBaseWrapper
+        attr_accessor :infobase, :server_agent, :claster
+        # @api private
+        def initialize(infobase, server_agent, claster)
+          self.infobase = infobase
+          self.server_agent = server_agent
+          self.claster = claster
+        end
+
+        # True if infobase exists
+        def exists?
+          fail NotImplementedError
+        end
+      end
+    end
+  end
+end

data/lib/ass_maintainer/info_base/version.rb

@@ -0,0 +1,6 @@
+module AssMaintainer
+  #
+  class InfoBase
+    VERSION = '0.1.0'
+  end
+end

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification
+name: ass_maintainer-info_base
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Leonid Vlasov
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-12-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ass_launcher
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Classes and utils for manipulate with 1C:Enterprise application instances
+  also known as "InfoBase" or "Information Base"
+email:
+- leoniv.vlasov@gmail.com
+executables:
+- ass_maintainer-info_base
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .simplecov
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- ass_maintainer-info_base.gemspec
+- bin/console
+- bin/setup
+- examples/describe_infobase.rb
+- exe/ass_maintainer-info_base
+- lib/ass_maintainer/info_base.rb
+- lib/ass_maintainer/info_base/cfg.rb
+- lib/ass_maintainer/info_base/config.rb
+- lib/ass_maintainer/info_base/default_maker.rb
+- lib/ass_maintainer/info_base/file_ib.rb
+- lib/ass_maintainer/info_base/interfaces.rb
+- lib/ass_maintainer/info_base/server_ib.rb
+- lib/ass_maintainer/info_base/server_ib/helpers.rb
+- lib/ass_maintainer/info_base/version.rb
+homepage: https://github.com/leoniv/ass_maintainer-info_base
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Manipulate with 1C:Enterprise application instances
+test_files: []
+has_rdoc: