s41c 0.0.5 → 0.0.6

data/lib/s41c/client.rb

@@ -6,6 +6,10 @@ module S41C
 
     include S41C::Utils
 
+    # Создать инстанс клиента
+    #
+    # @param [ String ] адрес сервера
+    # @param [ Integer ] порт сервера
     def initialize(host='localhost', port=1421)
       require 'net/telnet'
       require 's41c/parser'
@@ -14,36 +18,59 @@ module S41C
       @prompt = /^\+OK/n
       @errors = []
 
-    end # initialize
+    end
 
+    # Задать данные для авторизации
+    #
+    # @param [ String ] логин
+    # @param [ String ] пароль
     def login(username, password = nil)
       @login = username.nil? || username.empty? ? nil : username
       @password = password
 
       self
-    end # login
+    end
 
+    # Возвращает массив ошибок
+    #
+    # @return [ Array ] массив ошибок
     def errors
       @errors
-    end # errors
+    end
 
+    # Проверка соединения с сервером
     def ping
       cmd "ping"
-    end # ping
+    end
 
+    # Отключиться от сервера
     def disconnect
       cmd "disconnect"
-    end # disconnect
+    end
 
+    # Остановить сервер и отключиться от него
     def shutdown
       cmd "shutdown"
-    end # shutdown
+    end
 
-    def request(&block)
+    # Выполнить на сервере блок кода
+    #
+    # @param [ Hash ] переменные, которые будут доступны внутри блока
+    # @param [ Proc ] блок кода
+    #
+    # @return [ String ] результат выполнения блока
+    def request(vars = {}, &block)
       code = S41C::Parser.new(block).parse
-      self.eval code
-    end # request
+      dump = Marshal.dump({vars: vars, code: code})
 
+      self.eval dump
+    end
+
+    # Выполнить на сервере строку
+    #
+    # @param [ String ] строка кода
+    #
+    # @return [ String ] результат выполнения
     def eval(code)
       cmd "eval\0\n#{code}\nend_of_code"
     end
@@ -71,18 +98,18 @@ module S41C
         @errors << e.message
         return false
       end
-    end # conn
+    end
 
     def cmd(str)
       return @errors unless conn
-      parse @client.cmd(to_bin(str))
-    end # cmd
+      parse @client.cmd(str)
+    end
 
     def parse(response)
       resp = to_utf8(response)
       resp.lines.first.chomp
-    end # parse
+    end
 
-  end # Client
+  end
 
-end # S41C
+end

data/lib/s41c/parser.rb

@@ -1,12 +1,13 @@
 # encoding: utf-8
 
-module S41C
+module S41C #:nodoc
 
-  class Parser
+  class Parser #:nodoc
 
     BLOCK_BEGINNERS = /module|class|def|begin|do|case|if|unless|{/
     BLOCK_ENDERS = /end|}/
 
+    #:nodoc
     def initialize(block)
       sl = block.source_location
       @file, @start_line = sl.first, (sl.last)
@@ -22,15 +23,22 @@ module S41C
 
     end # new
 
+    #:nodoc
     def parse
       raw = @lines[@start_line..-1]
       depth = 0
+      code = []
       @finish_line = @start_line
 
       raw.each_with_index do |line, index|
 
-        depth += 1 if line[BLOCK_BEGINNERS]
-        depth -= 1 if line[BLOCK_ENDERS]
+        line.gsub!(/^\r\n/,'')
+        line.gsub!(/\r\n$/,'')
+
+        depth += line.scan(BLOCK_BEGINNERS).count
+        depth -= line.scan(BLOCK_ENDERS).count
+
+        code << line
 
         if depth == 0
           @finish_line = index
@@ -39,14 +47,12 @@ module S41C
 
       end # each
 
