carioca 2.0.4 → 2.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df2fae455d522ba26500abac0d203b29e1b173391b2e9eb9c27f9de83f282a55
-  data.tar.gz: 5e34e6d5b0eef09348906b45f6bb5c2db3d1874c6d4f3f05c5a017baca5f5da1
+  metadata.gz: 13022502526464ca7b3d4a3a7e0978da16561ba5ff5d122ecfe342490e4cf9e6
+  data.tar.gz: cf459b788caaab93897fa016979ff71330327ee6298924630d4bfd65810f1a0e
 SHA512:
-  metadata.gz: fad3b4fcbf8beb5811458891ad529a405fe85f19af613eb986369e51573eb87524d5849a566e7009a1a6c8d6f142e5a6f60a5e3ce82f9b60e82cabcfc814d02b
-  data.tar.gz: 1049e060ed5326a3f67acea98258fca5c2880f46ae1edc3b1d08070e7012d374d975c062e076adfb2a127e0f3027ba0117b57ba97bc06f43d1ab3f904f63a0a4
+  metadata.gz: af1f9349fcbde3d58278681fe4a2d8ac103f6cd1f9a6b16604cc456bf958c6f9f3a69c2c4eaef031a37cbd5a85061e6a8015ff4ba8f6fd9c9abe9c73d9fbd6dc
+  data.tar.gz: 8bb31c85ce579f72588fc54376e33701baf8e683929627e5edd07aed47bb9a1d9dfeeb5039eab8aa9f22bef8462812a6ebbe5a59c3138245ef2e77fac948af9d

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

@@ -7,19 +7,29 @@ PATH
       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/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.6

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/lib/carioca/configuration.rb

@@ -1,66 +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, :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
-            @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
+  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 debug=(state)
-            @debug = state
-            @log_level = :info if @debug == false and @log_level == :debug
-            @log_level = :debug if @debug == true
-        end
+    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? 
-            return @debug
-        end
+    def debug=(state)
+      @debug = state
+      @log_level = :info if (@debug == false) && (@log_level == :debug)
+      @log_level = :debug if @debug == true
+    end
 
-        def output_colors? 
-            return @output_colors
-        end
+    def debug?
+      @debug
+    end
 
-        def output_emoji? 
-            return @output_emoji
-        end
+    def output_colors?
+      @output_colors
+    end
 
-        def init_from_file? 
-            return @init_from_file
-        end
+    def output_emoji?
+      @output_emoji
+    end
+
+    def init_from_file?
+      @init_from_file
+    end
 
-        def log_file?
-            return !@log_file.empty?
-        end
+    def log_file?
+      !@log_file.empty?
+    end
 
-        def log_file=(name)
-            @log_file = name
-            @log_target = "::Logger::new('#{name}')"
-        end
+    def log_file=(name)
+      @log_file = name
+      @log_target = "::Logger::new('#{name}')"
     end
-end
+  end
+end

data/lib/carioca/constants.rb

@@ -1,68 +1,67 @@
-module Carioca
-    module Constants
-
-        VERSION = '2.0.4'
-        DEFAULT_REGISTRY_FILE  = './config/carioca.registry'
-        DEFAULT_CONFIG_FILE = './config/settings.yml'
-        DEFAULT_ENVIRONMENT = :development
-        DEFAULT_CONFIG_ROOT = :carioca
-        DEFAULT_LOCALE = :en
-        
+# frozen_string_literal: true
 
-        DEFAULT_OUTPUT_MODE = :mono
-        DEFAULT_EMOJI_STATUS = true
-        DEFAULT_COLORS_STATUS = true
-        DEFAULT_LOG_LEVEL = :info
+module Carioca
+  module Constants
+    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_DEBUGGER_TRACER = :output
+    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
             )"
-          },
-          debugger:{
-            type: :internal,
-            description: "The Debugger Service of Carioca",
-            service: "Carioca::Services::Debugger"
-          }
-        }
-
-    end
+      },
+      debugger: {
+        type: :internal,
+        description: 'The Debugger Service of Carioca',
+        service: 'Carioca::Services::Debugger'
+      }
+    }.freeze
+  end
 end

data/lib/carioca/container.rb

@@ -1,16 +1,14 @@
+# frozen_string_literal: true
 
 module Carioca
-    class Container
+  class Container
+    extend Carioca::Injector
 
-        extend Carioca::Injector
-
-        inject service: :logger
-        inject service: :configuration
-
-        def initialize(name: 'Carioca')
-            @name = name
-        end
+    inject service: :logger
+    inject service: :configuration
 
+    def initialize(name: 'Carioca')
+      @name = name
     end
-
+  end
 end

data/lib/carioca/dependencies.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'yaml'
 require 'forwardable'
 require 'singleton'