ass_launcher 0.1.1.alpha → 0.2.0

data/examples/troubles/with_running_1c_example.rb

@@ -0,0 +1,212 @@
+require 'example_helper'
+
+module Examples
+  module TroublesWithRunning1C
+    describe '1C:Enterprise show stupid GUI' do
+      # In this cases 1C:Enterprise open GUI dialog.
+      # Such stupid 1C:Enerprise behavior made difficult to run 1C:Enterprise
+      # without human watching
+
+      # For show dialogs set $SHOW_STUPID_GUI
+
+      it 'Thin client show dialog with error message' do
+        skip unless TROUBLES_EXECUTE_CONTROL::SHOW_STUPID_GUI
+        command = CLIENTS::THIN.command(['/F','bad infobase path', '/L', 'en'])
+        # It show error message window
+        command.run.wait
+        # But 1C:Enterprise process exit with status 0
+        command.process_holder.result.success?.must_equal true
+      end
+
+      it 'Thick client show dialog with offer for create new infobase' do
+        skip unless TROUBLES_EXECUTE_CONTROL::SHOW_STUPID_GUI
+        command = CLIENTS::THICK\
+          .command(:enterprise, ['/F','bad infobase path', '/L', 'en'])
+        # It show GUI dialg with offer create new infobase
+        command.run.wait
+      end
+
+      it 'Designer show dialg with error message for serevr infobase' do
+        skip unless TROUBLES_EXECUTE_CONTROL::SHOW_STUPID_GUI
+        designer = CLIENTS::THICK.command :designer do
+            _S 'example.org/fake_ib'
+            _L 'en'
+          end
+
+        # It show GUI
+        designer.run.wait
+      end
+
+      describe 'Solution. For file infobase only!!!' do
+        it 'Arguments builder check existing path for /F parameter' do
+          proc {
+            CLIENTS::THICK.command(:enterprise) do
+              _F 'bad infobase path'
+            end
+          }.must_raise ArgumentError
+        end
+
+        it 'Connection string fails in #to_args method if path not exists' do
+          extend AssLauncher::Api
+          conns = cs_file file: 'bad infobase path'
+
+          # Call #to_args directly
+          proc {
+            CLIENTS::THIN.command(conns.to_args)
+          }.must_raise Errno::ENOENT
+
+          # Passing connection string into arguments builder
+          # have the same effect
+          proc {
+            CLIENTS::THIN.command do
+              connection_string conns
+            end
+          }.must_raise Errno::ENOENT
+        end
+      end
+    end
+
+    describe '1C:Enterprise ignores mistakes in CLI parameters' do
+      # Usually command line apps are checking CLI parameters and
+      # exits with non zero status but usually 1C:Enterprise doesn't it
+
+      it 'Pass wrong parameter name /WrongParameter' do
+        command = CLIENTS::THICK\
+          .command(:designer, ['/F', TMP::EMPTY_IB, '/WrongParameter','']) do
+            checkModules do
+              thinClient
+            end
+          end
+        command.run.wait.result.exitstatus.must_equal 0
+      end
+
+      it 'Pass wrong parameter value' do
+        skip unless CLIENTS::THICK.version < Gem::Version.new('8.3.4')
+        command = CLIENTS::THICK\
+          .command(:designer, ['/F', TMP::EMPTY_IB,
+                   '/SetPredefinedDataUpdate','Bad value'
+        ])
+        command.run.wait.result.exitstatus.must_equal 0
+      end
+
+      it 'One of the rare cases when 1C:Enterprise verifies of paramter value' do
+        command = CLIENTS::THICK\
+          .command(:designer, ['/F', TMP::EMPTY_IB]) do
+            checkModules do
+              thinClient
+              eXtension 'bad value'
+            end
+          end
+        command.run.wait.result.exitstatus.wont_equal 0
+
+        # But doesn't explains cause of error
+        command.process_holder.result.assout.must_equal ''
+      end
+
+      describe 'Solutions this troubles with arguments builder' do
+        it 'Arguments builder fails BuildError if unknown parameter given' do
+          proc {
+            CLIENTS::THICK\
+              .command (:enterprise) do
+              uncknownParameter
+            end
+          }.must_raise AssLauncher::Enterprise::Cli::ArgumentsBuilder::BuildError
+        end
+
+        it 'Cli::Parameter instance verifies given value' do
+          proc {
+            CLIENTS::THICK\
+              .command (:designer) do
+                setPredefinedDataUpdate 'Bad value'
+            end
+          }.must_raise ArgumentError
+
+          proc {
+            CLIENTS::THICK\
+              .command (:enterprise) do
+              debuggerURL 'tcp:/baduri'
+            end
+          }.must_raise ArgumentError
+        end
+      end
+    end
+
+    describe 'Trouble with /C CLI parameter' do
+      it 'Transform value if value contains double quote char' do
+        source_string = 'Hello "World"'
+
+        enterprise = CLIENTS::THICK\
+          .command :enterprise, ['/C', source_string] do
+          connection_string TMP::EMPTY_IB_CS
+          _Execute TEMPLATES::HELLO_EPF
+        end
+
+        enterprise.run.wait
+        ret_string = enterprise.process_holder.result.assout.strip
+
+        source_string.wont_equal ret_string
+        ret_string.must_equal 'Hello \\'
+      end
+
+      it 'Transform value if value contains escaped double quote char' do
+        source_string = 'Hello \"World\"'
+
+        enterprise = CLIENTS::THICK\
+          .command :enterprise, ['/C', source_string] do
+          connection_string TMP::EMPTY_IB_CS
+          _Execute TEMPLATES::HELLO_EPF
+        end
+
+        enterprise.run.wait
+        ret_string = enterprise.process_holder.result.assout.strip
+
+        source_string.wont_equal ret_string
+        ret_string.must_equal 'Hello \\\\\\'
+      end
+
+      describe 'Solutions' do
+        it 'Check value /C parameter with arguments builder' do
+          proc {
+            CLIENTS::THIN.command do
+              _C '"'
+            end
+          }.must_raise ArgumentError
+        end
+
+        it 'Passing value with single quote char' do
+          source_string = 'Hello \'World\''
+
+          enterprise = CLIENTS::THICK\
+            .command :enterprise do
+            _C source_string
+            connection_string TMP::EMPTY_IB_CS
+            _Debug
+            debuggerURL 'tcp://localhost'
+            _Execute TEMPLATES::HELLO_EPF
+          end
+
+          enterprise.run.wait
+          ret_string = enterprise.process_holder.result.assout.strip
+
+          source_string.must_equal ret_string
+        end
+      end
+    end
+
+    describe 'Designer talks "Infobase not found!" but exit with 0 for file infobase' do
+      designer = CLIENTS::THICK.command :designer, ['/F','./fake_ib'] do
+        _L 'en'
+      end
+
+      designer.run.wait
+
+      it 'Exitstatus == 0' do
+        designer.process_holder.result.exitstatus.must_equal 0
+      end
+
+      it 'Error message in out' do
+        designer.process_holder.result.assout.strip.must_equal 'Infobase not found!'
+      end
+    end
+  end
+end