-      block = raw[0..@finish_line]
-
-      block.first.sub!(/^.*#{BLOCK_BEGINNERS}/, '')
-      block.last.sub!(/#{BLOCK_ENDERS}.*$/, '')
+      code.first.sub!(/^.*#{BLOCK_BEGINNERS}/, '')
+      code.last.sub!(/#{BLOCK_ENDERS}.*$/, '')
 
-      block.join
-    end # parse
+      code.delete_if{|el| el.empty?}.join(';')
+    end
 
-  end # Parser
+  end
 
-end # S41C
+end

data/lib/s41c/sandbox.rb

@@ -1,20 +1,24 @@
 # encoding: utf-8
 
-module S41C
+module S41C #:nodoc
 
-  class Sandbox
+  class Sandbox #:nodoc
 
     include S41C::Utils
 
-    def initialize(ole, code)
+    #:nodoc
+    def initialize(ole, dump)
       @ole = ole
-      code.untaint
+      dump.untaint
+      hsh = Marshal.load(dump)
+      @vars = hsh[:vars]
       @code = proc {
         $SAFE = 3
-        instance_eval code, __FILE__, __LINE__
+        instance_eval hsh[:code], __FILE__, __LINE__
       }
     end
 
+    #:nodoc
     def eval_code
       begin
         @code.call
@@ -29,4 +33,4 @@ module S41C
 
   end
 
-end # S41C
+end

data/lib/s41c/server.rb

@@ -6,6 +6,11 @@ module S41C
 
     include S41C::Utils
 
+    # Создать инстанс сервера
+    #
+    # @param [ String ] адрес, на котором будет запущен сервер
+    # @param [ Integer ] порт
+    # @param [ String ] лог-файл
     def initialize(host='localhost', port=1421, log_file=nil)
       require 'socket'
       require 'win32ole'
@@ -14,37 +19,53 @@ module S41C
       @logger = log_file ? ::STDOUT.reopen(log_file, 'a') : ::STDOUT
       @ole_name = 'V77.Application'
 
-    end # initialize
+    end
 
+    # Задать данные для авторизации подключающихся клиентов
+    #
+    # @param [ String ] логин
+    # @param [ String ] пароль
     def login(username, password)
       @login = username
       @password = password
 
       self
-    end # login
+    end
 
+    # Параметры подключения к базе 1C
+    #
+    # @params [ String ] база
+    # @params [ String ] имя пользователя
+    # @params [ String ] пароль пользователя
     def db(database, user=nil, password=nil)
       @conn_options = "/d #{database}"
       @conn_options << " /n #{user}" if user
       @conn_options << " /p #{password}" if password
 
       self
-    end # db
+    end
 
+    # Название ole-объекта, который будет использоваться для подключения к 1С
+    #
+    # @param [ String ] название ole-объекта
     def ole_name=(name)
       @ole_name = name
 
       self
-    end # ole_name=
+    end
 
+    # Задать блок кода, который будет выполнен при выключении сервера
+    #
+    # @param [ Proc ] блок кода
     def at_exit(&block)
       ::Kernel::at_exit do
         yield
       end
 
       self
-    end # at_exit
+    end
 
+    # Запустить сервер
     def start
 
       ["INT", "TERM"].each do |signal|
@@ -68,18 +89,18 @@ module S41C
         retry
       end
 
-    end # start
+    end
 
     private
 
     def read_response(session)
-      to_utf8(session.gets || '').chomp
-    end # read_response
+      (session.gets || '').chomp
+    end
 
     def log(msg)
       @logger.puts msg
       @logger.flush
-    end # log
+    end
 
     def connect_to_1c
       begin
@@ -97,11 +118,11 @@ module S41C
       end
     end
 
-    def eval_code(code)
+    def eval_code(dump)
       return "Error: not connected" unless @conn
 
-      S41C::Sandbox.new(@ole, code).eval_code
-    end # eval_code
+      S41C::Sandbox.new(@ole, dump).eval_code
+    end
 
     def main_loop(server)
       loop do
@@ -137,11 +158,11 @@ module S41C
           cmd = args.shift
           case cmd
           when "eval"
-            code = ""
+            dump = ""
             while !(part = session.gets)['end_of_code']
-              code << to_utf8(part)
+              dump << part
             end
-            session.puts to_bin(eval_code(code))
+            session.puts to_bin(eval_code(dump))
             session.puts "+OK"
           when "ping"
             session.puts "pong"
@@ -161,8 +182,8 @@ module S41C
         }
 
       end
-    end # main_loop
+    end
 
-  end # Server
+  end
 
-end # S41C
+end

data/lib/s41c/utils.rb

@@ -4,10 +4,20 @@ module S41C
 
   module Utils
 
+    # Переводит строку в бинарное представление
+    #
+    # @param [ String ] строка в utf-8
+    #
+    # @return [ String ] строка в бинарном представлении
     def to_bin(str)
       str.to_s.force_encoding("BINARY")
     end
 
+    # Переводит строку в utf-8
+    #
+    # @param [ String ] бинарная строка или строка из 1С
+    #
+    # @return [ String ] строка в utf-8
     def to_utf8(str)
       return unless str.is_a?(String)
       if str.encoding.to_s == "IBM866"
@@ -17,14 +27,19 @@ module S41C
       end
     end
 
+    # Обертка над 1С-функцией "ЗначениеВСтрокуВнутр"
+    #
+    # @param [ Object ] объект 1С
+    #
+    # @return [ String ] идентификатор объекта
     def get_1c_id(obj)
       return false unless @ole
 
       str_id = @ole.invoke('ЗначениеВСтрокуВнутр', obj)
       escaped_str_id = "\"#{str_id.gsub('"', '""')}\""
 
-    end # get_1c_id
+    end
 
-  end # Utils
+  end
 
-end # S41C
+end

data/lib/s41c/version.rb

@@ -1,5 +1,5 @@
 module S41C
 
-  VERSION = '0.0.5'
+  VERSION = '0.0.6'
 
 end # S41C

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: s41c
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-25 00:00:00.000000000 Z
+date: 2012-04-08 00:00:00.000000000 Z
 dependencies: []
 description: TCP-socket сервер и клиент для платформы "1С:Предприятие"
 email:
@@ -28,7 +28,6 @@ files:
 - lib/s41c/server.rb
 - lib/s41c/client.rb
 - lib/s41c.rb
-- s41c-0.0.4.gem
 - Gemfile
 - Rakefile
 homepage: https://github.com/dancingbytes/s41c