sc4ry 0.1.6 → 0.2.0

data/lib/sc4ry/notifiers/init.rb

@@ -1,29 +1,56 @@
 Dir[File.dirname(__FILE__) + '/*.rb'].sort.each { |file| require file unless File.basename(file) == 'init.rb' }
 
+# Sc4ry module
+# @note namespace
 module Sc4ry 
-  module Notifiers
-    @@notifiers_list = {:prometheus => {:class => Sc4ry::Notifiers::Prometheus, :config => {:url => 'http://localhost:9091'}},
-                        :mattermost => {:class => Sc4ry::Notifiers::Mattermost, :config => {:url => 'http://localhost:9999', :token => "<CHANGE_ME>"}}                            
-                       }
 
+  # Sc4ry::Notifiers module 
+  # @note namespace 
+    module Notifiers
+
+    # default notifiers specifications
+    DEFAULT_NOTIFIERS = {:prometheus => {:class => Sc4ry::Notifiers::Prometheus, :config => {:url => 'http://localhost:9091'}},
+                          :mattermost => {:class => Sc4ry::Notifiers::Mattermost, :config => {:url => 'http://localhost:9999', :token => "<CHANGE_ME>"}}
+                        }
+    @@notifiers_list =  DEFAULT_NOTIFIERS.dup                           
+  
+    # class method how display a specific notifier config
+    # @param notifier [Symbol] a notifier name
+    # @return [Hash] the config                     
+    def Notifiers.display_config(notifier: )
+      raise Sc4ry::Exceptions::Sc4ryNotifierError, "Notifier #{notifier} not found" unless @@notifiers_list.include? notifier
+      return @@notifiers_list[notifier][:config]
+    end
+
+    # class method how return the list of known notifiers
+    # @return [Array] a list of [Symbol] notifiers name
     def Notifiers.list
       return @@notifiers_list.keys
     end
 
-    def Notifiers.get(options ={})
-      return @@notifiers_list[options[:name]]
+    # class method how return a specific notifier by name
+    # @param name [Symbol] a notifier name
+    # @return [Hash] the notifier structure                     
+    def Notifiers.get(name: )
+      return @@notifiers_list[name]
     end
 
-    def Notifiers.register(options)
-      raise ":name is mandatory" unless options[:name]
-      raise ":definition is mandatory" unless options[:definition]
-      @@notifiers_list[options[:name]] = options[:definition]
+    # class method how register a specific notifier 
+    # @param name [Symbol] a notifier name
+    # @param definition [Hash] a notifier definition 
+    # @return [Hash] the notifier structure                     
+    def Notifiers.register(name: , definition: )
+      @@notifiers_list[name] = definition
     end
 
-    def Notifiers.config(options)
-      raise ":name is mandatory" unless options[:name]
-      raise ":config is mandatory" unless options[:config]
-      @@notifiers_list[options[:name]][:config] = options[:config]
+    
+    # class method how configure a specific notifier 
+    # @param name [Symbol] a notifier name
+    # @param config [Hash] a notifier config  
+    # @return [Hash] the notifier structure                     
+    def Notifiers.config(name:, config: )
+      @@notifiers_list[name][:config] = config
+      return config
     end
  end
 end

data/lib/sc4ry/notifiers/mattermost.rb

@@ -1,33 +1,41 @@
+# Sc4ry module
+# @note namespace 
 module Sc4ry
+    # Sc4ry::Notifiers module
+    # @note namespace
     module Notifiers
         
+        # Mattermost Notifier class
         class Mattermost
             
             # send metrics to Prometheus PushGateway
             # @return [Bool]
             def Mattermost.notify(options = {})
-                config = Sc4ry::Notifiers.get({name: :mattermost})[:config]
+                config = Sc4ry::Notifiers.get(name: :mattermost)[:config]
                 status = options[:config][:status][:general]
                 circuit = options[:circuit]
                 status_map = {:open => 0, :half_open => 1, :closed => 2}
-                
-                uri = URI.parse("#{config[:url]}/hooks/#{config[:token]}")
-                message = "notifying for circuit #{circuit.to_s}, state : #{status.to_s}."
-                if Sc4ry::Helpers::verify_service url: config[:url] then
-                    request = ::Net::HTTP::Post.new(uri)
-                    request.content_type = "application/json"
-                    req_options = {
-                        use_ssl: uri.scheme == "https",
-                    }
-                    payload = { "text" => "message : #{message } from #{Socket.gethostname}", "username" => "Sc4ry" }
-                    Sc4ry::Helpers.log level: :debug, message: "Mattermost Notifier : #{message}"
-                    request.body = ::JSON.dump(payload)
-                    response = ::Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
-                        http.request(request)
+                begin              
+                    uri = URI.parse("#{config[:url]}/hooks/#{config[:token]}")
+                    message = "notifying for circuit #{circuit.to_s}, state : #{status.to_s}."
+                    if Sc4ry::Helpers::verify_service url: config[:url] then
+                        request = ::Net::HTTP::Post.new(uri)
+                        request.content_type = "application/json"
+                        req_options = {
+                            use_ssl: uri.scheme == "https",
+                        }
+                        payload = { "text" => "message : #{message } from #{Socket.gethostname}", "username" => "Sc4ry" }
+                        Sc4ry::Helpers.log level: :debug, message: "Mattermost Notifying : #{message}"
+                        request.body = ::JSON.dump(payload)
+                        response = ::Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
+                            http.request(request)
+                        end
+                        
+                    else
+                        Sc4ry::Helpers.log level: :warn, message: "Mattermost Notifier : can't notify Mattermost not reachable."
                     end
-                    
-                else
-                    Sc4ry::Helpers.log level: :warn, message: "Mattermost Notifier : can't notify Mattermost not reachable."
+                rescue URI::InvalidURIError
+                    Sc4ry::Helpers.log level: :warn, message: "Mattermost Notifier : URL malformed"
                 end
             end
         end

data/lib/sc4ry/notifiers/prometheus.rb

@@ -1,7 +1,13 @@
+# Sc4ry module
+# @note namespace
 module Sc4ry
+
+  # Sc4ry::Notifiers module
+  # @note namespace
   module Notifiers
 
   
+    # Prometheus notifier class
     class Prometheus
 
       @@registry = ::Prometheus::Client::Registry::new
@@ -14,7 +20,7 @@ module Sc4ry
       # send metrics to Prometheus PushGateway
       # @return [Bool]
       def Prometheus.notify(options = {})
-        @config = Sc4ry::Notifiers.get({name: :prometheus})[:config]
+        @config = Sc4ry::Notifiers.get(name: :prometheus)[:config]
         status = options[:config][:status][:general]
         circuit = options[:circuit]
         status_map = {:open => 0, :half_open => 1, :closed => 2}

data/lib/sc4ry/run_controller.rb

@@ -1,9 +1,16 @@
 
+# Sc4ry module
+# @note namespace 
 module Sc4ry
+
+  # class Facility to run and update values/status for a circuit Proc
   class RunController
 
+    # return the execution time of the proc
     attr_reader :execution_time
 
+    # constructor
+    # @param [Hash] circuit the data of the circuit 
     def initialize(circuit = {})
       @circuit = circuit
       @execution_time = 0
@@ -12,38 +19,47 @@ module Sc4ry
       @overtime = false
     end
 
+    # return if the Proc failed on a covered exception by this circuit
+    # @return [Boolean]
     def failed?
       return @failure
     end 
-    
+
+    # return if the Proc overtime the specified time of the circuit
+    # @return [Boolean]
     def overtimed? 
       return @overtime
     end
 
+    # return if the Proc timeout the timeout defined value of the circuit, if timeout is active
+    # @return [Boolean]
     def timeout? 
       return @timeout
     end
 
-    
-    def run(options = {})
+    # run and update values for the bloc given by keyword
+    # @param [Proc] block a block to run and calculate
+    # @return [Hash] a result Hash
+    def run(block: )
       start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
       begin 
         if @circuit[:timeout] == true
           Timeout::timeout(@circuit[:timeout_value]) do 
-            options[:block].call
+            block.call
           end
           @timeout = false
         else
-          options[:block].call
+          block.call
         end
       rescue Exception => e
-        @last_exception = e.class
+        @last_exception = e.class.to_s
         if e.class  == Timeout::Error then 
           @timeout = true
         elsif @circuit[:exceptions].include? e.class
           @failure = true
         else  
           if @circuit[:forward_unknown_exceptions] then
+
             raise e.class, "Sc4ry forward: #{e.message}" 
           else
             Sc4ry::Helpers.log level: :debug, message: "skipped : #{@last_exception}"

data/lib/sc4ry/store.rb

@@ -1,4 +1,10 @@
+# Sc4ry module
+# @note namespace
 module Sc4ry
