dorsal 1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6b142bf4c6b5a14321f07c27e1de317bbe7bec8e
+  data.tar.gz: 31bbcd213f7c18aac8671d0041c00b6d7657e499
+SHA512:
+  metadata.gz: 6dead18e0122a5999e7d6276e709ec05492e3a7abcea00759ab6851bc8bdc1d2f58190225e830e1bbfa5e82a9ce0ac18de4bc8a9e011f270cc715b757a6cde63
+  data.tar.gz: da7218d7a318d41d98ccd3dc814c7f90c0a6f5c4d8f755dbbd703c0150a17684518b8762343f425ccf25e548ec43d8d3a5ec21d01e18171a93ab814b1b5c6b06

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dorsal.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Romain GEORGES
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,26 @@
+# Dorsal
+
+* *Authors* : Romain GEORGES
+* *Email* : romain@ultragreen.net
+* *Description* : Dorsal : Druby Objects's Ring Server as an simple Alternative to Linda
+   Dorsal provide a simple and easy to use Ring Server for DRuby Objects based services architectures
+* *Homepage : http://www.ultragreen.net/projects/dorsal
+* *License : BSD
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'dorsal'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install dorsal
+
+## Usage
+
+

data/Rakefile

@@ -0,0 +1,61 @@
+require "bundler/gem_tasks"
+require 'rubygems'
+require 'rspec'
+require 'rake'
+require "rake/clean"
+require "rubygems/package_task"
+require "rdoc/task"
+require 'code_statistics'
+require 'rspec/core/rake_task'
+require 'yard'
+require 'yard/rake/yardoc_task.rb'
+require "rake/tasklib"
+require "roodi"
+require "roodi_task"
+
+
+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__), 'dorsal.gemspec')).join
+spec = eval(content)
+
+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 = 'Dorsal : Yard'
+  d.options << '--line-numbers' << '--diagram' << '-SHN'
+end
+
+task :default => [:gem]

