carioca 1.1 → 2.0.1

metadata

@@ -1,201 +1,108 @@
 --- !ruby/object:Gem::Specification
 name: carioca
 version: !ruby/object:Gem::Version
-  version: '1.1'
+  version: 2.0.1
 platform: ruby
 authors:
 - Romain GEORGES
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2013-02-18 00:00:00.000000000 Z
+date: 2022-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: tty-prompt
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rdoc
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: roodi
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: uuid
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: code_statistics
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: yard-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: dorsal
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.23.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.23.1
 - !ruby/object:Gem::Dependency
-  name: methodic
+  name: pastel
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.8.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.8.0
 description: 'Carioca : provide a full IoC light Container for designing your applications'
-email: romain@ultragreen.net
+email:
+- romain@ultragreen.net
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/carioca/tasks/rake.rb
-- lib/carioca/tasks/registry_init.rake
-- lib/carioca/services/configuration.rb
-- lib/carioca/services/debug.rb
-- lib/carioca/services/logger.rb
-- spec/samples/dummy.rb
-- spec/samples/requireddummy.rb
-- spec/samples/otherdummy.rb
-- spec/config/services.registry
-- lib/carioca/services.rb
-- lib/carioca/private.rb
-- lib/carioca/exceptions.rb
-- lib/carioca/helpers.rb
-- doc/manual.rdoc
-- spec/init_spec.rb
-- spec/spec_helper.rb
-- spec/carioca_spec.rb
-- lib/carioca.rb
-- Gemfile.lock
+- ".github/workflows/main.yml"
+- ".gitignore"
+- ".rspec"
 - Gemfile
-- ChangeLog
-- COPYRIGHT
-- ultragreen_roodi_coding_convention.yml
-- AUTHORS
+- Gemfile.lock
 - README.md
-- test.rb
-- carioca.gemspec
 - Rakefile
-- INSTALL
-homepage: http://www.ultragreen.net
-licenses: []
-metadata: {}
+- bin/console
+- bin/setup
+- carioca.gemspec
+- config/locales/en.yml
+- config/locales/fr.yml
+- lib/carioca.rb
+- lib/carioca/configuration.rb
+- lib/carioca/constants.rb
+- lib/carioca/container.rb
+- lib/carioca/dependencies.rb
+- lib/carioca/helpers.rb
+- lib/carioca/mixin.rb
+- lib/carioca/rake/manage.rb
+- lib/carioca/rake/tasks/registry.tasks
+- lib/carioca/registry.rb
+- lib/carioca/registry_file.rb
+- lib/carioca/services/config.rb
+- lib/carioca/services/i18n.rb
+- lib/carioca/services/init.rb
+- lib/carioca/validator.rb
+- samples/Rakefile
+- samples/config/carioca.registry
+- samples/config/locales/en.yml
+- samples/config/locales/es.yml
+- samples/config/locales/fr.yml
+- samples/config/settings.yml
+- samples/test.rb
+homepage: https://github.com/Ultragreen/carioca
+licenses:
+- BSD-3-Clause
+metadata:
+  allowed_push_host: https://rubygems.org
+  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: 
-rdoc_options:
-- --title
-- 'Carioca : Gem documentation'
-- --main
-- doc/manual.rdoc
-- --line-numbers
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.8.1
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: nowarning
-rubygems_version: 2.0.7
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: 'Carioca : Configuration Agent and Registry with Inversion Of Control for

data/AUTHORS

@@ -1,8 +0,0 @@
-Author : 
-  Romain GEORGES <romain@ultragreen.net>
-        - code
-	- inline documentation
-	- specs
-	- Documentation
-Ruby Gem maintener : 
-  Romain GEORGES <romain@ultragreen.net>

data/COPYRIGHT

@@ -1,24 +0,0 @@
-carioca Copyright (c) 2013 Ultragreen Software, Romain GEORGES
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
-1. Redistributions of source code must retain the above copyright
-   notice, this list of conditions and the following disclaimer.
-2. Redistributions in binary form must reproduce the above copyright
-   notice, this list of conditions and the following disclaimer in the
-   documentation and/or other materials provided with the distribution.
- 
-THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-SUCH DAMAGE.
- 

data/ChangeLog

@@ -1,7 +0,0 @@
-carioca :
-- initial dev. version
- - version 0.1 (unstable)
-	Romain GEORGES
-- initial stable version
- - version 1.0 (stable)
-	Romain GEORGES	

data/INSTALL

@@ -1,7 +0,0 @@
-How to install carioca ?
-=========================
-
-Please install the gem version via RubyGems : 
-
-$ su -
-# gem ins carioca

data/doc/manual.rdoc

@@ -1,225 +0,0 @@
-= 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)
-
-
-== 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 :
-
-  $ gem ins bundler # if needed
-  $ bunlde gem myapp
-  $ cd myapp
-
-
-Edit your myapp.gemspec, add this line in Gem::Specification bloc :
-
-  gem.add_dependency 'carioca'
-  gem.add_development_dependency 'rake'
-  gem.add_development_dependency 'carioca'
-
-Description and summary need to be changed to be correctly displayed on Rubygems.
-
-so, execute bundle :
-
-  $ bundle
-
-Your environment, is ready to create your app
-
-==== Prepare Carioca
-
-
-  $ mkdir config
-  $ mkdir bin
- 
-edit bin/myapp :
-
-  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
-
-
-
-  $ ruby -e 'require "rubygems"; require "carioca"; reg = Carioca::Services::Registry.init :file => "config/myservices.registry"; reg.discover_builtins; reg.save!'
-
-
-
-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.
-
-Now you could continue coding your bin/myapp
-
-==== Using Configuration Service
-
-
-  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 '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' }
-
-
-==== Creating and using your own service
-
-before create your own service :
-
-
-  $ mkdir services
-
-
-Services, must be a class, if not do a wrapper
-edit services/myservice.rb
-
-  class MyService
-      def initialize
-      end
-
-      def test(arg = nil)
-        return 'OK'
-      end
-    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 :
-
-  ...
-  myservice:
-    :type: :file
-    :resource: services/myservice.rb
-    :description: a test service
-    :service: MyServices
-  ...
-
-So in your app :
-
-
-  require 'rubygems'
-  require 'carioca'
-
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry'
-  service = registry.start_service :name => 'myservice'
-  service.test('titi')
-
-
-
-==== Using Debug in multiple service instance
-
-
-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.)
-
-
-  require 'rubygems'
-  require 'carioca'
-
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry' :debug => true
-  proxy1  = registry.get_service :name => 'debug_myservice', :params => {:service => 'myservice'}
-  proxy1.test('titi')
-
-
-
-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
-
-==== Using Gem for a service
-
-
-For exemple install uuid gem :
-
-  $ gem ins uuid
-
-
-add to your YAML config config/myservices.registry :
-
-  uuid:
-    :type: :gem
-    :resource: uuid
-    :description: a Rubygems called uuid to build UUID ids.
-    :service: UUID  
-
-
-in your app :
-
-  require 'rubygems'
-  require 'carioca'
-
-  registry = Carioca::Services::Registry.init :file => 'config/myservices.registry' :debug => true
-  uuid  = registry.get_service :name => 'uuid'
-  uuid.generate
-
-
-== Copyright
-
-<pre>carioca (c) 2012-2013 Romain GEORGES <romain@ultragreen.net> for Ultragreen Software </pre>
-

data/lib/carioca/exceptions.rb

@@ -1,9 +0,0 @@
-#!/usr/bin/env ruby
-#---
-# Author : Romain GEORGES
-# type : gem component library
-# obj : Carioca Exceptions definition Module
-#---
-
-# Exception overload class for Carioca
-class RegistryError < Exception; end