cli_application 0.1.9 → 0.1.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c4b0f3ceada563c7810adb8fb2ec62d225ba1ff2
-  data.tar.gz: 77c131b002d7f03b7cb64b2106e4cc13f88970f6
+  metadata.gz: 97e161aaae872e64c8eb70ae91392d210c789564
+  data.tar.gz: c5d7d088bedf9edb2b02eaa0348d0d2da3a272cd
 SHA512:
-  metadata.gz: 3744fa04ba99818fec0cc888ebe108fcfcb3481e8546e7e8bd4b9d2d7f21c3ec4dbcde92d624dc255d567331539e4aef8f10e955ddd5d25a0cda7bd3a416de32
-  data.tar.gz: 3c144c21e11e0cf74b4bc2f4c222e1b4763d9471d00a3b7090d0c25219e5fa3810ba45ee85fd09ddcac8d7e5e3a62f8e7a6cc23c2eab778c11f9b9682849d11b
+  metadata.gz: 55ae149543d5269befed662bb517dc4caf9137d45f9d0bb9afa345a7093fba129a8cdf9afb6134c499920fe90d92955afe990bf452eb399de8f5315e8b390ea6
+  data.tar.gz: bb55fb421ad8fc54f29db17678b788332151b7a37115c097be66063025b908e518318efab920ed87b363a8f969d87b37a57702972573f2c2df24e0cd8d38c204

data/lib/cli_application.rb

@@ -24,6 +24,13 @@ module CliApplication  # :nodoc:
   require 'cli_application/mail_lib/sendmail'
   require 'cli_application/mail_lib/log'
 
+  # Функции записи логов в файл или в базу данных
+  require 'cli_application/log/base'
+  require 'cli_application/log/file'
+  require 'cli_application/log/database'
+  require 'cli_application/log/config'
+  require 'cli_application/log/none'
+
   require 'cli_application/json_struct'
   require 'cli_application/config'
   require 'cli_application/databases'

data/lib/cli_application/app.rb

@@ -35,7 +35,13 @@ module CliApplication
     # @param [String] classfolder директория, в которой расположен базовый класс проекта
     # @param [Sym] lang язык работы приложения (реализовано не полностью)
     def initialize(argv, appfolder, classfolder, lang = :ru)
+      # ru: Настраиваем локализацию приложения
+      # en: setup a localization
       StTools.configure { |config| config.locale = lang }
+      I18n.load_path += Dir[File.join(__dir__, 'locales', '*.{rb,yml}')]
+      I18n.available_locales = [:ru]
+      I18n.default_locale = lang
+      I18n.backend.load_translations
 
       @folders = Hash.new
       @folders[:app] = appfolder
@@ -50,9 +56,23 @@ module CliApplication
 
       @footer = nil
 
+      init_app_log
       init_app
     end
 
+    def init_app_log
+      log_config = ::CliApplication::Log::Config.new(@config)
+      case log_config.type
+        when :none
+          @cli_log = ::CliApplication::Log::None.new
+        when :file
+          @cli_log = ::CliApplication::Log::File.new(self, log_config, @folders[:class])
+        else
+          raise I18n.t('error.config.log_unknown', type: log_config.type.to_s.inspect)
+      end
+      @cli_log.save_app_start_information
+    end
+
     #-------------------------------------------------------------
     #
     # Функции для использования внутри функции main
@@ -223,8 +243,16 @@ module CliApplication
 
     # При вызове данного метода начнется выполнение кода приложения (будет осуществен вызов функции main)
     def run
-      self.exitcode = main || 255
-      self.executed_at = (::Time.now - @started_at).to_f
+      @cli_log.save_app_run_information
+      begin
+        self.exitcode = main || 255
+      rescue Exception => e
+        @cli_log.set_exception(e)
+        raise e
+      ensure
+        self.executed_at = (::Time.now - @started_at).to_f
+        @cli_log.save_app_finish_information
+      end
       puts_footer
       @cli_stat_record.save
       self.exitcode

data/lib/cli_application/config.rb

@@ -10,6 +10,7 @@
 module CliApplication
   class Config < OpenStruct
     attr_reader :config
+    attr_reader :filename
 
     # Конструктор. Вызывается при создании класса приложения. Данный класс доступен
     # в главной функции приложения (main) через переменную config
@@ -21,6 +22,7 @@ module CliApplication
       @folders = folders
       @filenames = Array.new
       @config_filename = File.join([folders[:class], 'config.yml'])