data/examples/v8i_file_example.rb

@@ -0,0 +1,72 @@
+require 'example_helper'
+
+module Examples
+  module V8iFile
+    require 'ass_launcher'
+
+    describe 'Build new v8i file' do
+
+      it 'V8i section must have :Connect field' do
+        proc do
+          AssLauncher::Support::V8iSection\
+            .new('Info base 1', {})
+        end.must_raise(ArgumentError)
+      end
+
+      # Build v8i section
+      v8i_section = AssLauncher::Support::V8iSection\
+        .new('Info base 1', 'Connect' => 'File="path"') do |s|
+        s[:ClientConnectionSpeed] = :Normal
+        s[:App] = :Auto
+      end
+
+      it 'V8i section is case insensitive' do
+        v8i_section[:app].must_equal :Auto
+      end
+
+      it 'For v8i section a Symbol key equal a String key' do
+        v8i_section[:app].must_equal :Auto
+        v8i_section[:app.to_s].must_equal :Auto
+      end
+
+      # Write section to file
+      v8i_file = File.join(Dir.tmpdir,'v8i_file_example.v8i')
+      # v8i file may contain many of sections
+      AssLauncher::Support::V8iFile.save(v8i_file, [v8i_section])
+
+
+      it 'File exists and valid' do
+        File.read(v8i_file).must_equal "[Info base 1]\r\n"\
+          "Connect=File=\"path\"\r\n"\
+          "ClientConnectionSpeed=Normal\r\n"\
+          "App=Auto\r\n"\
+          "\r\n"
+        FileUtils.rm_f v8i_file if File.exists? v8i_file
+      end
+    end
+
+    describe 'Use exists v8i file' do
+      extend AssLauncher::Api
+
+      # Read v8i file
+      v8i_sections = load_v8i(Examples::TEMPLATES::V8I)
+
+      # Get sections contained in v8i file
+      v8i_ib1 = v8i_sections.find {|s| s.caption == 'Info base 1'}
+      v8i_ib2 = v8i_sections.find {|s| s.caption == 'Info base 2'}
+
+      it 'v8i file contain sections describe two 1C:Enterprise applications' do
+        v8i_ib1.must_be_instance_of AssLauncher::Support::V8iSection
+        v8i_ib2.must_be_instance_of AssLauncher::Support::V8iSection
+      end
+
+      # Build connection string for 'Info base 1'
+      conns_ib1 = cs(v8i_ib1[:connect])
+
+      it 'Server connection string' do
+        conns_ib1.must_be_instance_of\
+          AssLauncher::Support::ConnectionString::Server
+      end
+    end
+  end
+end

