carioca 1.4 → 2.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9be0e1efee67cbc15309f5eb56a72208681b14d84c3c1f3666474c28798c1c51
-  data.tar.gz: 66033e08a911cd0b537eb7ca1114a8aca2d445f8cae79e9d04e62190e27d0a0c
+  metadata.gz: 99fbf2409631fe5afb97b9807059612f5eaa0e237bf44685a8f9aa993db1b87b
+  data.tar.gz: 36636acf529dc8610985e3bd96310482a0e0f9003836c6a902411cf908735166
 SHA512:
-  metadata.gz: 85c41d310a6ad5f7704b2f244a1616160569dd389939c4ed389b08d81520f15f1c304e5ece750e29205043544bcca886ad39a6925be24c941044acaf5a3c8cbd
-  data.tar.gz: 95cdb63add808821f358742e1fbd6ef611ebc49f062901405ec37cc972dcf7c8695a88583f16685b020df3f08485c8bc1dec83d2868c44641a67fd53c5c0ecef
+  metadata.gz: c9dccd95e578ea578f226c273c132f6021a23b856a25606557044cbaa0aea3403e0522b236c87a581a69653fc0264c8c3c38eb643baf4e9538db5534ffe0a316
+  data.tar.gz: b64096695a61f14423ca8d90363b3fd1d09317aa3eac742e4e9aef4b4ff0381cfd0f443fca2d498092673fd122d639e8b93f182ba1854d38fe138e742e19dc5d

data/.github/workflows/main.yml