+
+# Sc4ry::Store class
+# Store Class Provider/manager singleton Forwarder on {Sc4ry::Backends::Memory} or {Sc4ry::Backends::Redis}
+# @note must be accessed by {Sc4ry::Circuits.store}
   class Store
 
     @@current = :memory
@@ -6,35 +12,92 @@ module Sc4ry
     extend Forwardable
     include Singleton
 
-    @@backends = {:memory => {:class => Sc4ry::Backends::Memory},
+    @@backends = {:memory => {:class => Sc4ry::Backends::Memory, config: {}},
                   :redis  => {:class => Sc4ry::Backends::Redis, :config => {:host => 'localhost', :port => 6379, :db => 10 }}}
 
+    # accessor on current backend (default :memory)
     attr_reader :be
+    
     def_delegators :@be, :put, :get, :flush, :exist?, :del, :list
 
+    # constructor pointing on :memory backend
     def initialize
       change_backend name: @@current 
     end 
 
+    # return the current backend
+    # @return [Object] in {Sc4ry::Backends::Memory} or {Sc4ry::Backends::Redis}
+    # @example usage
+    #    include Sc4ry
+    #    puts Circuits.store.current
     def current
       return @@current
     end
 
-    def change_backend(options)
-      @@current = options[:name]
+    # return  the config of a specific backend
+    # @param [Symbol] backend the name the backend 
+    # @return [Hash] the config of the backend 
+    # @raise  Sc4ry::Exceptions::Sc4ryBackendError if backend is not found
+    # @example usage
+    #    include Sc4ry
+    #    puts Circuits.store.get_config backend: :redis
+    def get_config(backend: )
+      raise Sc4ry::Exceptions::Sc4ryBackendError, "backend #{backend} not found" unless @@backends.include? backend
+      return @@backends[backend][:config]
+    end
+
+    # list backend available  
+    # @return [Array] of Symbol the list of backend name
+    # @example usage
+    #    include Sc4ry
+    #    puts Circuits.store.list_backend
+    def list_backend
+      return @@backends.keys
+    end
+
+    # change the current backend 
+    # @note if changing form :memory to :redis => all values and result are lost and circuits will be lost 
+    # @note if changing to :redis, get all the define circuits with values and status (ideal) for distributed worker/instance/runner/services
+    # @param [Symbol] name the name of the target backend
+    # @return [Symbol] the name of the new current backend
+    # @raise Sc4ry::Exceptions::Sc4ryBackendError if backend is not found
+    def change_backend(name: )
+      raise Sc4ry::Exceptions::Sc4ryBackendError, "backend #{name} not found" unless @@backends.include? name
+      @@current =  name
       @be = @@backends[@@current][:class]::new(@@backends[@@current][:config])
+      return name
     end
 
-    def register_backend(options)
-      raise ":name is mandatory" unless options[:name]
-      raise ":definition is mandatory" unless options[:definition]
-      @@backends[options[:name]] = options[:definition]
+    # register a new backend 
+    # @param [Symbol] name the name of the backend
+    # @param [Hash] config the config for this backend
+    # @param [Class] backend_class the class name of the new backend 
+    # @raise Sc4ry::Exceptions::Sc4ryBackendError if backend already exist
+    # @return [Symbol] the name of the backend  
+    def register_backend(name:, config: {}, backend_class:)
+      raise Sc4ry::Exceptions::Sc4ryBackendError , "backend #{name} already exist" if @@backends.include? name
+      @@backends[name] = {config: config, class: backend_class}
+      return name
     end
 
-    def config_backend(options)
-      raise ":name is mandatory" unless options[:name]
-      raise ":config is mandatory" unless options[:config]
-      @@backends[options[:name]][:config] = options[:config]
+    # delete the specified backend reference
+    # @param [Symbol] name the name of the target backend
+    # @raise Sc4ry::Exceptions::Sc4ryBackendError if backend is not found, or name == :memory or :redis
+    # @return [Boolean]
+    def delete_backend(name: )
+      raise Sc4ry::Exceptions::Sc4ryBackendError , "Delete forbidden for backend in [:redis,:memory]" if [:memory,:redis].include? name
+      raise Sc4ry::Exceptions::Sc4ryBackendError , "backend #{name} not found" unless @@backends.include? name
+      return @@backends.delete(name)
+    end
+ 
+    # change the specified backend config
+    # @param [Symbol] name the name of the target backend
+    # @param [Hash] config the config of the specified backend
+    # @raise Sc4ry::Exceptions::Sc4ryBackendError if backend is not found, or name == :memory
+    def config_backend(name:, config:)
+      raise Sc4ry::Exceptions::Sc4ryBackendError, "backend #{name} not found" unless @@backends.include? name
+      raise Sc4ry::Exceptions::Sc4ryBackendError, "backend :memory not need config" if name == :memory
+      @@backends[name][:config] = config
     end
 
 

data/lib/sc4ry/version.rb

@@ -1,3 +1,9 @@
+require 'version'
+
+# Sc4ry module
+# @note namespace
 module Sc4ry
-  VERSION = "0.1.6"
+
+  # the version of Sc4ry
+  VERSION = Version.current
 end

data/sc4ry.gemspec

@@ -1,8 +1,7 @@
-require_relative 'lib/sc4ry/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "sc4ry"
-  spec.version       = Sc4ry::VERSION
+  spec.version       = `cat VERSION`.chomp
   spec.authors       = ["Romain GEORGES"]
   spec.email         = ["romain.georges@orange.com"]
 
@@ -22,6 +21,11 @@ Gem::Specification.new do |spec|
   
   spec.add_dependency "prometheus-client", "~> 3.0"
   spec.add_dependency "rest-client", "~> 2.1"
+  spec.add_dependency "redis", "~> 4.6"
 
-
+  spec.add_development_dependency "yard", "~> 0.9.27"
+  spec.add_development_dependency 'code_statistics', '~> 0.2.13'
+  spec.add_development_dependency "yard-rspec", "~> 0.1"
+  spec.add_development_dependency "roodi", "~> 5.0"
+  spec.add_dependency "version", "~> 1.1"
 end

data/ultragreen_roodi_coding_convention.yml

@@ -0,0 +1,25 @@
+AssignmentInConditionalCheck:
+CaseMissingElseCheck:
+ClassLineCountCheck:             
+  line_count: 300 # including comments yard
+ClassNameCheck:                  
+  pattern: !ruby/regexp /^[A-Z][a-zA-Z0-9]*$/
+#ClassVariableCheck:
+CyclomaticComplexityBlockCheck:  
+  complexity: 5
+CyclomaticComplexityMethodCheck: 
+  complexity: 10
+EmptyRescueBodyCheck:
+ForLoopCheck:
+MethodLineCountCheck:            
+  line_count: 30
+MethodNameCheck:                 
+  pattern: !ruby/regexp /^[_a-z<>=\[|+-\/\*`]+[_a-z0-9_<>=~@\[\]]*[=!\?]?$/ 
+# MissingForeignKeyIndexCheck:
+ModuleLineCountCheck:            
+  line_count: 300
+ModuleNameCheck:          
+  pattern: !ruby/regexp /^[A-Z][a-zA-Z0-9]*$/
+ParameterNumberCheck:            
+  parameter_count: 5
+ 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sc4ry
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.2.0
 platform: ruby
 authors:
 - Romain GEORGES
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-03-08 00:00:00.000000000 Z
+date: 2022-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prometheus-client
@@ -38,6 +38,90 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.6'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.27
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.27
+- !ruby/object:Gem::Dependency
+  name: code_statistics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.13
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.13
+- !ruby/object:Gem::Dependency
+  name: yard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: roodi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: version
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
 description: Sc4ry provide the design pattern Circuit breaker for your application.
 email:
 - romain.georges@orange.com
@@ -45,14 +129,16 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/main.yml"
 - ".gitignore"
 - ".rspec"
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
+- VERSION
 - assets/images/logo_sc4ry.png
-- assets/logo_sc4ry.png
+- assets/images/sc4ry_workflow.png
 - bin/console
 - bin/setup
 - lib/sc4ry.rb
@@ -60,6 +146,8 @@ files:
 - lib/sc4ry/backends/memory.rb
 - lib/sc4ry/backends/redis.rb
 - lib/sc4ry/circuits.rb
+- lib/sc4ry/config.rb
+- lib/sc4ry/constants.rb
 - lib/sc4ry/dependencies.rb
 - lib/sc4ry/exceptions.rb
 - lib/sc4ry/exporters/init.rb
@@ -72,11 +160,12 @@ files:
 - lib/sc4ry/store.rb
 - lib/sc4ry/version.rb
 - sc4ry.gemspec
+- ultragreen_roodi_coding_convention.yml
 homepage: https://github.com/Ultragreen/sc4ry
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -91,8 +180,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: Sc4Ry is Simple Circuitbreaker 4 RubY
 test_files: []