data/examples/webclient_example.rb

@@ -0,0 +1,67 @@
+require 'example_helper'
+
+module Examples
+  module WebClient
+    require 'ass_launcher'
+
+    describe 'Get web client instanse for connect to infobase' do
+      describe 'Whith URL of infobase' do
+        extend AssLauncher::Api
+
+        wc = web_client('http://host/path/infobase', '8.3.8')
+        loc = wc.location do
+          # Buld arguments
+          _N 'user name'
+          _P 'pass'
+          _L 'en'
+          testClientID 'id'
+          debuggerURL 'http://debugger:5668'
+        end
+
+        it 'We get URI::HTTP instanse' do
+          loc.must_be_instance_of URI::HTTP
+        end
+
+        it 'We get perfect string for connect to infobase' do
+          loc.to_s.must_equal 'http://host/path/infobase?'\
+            'DisableStartupMessages&'\
+            'N=user%20name&'\
+            'P=pass&'\
+            'L=en&'\
+            'TESTCLIENTID=id&'\
+            'DebuggerURL=http%3A%2F%2Fdebugger%3A5668'
+        end
+      end
+
+      describe 'Whith connection string' do
+        extend AssLauncher::Api
+
+        cs = cs_http(ws: 'http://host/path/infobase', usr: 'user name',
+                    pwd: 'pass')
+        wc = web_client(cs.uri, '8.3.8')
+
+        loc = wc.location do
+          # Buld arguments
+          _L 'en'
+          testClientID 'id'
+          debuggerURL 'http://debugger:5668'
+        end
+
+        it 'We get URI::HTTP instanse' do
+          loc.must_be_instance_of URI::HTTP
+        end
+
+        it 'We get perfect string for connect to infobase' do
+          loc.to_s.must_equal 'http://host/path/infobase?'\
+            'N=user%20name&'\
+            'P=pass&'\
+            'DisableStartupMessages&'\
+            'L=en&'\
+            'TESTCLIENTID=id&'\
+            'DebuggerURL=http%3A%2F%2Fdebugger%3A5668'
+        end
+
+      end
+    end
+  end
+end

data/lib/ass_launcher/api.rb