+      @filename = @config_filename
       load_config(@config_filename)
     end
 

data/lib/cli_application/locales/ru.yml

@@ -0,0 +1,20 @@
+ru:
+  error:
+    config:
+      log_section_missing: "В конфигурационном файле %{filename} отсутствует секция \"log\""
+      log_section_type_wrong: "Секция \"log\" конфигурационого файла %{filename} должна принимать одно из следующих значений: none, file, database (указано значение %{type})"
+      log_unknown: "Неизвестный тип логгирования: %{type}"
+      log_section_overwrite: "Необходимо переписать функцию \"%{func}\" в дочернем классе"
+
+  config:
+    log_section:
+      start_header:  "-- Запуск приложения ---------------------------"
+      run_header:    "-- Пользовательская секция ---------------------"
+      finish_header: "-- Завершение приложения -----------------------"
+      app_name: "Приложение: %{name}"
+      app_started_at: "Приложение запущено: %{time}"
+      app_executed_at: "Приложение завершено: %{time} (время выполнения: %{executed_at} сек.)"
+      app_exitcode: "Результат завершения: %{exitcode} (%{status})"
+      app_memory: "Использование памяти: %{value}"
+      app_script_name: "Имя скрипта: %{name}"
+

data/lib/cli_application/log/README.md

@@ -0,0 +1,57 @@
+# module CliApplication::Log
+
+В ходе эксплуатации библиотеки мне пришлось столкнуться с некоторыми проблемами, которые не сразу были
+диагностированы. Например, в ходе выполнения скрипта, через полгода, случайно выяснялось, что скрипт
+последний месяц работал с ошибкой. Подобных ситуаций может быть две:
+
+- Cкрипт был отлажен под девелоперским профилем, записаны логи, затем скрипт помещен в cron. После этого,
+при запуске из под крона, возникала ошибка записи лога (из-под крона другие права), которая не выводилась
+в консоль. Как следствие - под кроном скрипт не работет, а причина неизвестна.
+- В ходе исполнения скрипта возникали не предусмотренные на этапе отладки исключительные ситуации, и скрипт
+прекращал работать. Если не озаботиться выводом диагностических сообщений, например, в почту, то об этой
+ситуации можно было долго не узнать.
+
+Поэтому в CliApplication добавляются функции логгирования работы приложения. Практика показывет, что полные
+логи никто не изучает (трудоемко), поэтому логгирование осуществляется только для последнего запуска скрипта.
+
+При этом, функции логгирования делают следующее:
+1. Уже на этапе девелопмента предупреждают о ситуации, если запись лог-файлов будет ограничена по причине прав.
+Это дает гарантию того, что при запуске из под крона данные будут гарантированно записываться в файл.
+2. Записывают информацию о старте приложения. Если есть блок старта приложения, и ничего больше - где-то
+произошел "вылет" приложения.
+3. Дает возможность записи пользовательских сообщений (например, для отладки или контроля исполнения)
+4. Пишет финальную часть - время исполнения, результат, занятую память.
+
+Помимо файла, запись также возможна в базу данных, что дает возможность удаленно мониторить исполнение
+скриптов
+
+## Настройка логгирования
+
+Для настройки логгирования необходимо создать секцию cli/log в конфигурационном файле. Формат секции
+определяется значением type. Например:
+
+```yaml
+cli:
+  log:
+    type: none
+```
+
+```yaml
+cli:
+  log:
+    type: file
+    location: <folder>
+```
+
+```yaml
+cli:
+  log:
+    type: database
+    database: <имя секции cli/database>
+```
+
+## Логгирование в файл
+
+
+## Логгирование в базу данных
+

data/lib/cli_application/log/base.rb

@@ -0,0 +1,27 @@
+module CliApplication
+  module Log
+    class Base
+
+      def log(message)
+        raise I18n.t('error.config.log_section_overwrite', func: 'log')
+      end
+
+      def save_app_start_information
+        raise I18n.t('error.config.log_section_overwrite', func: 'save_app_start_information')
+      end
+
+      def save_app_run_information
+        raise I18n.t('error.config.log_section_overwrite', func: 'save_app_run_information')
+      end
+
+      def save_app_finish_information
+        raise I18n.t('error.config.log_section_overwrite', func: 'save_app_finish_information')
+      end
+
+      def set_exception(e)
+        @exception = e
+      end
+
+    end
+  end
+end

data/lib/cli_application/log/config.rb

