carioca 2.0.2 → 2.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23b95a753d4b358bde71f7d1e9f59ba9456b40302ef9a028a5e791a00c2c7d07
-  data.tar.gz: cb29906d32001f5eecf0b7f78e161cf86436b11cec67377a9efacd2ecf63a469
+  metadata.gz: 8c9296f0a424070e2bd252fe15432b820cfb6a3e9bd52f45e9fd2a0430d06174
+  data.tar.gz: 5815c387bafb81c50cb19e659d5440ab8db1654e873be742eaac9857433ad7fd
 SHA512:
-  metadata.gz: b105358ef95e063ffdeea22f81eff91dc0a9044b6dcc941fb0449b0d5f6a9b8106d2cdead2d6fd81223b5863d3a2e8ec902d0ce339c24b6c350f84dbcbd4fb4c
-  data.tar.gz: ccd2744676d47b0dd3e6e25acf29194441c2217018d7b1ca1266b55ad598a942b23ae219c26277b6b2986c67c1dcce1b1dc74ee041e4b32f1fab1ec4ed21c567
+  metadata.gz: 34a33f5e613a1530930cf0e6e53f8c1179a66d8eda41a440766ffeaf6d9060c44efa945ed40af22679e6e7ac90e1c3537222cf82473caaa315561b241b47814a
+  data.tar.gz: ab2fa5e329b95df2e04f87501ac8ab74a8450e16dbeff5cc61aa374455b4b7bc0c5c8365e198907fb2955e0c786fe3a8011292a33253545653e14ac3be1f9e5c

data/.rubocop.yml

@@ -0,0 +1,54 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2022-07-26 15:23:44 UTC using RuboCop version 1.32.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false
+
+# definitive :
+Lint/Debugger:
+  Exclude:
+    - 'samples/test.rb'
+Security/Eval:
+  Enabled: true
+  Exclude:
+    - 'lib/carioca/registry.rb'
+Style/ClassVars:
+  Enabled: false
+Style/MissingRespondToMissing:
+  Enabled: false
+Gemspec/RequireMFA:
+  Enabled: false
+
+
+# to study :
+Metrics/AbcSize:
+  Enabled: false
+Metrics/CyclomaticComplexity:
+  Enabled: false
+Metrics/MethodLength:
+  Enabled: false
+Metrics/PerceivedComplexity:
+  Enabled: false
+Style/EvalWithLocation:
+  Enabled: false
+Style/GuardClause:
+  Enabled: false
+
+
+
+# to do : 
+Style/Documentation:
+  Enabled: false
+Layout/LineLength:
+  Enabled: false
+
+
+
+
+

data/Gemfile

@@ -1,6 +1,5 @@
-source "https://rubygems.org"
-
-gemspec
-
+# frozen_string_literal: true
 
+source 'https://rubygems.org'
 
+gemspec

data/Gemfile.lock

@@ -1,25 +1,35 @@
 PATH
   remote: .
   specs:
-    carioca (2.0.2)
+    carioca (2.0.4)
       deep_merge (~> 1.2)
       i18n (~> 1.10)
       locale (~> 2.1)
       pastel (~> 0.8.0)
       tty-prompt (~> 0.23.1)
+      version (~> 1.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    concurrent-ruby (1.1.9)
+    ast (2.4.2)
+    code_statistics (0.2.13)
+    concurrent-ruby (1.1.10)
     deep_merge (1.2.2)
     diff-lcs (1.5.0)
-    i18n (1.10.0)
+    i18n (1.12.0)
       concurrent-ruby (~> 1.0)
+    json (2.6.2)
     locale (2.1.3)
+    parallel (1.22.1)
+    parser (3.1.2.0)
+      ast (~> 2.4.1)
     pastel (0.8.0)
       tty-color (~> 0.5)
+    rainbow (3.1.1)
     rake (13.0.6)
+    regexp_parser (2.5.0)
+    rexml (3.2.5)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
@@ -33,6 +43,19 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-support (3.9.4)
+    rubocop (1.32.0)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.1.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.19.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.19.1)
+      parser (>= 3.1.1.0)
+    ruby-progressbar (1.11.0)
     tty-color (0.6.0)
     tty-cursor (0.7.1)
     tty-prompt (0.23.1)
@@ -43,7 +66,14 @@ GEM
       tty-screen (~> 0.8)
       wisper (~> 2.0)
     tty-screen (0.8.1)
+    unicode-display_width (2.2.0)
+    version (1.1.1)
+    webrick (1.7.0)
     wisper (2.0.1)
+    yard (0.9.28)
+      webrick (~> 1.7.0)
+    yard-rspec (0.1)
+      yard
 
 PLATFORMS
   arm64-darwin-20
@@ -51,8 +81,12 @@ PLATFORMS
 
 DEPENDENCIES
   carioca!
+  code_statistics (~> 0.2.13)
   rake (~> 13.0)
   rspec (~> 3.0)
+  rubocop (~> 1.32)
+  yard (~> 0.9.27)
+  yard-rspec (~> 0.1)
 
 BUNDLED WITH
    2.2.3

data/README.md

@@ -1,5 +1,8 @@
 # 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
 
 Install it yourself as:
@@ -35,17 +38,21 @@ require "carioca/rake/manage"
 Verify, all is right with :
 
     $ rake -T
-    rake build                         # Build yourgem-0.1.0.gem into the pkg directory
+    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 yourgem-0.1.0.gem into system gems
-    rake install:local                 # Build and install yourgem-0.1.0.gem into system gems without network access
-    rake release[remote]               # Create tag v0.1.0 and build and push yourgem-0.1.0.gem to Set to 'http://mygemserver.com'
+    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
 
 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
@@ -63,7 +70,7 @@ You could now initialize the Carioca registry following the wizard, with (sample
      * service: UUID
      * resource: uuid
     Is it correct ?  Yes
-    Carioca : Registry saved
+    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):
 
@@ -132,19 +139,21 @@ After this, don't forget to stage new files, and you could build & install the g
     $ rake install && yourgem_cmd
     yourgem 0.1.0 built to pkg/yourgem-0.1.0.gem.
     yourgem (0.1.0) installed.