@@ -0,0 +1,18 @@
+name: Ruby
+
+on: [push,pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.0.0
+    - name: Run the default task
+      run: |
+        gem install bundler -v 2.2.3
+        bundle install
+        bundle exec rake

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/Gemfile

@@ -1,4 +1,6 @@
-source "http://rubygems.org"
+source "https://rubygems.org"
 
 gemspec
 
+
+

data/Gemfile.lock

@@ -0,0 +1,58 @@
+PATH
+  remote: .
+  specs:
+    carioca (2.0.3)
+      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)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.3)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.4)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.1)
+    wisper (2.0.1)
+
+PLATFORMS
+  arm64-darwin-20
+  ruby
+
+DEPENDENCIES
+  carioca!
+  rake (~> 13.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.2.3

data/README.md

@@ -1,239 +1,172 @@
 # Carioca
 
-## Content
-
-Author:: Romain GEORGES <romain@ultragreen.net> 
-Version:: 1.0
-WWW:: http://www.ultragreen.net/projects/carioca
-
-## Description 
-
-CARIOCA is Configuration Agent and Registry with Inversion Of Control for your Applications
-Carioca provide a full IoC light Container for designing your applications
-Carioca provide :
-- a complete Configuration Agent 
-- A service Registry (base on IOC/DI pattern)
-
-[![Build Status](https://travis-ci.org/lecid/carioca.png?branch=master)](https://travis-ci.org/lecid/carioca)
-
-
 ## Installation
 
-In a valid Ruby environment :
-
-```
-   $ sudo zsh
-   # gem ins carioca
-```
-## Implementation 
-
-* [Carioca]
-* [Carioca::Services]
-* [Carioca:Services::Registry]
-
-## Utilisation
-
-Carioca may be used to create Ruby applications, based on a service registry 
-Carioca come with somes builtin services :
-* logger : an Internal logger based on the logger gem.
-* Configuration : a Configuration Service, with Yaml percistance, and pretty accessors.
-* Debug : a Class Debugger, based on Proxy Design pattern and meta-programation like method_missing   
-
-### Getting start
-
-#### Preparing Gem
-
-Just after Installation, Carioca :
+Install it yourself as:
 
-```
-  $ gem ins bundler # if needed
-  $ bunlde gem myapp
-  $ cd myapp
-```
+    $ gem install carioca
 
-Edit your myapp.gemspec, add this line in Gem::Specification bloc :
-
-```ruby
-  gem.add_dependency 'carioca'
-  gem.add_development_dependency 'rake'
-  gem.add_development_dependency 'carioca'
-```
+## Usage
 
-Description and summary need to be changed to be correctly displayed on Rubygems.
 
-so, execute bundle :
+### Basic usage
 
-```
-  $ bundle
-```
+Create you own gem :
 
-Your environment, is ready to create your app
+    $ bundle gem yourgem
+    $ cd yourgem
+    $ vi yourgem.gemspec
 
-#### Prepare Carioca
-
-```
-  $ mkdir config
-  $ mkdir bin
-```
-
-edit bin/myapp :
+check all the TODO in your gemspec, specify concretly you Gem specification, add the following line :
 
 ```ruby
-  require 'rubygems' 
-  require 'carioca'
-
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry'
-```
-
-
-After, you could Run Carioca and discover Builtins Services, you need the write access to config path
-
-
+     spec.add_dependency "carioca", "~> 2.0"
 ```
-  $ ruby -e 'require "rubygems"; require "carioca"; reg = Carioca::Services::Registry.init :file => "config/myservices.registry"; reg.discover_builtins; reg.save!'
-```
-
+and after :
 
-this create you, a New Registry config, with all builtins registered.
-Default path :
-* config file : ./.config
-* log file : /tmp/log.file
-Carioca Registry is a Singleton, and services also be unique instance.
+    $ bundle add carioca
+    $ mkdir -p config/locales
 
-Now you could continue coding your bin/myapp
-
-#### Using Configuration Service
+Edit the Rakefil, and add the following line :
 
 ```ruby
-  require 'rubygems'
-  require 'carioca'
-
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry'
-  config = registry.start_service :name => 'configuration'
-  config.setings.db = { :name => 'mydb' }
-  config.settings.db.host = "myhost"
-  config.settings.db.port = "4545"
-  config.settings.email = "my@email.com"
-  config.save!
-```
-
-#### Using Logger Service
-
-logger is automatically loaded with Carioca, loading registry with :debug => true, let you see the Carioca traces. 
+require "carioca/rake/manage"
+```
+Verify, all is right with :
+
+    $ rake -T
+    rake build                         # Build yourgem-0.1.0.gem into the pkg directory
+    rake carioca:registry:add_service  # Adding service to Carioca Registry 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 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: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 saved
+
+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
-  require 'rubygems'
-  require 'carioca'
 
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry' :debug => true
-  log = registry.get_service :name => 'logger'
-  log.info('myapp') {'my message' }
-```
+# frozen_string_literal: true
 
-#### Creating and using your own service
+require_relative "yourgem/version"
+require 'carioca'
 
-before create your own service :
 
-```
-  $ mkdir services
-```
+Carioca::Registry.configure do |spec|
+  spec.debug = true
+end
 
-Services, must be a class, if not do a wrapper
-edit services/myservice.rb
+module Yourgem
+  class Error < StandardError; end
 
-```ruby
-  class MyService
-      def initialize
-      end
-
-      def test(arg = nil)
-        return 'OK'
-      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
-  end
-```
 
-You could use the #service_register API (See spec for all details)
-but, you could write it directly in YAML in your config/myservices.registry :
-add the following lines :
+    inject service: :uuid
 
-```yaml
-  ...
-  myservice:
-    :type: :file
-    :resource: services/myservice.rb
-    :description: a test service
-    :service: MyServices
-  ...
+    logger.info(self.to_s) { "Log me as class method" }
 
-So in your app :
+  end
 
-```ruby
-  require 'rubygems'
-  require 'carioca'
+end
 
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry'
-  service = registry.start_service :name => 'myservice'
-  service.test('titi')
 ```
 
-#### Using Debug in multiple service instance
+    $ emacs exe/yourgem_cmd
 
-
-in your app, for debug you could use the Proxy Debug (you need to run Carioca Registry in debug mode ) :
-(Using "debug_", you create an instance of service debug, so with this syntaxe you could create multiple services instances, with different parameters calling.)
+content of the file
 
 ```ruby
-  require 'rubygems'
-  require 'carioca'
+require 'yourgem'
 
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry' :debug => true
-  proxy1  = registry.get_service :name => 'debug_myservice', :params => {:service => 'myservice'}
-  proxy1.test('titi')
+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 :
 
-see the log /tmp/log.file  :
-
-```
-    D, [2013-03-23T18:20:39.839826 #76641] DEBUG -- ProxyDebug: BEGIN CALL for mapped service myservice
-    D, [2013-03-23T18:20:39.839875 #76641] DEBUG -- ProxyDebug: called: test
-    D, [2013-03-23T18:20:39.839920 #76641] DEBUG -- ProxyDebug: args : titi
-    D, [2013-03-23T18:20:39.839970 #76641] DEBUG -- ProxyDebug: => returned: OK
-    D, [2013-03-23T18:20:39.840014 #76641] DEBUG -- ProxyDebug: END CALL
-```
+    $ 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-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
 
-#### Using Gem for a service
+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 
 
-For exemple install uuid gem :
 
-```
-  $ gem ins uuid
-```
+## Development
 
-add to your YAML config config/myservices.registry :
-
-```yaml
-  uuid:
-    :type: :gem
-    :resource: uuid
-    :description: a Rubygems called uuid to build UUID ids.
-    :service: UUID  
-```
-
-in your app :
-
-```ruby
-  require 'rubygems'
-  require 'carioca'
-
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry' :debug => true
-  uuid  = registry.get_service :name => 'uuid'
-  uuid.generate
-```
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-== Copyright
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
-<pre>carioca (c) 2012-2013 Romain GEORGES <romain@ultragreen.net> for Ultragreen Software </pre>
+## Contributing
 
+Bug reports and pull requests are welcome on GitHub at https://github.com/Ultragreen/carioca.

data/Rakefile

@@ -1,69 +1,8 @@
-require 'rubygems'
-require "bundler/gem_tasks"
-require 'rspec'
-require 'rake'
-require "rake/clean"
-require "rubygems/package_task"
-require "rdoc/task"
-require 'rspec/core/rake_task'
-require 'yard'
-require 'yard/rake/yardoc_task.rb'
-require "rake/tasklib"
-require "roodi"
-require "roodi_task"
-require 'code_statistics'
-
-
-RoodiTask.new() do | t |
-t.patterns = %w(lib/**/*.rb)
-t.config = "ultragreen_roodi_coding_convention.yml"
-end
-
-
-CLEAN.include('*.tmp','*.old')
-CLOBBER.include('*.tmp', 'build/*','#*#')
-
-
-content = File::readlines(File.join(File.dirname(__FILE__), 'carioca.gemspec')).join
-spec = eval(content)
-
-RSpec::Core::RakeTask.new('spec')
+# frozen_string_literal: true
 
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
 
+RSpec::Core::RakeTask.new(:spec)
 
-YARD::Rake::YardocTask.new do |t|
-  t.files   = [ 'lib/**/*.rb', '-', 'doc/**/*','spec/**/*_spec.rb']
-  t.options += ['--title', "Gem Documentation"]
-  t.options += ['-o', "yardoc"]
-  t.options += ['-r', "doc/manual.rdoc"]
-end
-YARD::Config.load_plugin('yard-rspec')
-
-namespace :yardoc do
-  task :clobber do
-    rm_r "yardoc" rescue nil
-    rm_r ".yardoc" rescue nil
-  end
-end
-task :clobber => "yardoc:clobber"
-
-
-Gem::PackageTask.new(spec) do |pkg|
-  pkg.need_tar = true
-  pkg.need_zip = true
-end
-
-Rake::RDocTask.new('rdoc') do |d|
-  d.rdoc_files.include('doc/**/*','bin/*')
-  d.main = 'doc/manual.rdoc'
-  d.title = 'Uglibs : Ultragreen libraries'
-  d.options << '--line-numbers' << '--diagram' << '-SHN'
-end
-
-task :default => [:gem]
-
-task :stage do
-  Rake::Task["clean"].invoke
-  Rake::Task["clobber"].invoke
-  Rake::Task["install"].invoke
-end
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+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.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/carioca.gemspec

@@ -1,32 +1,46 @@
-Gem::Specification.new do |s|
-  s.name = %q{carioca}
-  s.author = "Romain GEORGES"
-  s.version = "1.4"
-  s.license =  "BSD-2-Clause"
-  s.summary = %q{Carioca : Configuration Agent and Registry with Inversion Of Control for your Applications}
-  s.email = %q{romain@ultragreen.net}
-  s.homepage = %q{https://github.com/Ultragreen/carioca}
-  s.description = %q{Carioca : provide a full IoC light Container for designing your applications}
-  s.files = `git ls-files`.split($/)
+# frozen_string_literal: true
 
+require_relative "lib/carioca/constants"
 
-  s.add_development_dependency "rake", "~> 13.0.1"
-  s.add_development_dependency 'rspec', '~> 3.9.0'
-  s.add_development_dependency 'yard', '~> 0.9.24'
-  s.add_development_dependency 'rdoc', '~> 6.2.1'
-  s.add_development_dependency 'roodi', '~> 5.0.0'
-  s.add_development_dependency 'code_statistics', '~> 0.2.13'
-  s.add_development_dependency 'yard-rspec', '~> 0.1'
+Gem::Specification.new do |spec|
+  spec.name          = "carioca"
+  spec.version       = Carioca::Constants::VERSION
+  spec.authors       = ["Romain GEORGES"]
+  spec.email         = ["romain@ultragreen.net"]
 
 
-s.add_development_dependency 'uuid', '~> 2.3.9'
 
 
+  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.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.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  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"
 
-  s.add_dependency 'dorsal', "~> 1.0"
-  s.add_dependency 'methodic', "~> 1.3", '>= 1.3'
-  s.add_dependency 'xml-simple', "~> 1.1", '>= 1.1.5'
-  s.add_dependency 'activesupport', "~> 6.0.2.2"
-  s.required_ruby_version = '>= 1.8.1'
 
 end

data/config/locales/en.yml

@@ -0,0 +1,23 @@
+en:
+  service: 
+    adding: "Adding service %{name}"
+    starting: "Starting service %{name}"
+    getting: "Getting service %{name}"
+    depends: "Dependencie service %{name}"
+  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"
+  config:
+    load:
+      error: "Config file ignored, error : %{message}"
+      success: "Configuration Service successfully initialized from : %{from}"
+  output: 
+    load:
+      context: "Output service initialized in mode : %{confset}"