@@ -0,0 +1,71 @@
+module CliApplication
+  module Log
+    class Config
+      attr_reader :log_section
+      attr_reader :type
+
+      # Конструктор. Вызывается при создании класса приложения. В Конструктор передается
+      # секция конфигурационного файла, описывающего правила логгирования приложения
+      # Форматы файла:
+      #
+      # Логгирование отключено (не рекомендуется)
+      # cli:
+      #    log:
+      #       type: none
+      #
+      # Логгирование в файл
+      # cli:
+      #    log:
+      #       type: file
+      #       location: папка для храннения логов
+      #
+      # Логгирование в базу данных
+      # cli:
+      #    log:
+      #       type: database
+      #       database: имя конфигурации базы данных
+      #       table_name: имя таблицы. По умолчанию - st_cli_application_log
+      #
+      #
+      # 1. Описание хранения логов в файлах
+      # Если ключ location не указан, то в качестве базовой папки будет использована
+      # папка класса, с добавлением logs. Если папки нет - она будет создана.
+      # Имя файла лога - соответствует имени скрипта, с добавкой '/logs/'
+      # При запуске осуществляется проверка прав на указанные файлы. Если есть риск незапуска
+      # скрипта под другими пользователями - то будет исключение.
+      # Файл создается в два этапа. Первый - создается файл при запуске, с указанием даты старта
+      # В случае ошибки - она пишется в лог. В случае успешного завершения - запись об этом тоже пишется
+      # в лог
+      #
+      # 2. Описание хранения логов в базе данных
+      #
+      def initialize(config)
+        @possible_keys = [:none, :file, :database]
+
+        @log_section = config.cli.log
+        @config = config
+        check_section_exist
+        check_section_type
+      end
+
+
+      private
+
+
+      def check_section_type
+        @type = @log_section.type.downcase.to_sym rescue :unknown
+        unless @possible_keys.include?(@type)
+          raise I18n.t('error.config.log_section_type_wrong', filename: @config.filename, type: @type.to_s.inspect)
+        end
+      end
+
+      def check_section_exist
+        if @log_section.nil?
+          raise I18n.t('error.config.log_section_missing', filename: @config.filename)
+        end
+      end
+
+
+    end
+  end
+end

data/lib/cli_application/log/database.rb

@@ -0,0 +1,21 @@
+module CliApplication
+  module Log
+    class Database < CliApplication::Log::Base
+
+      def initialize(table)
+        super
+        @table = table
+      end
+
+      def log_possible?
+
+      end
+
+      def save
+
+      end
+
+
+    end
+  end
+end

data/lib/cli_application/log/file.rb

@@ -0,0 +1,96 @@
+module CliApplication
+  module Log
+    class File < CliApplication::Log::Base
+      attr_reader :folder
+      attr_reader :filename
+
+      def initialize(app, log, class_folder)
+        @app = app
+        @log = log
+        @class_folder = class_folder
+        init_log
+      end
+
+      def save_app_start_information
+        log(I18n.t('config.log_section.start_header'))
+        log(I18n.t('config.log_section.app_name', name: $PROGRAM_NAME))
+        log(I18n.t('config.log_section.app_script_name', name: ::File.basename($PROGRAM_NAME)))
+        log(I18n.t('config.log_section.app_started_at', time: Time.zone.now))
+        log("")
+      end
+
+      def save_app_run_information
+        log(I18n.t('config.log_section.run_header'))
+        log("")
+      end
+
+      def save_app_finish_information
+        log(I18n.t('config.log_section.finish_header'))
+        unless @exception.nil?
+          log(@exception.message)
+          log(@exception.backtrace.join("\n"))
+        end
+        log(I18n.t('config.log_section.app_executed_at', time: Time.zone.now, executed_at: @app.executed_at.round(3)))
+        log(I18n.t('config.log_section.app_memory', value: StTools::Human.memory))
+        log(I18n.t('config.log_section.app_exitcode', exitcode: @app.exitcode, status: ((@app.exitcode == 0 ? 'SUCCESS' : 'FAIL'))))
+      end
+
+      def log(message)
+        ::File.open(@filename, 'a') {|f| f.write message + "\n" }
+        ::File.chmod(0777, @filename)
+      end
+
+
+      private
+
+
+      def init_log
+        init_names
+        create_folder
+        check_folder_and_file
+      end
+
+      # Проверка на доступность папки и файла. Если с этим проблема,
+      # то выбрасываем исключение, чтобы уже на этапе отладки было понятно, что
+      # при запуске приложения из под cron будут проблемы
+      def check_folder_and_file
+        if ::File.exists?(@filename)
+          delete_file
+        else
+          check_folder
+        end
+      end
+
+      # Проверка на возможность дописывать в вфайл из под любого пользователя
+      # Если права не XXX, то выбрасываем исключение
+      def delete_file
+        ::File.delete(@filename)
+      end
+
+      def check_folder
+        if Dir.exists?(@folder)
+          # s = Dir.stat(@filename)
+          # puts "Dir >>>>>>>>>>>>>>>>>> #{s.mode}"
+        end
+      end
+
+      def create_folder
+        unless Dir.exists?(@folder)
+          Dir.mkdir(@folder, 0777)
+        end
+      end
+
+      def init_names
+        if @log.log_section.location.nil?
+          # Локация не задана
+          @folder = ::File.join(@class_folder, 'logs')
+        else
+          # Локация в конфиге задана
+          @folder = @log.log_section.location
+        end
+        @filename = ::File.join(@folder, ::File.basename($PROGRAM_NAME, '.rb')+'.log')
+      end
+
+    end
+  end
+end

