excadg 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6eaa4affddc5100a387f6faa4006451eac4fe7ca15d03817fd962e25b25c8a79
-  data.tar.gz: 607ad2df4d09b404ab728d3397f6a82b41631a9a603412367f66dabbba1e2a1f
+  metadata.gz: 1081c1531553e5ca9113aab9d0f8dfaa7982438438f646df74fded7a17ec0e99
+  data.tar.gz: 88d4ecf74086eddcea280c44844c47097aeca252b6f9170f585f0516368928f0
 SHA512:
-  metadata.gz: 9b540b1c30fe6a6a1a124e55a29dd21d68d2cf27631a6bfce4e14fa41fc2708e57587eb1174ba1ec15ce75be66eb7d8b54da392dedfc6afca63fd35fd56bf3ce
-  data.tar.gz: c16ae1cf5e5c723cad55a44ff2e16881ab575145cabb2a6ff2d75ba5ab935249cfa79fd22ab4b7a1966adc02cbf03674a57fe1453b8add297b16a7be6ed93303
+  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.  
@@ -144,6 +148,8 @@ There is a gem specification. Typical commands:
 - install / uninstall gem built locally: `gem install ./excadg*.gem` / `gem uninstall excadg`
 - publish: `gem push excadg*.gem`
 
+Latest version is published here: https://rubygems.org/gems/excadg.
+
 ## Testing
 
 Test are located in [spec/](spec/) folder and are written using rspec.
@@ -157,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
 
@@ -180,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,21 +1,36 @@
 --- !ruby/object:Gem::Specification
 name: excadg
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - skorobogatydmitry
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-06 00:00:00.000000000 Z
-dependencies: []
+date: 2024-07-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rgl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
 description: "\n\nThat's a library (framework) to execute a graph of dependent tasks
   (vertices).  \nIts main feature is to run all possible tasks independently in parallel
   once they're ready.  \nAnother feature is that the graph is dynamic and any vertex
   could produce another vertice(s) to extend execution graph.\n"
 email: skorobogaty.dmitry@gmail.com
-executables: []
+executables:
+- excadg
 extensions: []
 extra_rdoc_files: []
 files:
@@ -39,7 +54,8 @@ files:
 homepage: https://rubygems.org/gems/excadg
 licenses:
 - LGPL-3.0-only
-metadata: {}
+metadata:
+  source_code: https://github.com/skorobogatydmitry/excadg
 post_install_message:
 rdoc_options: []
 require_paths: