main_loop 0.1.4.367214 → 0.1.4.369901

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 850bb2f02f1bff7caf3ebca532839b4143a24810948b2ac29446d0321542911b
-  data.tar.gz: 88f4324fb104706a0705260d6c82ca7f2f04e66af1a9ca2c88d63e3142bcbe62
+  metadata.gz: 6715ecb631f944f513d3ef4083ca568fe7f1e50fda1e007ff27a08f9d11da959
+  data.tar.gz: f639291ab878bec54c493e79abf9e5bd004ab670c44dea5db0fc2d892baf2070
 SHA512:
-  metadata.gz: 2d2675f76bb8127405617c12f4fa39a5e6ae2f3507de8131b4f878a22dc9884ba46e2d50125729e2471bbaee9c2be2fbd164b047914738c5f2b7f13642b71197
-  data.tar.gz: eaa4672e9905b147a25b8a376c871debc1841879e8f486d58f8928c14c7289ce19b3813b6ad7a8042f49a0eca88f5d190270e334b9799371b252468575a2a803
+  metadata.gz: ba62a2aa69a9774f8a6c851942689546ea6ab5a34297a60724c627fbb1427c5dde21d5f2435d6ade44afcec90de929c3066bd6f36439210bf0692af1becc83c5
+  data.tar.gz: a1892e24867d6be57ed7f00834f404635d92b907c46bcf1a5149559af84a5c05caa452cbdd0a41c2ca6e255bd8511c16160082fa0303a1ee9b12de344b12d104

data/lib/main_loop/bus.rb

@@ -108,11 +108,11 @@ module MainLoop
 
     # == Блокирующее чтение события
     #
-    # Блокирует до получения строки или таймаута.
+    # Блокирует до получения события или таймаута.
     # Использует {Timeouter.loop} для ограничения времени ожидания.
     #
     # @param timeout [Numeric] таймаут ожидания в секундах
-    # @return [String|nil] прочитанная строка (без символа новой строки) или nil при таймауте
+    # @return [String|nil] прочитанное событие (без символа новой строки) или nil при таймауте
     def gets(timeout)
       Timeouter.loop(timeout) do |t|
         line = gets_nonblock if wait_for_event(t.left)
@@ -120,7 +120,7 @@ module MainLoop
       end
     end
 
-    # == Неблокирующее чтение символа
+    # == Неблокирующее чтение строки
     #
     # Читает посимвольно до конца строки (EOL).
     # Буферизует символы и возвращает полную строку.

data/lib/main_loop/dispatcher.rb

@@ -130,7 +130,7 @@ module MainLoop
 
     # == Отправить сигнал аварийного завершения
     #
-    # Устанавливает 코드 выхода 3 и инициирует терминацию.
+    # Устанавливает код выхода 3 и инициирует терминацию.
     # Если уже терминация — ничего не делает.
     def crash
       @exit_code = 3
@@ -194,7 +194,7 @@ module MainLoop
     # == Логировать статус
     #
     # Логирует текущее состояние обработчиков (DEBUG уровень).
-    # Формат: "Total:N Running:M Finihsed:K. TERM"
+    # Формат: "Total:N Running:M Finished:K. Success:[] TERM"
     #
     # :nocov:
     def log_status
@@ -202,7 +202,7 @@ module MainLoop
       running = handlers.count(&:running?)
       finihsed = handlers.count(&:finished?)
       term_text = terminating? ? 'TERM' : ''
-      logger.debug("Total:#{total} Running:#{running} Finihsed:#{finihsed}. #{term_text}".strip)
+      logger.debug("Total:#{total} Running:#{running} Finished:#{finihsed} Success:#{handlers.map {|h| h.success?}.to_s}. #{term_text}".strip)
     end
     # :nocov:
   end

data/lib/main_loop/handler.rb

@@ -18,30 +18,6 @@ require 'logger'
 # - {#kill} — принудительное завершение
 # - {#reap(status)} — обработка завершения процесса/потока
 #