data/lib/cli_application/log/none.rb

@@ -0,0 +1,19 @@
+module CliApplication
+  module Log
+    class None < CliApplication::Log::Base
+
+      def log(message)
+      end
+
+      def save_app_start_information
+      end
+
+      def save_app_run_information
+      end
+
+      def save_app_finish_information
+      end
+
+    end
+  end
+end

data/lib/cli_application/stat.rb

@@ -1,19 +1,21 @@
 module CliApplication
-  class Stat  # :nodoc:
+  class Stat # :nodoc:
     attr_reader :stat
 
+
     def initialize(folders)
       @stat_filename = File.join([folders[:class], 'stat', ::StTools::System.exename.gsub(/\.rb$/, '.yml')])
-      @stat_folder = File.join([folders[:class], 'stat'])
+      @stat_folder   = File.join([folders[:class], 'stat'])
       create_folder
 
       init_stat
-      folders[:stat] = @stat_folder
+      folders[:stat]  = @stat_folder
       @stat[:folders] = folders
 
       @prev = load_stat
     end
 
+
     #-------------------------------------------------------------
     #
     # Функции настройки приложения
@@ -23,36 +25,38 @@ module CliApplication
       @stat[:last][:exitcode] = code
     end
 
+
     def executed_at=(at)
       @stat[:last][:executed_at] = at
     end
 
+
     def last_started_at=(at)
       @stat[:last][:started_at] = at.to_s
-      @stat[:last_started_at] = at.to_s
+      @stat[:last_started_at]   = at.to_s
     end
 
+
     def version=(val)
       @stat[:version] = val
     end
 
+
     def description=(val)
       @stat[:description] = val
     end
 
+
     def shortdescription=(val)
       @stat[:shortdescription] = val
     end
 
+
     def releasedate=(val)
       @stat[:releasedate] = val
     end
 
 
-
-
-
-
     def last_started_at_human
       res = last_started_at
       if res.nil? || res == ''
@@ -62,45 +66,62 @@ module CliApplication
       end
     end
 
+
     def startes_human
       res = @prev[:avg][:starts]
       "Всего было #{res} запусков"
     end
 
+
     def last_started_at
       @prev[:last][:started_at] || ::Time.zone.now
     end
 
+
     def load_stat
-      YAML.load_file(@stat_filename)
+      res = YAML.load_file(@stat_filename, {})
+      res.empty? ? Marshal.load(Marshal.dump(init_stat)) : res
     rescue
-      Marshal.load( Marshal.dump(init_stat))
+      Marshal.load(Marshal.dump(init_stat))
     end
 
+
     def save
       @prev = load_stat
       update_stat
-      File.open(@stat_filename, 'w') {|f| f.write @prev.to_yaml }
+      File.open(@stat_filename, 'w') { |f| f.write @prev.to_yaml }
     end
 
+
     def create_folder
       unless Dir.exist?(@stat_folder)
         Dir.mkdir(@stat_folder, 0777)
       end
+
+# ToDo убрать в модуль Log
+# 2018-01-06, добавляем проверку на доступность папки и файла. Если с этим проблема,
+# то выбрасываем исключение, чтобы уже на этапе отладки было понятно, что
+# при запуске приложения из под cron будут проблемы
+      if File.exist?(@stat_filename)
+        s = File.stat(@stat_filename)
+        puts ">>>>>>>>>>>>>>>>>> #{s.mode}"
+      end
     end
 
+
     def timezone=(val)
       @stat[:timezone] = val
     end
 
+
     def update_stat
-      @prev[:name] = @stat[:name]
+      @prev[:name]             = @stat[:name]
       @prev[:shortdescription] = @stat[:shortdescription]
-      @prev[:version] = @stat[:version]
-      @prev[:releasedate] = @stat[:releasedate]
-      @prev[:timezone] = ::Time.zone.name
-      @prev[:last_started_at] = @stat[:last_started_at]
-      @prev[:folders] = @stat[:folders]
+      @prev[:version]          = @stat[:version]
+      @prev[:releasedate]      = @stat[:releasedate]
+      @prev[:timezone]         = ::Time.zone.name
+      @prev[:last_started_at]  = @stat[:last_started_at]
+      @prev[:folders]          = @stat[:folders]
 
       make_averages(@prev[:avg])
       make_last(@prev[:last])
@@ -112,58 +133,61 @@ module CliApplication
       tmp << @prev[:last][:memory]
 
       @prev[:last10].unshift(tmp.join(','))
-      @prev[:last10] = @prev[:last10][0,10]
+      @prev[:last10] = @prev[:last10][0, 10]
     end
 
+
     def init_stat
-      @stat = Hash.new
-      @stat[:name] = ::StTools::System.exename
+      @stat                    = Hash.new
+      @stat[:name]             = ::StTools::System.exename
       @stat[:shortdescription] = ''
-      @stat[:version] = ''
-      @stat[:releasedate] = ''
-      @stat[:timezone] = ''
-      @stat[:last_started_at] = ''
-      @stat[:folders] = @folders
-
-      @stat[:avg] = Hash.new
-      @stat[:avg][:starts] = 0
-      @stat[:avg][:executed_at] = 0
+      @stat[:version]          = ''
+      @stat[:releasedate]      = ''
+      @stat[:timezone]         = ''
+      @stat[:last_started_at]  = ''
+      @stat[:folders]          = @folders
+
+      @stat[:avg]                     = Hash.new
+      @stat[:avg][:starts]            = 0
+      @stat[:avg][:executed_at]       = 0
       @stat[:avg][:executed_at_human] = ''
-      @stat[:avg][:memory] = 0
+      @stat[:avg][:memory]            = 0
 
-      @stat[:last] = Hash.new
-      @stat[:last][:started_at] = nil
-      @stat[:last][:executed_at] = 0
+      @stat[:last]                     = Hash.new
+      @stat[:last][:started_at]        = nil
+      @stat[:last][:executed_at]       = 0
       @stat[:last][:executed_at_human] = ''
-      @stat[:last][:memory] = ''
-      @stat[:last][:exitcode] = 0
+      @stat[:last][:memory]            = ''
+      @stat[:last][:exitcode]          = 0
 
       @stat[:last10] = Array.new
 
       @stat
     end
 
+
     def make_averages(avg)
       if avg[:starts] == 0
-        avg[:starts] = 1
-        avg[:executed_at] = @stat[:last][:executed_at]
+        avg[:starts]            = 1
+        avg[:executed_at]       = @stat[:last][:executed_at]
         avg[:executed_at_human] = ::StTools::Human.ago_in_words_pair(avg[:executed_at].to_i).join(' ')
-        avg[:memory] = ::StTools::System.memory.to_i
+        avg[:memory]            = ::StTools::System.memory.to_i
       else
-        mul = avg[:starts]
-        avg[:starts] += 1
-        avg[:executed_at] = ((avg[:executed_at]*mul + @stat[:last][:executed_at]).to_f / avg[:starts]).round(6)
+        mul                     = avg[:starts]
+        avg[:starts]            += 1
+        avg[:executed_at]       = ((avg[:executed_at] * mul + @stat[:last][:executed_at]).to_f / avg[:starts]).round(6)
         avg[:executed_at_human] = ::StTools::Human.ago_in_words_pair(avg[:executed_at]).join(' ')
-        avg[:memory] = (avg[:memory]*mul + ::StTools::System.memory).to_i / avg[:starts]
+        avg[:memory]            = (avg[:memory] * mul + ::StTools::System.memory).to_i / avg[:starts]
       end
     end
 
+
     def make_last(last)
-      last[:started_at] = @stat[:last_started_at]
-      last[:executed_at] = @stat[:last][:executed_at]
+      last[:started_at]        = @stat[:last_started_at]
+      last[:executed_at]       = @stat[:last][:executed_at]
       last[:executed_at_human] = ::StTools::Human.ago_in_words_pair(last[:executed_at]).join(' ')
-      last[:memory] = ::StTools::Human.memory
-      last[:exitcode] = @stat[:last][:exitcode]
+      last[:memory]            = ::StTools::Human.memory
+      last[:exitcode]          = @stat[:last][:exitcode]
     end
 
   end

data/lib/cli_application/version.rb

@@ -1,3 +1,3 @@
 module CliApplication
-  VERSION = "0.1.9"
+  VERSION = "0.1.10"
 end

data/test/examples/1/stat/app.yml

@@ -1,33 +1,21 @@
 ---
 :name: app.rb
-:shortdescription: "Пример 2 - Настройки CLI-приложения"
-:version: '1.0'
-:releasedate: '2015-05-11'
+:shortdescription: ''
+:version: ''
+:releasedate: ''
 :timezone: Moscow
-:last_started_at: '2017-01-04 12:18:36 +0300'
-:folders:
-  :app: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/examples/2"
-  :class: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/examples/1"
-  :stat: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/examples/1/stat"
+:last_started_at: ''
+:folders: 
 :avg:
-  :starts: 244
-  :executed_at: 4.383912
-  :executed_at_human: 4.383912 секунд
-  :memory: 391427
+  :starts: 1
+  :executed_at: 0
+  :executed_at_human: 0 секунд
+  :memory: 44269568
 :last:
-  :started_at: '2017-01-04 12:18:36 +0300'
-  :executed_at: 0.059596
-  :executed_at_human: 0.059596 секунд
-  :memory: 41.8 Мбайт
-  :exitcode: 255
+  :started_at: ''
+  :executed_at: 0
+  :executed_at_human: 0 секунд
+  :memory: 42.2 Мбайт
+  :exitcode: 0
 :last10:
-- 2017-01-04 12:18:36 +0300,255,0.059596,41.8 Мбайт
-- 2017-01-04 12:18:26 +0300,255,0.053526,41.2 Мбайт
-- 2015-11-12 08:04:04 +0300,10,0.032581,35 кбайт
-- 2015-10-26 22:16:55 +0300,0,0.029927,36 кбайт
-- 2015-10-26 22:16:01 +0300,0,0.02892,36 кбайт
-- 2015-10-26 22:10:40 +0300,0,0.033229,36 кбайт
-- 2015-10-26 22:10:25 +0300,0,0.036708,36 кбайт
-- 2015-10-26 22:08:56 +0300,0,0.036485,38 кбайт
-- 2015-10-26 22:07:56 +0300,0,0.035323,36 кбайт
-- 2015-10-26 22:04:20 +0300,255,0.053609,35 кбайт
+- ",0,0,42.2 Мбайт"

data/test/log/01_log_section_missing/app.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+#encoding: utf-8
+require './cli_example.rb'
+
+class TestApp < CliExample
+
+  def main
+    puts "Hello, world!"
+  end
+
+end
+
+app = TestApp.new(ARGV, __dir__)
+
+app.version = '1.0'
+app.releasedate = '2018-01-06'
+app.shortdescription = 'Тестовый скрипт демонстрации CliApplication'
+app.description = "CliApplication gem демо. #{app.shortdescription}"
+
+app.help
+
+app.run
+exit(app.exitcode)
+

data/test/log/01_log_section_missing/cli_example.rb

@@ -0,0 +1,14 @@
+require '../../../lib/cli_application.rb'
+
+class CliExample < CliApplication::App
+
+  def initialize(argv, folder, lang = :ru)
+    super(argv, folder, __dir__, lang)
+  end
+
+  def init_app
+    super
+    add_config('config.yml', :class)
+  end
+
+end

data/test/log/02_log_section_type_wrong/app.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+#encoding: utf-8
+require './cli_example.rb'
+
+class TestApp < CliExample
+
+  def main
+    puts "Hello, world!"
+  end
+
+end
+
+app = TestApp.new(ARGV, __dir__)
+
+app.version = '1.0'
+app.releasedate = '2018-01-06'
+app.shortdescription = 'Тестовый скрипт демонстрации CliApplication'
+app.description = "CliApplication gem демо. #{app.shortdescription}"
+
+app.help
+
+app.run
+exit(app.exitcode)
+

data/test/log/02_log_section_type_wrong/cli_example.rb