@@ -0,0 +1,113 @@
+# encoding: utf-8
+module AssLauncher
+  # Helpers for easy to use ass_launcher
+  module Api
+    # Return sorted array of instaled 1C binary wrappers
+    # @example
+    #  inclide AssLauncher::Api
+    #  # I can get 1C thick client specific version
+    #  cl = thicks('~> 8.3.8.0').last
+    #  fail "Client '~> 8.3.8.0' not found" if cl.nil?
+    # @param requiremet [String, Gem::Version::Requirement] spec require version
+    # @return [Array<AssLauncher::Enterprise::BinaryWrapper::ThickClient>]
+    def thicks(requiremet = '>= 0')
+      AssLauncher::Enterprise.thick_clients(requiremet).sort
+    end
+
+    # Return sorted array of instaled 1C binary wrappers
+    # @example
+    #  inclide AssLauncher::Api
+    #  # I can get 1C thin client specific version
+    #  cl = thins('~> 8.3.8.0').last
+    #  fail "Client '~> 8.3.8.0' not found" if cl.nil?
+    # @param (see .thicks)
+    # @return [Array<AssLauncher::Enterprise::BinaryWrapper::ThinClient>]
+    def thins(requiremet = '>= 0')
+      AssLauncher::Enterprise.thin_clients(requiremet).sort
+    end
+
+    # (see AssLauncher::Support::ConnectionString.new)
+    # @example
+    #  include AssLauncher::Api
+    #  file_cs = cs 'file="path";'
+    #  srv_cs = cs 'srvr="host";ref="ib_name";'
+    #  http_cs = cs 'ws="http://host/ib";'
+    def cs(connstr)
+      AssLauncher::Support::ConnectionString.new(connstr)
+    end
+
+    # @example
+    #  include AssLauncher::Api
+    #  fcs = cs_file({:file => 'path'})
+    # @return [AssLauncher::Support::ConnectionString::File]
+    def cs_file(hash)
+      AssLauncher::Support::ConnectionString::File.new hash
+    end
+
+    # @example
+    #  include AssLauncher::Api
+    #  httpcs = cs_http({:ws => 'http://host/ib'})
+    # @return [AssLauncher::Support::ConnectionString::Http]
+    def cs_http(hash)
+      AssLauncher::Support::ConnectionString::Http.new hash
+    end
+
+    # @example
+    #  include AssLauncher::Api
+    #  srvcs = cs_srv({:srvr => 'host', :ref=> 'ib'})
+    # @return [AssLauncher::Support::ConnectionString::Server]
+    def cs_srv(hash)
+      AssLauncher::Support::ConnectionString::Server.new hash
+    end
+
+    # (see AssLauncher::Support::V8iFile.load)
+    # @example
+    #  include AssLauncher::Api
+    #
+    #  v8i = load_v8i('infobase.v8i')[0]
+    #  conn_str = cs(v8i[:connect])
+    #  conn_str.usr = 'admin'
+    #  conn_str.pwd = 'password'
+    #  designer = thicks.last.command(:designer, conn_str.to_args)
+    #  designer.run.wait
+    def load_v8i(filename)
+      AssLauncher::Support::V8iFile.load(filename)
+    end
+
+    # Return 1C ole client suitable class instance
+    # @param type [Symbol] type of 1C ole client.
+    #  See {Enterprise::Ole::OLE_CLIENT_TYPES}
+    # @param requiremet [String, Gem::Version::Requirement] require version spec
+    # @raise [ArgumentError] if invalid +type+ given
+    def ole(type, requiremet = '>= 0')
+      AssLauncher::Enterprise::Ole.ole_client(type).new(requiremet)
+    end
+
+    # (see Enterprise.web_client)
+    # @example
+    #  include AssLauncher::Api
+    #
+    #  # Get web client instanse for connect to
+    #  # infobase 'http://host/port/path/infobase'
+    #  wc = web_client('http://host/path/infobase')
+    #
+    #  loc = wc.location do
+    #    _N 'user_name'
+    #    _P 'password'
+    #    _L 'en'
+    #  end # => URI
+    #
+    #  # Or do it with uses connecton string
+    #  connstr =  cs 'ws="http://host/path/infobase";usr="user";pwd="password"'
+    #  wc = web_client(connstr.uri)
+    #  loc = wc.location do
+    #    _L 'en'
+    #  end # => URI
+    #
+    #  # And use given location URI with selenium driver:
+    #  # driver.navigate.to loc.to_s
+    def web_client(uri = nil, version = nil)
+      AssLauncher::Enterprise.web_client(uri, version)
+    end
+  end
+end