-    D, [2022-03-04T23:11:52.663459 #88808] DEBUG -- Carioca: Preloaded service :i18n on locale : en
-    D, [2022-03-04T23:11:52.663519 #88808] DEBUG -- Carioca: Preloaded service :logger ready on STDOUT
-    D, [2022-03-04T23:11:52.663537 #88808] DEBUG -- Carioca: Initializing Carioca registry
-    D, [2022-03-04T23:11:52.663550 #88808] DEBUG -- Carioca: Preparing builtins services
-    D, [2022-03-04T23:11:52.663580 #88808] DEBUG -- Carioca: Adding service configuration
-    D, [2022-03-04T23:11:52.663609 #88808] DEBUG -- Carioca: Adding service i18n
-    D, [2022-03-04T23:11:52.663649 #88808] DEBUG -- Carioca: Initializing registry from file : ./config/carioca.registry
-    D, [2022-03-04T23:11:52.663773 #88808] DEBUG -- Carioca: Adding service uuid
-    D, [2022-03-04T23:11:52.663794 #88808] DEBUG -- Carioca: Registry initialized successfully
-    I, [2022-03-04T23:11:52.663802 #88808]  INFO -- Sample::YourGemCMD: Log me as class method
-    I, [2022-03-04T23:11:52.663813 #88808]  INFO -- #<Sample::YourGemCMD:0x00000001312c0bf0>: Log me as an instance method
-    D, [2022-03-04T23:11:52.663844 #88808] DEBUG -- Carioca: Starting service uuid
-    W, [2022-03-04T23:11:52.682812 #88808]  WARN -- Sample::YourGemCMD: Give me an UUID : 0505f3f0-7e36-013a-22c7-1e00870a7189
+    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): 

data/Rakefile

@@ -1,8 +1,46 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop//rake_task'
 
+require 'yard'
+require 'yard/rake/yardoc_task'
+
+require 'code_statistics'
+
+RuboCop::RakeTask.new
 RSpec::Core::RakeTask.new(:spec)
 
 task default: :spec
+
+require 'version'
+require 'rake/version_task'
+Rake::VersionTask.new
+
+YARD::Rake::YardocTask.new do |t|
+  t.files = ['lib/**/*.rb', '-', 'doc/**/*', 'spec/**/*_spec.rb']
+  t.options += ['-o', 'yardoc']
+end
+YARD::Config.load_plugin('yard-rspec')
+
+namespace :yardoc do
+  task :clobber do
+    begin
+      rm_r 'yardoc'
+    rescue StandardError
+      nil
+    end
+    begin
+      rm_r '.yardoc'
+    rescue StandardError
+      nil
+    end
+    begin
+      rm_r 'pkg'
+    rescue StandardError
+      nil
+    end
+  end
+end
+task clobber: 'yardoc:clobber'

data/VERSION

@@ -0,0 +1 @@
+2.0.5

data/bin/console

@@ -1,8 +1,8 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "bundler/setup"
-require "carioca"
+require 'bundler/setup'
+require 'carioca'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -11,5 +11,5 @@ require "carioca"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/carioca.gemspec

@@ -1,46 +1,46 @@
 # frozen_string_literal: true
 
-require_relative "lib/carioca/constants"
+require_relative 'lib/carioca/constants'
 
 Gem::Specification.new do |spec|
-  spec.name          = "carioca"
-  spec.version       = Carioca::Constants::VERSION
-  spec.authors       = ["Romain GEORGES"]
-  spec.email         = ["romain@ultragreen.net"]
+  spec.name          = 'carioca'
+  spec.version       = `cat VERSION`.chomp
+  spec.authors       = ['Romain GEORGES']
+  spec.email         = ['romain@ultragreen.net']
 
+  spec.license = 'BSD-3-Clause'
 
+  spec.summary = 'Carioca : Container And Registry with Inversion Of Control for your Applications'
+  spec.homepage = 'https://github.com/Ultragreen/carioca'
+  spec.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'
 
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.6.0')
 
-  spec.license =  "BSD-3-Clause"
-
-  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 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")
-
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["changelog_uri"] = spec.homepage
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
 
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = spec.homepage
 
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
   # 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"
-
-
+  spec.add_dependency 'deep_merge', '~> 1.2'
+  spec.add_dependency 'i18n', '~> 1.10'
+  spec.add_dependency 'locale', '~> 2.1'
+  spec.add_dependency 'pastel', '~>0.8.0'
+  spec.add_dependency 'tty-prompt', '~>0.23.1'
+  spec.add_development_dependency 'code_statistics', '~> 0.2.13'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 1.32'
+  spec.add_development_dependency 'yard', '~> 0.9.27'
+  spec.add_development_dependency 'yard-rspec', '~> 0.1'
+  spec.metadata['rubygems_mfa_required'] = 'false'
+  spec.add_dependency 'version', '~> 1.1'
 end

data/config/locales/en.yml

@@ -17,3 +17,7 @@ en:
   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

@@ -1,60 +1,69 @@
+# frozen_string_literal: true
+
 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, :output_mode, :log_level
-        attr_writer :debug, :init_from_file,  :output_colors, :output_emoji
-        attr_reader :log_file, :locales_availables
-        def initialize
-            @init_from_file = true
-            @filename = DEFAULT_REGISTRY_FILE.dup
-            @debug = false
-            @name = 'Carioca' 
-            @builtins = BUILTINS
-            @log_file = ''
-            @log_level = DEFAULT_LOG_LEVEL.dup
-            @log_level = :info if @debug == false and @log_level == :debug
-            @config_file = DEFAULT_CONFIG_FILE.dup
-            @environment = DEFAULT_ENVIRONMENT.dup
-            @config_root = DEFAULT_CONFIG_ROOT.dup
-            @log_target = '::Logger::new(STDOUT)'
-            @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
-        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
-
-        def log_file?
-            return !@log_file.empty?
-        end
-
-        def log_file=(name)
-            @log_file = name
-            @log_target = "::Logger::new('#{name}')"
-        end
-    end
-end
+  class Configuration
+    include Carioca::Constants
+    include Carioca::Helpers
+    attr_accessor :filename, :name, :builtins, :log_target, :default_locale, :locales_load_path, :debugger_tracer,
+                  :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
+      @debug = false
+      @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
+      @log_target = '::Logger::new(STDOUT)'
+      @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) && (@log_level == :debug)
+      @log_level = :debug if @debug == true
+    end
+
+    def debug?
+      @debug
+    end
+
+    def output_colors?
+      @output_colors
+    end
+
+    def output_emoji?
+      @output_emoji
+    end
+
+    def init_from_file?
+      @init_from_file
+    end
+
+    def log_file?
+      !@log_file.empty?
+    end
+
+    def log_file=(name)
+      @log_file = name
+      @log_target = "::Logger::new('#{name}')"
+    end
+  end
+end

data/lib/carioca/constants.rb

@@ -1,60 +1,67 @@
+# frozen_string_literal: true
+
 module Carioca
-    module Constants
+  module Constants
+    DEFAULT_REGISTRY_FILE = './config/carioca.registry'
+    DEFAULT_CONFIG_FILE = './config/settings.yml'
+    DEFAULT_ENVIRONMENT = :development
+    DEFAULT_CONFIG_ROOT = :carioca
+    DEFAULT_LOCALE = :en
 
-        VERSION = '2.0.2'
-        DEFAULT_REGISTRY_FILE  = './config/carioca.registry'
-        DEFAULT_CONFIG_FILE = './config/settings.yml'
-        DEFAULT_ENVIRONMENT = :development
-        DEFAULT_CONFIG_ROOT = :carioca
-        DEFAULT_LOCALE = :en
-        
+    DEFAULT_OUTPUT_MODE = :mono
+    DEFAULT_EMOJI_STATUS = true
+    DEFAULT_COLORS_STATUS = true
+    DEFAULT_LOG_LEVEL = :info
 
-        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 })
-        SERVICES_SPECS_DETAIL = {type: [:gem, :stdlib, :file, :internal]} 
+    # service definitions specs
+    SERVICES_MANDATORY_SPECS = { type: Symbol, service: String }.freeze
+    SERVICES_FULL_LIST_SPECS = SERVICES_MANDATORY_SPECS.merge({ depends: Array, description: String,
+                                                                resource: String })
+    SERVICES_SPECS_DETAIL = { type: %i[gem stdlib file internal] }.freeze
 
-        DEFAULT_ENVIRONMENTS_LIST = [:production, :staging, :test, :development]
+    DEFAULT_ENVIRONMENTS_LIST = %i[production staging test development].freeze
 
-        BUILTINS = {
-          configuration: { 
-            type: :internal,
-            depends: [:logger],
-            description: "The configuration service of Carioca",
-            service: "Carioca::Services::Config::Factory::new(
-                                 config_filename: Carioca::Registry.config.config_file, 
-                                 stage: Carioca::Registry.config.environment, 
-                                 root: Carioca::Registry.config.config_root)" },
-          logger: {
-            type: :stdlib,
-            resource: "logger",
-            description: "The Logger service of Carioca",
-            depends: [:i18n]
-          },
-          i18n:{
-            type: :internal,
-            description: "The Internalisation service of Carocia",
-            service: "Carioca::Services::I18n.get(
+    BUILTINS = {
+      configuration: {
+        type: :internal,
+        depends: [:logger],
+        description: 'The configuration service of Carioca',
+        service: "Carioca::Services::Config::Factory::new(
+                                 config_filename: Carioca::Registry.config.config_file,
+                                 stage: Carioca::Registry.config.environment,
+                                 root: Carioca::Registry.config.config_root)"
+      },
+      logger: {
+        type: :stdlib,
+        resource: 'logger',
+        description: 'The Logger service of Carioca',
+        depends: [:i18n]
+      },
+      i18n: {
+        type: :internal,
+        description: 'The Internalisation service of Carocia',
+        service: "Carioca::Services::I18n.get(
                                 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(
+      },
+      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
             )"
-          }
-        }
-
-    end
+      },
+      debugger: {
+        type: :internal,
+        description: 'The Debugger Service of Carioca',
+        service: 'Carioca::Services::Debugger'
+      }
+    }.freeze
+  end
 end