data/dorsal.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dorsal/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "dorsal"
+  spec.version       = Dorsal::VERSION
+  spec.authors       = ["Romain GEORGES"]
+  spec.email         = ["romain@ultragreen.net"]
+  spec.description   = %q{Dorsal : Druby Objects's Ring Server as an simple Alternative to Linda}
+  spec.summary       = %q{Dorsal provide a simple and easy to use Ring Server for DRuby Objects based services architectures}
+  spec.homepage      = "http://www.ultragreen.net/projects/dorsal"
+  spec.license       = "BSD"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.add_development_dependency('methodic', '>= 1.2')
+  spec.add_development_dependency('rspec')
+  spec.add_development_dependency('yard')
+  spec.add_development_dependency('rdoc')
+  spec.add_development_dependency('roodi')
+  spec.add_development_dependency('code_statistics')
+  spec.add_development_dependency('yard-rspec')
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_dependency "daemons"
+
+  spec.required_ruby_version = '>= 1.8.1'
+  spec.rubyforge_project = "nowarning"
+  spec.has_rdoc = true
+end

data/lib/dorsal.rb

@@ -0,0 +1,53 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#---# Author : Romain GEORGES
+# type : gem component library
+# obj : Dorsal Module
+#---
+require "dorsal/version"
+require 'rubygems'
+require 'methodic'
+require 'drb/drb'
+require 'dorsal/privates'
+require 'dorsal/exceptions'
+require 'dorsal/implementation'
+require 'dorsal/controller'
+
+# module Dorsal
+# @author Romain GEORGES <romain@ultragreen.net>
+# @see http://www.ultragreen.net/projects/dorsal
+# @version (See Dorsal::VERSION)
+# @note this module is a namespace Dorsal 
+module Dorsal
+
+  # the default dir where write pid files
+  DEFAULT_DIR  = '/tmp/dorsal'
+
+  # the default host name shared between Ring Server and DRb hosted services
+  DEFAULT_HOST = 'localhost'
+  
+  # the default port of the Ring Server
+  DEFAULT_PORT = '8686' 
+
+  # the default shortname of the ringserver 
+  DEFAULT_RINGSERVER_NAME = 'ringserver'
+
+  # the default long description of the ring Server
+  DEFAULT_RINGSERVER_DESCRIPTION = 'Dorsal Ring Server'
+  
+  # the default debug status
+  DEFAULT_DEBUG = false
+
+
+end
+
+
+
+
+
+
+
+
+
+
+

data/lib/dorsal/controller.rb

@@ -0,0 +1,131 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#---
+# Author : Romain GEORGES
+# type : gem component library
+# obj : Dorsal Module
+#---
+require 'drb'
+require 'methodic'
+require 'dorsal/privates'
+require 'dorsal/exceptions'
+
+# the Dorsal namespace
+module Dorsal
+  # the Controller Class, provide access and control of the Ring Server and services, via the Ring Server
+  # @example usage
+  #   dorsal = Dorsal::Controller::new
+  #   # or 
+  #   dorsal = Dorsal::Contoller::new :host => 'dorsal.example.com', 
+  #                                   :port => "8888", :dir => '/a/writable/path', :description => 'My Own Dorsal Ring Server'
+  class Controller
+    
+    # use shared privates
+    include Dorsal::Privates
+    private :start
+    private :stop
+    private :status
+    
+
+    # @example read
+    #   dorsal = Dorsal::Controller::new
+    #   p dorsal.options                                                                                                                                                             
+    # @attr_reader [Hash] options a hash table of all structured options of Dorsal
+    attr_reader :options
+
+    # contructor for Dorsal::Controller
+    # @param [Hash] _options (all options are optionals
+    # @note see default values from Dorsal namespace Constants 
+    # @option _options [String] :name the name of the ringserver instance
+    # @option _options [String] :description the detail name of the the ring server, use for $0
+    # @option _options [String] :port the port where to bind ring server
+    # @option _options [String] :host the host name share between ring server and hosted DRb services
+    # @option _options [String] :dir a writable path where to write pid files and more.
+    # @option _options [TruClass,FalseClass] :debug to run Dorsal Ring server in foreground, with more traces 
+    # @example usage
+    #   dorsal = Dorsal::Controller::new
+    #   # or 
+    #   dorsal = Dorsal::Contoller::new :host => 'dorsal.example.com', 
+    #                                   :port => "8888", :dir => '/a/writable/path', :description => 'My Own Dorsal Ring Server'
+    def initialize(_options = {})
+      @options = Methodic::get_options(_options)
+      @options.specify_defaults_values :description => Dorsal::DEFAULT_RINGSERVER_DESCRIPTION, 
+      :debug => Dorsal::DEFAULT_DEBUG, 
+      :host => Dorsal::DEFAULT_HOST, 
+      :port => Dorsal::DEFAULT_PORT, 
+      :dir => Dorsal::DEFAULT_DIR
+      @options.merge
+      @options[:dir].chomp!('/')
+      @options[:name] = Dorsal::DEFAULT_RINGSERVER_NAME
+      @options[:uri] = "druby://#{options[:host]}:#{options[:port]}"
+      Dir::mkdir(@options[:dir]) unless File::exist?(@options[:dir])
+      @options[:pid_file] = "#{@options[:dir]}/#{@options[:name]}.pid"
+      @options[:object] = Dorsal::ImplementationServer::new({ :dir => @options[:dir], :host => @options[:host], :debug => @options[:debug]})
+    end
+    
+    # accessor to ring server if up
+    # @return [DRbObject, nil] the ring server Drb Object if Up or nil
+    # @example usage
+    #   dorsal = Dorsal::Controller::new
+    #   dorsal.start_ring_server
+    #   ring = dorsal.bin_to_ring
+    def bind_to_ring
+      if ring_server_status then
+        DRb.start_service
+        return DRbObject.new nil, @options[:uri]
+      else
+        return nil
+      end
+    end
+    
+    # start the ring server if not
+    # @return [Fixnum, FalseClass] the pid of the ring server or false if already start
+    # @example usage
+    #   dorsal = Dorsal::Controller::new
+    #   dorsal.start_ring_server #=> a Fixnum for the PID
+    #   dorsal.start_ring_server #=> false
+    def start_ring_server 
+      unless ring_server_status then
+          res = start(@options) do
+            DRb.start_service(@options[:uri], @options[:object])
+            DRb.thread.join
+          end
+        return res      
+      else
+        return false
+      end
+      
+    end
+    
+    # stop the ring server if up
+    # @return [TrueClass, FalseClass] true if really shutdown, false otherwise
+    # @example usage
+    #   dorsal = Dorsal::Controller::new
+    #   dorsal.start_ring_server #=> a Fixnum for the PID
+    #   dorsal.stop_ring_server #=> true
+    #   dorsal.stop_ring_server #=> false
+    def stop_ring_server
+      if ring_server_status then
+        ring = self.bind_to_ring
+        ring.list_services.keys.each do |service|
+          ring.destroy_service :name => service
+        end
+        return stop @options
+      else
+        return false
+      end
+    end
+    
+    # return the running status of the ring server
+    # @return [TrueClass, FalseClass] true if up, false if down
+    # @example usage
+    #   dorsal = Dorsal::Controller::new
+    #   dorsal.start_ring_server #=> a Fixnum for the PID
+    #   dorsal.ring_server_status #=> true
+    #   dorsal.stop_ring_server #=> true
+    #   dorsal.ring_server_status #=> false
+    def ring_server_status
+      return status @options
+    end
+  end
+end

data/lib/dorsal/exceptions.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#---
+# Author : Romain GEORGES
+# type : gem component library
+# obj : Dorsal Module
+#---
+
+# the Dorsal Namespace
+module Dorsal
+  # Exception class override from servers errors
+  class ServerError < Exception; end
+end

data/lib/dorsal/implementation.rb

@@ -0,0 +1,151 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#---
+# Author : Romain GEORGES
+# type : gem component library
+# obj : Dorsal Module
+#---
+require 'drb'
+require 'dorsal/privates'
+
+# the dorsal namespace
+module Dorsal
+  
+  # the Ring Server DRbObject Implementation
+  # @note should NOT be instantiate
+  # @note this classe is made to be instantiate as a ring server 
+  # @private
+  class ImplementationServer
+    
+    include DRbUndumped
+    include Dorsal::Privates
+    
+    # @attr_reader [Hash] data the internal Hash of the ring server
+    # @note for debug only
+    attr_reader :data
+    
+    # the contructor of the Ring Server
+    # @param [Hash] _options the params of the constructor, keys must be symbols
+    # @note :description (default) 'Dorsal::DEFAULT_RINGSERVER_DESCRIPTION'
+    # @note :debug (default) 'Dorsal::DEFAULT_DEBUG'
+    # @note :host (default) 'Dorsal::DEFAULT_HOST'
+    # @note :port (default) 'Dorsal::DEFAULT_PORT'
+    # @note :dir (default) 'Dorsal::DEFAULT_DIR'
+    # @note :name (default) 'Dorsal::DEFAULT_RINGSERVER_NAME'
+    # @note :uri rule 'druby://(:host):(:port)'                                                                                                                                  
+    # @note :pid_file rule '(:dir)/(:name).pid' 
+    # @option _options [String] :description the description of ring server 
+    # @option _options [TrueClass,FalseClass] :debug the deubg mode  
+    # @option _options [String] :host the host for ring server and services
+    # @option _options [String] :port the port for the ring server
+    # @option _options [String] :dir the writable path for pids files
+    # @option _options [String] :name the ring server name
+    # @option _options [String] :uri the defined uri for ring server
+    # @option _options [String] :pid_file the defined pid_file for ring server
+    # @note DO NOT USE DIRECTLY
+    def initialize(_options = {})
+      @options = Methodic::get_options(_options)
+      @options.specify_defaults_values :name => 'ringserver',
+      :host => 'localhost',
+      :debug => false,
+      :dir => '/tmp/dorsal'
+      @options.merge
+      @data ={}
+    end
+
+
+    # start a service from the ring server
+    # @return [Fixnum,FalseClass] the pid of the process who host the DRb service, false if already started
+    # @param [Hash] _options the params of the constructor, keys must be symbols
+    # @option _options [String] :name the name of the service
+    # @option _options [String] :description the long name of the service, use for $0 
+    # @option _options [Object] :object an object to be served by DRb 
+    # @note access by Dorsal::Controller::new.bind_to_ring.start_service
+    # @example usage
+    #   Dorsal::Controller::new.bind_to_ring.start_service :name => 'service', :description => 'a service', :object => MyService::new
+    def start_service(_options = {})
+      options = Methodic::get_options(_options)
+      options.specify_presences_of :name, :description, :object
+      options.validate
+      unless @data.include?(options[:name]) then
+      options[:pid_file] = "#{@options[:dir]}/service-#{options[:name]}.pid"
+      options[:uri] = "druby://#{@options[:host]}:#{get_free_port(40000,50000)}"
+        @data[options[:name]] = { :description => options[:description] , :pid_file => options[:pid_file], :uri => options[:uri] }
+        return start(options) do
+          require 'drb'
+          options[:object].extend DRb::DRbUndumped
+          DRb.start_service(options[:uri], options[:object])
+          DRb.thread.join
+        end
+      else
+        return false
+      end 
+    end
+    
+    # stop a service in the ring 
+    # @return [TrueClass,FalseClass] true if really stop, false if already down
+    # @param [Hash] _options the params of the constructor, keys must be symbols
+    # @option _options [String] :name the name of the service
+    # @note access by Dorsal::Controller::new.bind_to_ring.destroy_service
+    # @example usage
+    #   Dorsal::Controller::new.bind_to_ring.destroy_service :name => 'service'
+    def destroy_service(_options = {})
+      options = Methodic::get_options(_options)
+      options.specify_presences_of :name
+      options.validate
+      if @data.include? options[:name] then
+        options[:pid_file] = @data[options[:name]][:pid_file]
+        options[:description] = @data[options[:name]][:description]
+        if stop(options) then
+          @data.delete(options[:name])  
+          return true
+        end
+        return false
+      end
+      return false
+    end
+
+
+    # bind to a service from the ring server
+    # @return [DRbObject,nil] the Distributed Service, nil if service not in the Ring
+    # @param [Hash] _options the params of the constructor, keys must be symbols
+    # @option _options [String] :name the name of the service
+    # @note access by Dorsal::Controller::new.bind_to_ring.bind_to_service
+    # @example usage
+    #   Dorsal::Controller::new.bind_to_ring.bind_to_service :name => 'service'
+    def bind_to_service(_options = {})
+      options = Methodic::get_options(_options)
+      options.specify_presences_of :name
+      options.validate
+      if list_services.include?(options[:name]) then
+        DRb.start_service
+        return DRbObject.new nil, @data[options[:name]][:uri]
+      else
+        return nil
+      end
+    end
+
+    # list the services from the ring server
+    # @return [Hash] the structured list of services in the ring
+    # @note access by Dorsal::Controller::new.bind_to_ring.list_services
+    # @example usage
+    #   Dorsal::Controller::new.bind_to_ring.list_services
+    def list_services
+      return @data
+    end
+
+    private
+    # return a free TCP port in range
+    # @param [Fixnum,String] _start the first port (default 40000)
+    # @param [Fixnum,String] _end the last port (default 50000)
+    # @return [fixnum, FalseClass] the port or false if no port found
+    def get_free_port(_start=40000,_end=50000)
+      list = IO.popen("netstat -an|grep tcp|awk '{ print $4}'").readlines.map!{|item| item.chomp! ; item = item.split('.').last}
+      _start.upto(_end) do |port|
+        return port unless list.include?(port.to_s)
+      end
+      return false
+    end
+    
+  end
+end

data/lib/dorsal/privates.rb

@@ -0,0 +1,183 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#---
+# Author : Romain GEORGES
+# type : gem component library
+# obj : Dorsal Module
+#---
+
+require 'methodic'
+
+# the Dorsal Namespace
+module Dorsal
+
+  # module mixin for privates methods for both Controller and ImplementationServer
+  # @private
+  module Privates
+
+    # method for daemonize blocks
+    # @param [Hash] _options the list of options, keys are symbols
+    # @option  _options [String] :description the description of the process, use for $0
+    # @option  _options [String] :pid_file the pid filenam
+    # @yield a process definion or block given 
+    # @example usage inline
+    #    require 'dorsal/privates'
+    #    class Test
+    #      include Dorsal::Privates
+    #      private :daemonize
+    #      def initialize
+    #        @loop = Proc::new do 
+    #          loop do
+    #            sleep 1
+    #          end
+    #        end
+    #      end
+    #      
+    #      def run
+    #        daemonize({:description => "A loop daemon", :pid_file => '/tmp/pid.file'}, &@loop)
+    #      end
+    #     end
+    # 
+    # @example usage block
+    #    require 'dorsal/privates'
+    #    class Test
+    #      include Dorsal::Privates
+    #      private :daemonize
+    #      def initialize
+    #      end
+    #      
+    #      def run
+    #        daemonize :description => "A loop daemon", :pid_file => '/tmp/pid.file' do
+    #          loop do
+    #            sleep 1
+    #          end
+    #        end
+    #      end
+    #     end
+    # @return [Fixnum] pid the pid of the forked processus 
+    def daemonize(_options)
+      options = Methodic::get_options(_options)
+      options.specify_presences_of :description, :pid_file
+      options.validate
+      return yield if options[:debug]
+      pid = fork do 
+        trap("SIGINT"){ exit! 0 }
+        trap("SIGTERM"){ exit! 0 }
+        trap("SIGHUP"){ exit! 0 }
+        Process.daemon
+        $0 = options[:description]
+        yield
+      end
+      File.open(options[:pid_file],"w"){|f| f.puts pid } if options[:pid_file]
+      return pid
+    end
+    
+    # daemonize wrapper to prevent processus cloning
+    # @param [Hash] _options the list of options, keys are symbols
+    # @option  _options [String] :description the description of the process, use for $0
+    # @option  _options [String] :pid_file the pid filenam
+    # @return [Fixnum] pid the pid of the forked processus
+    # @yield a process definion or block given 
+    # @raise [Dorsal::RingServerError] if pid_file exist or processus with the present description  
+    # @example usage inline
+    #    require 'dorsal/privates'
+    #    class Test
+    #      include Dorsal::Privates
+    #      private :start
+    #      private :daemonize
+    #      def initialize
+    #        @loop = Proc::new do 
+    #          loop do
+    #            sleep 1
+    #          end
+    #        end
+    #      end
+    #      
+    #      def run
+    #        start({:description => "A loop daemon", :pid_file => '/tmp/pid.file'}, &@loop)
+    #      end
+    #     end
+    # 
+    # @example usage block
+    #    require 'dorsal/privates'
+    #    class Test
+    #      include Dorsal::Privates
+    #      private :daemonize
+    #      private :start
+    #      def initialize
+    #      end
+    #      
+    #      def run
+    #        start :description => "A loop daemon", :pid_file => '/tmp/pid.file' do
+    #          loop do
+    #            sleep 1
+    #          end
+    #        end
+    #      end
+    #     end 
+    def start(_options = {})
+      options = Methodic::get_options(_options)
+      options.specify_presences_of :description, :pid_file
+      options.validate
+      raise Dorsal::RingServerError::new('already running, pid file exist') if File::exist?(options[:pid_file])
+      raise Dorsal::RingServerError::new('already running') unless `ps aux|grep ruby|grep -v grep |grep '#{options[:description]}'`.empty?
+      return daemonize(options) do
+        yield
+      end
+    end
+
+    # stop a running processus 
+    # @param [Hash] _options the list of options, keys are symbols
+    # @option _options [String] :description the description of the process, use for $0
+    # @option _options [String] :pid_file the pid filename
+    # @option _options [String] :name the name of the processus (OPTIONAL)
+    # @return [TrueClass,FalseClass] true if a service really closed, false otherwise
+    # @raise [Dorsal::ServerError] if can't close an existant service
+    # @example usage inline
+    #   #in the same class
+    #   def stop_service
+    #     stop :name => 'service', :description => 'A loop daemon', :pid_file => '/tmp/pid.file'
+    #   end
+    def stop(_options = {})
+      options = Methodic::get_options(_options)
+      options.specify_presences_of :description, :pid_file
+      options.validate
+      File::unlink(options[:pid_file]) if File::exist?(options[:pid_file])
+      pid = `COLUMNS=160 ps aux|grep ruby|grep -v grep |grep '#{options[:description]}'|awk '{ print $2}'`
+      if pid.empty? then
+        return false
+      else
+        if options[:name] == 'ringserver' then
+          raise Dorsal::ServerError::new('Stopping failed') unless system("kill -TERM #{pid} > /dev/null")
+        else
+          return false unless system("kill -TERM #{pid} > /dev/null")
+        end
+        return true
+      end
+    end
+
+    # give the status of a processus 
+    # @param [Hash] _options the list of options, keys are symbols
+    # @option _options [String] :description the description of the process, use for $0
+    # @option _options [String] :pid_file the pid filename
+    # @option _options [String] :name the name of the processus (OPTIONAL)
+    # @return [TrueClass,FalseClass] true if service running, false otherwise
+    # @example usage inline
+    #   #in the same class
+    #   def service_status
+    #     status :name => 'service', :description => 'A loop daemon', :pid_file => '/tmp/pid.file'
+    #   end
+    def status(_options = {})
+      options = Methodic::get_options(_options)
+      options.specify_presences_of :description, :pid_file
+      options.validate
+      pid = `COLUMNS=160 ps aux|grep ruby|grep -v grep |grep '#{options[:description]}'|awk '{ print $2}'`
+      if pid.empty? then
+        return false
+      else
+        File.open(options[:pid_file],"w"){|f| f.puts pid } unless File::exist?(options[:pid_file])
+        return true
+      end
+    end
+  end
+end

data/lib/dorsal/version.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#---
+# Author : Romain GEORGES
+# type : gem component library
+# obj : Carioca Module
+#---
+
+# the dorsal namespace
+module Dorsal
+
+  # global version of Dorsal
+  VERSION = "1.1"
+end

data/spec/dorsal_spec.rb

@@ -0,0 +1,168 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#---
+# Author : Romain GEORGES
+# type : Rspec 
+# obj : Dorsal Spec
+#---
+require 'dorsal'
+require './spec/samples/dummy'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.syntax = :should
+  end
+  config.mock_with :rspec do |c|
+    c.syntax = :should
+  end
+end
+
+
+describe "Dorsal" do
+  before :all do
+    File::unlink('/tmp/dorsal_ringserver.pid') if File::exist?('/tmp/dorsal_ringserver.pid')
+    pid = `ps aux|grep ruby|grep -v grep |grep 'Dorsal Ring Server'|awk '{ print $2}'`
+    unless pid.empty? then
+      res = `kill -TERM #{pid.chomp}`
+    end
+    $controller = Dorsal::Controller::new
+  end
+
+  subject { Dorsal }
+  it { should be_an_instance_of Module}
+  context "Dorsal::Controller" do
+    subject { $controller }
+    it { should be_an_instance_of Dorsal::Controller } 
+    context "#initialize" do
+
+    end
+    context "Attributs accessor" do
+      context "#options (RO)" do
+        it { should respond_to :options }
+        it { should_not respond_to :options= }
+        it { subject.options[:debug].should eq false }
+        it { subject.options[:uri].should eq "druby://localhost:8686" }
+        it { subject.options[:object].should be_an_instance_of Dorsal::ImplementationServer }
+        it { subject.options[:pid_file].should eq "/tmp/dorsal/ringserver.pid" }
+        it { subject.options[:name].should eq "ringserver" }
+        it { subject.options[:description].should eq "Dorsal Ring Server" }
+      end
+    end
+    context "Instance Methods" do
+      context "#start_ring_server" do
+        it { should respond_to :start_ring_server }
+        it { subject.start_ring_server.should be_an_instance_of Fixnum }
+        it "should return false if try to start twice" do
+          subject.start_ring_server.should be false
+        end
+        it "should exist an instance process of the Ring server" do 
+          pid = `ps aux|grep ruby|grep -v grep |grep 'Dorsal Ring Server'|awk '{ print $2}'`.chomp
+          pid.should_not be_empty
+        end
+        
+      end
+      
+      context "#bind_to_ring_server" do
+        it { should respond_to :bind_to_ring }
+        it "should be possible to bing distributed Ring Server" do
+          $ring = subject.bind_to_ring
+        end
+        context "Ring server Instance" do
+          it "should be an Instance of DRb::DRbObject" do 
+            $ring.should be_an_instance_of DRb::DRbObject
+          end
+          it "should Ring server respond to start_service" do
+            $ring.should respond_to :start_service 
+          end
+          it "should start a service" do 
+            $ring.start_service({ :name => 'dummy', :object => Dummy::new, :description => 'A dummy distributed service' }).should  > 0
+          end
+          it "should exist an instance process of dummy service" do 
+            pid = `ps aux|grep ruby|grep -v grep |grep 'A dummy distributed service'|awk '{ print $2}'`.chomp
+            pid.should_not be_empty
+          end
+          it "should Ring server respond to list_services" do
+            $ring.should respond_to :list_services 
+          end
+          it "should list_services return a Hash" do
+            $ring.list_services.should be_an_instance_of Hash
+          end
+          it "should list_services include 'dummy' service" do
+            $ring.list_services.should include 'dummy'
+            $ring.list_services['dummy'][:description].should eq 'A dummy distributed service'
+            $ring.list_services['dummy'][:pid_file].should eq '/tmp/dorsal/service-dummy.pid'
+            $ring.list_services['dummy'][:uri].should =~  /druby:\/\/localhost:\d+/
+          end
+          it "should exist pid_file : /tmp/dorsal/service-dummy.pid" do
+            File::exist?('/tmp/dorsal/service-dummy.pid').should be true
+          end
+          it "should ring server respond to bind_to_service" do
+            $ring.should respond_to :bind_to_service 
+          end
+          it "should bind the dummy service" do
+            $dummy = $ring.bind_to_service :name => 'dummy'
+            $dummy.should be_an_instance_of DRb::DRbObject
+            $dummy.test.should eq 'OK'
+          end
+          it "should have a running daemon instance of the service dummy" do
+            pid = `ps aux|grep ruby|grep -v grep |grep 'A dummy distributed service'|awk '{ print $2}'`.chomp
+            pid.should_not be_empty
+          end
+
+          it "should ring server respond to destroy_service" do
+            $ring.should respond_to :destroy_service 
+            
+          end
+         
+          it "should be possible to stop the dummy_service" do
+            res = $ring.destroy_service({ :name => 'dummy'})
+            res.should be true
+            $ring.list_services.should be_empty
+            
+          end
+          it "should not exist pid_file : /tmp/dorsal/service-dummy.pid" do
+            File::exist?('/tmp/dorsal/service-dummy.pid').should be false
+          end
+
+          it "should return false if trying to stop again the dummy_service" do
+            $ring.destroy_service({ :name => 'dummy'}).should be false
+          end
+
+
+        end
+      end
+      context "#ring_server_status(running)" do
+        it { should respond_to :ring_server_status }
+        it "should respond true" do
+          subject.ring_server_status.should be true
+        end
+      end
+      
+      context "#stop_ring_server" do
+        it "should re-start a service dummy for testing auto_destroy when stop Ring Server" do 
+          $ring.start_service({ :name => 'dummy', :object => Dummy::new, :description => 'A dummy distributed service' }).should  > 0
+        end
+        it { should respond_to :stop_ring_server }
+        it { subject.stop_ring_server.should eq true }
+        it "should no longer exist an instance process of the Ring server" do 
+          pid = `ps aux|grep ruby|grep -v grep |grep 'Dorsal Ring Server'|awk '{ print $2}'`.chomp
+          pid.should be_empty
+        end
+        it "should not exist an instance process of dummy service" do 
+          pid = `ps aux|grep ruby|grep -v grep |grep 'A dummy distributed service'|awk '{ print $2}'`.chomp
+          pid.should be_empty
+        end
+        it "should not exist pid_file : /tmp/dorsal/service-dummy.pid" do
+          File::exist?('/tmp/dorsal/service-dummy.pid').should be false
+        end
+       end
+
+      context "#ring_server_status(shutdown)" do
+        it "should respond false" do
+          subject.ring_server_status.should be false
+        end
+      end
+
+    end
+  end
+end

data/spec/samples/dummy.rb

@@ -0,0 +1,10 @@
+class Dummy
+
+  def initialize
+    
+  end
+
+  def test
+    return 'OK'
+  end
+end

data/ultragreen_roodi_coding_convention.yml

@@ -0,0 +1,25 @@
+AssignmentInConditionalCheck:
+CaseMissingElseCheck:
+ClassLineCountCheck:             
+  line_count: 300
+ClassNameCheck:                  
+  pattern: !ruby/regexp /^[A-Z][a-zA-Z0-9]*$/
+#ClassVariableCheck:
+CyclomaticComplexityBlockCheck:  
+  complexity: 5
+CyclomaticComplexityMethodCheck: 
+  complexity: 10
+EmptyRescueBodyCheck:
+ForLoopCheck:
+MethodLineCountCheck:            
+  line_count: 30 
+MethodNameCheck:                 
+  pattern: !ruby/regexp /^[_a-z<>=\[|+-\/\*`]+[_a-z0-9_<>=~@\[\]]*[=!\?]?$/ 
+# MissingForeignKeyIndexCheck:
+ModuleLineCountCheck:            
+  line_count: 500
+ModuleNameCheck:          
+  pattern: !ruby/regexp /^[A-Z][a-zA-Z0-9]*$/
+ParameterNumberCheck:            
+  parameter_count: 5
+ 

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: dorsal
+version: !ruby/object:Gem::Version
+  version: '1.1'
+platform: ruby
+authors:
+- Romain GEORGES
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-06-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: methodic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: 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: 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: 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: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: daemons
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 'Dorsal : Druby Objects''s Ring Server as an simple Alternative to Linda'
+email:
+- romain@ultragreen.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- doc/manual.rdoc
+- dorsal.gemspec
+- lib/dorsal.rb
+- lib/dorsal/controller.rb
+- lib/dorsal/exceptions.rb
+- lib/dorsal/implementation.rb
+- lib/dorsal/privates.rb
+- lib/dorsal/version.rb
+- spec/dorsal_spec.rb
+- spec/samples/dummy.rb
+- ultragreen_roodi_coding_convention.yml
+homepage: http://www.ultragreen.net/projects/dorsal
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.8.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: nowarning
+rubygems_version: 2.4.7
+signing_key: 
+specification_version: 4
+summary: Dorsal provide a simple and easy to use Ring Server for DRuby Objects based
+  services architectures
+test_files:
+- spec/dorsal_spec.rb
+- spec/samples/dummy.rb