excadg 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec293c45ae406af7c9b65765b6b755680006b2883faceef34a79cb3856fc5337
-  data.tar.gz: 56f54c58453d79dc7cdf457756c9afaccc8ebe88320464fab34e7c9a0f0a49fd
+  metadata.gz: 1081c1531553e5ca9113aab9d0f8dfaa7982438438f646df74fded7a17ec0e99
+  data.tar.gz: 88d4ecf74086eddcea280c44844c47097aeca252b6f9170f585f0516368928f0
 SHA512:
-  metadata.gz: d32612798b22716343e841c9915b3b599a3f08d800843f4381b4b43acba7c91c75ef80523b7bdcad3d5d5305a2542848e1b8186017a8302eb19c77019c0e1e0e
-  data.tar.gz: 8c8a2be23aabd61ffc546c81e256497d796aeaab60c7ce804fe9b5e9f2abc6a7223770fd6376396fd436815f48bc615fc4d731678129c93c0eeff2c2e676f412
+  metadata.gz: a086d015c957d0b86ecf3ec8de789aa4f151ea1687c6ddde4f5454b28ea1f4737bafc1f81ccac9dd0a1fed45603c6fae8dfc71649dcbe383f8cb9baf3f887e70
+  data.tar.gz: 394abc39d249922bd7eec046e748673e0ad7eb294f3c91db5a15bbea26a99486f159a55411f1baed09c80f6e3e919654bce87eb97a441461c9b97e464ee97b96

data/README.md

@@ -8,7 +8,7 @@ Another feature is that the graph is dynamic and any vertex could produce anothe
 
 ## Tool
 
-There is a tool script in root folder called `excadg`. Run `./bin/excadg --help` for available options.  
+There is a tool script in `bin` folder called `excadg`. Run `./bin/excadg --help` for available options.  
 It allows to make and run basic payload graphs specified by a YAML config. See [config/](config/) folder for sample configs.
 
 ## Framework
@@ -132,6 +132,10 @@ Second way is built-in. Vertex invokes payload with {ExcADG::Array} of dependenc
 > Be mindful about data your payload receives (args) and returns (state data). It could appear incompatible with ractors and cause vertice to fail.  
 > Although these failures are hard to tell beforehand, [state machine](#statemachine) processes them gracefully.
 
+## {ExcADG::Log}
+
+The library has its own logger based on Ractors. You could call {ExcADG::Log#unmute} to enable these logs.
+
 # Development
 
 The project is based on RVM => there is a .ruby-gemset file.  
@@ -159,9 +163,7 @@ Commands to run tests:
   > there is no consistent set of suites, tags are used to exclude mutually incompatible tests or e.g. perfomance tests  
   > search for `config.filter_run_excluding` in [spec/spec_helper.rb](spec/spec_helper.rb) to see what tests are disabled by default
 
-### Logging
-
-Most of the tests have loggin stubbed to avoid noize. Comment out either `stub_loogging` or `Log.mute` in the respective spec file to enable logging for it.
+Logging is disabled by default, but it could be useful to debug tests. Add `ExcADG::Log.unmute` to `spec/spec_helper.rb` to enable logs.
 
 # Docs
 
@@ -182,7 +184,6 @@ Most of the tests have loggin stubbed to avoid noize. Comment out either `stub_l
     - problem: can't find what to suspend
 - make a loop payload template
   - provide a mechanism to control # of children
-- avoid initializing Log on require
 
 ## Graph checks
 

data/bin/excadg

@@ -61,9 +61,7 @@ logfile, ui_drawer =
     [options[:logfile], ExcADG::Tui]
   end
 
-if logfile.nil?
-  ExcADG::Log.mute
-else
+unless logfile.nil?
   ExcADG::Log.logger ExcADG::Log::RLogger.new dest: logfile, level: options[:loglevel]
 end
 

data/lib/excadg/log.rb

@@ -7,11 +7,10 @@ require_relative 'assertions'
 module ExcADG
   # logging support
   module Log
-    # ractor-based logger
-    # this ractor logger receives messages from other ractors and log them
-    # it can be useful in case logging shouldn't interrupt other thread
-    # @param dest - what to write logs to, $stdout by default, gets interpret as filename unless IO
-    # @param level - one of the Logger's log levels
+    # ractor-based logger,
+    # this ractor logger receives messages from other ractors and log them,
+    # @param dest what to write logs to, $stdout by default, gets interpret as filename unless IO
+    # @param level one of the Logger's log levels
     class RLogger < Ractor
       def self.new dest: $stdout, level: Logger::INFO
         super(dest, level) { |dest, level|
@@ -29,6 +28,12 @@ module ExcADG
       end
     end
 
+    # default logger
+    @main = RLogger.new
+
+    # logging is muted by default
+    @muted = true
+
     def self.method_missing(method, *args, &_block)
       return if @muted
 
@@ -43,19 +48,22 @@ module ExcADG
       true
     end
 
-    # default logger e.g. for tests
-    @main = RLogger.new
-    @muted = false
-
-    # replaces default logger with a custom logger
+    # replaces default logger with a custom one
+    # and unmutes logging
     def self.logger new_logger
       Assertions.is_a? new_logger, RLogger
       @main = new_logger
+      unmute
     end
 
     # mute logging by ignoring all incoming log requests
     def self.mute
       @muted = true
     end
+
+    # unmute logging for new messages
+    def self.unmute
+      @muted = false
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: excadg
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - skorobogatydmitry
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-06 00:00:00.000000000 Z
+date: 2024-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rgl