@@ -0,0 +1,14 @@
+require '../../../lib/cli_application.rb'
+
+class CliExample < CliApplication::App
+
+  def initialize(argv, folder, lang = :ru)
+    super(argv, folder, __dir__, lang)
+  end
+
+  def init_app
+    super
+    add_config('config.yml', :class)
+  end
+
+end

data/test/log/02_log_section_type_wrong/stat/app.yml

@@ -0,0 +1,21 @@
+---
+:name: app.rb
+:shortdescription: ''
+:version: ''
+:releasedate: ''
+:timezone: Moscow
+:last_started_at: ''
+:folders: 
+:avg:
+  :starts: 1
+  :executed_at: 0
+  :executed_at_human: 0 секунд
+  :memory: 41975808
+:last:
+  :started_at: ''
+  :executed_at: 0
+  :executed_at_human: 0 секунд
+  :memory: 40.0 Мбайт
+  :exitcode: 0
+:last10:
+- ",0,0,40.0 Мбайт"

data/test/log/03_log_section_type_none_ok/app.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+#encoding: utf-8
+require './cli_example.rb'
+
+class TestApp < CliExample
+
+  def main
+    puts "Hello, world!"
+  end
+
+end
+
+app = TestApp.new(ARGV, __dir__)
+
+app.version = '1.0'
+app.releasedate = '2018-01-06'
+app.shortdescription = 'Тестовый скрипт демонстрации CliApplication'
+app.description = "CliApplication gem демо. #{app.shortdescription}"
+
+app.help
+
+app.run
+exit(app.exitcode)
+

data/test/log/03_log_section_type_none_ok/cli_example.rb

@@ -0,0 +1,14 @@
+require '../../../lib/cli_application.rb'
+
+class CliExample < CliApplication::App
+
+  def initialize(argv, folder, lang = :ru)
+    super(argv, folder, __dir__, lang)
+  end
+
+  def init_app
+    super
+    add_config('config.yml', :class)
+  end
+
+end

data/test/log/03_log_section_type_none_ok/stat/app.yml

@@ -0,0 +1,26 @@
+---
+:name: app.rb
+:shortdescription: "Тестовый скрипт демонстрации CliApplication"
+:version: '1.0'
+:releasedate: '2018-01-06'
+:timezone: Moscow
+:last_started_at: '2018-01-06 23:26:28 +0300'
+:folders:
+  :app: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/log/03_log_section_type_none_ok"
+  :class: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/log/03_log_section_type_none_ok"
+  :stat: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/log/03_log_section_type_none_ok/stat"
+:avg:
+  :starts: 3
+  :executed_at: 0.040108
+  :executed_at_human: 0.040108 секунд
+  :memory: 41891157
+:last:
+  :started_at: '2018-01-06 23:26:28 +0300'
+  :executed_at: 0.054604
+  :executed_at_human: 0.054604 секунд
+  :memory: 40.1 Мбайт
+  :exitcode: 255
+:last10:
+- 2018-01-06 23:26:28 +0300,255,0.054604,40.1 Мбайт
+- 2018-01-06 20:20:48 +0300,255,0.06572,39.7 Мбайт
+- ",0,0,40.0 Мбайт"

data/test/log/04_log_section_type_file_ok/app.rb

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+#encoding: utf-8
+require './cli_example.rb'
+
+class TestApp < CliExample
+
+  def main
+    puts "Hello, world!"
+    0
+  end
+
+end
+
+app = TestApp.new(ARGV, __dir__)
+
+app.version = '1.0'
+app.releasedate = '2018-01-06'
+app.shortdescription = 'Тестовый скрипт демонстрации CliApplication'
+app.description = "CliApplication gem демо. #{app.shortdescription}"
+
+app.help
+
+app.run
+exit(app.exitcode)
+

data/test/log/04_log_section_type_file_ok/cli_example.rb

@@ -0,0 +1,14 @@
+require '../../../lib/cli_application.rb'
+
+class CliExample < CliApplication::App
+
+  def initialize(argv, folder, lang = :ru)
+    super(argv, folder, __dir__, lang)
+  end
+
+  def init_app
+    super
+    add_config('config.yml', :class)
+  end
+
+end

data/test/log/04_log_section_type_file_ok/logs/app.log

@@ -0,0 +1,11 @@
+-- Запуск приложения ---------------------------
+Приложение: /Users/Stan/Documents/Development/RubyMine/cli_application/test/log/04_log_section_type_file_ok/app.rb
+Имя скрипта: app.rb
+Приложение запущено: 2018-01-07 16:47:13 +0300
+
+-- Пользовательская секция ---------------------
+
+-- Завершение приложения -----------------------
+Приложение завершено: 2018-01-07 16:47:13 +0300 (время выполнения: 0.045 сек.)
+Использование памяти: 40.0 Мбайт
+Результат завершения: 0 (SUCCESS)

data/test/log/04_log_section_type_file_ok/stat/app.yml

@@ -0,0 +1,33 @@
+---
+:name: app.rb
+:shortdescription: "Тестовый скрипт демонстрации CliApplication"
+:version: '1.0'
+:releasedate: '2018-01-06'
+:timezone: Moscow
+:last_started_at: '2018-01-07 16:47:13 +0300'
+:folders:
+  :app: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/log/04_log_section_type_file_ok"
+  :class: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/log/04_log_section_type_file_ok"
+  :stat: "/Users/Stan/Documents/Development/RubyMine/cli_application/test/log/04_log_section_type_file_ok/stat"
+:avg:
+  :starts: 21
+  :executed_at: 0.062094
+  :executed_at_human: 0.062094 секунд
+  :memory: 41897590
+:last:
+  :started_at: '2018-01-07 16:47:13 +0300'
+  :executed_at: 0.044499
+  :executed_at_human: 0.044499 секунд
+  :memory: 40.0 Мбайт
+  :exitcode: 0
+:last10:
+- 2018-01-07 16:47:13 +0300,0,0.044499,40.0 Мбайт
+- 2018-01-07 00:00:13 +0300,0,0.066548,40.4 Мбайт
+- 2018-01-06 23:59:57 +0300,255,0.089557,39.7 Мбайт
+- 2018-01-06 23:54:52 +0300,255,0.088694,40.0 Мбайт
+- 2018-01-06 23:51:19 +0300,255,0.085997,39.9 Мбайт
+- 2018-01-06 23:32:03 +0300,255,0.051075,40.2 Мбайт
+- 2018-01-06 23:30:44 +0300,255,0.075102,39.7 Мбайт
+- 2018-01-06 23:27:03 +0300,255,0.079105,40.1 Мбайт
+- 2018-01-06 23:24:07 +0300,255,0.056074,40.1 Мбайт
+- 2018-01-06 23:23:17 +0300,255,0.057794,40.2 Мбайт

metadata

@@ -1,61 +1,61 @@
 --- !ruby/object:Gem::Specification
 name: cli_application
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.1.10
 platform: ruby
 authors:
 - Stan Zhuravlev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-01-04 00:00:00.000000000 Z
+date: 2019-01-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.9'
 - !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: st_tools
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.4'
-    - - ">="
+    - - ">"
       - !ruby/object:Gem::Version
         version: '0.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.4'
-    - - ">="
+    - - ">"
       - !ruby/object:Gem::Version
         version: '0.4'
 - !ruby/object:Gem::Dependency
@@ -100,6 +100,13 @@ files:
 - lib/cli_application/databases.rb
 - lib/cli_application/includes.rb
 - lib/cli_application/json_struct.rb
+- lib/cli_application/locales/ru.yml
+- lib/cli_application/log/README.md
+- lib/cli_application/log/base.rb
+- lib/cli_application/log/config.rb
+- lib/cli_application/log/database.rb
+- lib/cli_application/log/file.rb
+- lib/cli_application/log/none.rb
 - lib/cli_application/mail.rb
 - lib/cli_application/mail_lib/base.rb
 - lib/cli_application/mail_lib/error.rb
@@ -123,6 +130,18 @@ files:
 - test/examples/7/app.rb
 - test/examples/7/mail/app-mail-2015-06-10.txt
 - test/examples/8/app.rb
+- test/log/01_log_section_missing/app.rb
+- test/log/01_log_section_missing/cli_example.rb
+- test/log/02_log_section_type_wrong/app.rb
+- test/log/02_log_section_type_wrong/cli_example.rb
+- test/log/02_log_section_type_wrong/stat/app.yml
+- test/log/03_log_section_type_none_ok/app.rb
+- test/log/03_log_section_type_none_ok/cli_example.rb
+- test/log/03_log_section_type_none_ok/stat/app.yml
+- test/log/04_log_section_type_file_ok/app.rb
+- test/log/04_log_section_type_file_ok/cli_example.rb
+- test/log/04_log_section_type_file_ok/logs/app.log
+- test/log/04_log_section_type_file_ok/stat/app.yml
 - test/stat/rdebug-ide
 - test/stat/test_app.yml
 - test/test_app.rb