carioca 2.0.1 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c349ebcb566a9571f7cd424b6cb3a95dd3b6871a99caf992ac04af996a35259a
-  data.tar.gz: d4f4a5db811c978fe0390f41a757a352452c844f72775c21435c6ca1656213c1
+  metadata.gz: df2fae455d522ba26500abac0d203b29e1b173391b2e9eb9c27f9de83f282a55
+  data.tar.gz: 5e34e6d5b0eef09348906b45f6bb5c2db3d1874c6d4f3f05c5a017baca5f5da1
 SHA512:
-  metadata.gz: d05baa11c7379fe052161140fef4a17dd075ce2998c600ad5023d947edf76769fe2020829438863bc4adf4ee4c62f50da2bfb73c2937a5837fe6a48be87de1fb
-  data.tar.gz: 1e12daba542a3e103205f1f7f7fcd71f82a924b2e247fc48ca6a0ee0feb9e4fca85e3a22d2b6baf9c2b7c705b6ef71d0e70611cd9509928eb25584b423a8578a
+  metadata.gz: fad3b4fcbf8beb5811458891ad529a405fe85f19af613eb986369e51573eb87524d5849a566e7009a1a6c8d6f142e5a6f60a5e3ce82f9b60e82cabcfc814d02b
+  data.tar.gz: 1049e060ed5326a3f67acea98258fca5c2880f46ae1edc3b1d08070e7012d374d975c062e076adfb2a127e0f3027ba0117b57ba97bc06f43d1ab3f904f63a0a4

data/Gemfile

@@ -2,8 +2,5 @@ source "https://rubygems.org"
 
 gemspec
 
-gem "rake", "~> 13.0"
-gem "rspec", "~> 3.0"
-gem 'i18n', "~> 1.10"
-gem 'locale', "~> 2.1"
-gem "deep_merge", "~> 1.2"
+
+

data/Gemfile.lock

@@ -1,13 +1,22 @@
 PATH
   remote: .
   specs:
-    carioca (2.0.0)
+    carioca (2.0.4)
+      deep_merge (~> 1.2)
+      i18n (~> 1.10)
+      locale (~> 2.1)
+      pastel (~> 0.8.0)
       tty-prompt (~> 0.23.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    concurrent-ruby (1.1.9)
+    deep_merge (1.2.2)
     diff-lcs (1.5.0)
+    i18n (1.10.0)
+      concurrent-ruby (~> 1.0)
+    locale (2.1.3)
     pastel (0.8.0)
       tty-color (~> 0.5)
     rake (13.0.6)

data/README.md

@@ -1,23 +1,173 @@
 # Carioca
 
+Carioca : Container And Registry with Inversion Of Control for your Applications
+
+Carioca 2: is a complete rewrite who provide a full IoC/DI light Container and a services registry, build with logs, config and Internationalization facilities for designing your applications
 ## Installation
 
-Add this line to your application's Gemfile:
+Install it yourself as:
+
+    $ gem install carioca
+
+## Usage
+
+
+### Basic usage
+
+Create you own gem :
+
+    $ bundle gem yourgem
+    $ cd yourgem
+    $ vi yourgem.gemspec
+
+check all the TODO in your gemspec, specify concretly you Gem specification, add the following line :
 
 ```ruby
-gem 'carioca'
+     spec.add_dependency "carioca", "~> 2.0"
 ```
+and after :
 
-And then execute:
+    $ bundle add carioca
+    $ mkdir -p config/locales
 
-    $ bundle install
+Edit the Rakefil, and add the following line :
 
-Or install it yourself as:
+```ruby
+require "carioca/rake/manage"
+```
+Verify, all is right with :
 
-    $ gem install carioca
+    $ rake -T
+    rake build                         # Build sample-0.1.0.gem into the pkg directory
+    rake carioca:gem:init_path         # prepare Gem vitals path for Carioca
+    rake carioca:registry:add_service  # Adding service to Carioca Registry file
+    rake carioca:services:config:init  # Initialise Service configuration file ./config/settings.yml file
+    rake clean                         # Remove any temporary products
+    rake clobber                       # Remove any generated files
+    rake install                       # Build and install sample-0.1.0.gem into system gems
+    rake install:local                 # Build and install sample-0.1.0.gem into system gems without network access
+    rake release[remote]               # Create tag v0.1.0 and build and push sample-0.1.0.gem to Set to 'http://mygemserver.com'
+    rake spec                          # Run RSpec code examples
 
-## Usage
+You could now initialize the Carioca registry following the wizard, with (sample with a simple UUID generator gem): 
+
+    $ rake carioca:gem:init_path 
+    Carioca : Initialising vitals gem path : done
+    $ rake carioca:registry:add_service
+    Carioca : registering service :
+    Registry File path ? ./config/carioca.registry
+    Service name ? uuid
+    Choose the service type ? gem
+    Description ? The uuid service
+    Service [uuid] inline Proc Ruby code ? UUID
+    Give the Rubygem name ?  uuid
+    Did this service have dependencies ?  no
+
+     => Service : uuid
+    Definition
+     * type: gem
+     * description: The uuid service
+     * service: UUID
+     * resource: uuid
+    Is it correct ?  Yes
+    Carioca : Registry saving : done
+
+This will initiate a Carioca Registry (YAML file, the format will be describe after, the wizard support all type of services, managed by Carioca, all keys are Symbols):
+
+    $ cat config/carioca.registry
+    ---
+    :uuid:
+      :type: :gem
+      :description: The uuid service
+      :service: UUID
+      :resource: uuid
+
+Now your are ready to use Carioca :
+
+In this sample, we are going th create a demo command. 
+Firstly, we have to configure a basic usage of Carioca, this could be made in the lib path, in the root gem library. 
+
+    $ emacs lib/yourgem.rb 
+
+content of the destination file 
+
+```ruby
+
+# frozen_string_literal: true
+
+require_relative "yourgem/version"
+require 'carioca'
+
+
+Carioca::Registry.configure do |spec|
+  spec.debug = true
+end
+
+module Yourgem
+  class Error < StandardError; end
+
+  class YourgemCMD < Carioca::Container
+    def test
+      logger.info(self.to_s) { "Log me as an instance method" }
+      logger.warn(self.class.to_s) {"Give me an UUID : "  + uuid.generate}
+    end
+
+    inject service: :uuid
+
+    logger.info(self.to_s) { "Log me as class method" }
+
+  end
+
+end
+
+```
+
+    $ emacs exe/yourgem_cmd
+
+content of the file
+
+```ruby
+require 'yourgem'
+
+yourgem_cmd = Yourgem::YourgemCMD::new
+yourgem_cmd.test
+```
+
+After this, don't forget to stage new files, and you could build & install the gem before running your new command for the first time :
+
+    $ git add config/ exe/
+    $ rake install && yourgem_cmd
+    yourgem 0.1.0 built to pkg/yourgem-0.1.0.gem.
+    yourgem (0.1.0) installed.
+    D, [2022-03-07T01:06:20.337961 #21513] DEBUG -- Carioca: Preloaded service :i18n on locale : en
+    D, [2022-03-07T01:06:20.338020 #21513] DEBUG -- Carioca: Preloaded service :logger ready on STDOUT
+    D, [2022-03-07T01:06:20.338037 #21513] DEBUG -- Carioca: Initializing Carioca registry
+    D, [2022-03-07T01:06:20.338049 #21513] DEBUG -- Carioca: Preparing builtins services
+    D, [2022-03-07T01:06:20.338079 #21513] DEBUG -- Carioca: Adding service configuration
+    D, [2022-03-07T01:06:20.338107 #21513] DEBUG -- Carioca: Adding service i18n
+    D, [2022-03-07T01:06:20.338133 #21513] DEBUG -- Carioca: Adding service output
+    D, [2022-03-07T01:06:20.338156 #21513] DEBUG -- Carioca: Adding service debugger
+    D, [2022-03-07T01:06:20.338191 #21513] DEBUG -- Carioca: Initializing registry from file : ./config/carioca.registry
+    D, [2022-03-07T01:06:20.338312 #21513] DEBUG -- Carioca: Adding service uuid
+    D, [2022-03-07T01:06:20.338333 #21513] DEBUG -- Carioca: Registry initialized successfully
+    I, [2022-03-07T01:06:20.338340 #21513]  INFO -- Sample::YourGemCMD: Log me as class method
+    I, [2022-03-07T01:06:20.338351 #21513]  INFO -- #<Sample::YourGemCMD:0x0000000148270698>: Log me as an instance method
+    D, [2022-03-07T01:06:20.338381 #21513] DEBUG -- Carioca: Starting service uuid
+    W, [2022-03-07T01:06:20.353142 #21513]  WARN -- Sample::YourGemCMD: Give me an UUID : 574cc860-7fd8-013a-2323-1e00870a7189
+
+You could see, somme interesting things : 
+* Carioca have an internationalisation service (this service will be explain in detail after): 
+  * default configured on :en locale
+  * must be in French (:fr) or English (:en), other traductions are welcome
+* Carioca have a builtin logger service using regular Logger from Stdlib (also explain in detail in this document)
+  * default logging on STDOUT, but could be redirect in the configure bloc
+* Carioca give us some usefull traces in debug   
+* Carioca come with a Container Class Template
+  * the Container automatically inject :logger, :i18n and a :configuration service (explain in detail after) 
+  * the Container provide a class method macro :inject 
+    *  this macro give a way to use other services defined in the registry file (service could be register inline, presented after)   
 
+## A step further 
 
 
 ## Development

data/carioca.gemspec

@@ -13,9 +13,9 @@ Gem::Specification.new do |spec|
 
   spec.license =  "BSD-3-Clause"
 
-  spec.summary = %q{Carioca : Configuration Agent and Registry with Inversion Of Control for your Applications}
+  spec.summary = %q{Carioca : Container And Registry with Inversion Of Control for your Applications}
   spec.homepage = %q{https://github.com/Ultragreen/carioca}
-  spec.description = %q{Carioca : provide a full IoC light Container for designing your applications}
+  spec.description = %q{Carioca 2: is a complete rewrite who provide a full IoC/DI light Container and a services registry, build with logs, config and Internationalization facilities for designing your applications}
 
   spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
 
@@ -36,6 +36,11 @@ Gem::Specification.new do |spec|
   # Uncomment to register a new dependency of your gem
   spec.add_dependency "tty-prompt", "~>0.23.1"
   spec.add_dependency "pastel", "~>0.8.0"
+  spec.add_dependency 'i18n', "~> 1.10"
+  spec.add_dependency 'locale', "~> 2.1"
+  spec.add_dependency "deep_merge", "~> 1.2"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
 
 
 end

data/config/locales/en.yml

@@ -7,9 +7,17 @@ en:
   notify: 
     locale: "Preloaded service :i18n on locale : %{loc}"
     logger: "Preloaded service :logger ready on %{target}"
+    useless_entry: "Useless entry in registry (builtin service) %{altered} in %{filename}"
   init: 
     carioca: "Initializing Carioca registry"
     builtins: "Preparing builtins services"
     registry: 
-        processing: "Initializing registry from file : %{filename}"
-        success: "Registry initialized successfully"
+      processing: "Initializing registry from file : %{filename}"
+      success: "Registry initialized successfully"
+  config:
+    load:
+      error: "Config file ignored, error : %{message}"
+      success: "Configuration Service successfully initialized from : %{from}"
+  output: 
+    load:
+      context: "Output service initialized in mode : %{confset}"

data/config/locales/fr.yml

@@ -16,4 +16,8 @@ fr:
       success: "Registre initialisé avec succès"
   config:
     load:
-      error: "Fichier de configuration ignoré, erreur : %{message}"
+      error: "Fichier de configuration ignoré, erreur : %{message}"
+      success: "Service de configuration initialisé avec succès depuis : %{from}"
+  output: 
+    load:
+      context: "Service output initialisé en mode : %{confset}"

data/lib/carioca/configuration.rb

@@ -2,10 +2,10 @@ module Carioca
     class Configuration
         include Carioca::Constants
         include Carioca::Helpers
-        attr_accessor :filename, :name, :builtins, :log_target, :default_locale, :locales_load_path
-        attr_accessor :config_file, :config_root, :environment, :supported_environment
-        attr_writer :debug, :init_from_file
-        attr_reader :log_file, :locales_availables
+        attr_accessor :filename, :name, :builtins, :log_target, :default_locale, :locales_load_path, :debugger_tracer
+        attr_accessor :config_file, :config_root, :environment, :supported_environment, :output_mode, :log_level
+        attr_writer :init_from_file,  :output_colors, :output_emoji
+        attr_reader :log_file, :locales_availables, :debug
         def initialize
             @init_from_file = true
             @filename = DEFAULT_REGISTRY_FILE.dup
@@ -13,6 +13,7 @@ module Carioca
             @name = 'Carioca' 
             @builtins = BUILTINS
             @log_file = ''
+            @log_level = DEFAULT_LOG_LEVEL.dup
             @config_file = DEFAULT_CONFIG_FILE.dup
             @environment = DEFAULT_ENVIRONMENT.dup
             @config_root = DEFAULT_CONFIG_ROOT.dup
@@ -20,17 +21,35 @@ module Carioca
             @supported_environment = DEFAULT_ENVIRONMENTS_LIST.dup
             @default_locale = DEFAULT_LOCALE
             @locales_availables = []
+            @output_mode = DEFAULT_OUTPUT_MODE.dup
+            @output_colors  = DEFAULT_COLORS_STATUS.dup
+            @output_emoji = DEFAULT_EMOJI_STATUS.dup
             path = search_file_in_gem('carioca',"config/locales")
             @locales_load_path = Dir[File.expand_path(path) + "/*.yml"]
             Dir[path + '/*.yml'].sort.each do |file|
                 @locales_availables.push File::basename(file,'.yml').to_sym
             end
+            @debugger_tracer = DEFAULT_DEBUGGER_TRACER.dup
+        end
+
+        def debug=(state)
+            @debug = state
+            @log_level = :info if @debug == false and @log_level == :debug
+            @log_level = :debug if @debug == true
         end
 
         def debug? 
             return @debug
         end
 
+        def output_colors? 
+            return @output_colors
+        end
+
+        def output_emoji? 
+            return @output_emoji
+        end
+
         def init_from_file? 
             return @init_from_file
         end

data/lib/carioca/constants.rb

@@ -1,7 +1,7 @@
 module Carioca
     module Constants
 
-        VERSION = '2.0.1'
+        VERSION = '2.0.4'
         DEFAULT_REGISTRY_FILE  = './config/carioca.registry'
         DEFAULT_CONFIG_FILE = './config/settings.yml'
         DEFAULT_ENVIRONMENT = :development
@@ -9,6 +9,14 @@ module Carioca
         DEFAULT_LOCALE = :en
         
 
+        DEFAULT_OUTPUT_MODE = :mono
+        DEFAULT_EMOJI_STATUS = true
+        DEFAULT_COLORS_STATUS = true
+        DEFAULT_LOG_LEVEL = :info
+
+
+        DEFAULT_DEBUGGER_TRACER = :output
+
         # service definitions specs
         SERVICES_MANDATORY_SPECS = {type: Symbol, service: String}
         SERVICES_FULL_LIST_SPECS = SERVICES_MANDATORY_SPECS.merge({depends: Array, description: String, resource: String })
@@ -38,6 +46,21 @@ module Carioca
                                 default_locale: Carioca::Registry.config.default_locale,
                                 load_path: Carioca::Registry.config.locales_load_path,
                                 locales_availables: Carioca::Registry.config.locales_availables)"
+          },
+          output:{
+            type: :internal,
+            description: "The Output serice of Carioca",
+            service: "Carioca::Services::Output::Provider::new(
+                                mode: Carioca::Registry.config.output_mode,
+                                emoji: Carioca::Registry.config.output_emoji?,
+                                colors: Carioca::Registry.config.output_colors?,
+                                level: Carioca::Registry.config.log_level
+            )"
+          },
+          debugger:{
+            type: :internal,
+            description: "The Debugger Service of Carioca",
+            service: "Carioca::Services::Debugger"
           }
         }
 

data/lib/carioca/dependencies.rb

@@ -6,12 +6,13 @@ require 'rubygems'
 require 'i18n'
 require 'locale'
 require 'deep_merge'
+require 'pastel'
 
+require_relative 'helpers'
 require_relative 'constants'
 require_relative 'validator'
 require_relative 'mixin'
 require_relative 'container'
-require_relative 'helpers'
 require_relative 'configuration'
 
 require_relative 'registry_file'

data/lib/carioca/rake/manage.rb

@@ -2,6 +2,9 @@
 require 'rake'
 require 'rubygems'
 require 'carioca'
+require "tty-prompt"
+require "pastel"
+
 
 $VERBOSE = nil
 if Gem::Specification.respond_to?(:find_by_name)

data/lib/carioca/rake/tasks/config.tasks

@@ -0,0 +1,46 @@
+namespace :carioca do
+     namespace :services do
+         namespace :config do 
+            desc "Initialise Service configuration file ./config/settings.yml file"
+            task :init do 
+                begin
+                    prompt = TTY::Prompt.new
+                    pastel = ::Pastel.new
+
+                    if File::exist? "./config/settings.yml" then 
+                        puts pastel.yellow "WARNING : config file already exist, if you continue, you will destroy it !"
+                        continue = prompt.yes?("continue ? ") do |q|
+                            q.default false
+                        end
+                        print "Carioca : "                            
+                        unless continue then 
+                            puts pastel.yellow "canceled"
+                            exit 5
+                        else
+                            File::unlink "./config/settings.yml"
+                            puts pastel.cyan "Reset File"
+                        end
+                    end
+
+                    unless File::exist? "./config" then
+                        puts pastel.red "Carioca is not initialized for Gem usage, perhaps need to run :"
+                        puts pastel.red "$ rake carioca:gem:init_path"
+                        exit 10
+                    end
+                    puts "Carioca : initializing default config file (./config/settings.yml): "
+                    root = prompt.ask("Root config name ? (like your gem/App name)") { |q| 
+                        q.modify :down
+                        q.required true }.to_sym
+                    print "Carioca : Generating config file : "
+                    structure = {root => {:production => {}, :staging => {}, :development => {}, :test => {}, :default => {}}}
+                    File.open('./config/settings.yml', 'w') { |file| file.write(structure.to_yaml) } 
+                    puts pastel.green 'done'
+                rescue TTY::Reader::InputInterrupt
+                    print "Carioca : "
+                    puts pastel.yellow 'interrupted'
+                   exit 5
+                end
+            end
+        end
+    end
+end

data/lib/carioca/rake/tasks/gem.tasks

@@ -0,0 +1,15 @@
+namespace :carioca do
+     namespace :gem do
+        desc "prepare Gem vitals path for Carioca"
+        task :init_path do 
+            pastel = Pastel.new
+            if File::exist? "./config/locales"
+                puts pastel.yellow "Carioca path already initialized"
+            else
+                print 'Carioca : Initialising vitals gem path : '
+                FileUtils.mkdir_p "./config/locales"
+                puts pastel.green "done"
+            end
+        end
+    end
+end

data/lib/carioca/rake/tasks/registry.tasks

@@ -1,15 +1,18 @@
-require "tty-prompt"
-require "pastel"
-
 namespace :carioca  do
     namespace :registry do 
         desc "Adding service to Carioca Registry file"
         task :add_service do
+        prompt = TTY::Prompt.new
+            pastel = ::Pastel.new
             begin 
+                unless File::exist? "./config" then
+                
+                    puts pastel.yellow "Carioca is not initialized for Gem usage, perhaps need to run :"
+                    puts pastel.yellow "$ rake carioca:gem:init_path"
+                    exit unless prompt.yes?("Do you want to continue, with a standalone registry (not recommanded). ? ")
+                end
                 puts "Carioca : registering service :"
                 config = Carioca::Configuration::new
-                prompt = TTY::Prompt.new
-                pastel = Pastel.new
                 filename = prompt.ask("Registry File path ?", default: config.filename)
                 registry_file = Carioca::RegistryFile::new filename: filename
                 name = prompt.ask("Service name ?") { |q| q.required true }.to_sym
@@ -36,22 +39,26 @@ namespace :carioca  do
                 end
                 is_correct = prompt.yes?("Is it correct ? ")
             rescue TTY::Reader::InputInterrupt
-                puts 'Carioca : interrupted'
+                print "Carioca : "
+                puts pastel.yellow 'interrupted'
                 exit 5
             end
+             print "Carioca : Registry saving : "
             if is_correct then 
                 begin
                     registry_file.add service: name, definition: definition
                     registry_file.save!
                 rescue => e 
-                    puts "Carioca: Can't save : #{e}"
+                    print pastel.red "failed" 
+                    puts " error : #{e}"
                     exit 10
                 end
 
-                puts "Carioca : Registry saved"
+                puts pastel.green "done"
             else
-                puts 'Carioca : Nothing saved'
+                puts pastel.yellow 'canceled'
             end
         end
     end
-  end
+  
+end

data/lib/carioca/registry.rb

@@ -25,7 +25,7 @@ module Carioca
 
           raise "Service not found: #{name}" unless @services.include? name
           if @active_services.include? name then 
-            debug message: i18n.t('service.getting', name: name) if @active_services.include? :logger and ![:logger, :i18n].include? name and @@config.debug?
+            debug message: i18n.t('service.getting', name: name) if @active_services.include? :logger and ![:logger, :i18n, :output].include? name and @@config.debug?
           else
             service = @services[name]
             service[:depends].each do|dep|
@@ -59,7 +59,8 @@ module Carioca
           conf_logger = @@config.builtins[:logger]
           conf_logger[:service] = @@config.log_target
           add service: :logger, definition: @@config.builtins[:logger], skip_validation: true
-          get_service name: :logger
+          log = get_service name: :logger
+          log.level = @@config.log_level
         end
 
         def initialize
@@ -81,11 +82,11 @@ module Carioca
         def open_registry_file
           debug message: i18n.t('init.registry.processing', filename: @@config.filename) if @@config.debug?
           registry_file = Carioca::RegistryFile::new filename: @@config.filename
-          debug message: i18n.t('notify.useless_entry', altered: registry_file.altered.to_s, filename: @@config.filename ) if registry_file.altered? and @@config.debug?
+          debug message: i18n.t('notify.useless_entry', altered: registry_file.altered.to_s, file_name: @@config.filename ) if registry_file.altered? and @@config.debug?
           registry_file.validated.each do |service,spec|
             add service: service, definition: spec
           end
-          debug message: i18n.t('init.registry.processing') if @@config.debug?
+          debug message: i18n.t('init.registry.success') if @@config.debug?
         end 
     
     

data/lib/carioca/services/config.rb

@@ -85,7 +85,7 @@ class Hash
                     registry = Carioca::Registry.get
                     @logger = registry.get_service name: :logger
                     @i18n = registry.get_service name: :i18n
-                    
+                    @debug = Carioca::Registry.config.debug?
                     @stage = stage
                     @root = root
                     @config_file = Carioca::Services::Config::ConfigFile::new filename: config_filename
@@ -101,7 +101,7 @@ class Hash
                 private
                 def initconf
                     newsets = {}
-                    @logger.debug("Carioca->Config") { @i18n.t('config.load.error', message: @config_file.error) } if @config_file.error? 
+                    @logger.debug("Carioca->Config") { @i18n.t('config.load.error', message: @config_file.error) } if @config_file.error? and @debug
                     @content = @config_file.data
 
                     unless @stage then
@@ -112,6 +112,7 @@ class Hash
                         self.deep_merge! data
 
                     end
+                    @logger.debug("Carioca->Config") { @i18n.t('config.load.success', from: @config_file.filename) } if @debug
 
 
                 end

data/lib/carioca/services/debug.rb

@@ -0,0 +1,58 @@
+module Carioca
+    module Services
+        class Debugger
+
+            def Debugger.get(service:, trace: Carioca::Registry.config.debugger_tracer)
+                return ProxyDebug::new service: service, trace: trace
+            end
+
+
+        end
+
+        class ProxyDebug
+            def initialize(service:, trace:)
+                registry = Carioca::Registry.get
+                @service = registry.get_service name: service
+                @tracers = [:output, :logger]
+                raise "Debugger :trace is not valid : #{trace}, must be in : #{@tracers.to_s}" unless @tracers.include? trace
+                @tracer = registry.get_service name: trace
+                @tracer_type = trace
+            end
+
+            def method_missing(methodname, *args, **keywords,&block)
+                
+                trace message: "BEGIN CALL for service #{@service} "
+                trace message: "Method called: #{methodname} " 
+                trace message: "args : #{args.join " "}" 
+                trace message:  "keywords : #{keywords.to_s}"
+                if block_given? then
+                    trace message: "block given" 
+                    a = @service.send(methodname, *args, **keywords,&block)
+                else
+                    a = @service.send(methodname, *args, **keywords)
+                end
+                trace message: "=> method returned: #{a} " 
+                trace message: 'END CALL' 
+               
+                return a
+            end
+
+            def trace(message: )
+                if @tracer_type == :output then 
+                    save = @tracer.mode
+                    @tracer.mode = :mono 
+                    @tracer.debug message 
+                    @tracer.mode = save
+                else
+                    @tracer.debug("Carioca->ProxyDebug") { message }
+                end
+
+            end
+
+            
+
+
+        end
+
+    end
+end

data/lib/carioca/services/output.rb

@@ -0,0 +1,189 @@
+module Carioca
+    module Services
+        module Output
+            
+            module FormatsMapping
+                COLORS = { 
+                    :unknown => :red,
+                    :fatal => :red,
+                    :error => :red,
+                    :ko => :yellow,
+                    :warn => :yellow,
+                    :item => :white,
+                    :arrow => :white,
+                    :sending => :white,
+                    :calling => :white,
+                    :scheduling => :white,
+                    :trigger => :white,
+                    :receive => :white,
+                    :info => :cyan,
+                    :ok => :green,
+                    :success => :green,
+                    :debug => :magenta,
+                    :flat => :white
+                }
+                
+                EMOJI = { 
+                    :unknown => {:value => "\u{1F4A5}", :alt => '[!!]', :text => "(UNKNOWN)"},
+                    :fatal => {:value => "\u{26D4}", :alt => '[!!]', :text => "(FATAL)"},
+                    :error => {:value => "\u{1F6AB}", :alt => '[!]', :text => "(ERROR)"},
+                    :ko => {:value => "\u{1F44E}", :alt => '[-]', :text => "(KO)"},
+                    :warn =>  {:value => "\u{26A0}", :alt => '[/!\]', :text => "(WARNING)"},
+                    :info =>  {:value => "\u{2139}", :alt => '[i]', :text => "(INFO)"},
+                    :item =>  {:value => " \u{1F539}", :alt => '', :text => " *"},
+                    :arrow =>  {:value => "  \u{27A1}", :alt => '', :text => " =>"},
+                    :calling => {:value => "\u{1F4DE}" , :alt => '[C]', :text => "(CALLING)"},
+                    :scheduling => {:value => "\u{23F2}" , :alt => '[S]', :text => "{SCHEDULING})"},
+                    :trigger => {:value => "\u{23F0}", :alt => '[T]', :text => "(TRIGGER)"},
+                    :sending =>  {:value => "\u{1F4E4}", :alt => '[>]', :text => "(SENDING)"},
+                    :receive => {:value => "\u{1F4E5}" , :alt => '[<]', :text => "(RECEIVE)"},
+                    :ok =>  {:value => "\u{1F44D}" , :alt => '[+]', :text => "(OK)"},
+                    :success =>  {:value => "\u{1F4AA}" , :alt => '[+]', :text => "(SUCCESS)"},
+                    :debug => {:value => "\u{1F41B}" , :alt => '[D]', :text => "(DEBUG)"},
+                    :flat => {:value => "", :alt => ""}
+                }
+                LEVELS = [:debug, :info, :warn, :error, :fatal, :unknown ]
+                ALIAS = {
+                    :flat => :info, 
+                    :item => :info, 
+                    :ok => :info, 
+                    :ko => :error, 
+                    :trigger => :info,
+                    :scheduling => :info, 
+                    :arrow => :info, 
+                    :sending => :info, 
+                    :calling => :info,
+                    :receive => :info, 
+                    :success => :info 
+                    
+                }
+            end
+            class Provider 
+                include FormatsMapping
+                
+                attr_accessor :mode, :emoji, :color
+                
+                @@alias = ALIAS.dup
+                @@colors = COLORS.dup
+                @@emoji = EMOJI.dup
+                
+                MODE = [:mono, :dual]
+                
+                LEVELS.each do |method|
+                    define_method(method) do |message, session = '', source = 'Carioca->Output'|
+                        self.display(level: method, message:  message, session: session, source: source)
+                    end
+                end
+                @@alias.keys.each do |method|
+                    define_method(method) do |message, session = '',source = 'Carioca->Output'|
+                        self.display( level: method, message: message, session: session, source: source)
+                    end
+                end
+                
+                def map_color(color: , analias: )
+                    raise "Color must be a Symbol" unless color.class == Symbol
+                    raise "Missing alias : #{analias}" unless LEVELS.include? analias
+                    @@alias[analias] = color
+                end
+                
+                def map_emoji(emoji: , analias: )
+                    raise "Emoji must be a String" unless color.class == String
+                    raise "Missing alias : #{analias}" unless LEVELS.include? analias
+                    @@alias[analias] = emoji
+                end
+                
+                
+                def add_alias(newalias:, level:)
+                    raise "Alias must be a Symbol" unless newalias.class == Symbol
+                    raise "Bad Level : #{level}" unless LEVELS.include? level
+                    self.class.define_method(newalias) do |message, session = ''|
+                        self.display({ level: newalias, message: message, session: session})
+                    end
+                end
+                
+                
+                # constructor
+                def initialize(level: :debug, mode: :mono , emoji: true, colors: true)
+                    registry = Carioca::Registry.get
+                    @logger = registry.get_service name: :logger
+                    @i18n = registry.get_service name: :i18n
+                    @debug = Carioca::Registry.config.debug?
+                    self.level = level
+                    @mode = mode
+                    @emoji = (check_unicode_term)? emoji : false
+                    @color = colors
+                    set = []; set.push mode; set.push :emoji if @emoji ; set.push :colors if @color
+                    @logger.debug("Carioca->Output") { @i18n.t('output.load.context', confset: set.to_s ) } if  @debug
+                    raise "Unknown output mode : #{@mode}" unless MODE.include? @mode
+                end
+                
+                # build a session number
+                # @return [String] Session number
+                def get_session
+                    return "#{Time.now.to_i.to_s}#{rand(999)}"
+                end
+                
+                # getter for the current level
+                # @return [Symbol] level
+                def level
+                    return @active_levels.first
+                end
+                
+                # virtual setter for level, set the current level
+                # @raise a badLevel in case of bad level
+                # @param [Symbol] level
+                def level=(level)
+                    raise "Bad Level : #{level}" unless LEVELS.include? level
+                    @active_levels = LEVELS.dup
+                    @active_levels.shift(LEVELS.index(level))
+                end
+                
+                # check if unicode must be used with term ENV
+                # @return [Boolean]
+                def check_unicode_term
+                    return false unless ENV.include? "TERM"
+                    if ENV.values_at("LC_ALL","LC_CTYPE","LANG").compact.first.include?("UTF-8") and ENV.values_at('TERM').first.include? "xterm" then
+                    return true
+                    else
+                    return false
+                    end
+                end
+
+                
+                # abstract method for log wrapper
+                # @param [Hash] params
+                # @option params [Symbol] :level, a valid level in LEVELS or ALIAS
+                # @option params [String] :message text
+                def display(level: , message: , session:, source:)
+                    save = message.dup
+                    target_level = (@@alias.keys.include? level)?  @@alias[level] : level
+                    if @active_levels.include? target_level then
+                        if @color then 
+                            pastel = ::Pastel.new
+                            message = pastel.send @@colors[level], message
+                        end
+                        if @@emoji.include? level
+                            pattern = (@emoji)? @@emoji[level][:value] : @@emoji[level][:alt]
+                            pattern = "#{pattern} #{@@emoji[level][:text]}" if @@emoji[level].include? :text and !@emoji
+                            message  = pattern + " " + message unless pattern.empty?
+                        end
+                        if @mode == :dual
+                            
+                            pattern = @@emoji[level][:alt]
+                            unless LEVELS.include? level
+                                save  =  "#{@@emoji[level][:text]} #{save}" if @@emoji[level].include? :text
+                            end 
+                            block = Proc::new {save}
+                            @logger.send target_level, source, &block
+                        end
+                        puts message
+                    end
+                end
+                
+            end
+            
+            
+        end
+    end
+end
+

data/samples/test.rb

@@ -11,7 +11,12 @@ Carioca::Registry.configure do |spec|
     spec.config_root = :monappli
     spec.environment = :development
     spec.default_locale = :fr
+    spec.log_level = :debug
+    spec.output_mode = :mono
+    spec.output_emoji = true
+    spec.output_colors = true
     spec.locales_load_path << Dir[File.expand_path('./config/locales') + "/*.yml"]
+    spec.debugger_tracer = :output
 end
 
 
@@ -26,6 +31,12 @@ class MyService
     def hello
         logger.info(self.class.to_s) {'Hello World'}
     end
+
+    def method_test(titi, tutu: )
+        yield if block_given?
+        return "result"
+    end     
+
 end
 
 
@@ -58,13 +69,49 @@ class MonAppli < Carioca::Container
     inject service: :myservice
     logger.info(self.to_s) { uuid.generate }
 
+    inject service: :output
+    inject service: :debugger
+
+    def test2
+        cycle = [:unknown,:fatal,:error,:ko,:warn,:info,:item,:arrow,:scheduling,:trigger,:sending, :calling,:receive,:ok,:success,:debug,:flat]
+        cycle.each do |verb| 
+            output.send verb, verb.to_s
+        end
+        output.color = false
+        cycle.each do |verb| 
+            output.send verb, verb.to_s
+        end
+        output.emoji = false
+        cycle.each do |verb| 
+            output.send verb, verb.to_s
+        end
+        output.color = true
+        cycle.each do |verb| 
+            output.send verb, verb.to_s
+        end
+
+    end
+
+    def test3
+        proxy = debugger.get service: :myservice
+        proxy.method_test "param", tutu: "keyword" do 
+            puts 'titi'
+        end
+    end
+
 end
 
 
 
 
+
 appli = MonAppli::new
 appli.test
+#appli.test2
+appli.test3
+
+
+
 
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: carioca
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.4
 platform: ruby
 authors:
 - Romain GEORGES
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-03-04 00:00:00.000000000 Z
+date: 2022-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tty-prompt
@@ -38,7 +38,79 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.8.0
-description: 'Carioca : provide a full IoC light Container for designing your applications'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: locale
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: deep_merge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 'Carioca 2: is a complete rewrite who provide a full IoC/DI light Container
+  and a services registry, build with logs, config and Internationalization facilities
+  for designing your applications'
 email:
 - romain@ultragreen.net
 executables: []
@@ -65,12 +137,16 @@ files:
 - lib/carioca/helpers.rb
 - lib/carioca/mixin.rb
 - lib/carioca/rake/manage.rb
+- lib/carioca/rake/tasks/config.tasks
+- lib/carioca/rake/tasks/gem.tasks
 - lib/carioca/rake/tasks/registry.tasks
 - lib/carioca/registry.rb
 - lib/carioca/registry_file.rb
 - lib/carioca/services/config.rb
+- lib/carioca/services/debug.rb
 - lib/carioca/services/i18n.rb
 - lib/carioca/services/init.rb
+- lib/carioca/services/output.rb
 - lib/carioca/validator.rb
 - samples/Rakefile
 - samples/config/carioca.registry
@@ -87,7 +163,7 @@ metadata:
   homepage_uri: https://github.com/Ultragreen/carioca
   source_code_uri: https://github.com/Ultragreen/carioca
   changelog_uri: https://github.com/Ultragreen/carioca
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -102,9 +178,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: 'Carioca : Configuration Agent and Registry with Inversion Of Control for
-  your Applications'
+summary: 'Carioca : Container And Registry with Inversion Of Control for your Applications'
 test_files: []