-# == Пример использования
-#
-#   class MyHandler < MainLoop::Handler
-#     def id
-#       @process_id
-#     end
-#
-#     def term
-#       Process.kill('TERM', @process_id)
-#     end
-#
-#     def run
-#       @process_id = Process.fork { yield }
-#     end
-#
-#     def kill
-#       Process.kill('KILL', @process_id)
-#     end
-#
-#     def reap(status)
-#       # обработка завершения
-#     end
-#   end
-#
 # == См. также
 # - {MainLoop::ProcessHandler} — реализация для процессов
 # - {MainLoop::ThreadHandler} — реализация для потоков

data/lib/main_loop/process_handler.rb

@@ -92,7 +92,7 @@ module MainLoop
     def term(*_args)
       unless @pid
         @terminating_at ||= Time.now
-        logger.debug "Process[#{name}] alredy terminated. Skipped."
+        logger.debug "Process[#{name}] already terminated. Skipped."
         return
       end
 
@@ -116,7 +116,7 @@ module MainLoop
     # @param *_args (Unused)
     def kill(*_args)
       unless @pid
-        logger.debug "Process[#{name}] alredy Killed. Skipped."
+        logger.debug "Process[#{name}] already Killed. Skipped."
         return
       end
 
@@ -142,7 +142,7 @@ module MainLoop
     #
     # Создает дочерний процесс и настраивает обработку ошибок.
     #
-    # @yield执行 блок кода в дочернем процессе
+    # @yield выполнить блок кода в дочернем процессе
     # @return [Integer] PID дочернего процесса
     protected
 

data/lib/main_loop/thread_handler.rb

@@ -7,8 +7,13 @@ require 'main_loop/handler'
 # == Особенности потоков
 #
 # - Потоки не имеют status завершения (как процессы)
-# - Поэтому @success = false для всех завершений (кроме graceful term)
-# - Завершение потока публикуется в ensure блоке
+# - Если завершение graceful term, то @success отражает, завершился ли он после вызова on_term (true) или после нашего kill
+# - Внутри on_term поток может быть завершен так, как считает нужным разработчик метода, например
+#     @stopped = true
+#     @thread&.wakeup
+#     @thread&.kill unless @thread&.join(2)
+# - Если поток завершился сам, то смотрим на Thread.current[:exit_reason]
+# - Завершение потока публикуется в ensure блоке и обрабатывается в MainLoop#start_loop_forever
 #
 # == Сигналы для потока
 #
@@ -69,12 +74,13 @@ module MainLoop
     # @param status [String] статус завершения (описание)
     def reap(status)
       logger.info "Thread[#{name}] exited: thread:#{@thread} Status:#{status}"
+      exit_reason = @thread[:exit_reason] if @thread
       @thread = nil
       @finished = true
 
       return if terminating?
-      @success = false
 
+      @success = (exit_reason == :normal)
       handle_retry
     end
 
@@ -84,7 +90,7 @@ module MainLoop
     def term(*_args)
       unless @thread
         @terminating_at ||= Time.now
-        logger.debug "Thread[#{name}] alredy terminated. Skipped."
+        logger.debug "Thread[#{name}] already terminated. Skipped."
         return
       end
 
@@ -107,7 +113,7 @@ module MainLoop
     # @param *_args (Unused)
     def kill(*_args)
       unless @thread
-        logger.debug "Thread[#{name}] alredy Killed. Skipped."
+        logger.debug "Thread[#{name}] already Killed. Skipped."
         return
       end
 
@@ -133,20 +139,23 @@ module MainLoop
     #
     # Создает новый поток и настраивает обработку ошибок и завершения.
     #
-    # @yield执行 блок кода в потоке
+    # @yield выполнить блок кода в потоке
     # @return [Thread] созданный поток
     protected
 
       def start_thread
         @thread = Thread.new do
           yield(self)
+          Thread.current[:exit_reason] = :normal
         rescue StandardError => e
+          Thread.current[:exit_reason] = :exception
           logger.error "Thread[#{name}] crashed: #{e.message}"
         ensure
+          Thread.current[:exit_reason] ||= :killed
           publish("reap:#{id}:exited")
         end
         @finished = false
         logger.info "Thread[#{name}] created: thread:#{@thread}"
-    end
+      end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: main_loop
 version: !ruby/object:Gem::Version
-  version: 0.1.4.367214
+  version: 0.1.4.369901
 platform: ruby
 authors:
 - Samoilenko Yuri
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-09 00:00:00.000000000 Z
+date: 2026-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler