drbqs 0.0.3 → 0.0.4

data/README.rdoc

@@ -1,6 +1,62 @@
 = drbqs
 
-Description goes here.
+Task queuing system over network that is implemented by dRuby.
+
+== Usage
+
+=== Preparation
+
+We prepare a class to send tasks over network,
+which has data and a method to deal with tasks.
+
+We make sum.rb as the following.
+
+ class Sum
+   def initialize(start_num, end_num)
+     @num = [start_num, end_num]
+   end
+ 
+   def exec
+     (@num[0]..@num[1]).inject(0) { |sum, i| sum += i }
+   end
+ end
+
+The Sum class calculates sum of numbers from start_num to end_num.
+The task we want to calculate is summation of numbers.
+
+=== Start server
+
+We make server.rb as the following.
+
+ require_relative 'sum.rb'
+ 
+ DRbQS.define_server do |server|
+   10.step(100, 10) do |i|
+     task = DRbQS::Task.new(Sum.new(i - 10, i), :exec)
+     server.queue.add(task)
+   end
+ 
+   server.set_finish_hook do |serv|
+     serv.exit
+   end
+ end
+
+In terminal, we load server.rb and execute server of drbqs.
+
+ drbqs-server server.rb -p 13500
+
+=== Start node and connect server
+
+We type in terminal.
+
+ drbqs-node druby://localhost:13500/
+
+To use two cpu cores we execute two processes by the following.
+
+ drbqs-node 2 druby://localhost:13500/
+
+Then, if it succeeds, the calculation starts.
+If it finishes, the server and node ends.
 
 == Contributing to drbqs
  

data/Rakefile

@@ -16,7 +16,7 @@ Jeweler::Tasks.new do |gem|
   gem.homepage = "http://github.com/ytaka/drbqs"
   gem.license = "GPL3"
   gem.summary = "dRuby Queueing System"
-  gem.description = "Queuing system over network that is implemented by dRuby."
+  gem.description = "Task queuing system over network that is implemented by dRuby."
   gem.email = "d@ytak.info"
   gem.authors = ["Takayuki YAMAGUCHI"]
   # Include your dependencies below. Runtime dependencies are required when using your gem,

data/VERSION

@@ -1 +1 @@
-0.0.3
+0.0.4

data/bin/drbqs-server

@@ -0,0 +1,60 @@
+#!/usr/bin/env ruby
+
+require 'drbqs'
+require 'optparse'
+
+Version = '0.0.1'
+
+help_message =<<HELP
+#{File.basename(__FILE__)} server_definition.rb [other files ...]
+HELP
+
+options = {
+  :log_file => STDOUT
+}
+
+begin
+  OptionParser.new(help_message) do |opt|
+    opt.on('-p PORT', '--port', Integer, 'Set the port number of server.') do |v|
+      options[:port] = v
+    end
+    opt.on('--acl FILE', String, 'Set a file to define ACL.') do |v|
+      options[:acl] = v
+    end
+    opt.on('--log-file STR', String, "Set the path of log file. If this options is not set, use STDOUT.") do |v|
+      options[:log_file] = v
+    end
+    opt.on('--log-level LEVEL', String,
+           "Set the log level. The value accepts 'fatal', 'error', 'warn', 'info', and 'debug'. The default is 'error'.") do |v|
+      if /^(fatal)|(error)|(warn)|(info)|(debug)$/i =~ v
+        options[:log_level] = eval("Logger::#{v.upcase}")
+      else
+        raise "Invalid log level."
+      end
+    end
+    opt.parse!(ARGV)
+  end
+rescue OptionParser::InvalidOption
+  $stderr.print <<MES
+error: Invalid Option
+#{help_message}
+MES
+  exit(2)
+rescue OptionParser::InvalidArgument
+  $stderr.print <<MES
+error: Invalid Argument
+#{help_message}
+MES
+  exit(2)
+end
+
+if ARGV.size == 0 || !File.exist?(ARGV[0])
+  raise "Invalid arguments. Please refer '#{File.basename(__FILE__)} -h'."
+end
+
+ARGV.each do |path|
+  puts "load #{path}"
+  load path
+end
+
+DRbQS.start_server(options)

data/drbqs.gemspec

@@ -5,15 +5,14 @@
 
 Gem::Specification.new do |s|
   s.name = %q{drbqs}
-  s.version = "0.0.3"
+  s.version = "0.0.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Takayuki YAMAGUCHI"]
-  s.date = %q{2011-02-28}
-  s.default_executable = %q{drbqs-node}
-  s.description = %q{Queuing system over network that is implemented by dRuby.}
+  s.date = %q{2011-03-01}
+  s.description = %q{Task queuing system over network that is implemented by dRuby.}
   s.email = %q{d@ytak.info}
-  s.executables = ["drbqs-node"]
+  s.executables = ["drbqs-node", "drbqs-server"]
   s.extra_rdoc_files = [
     "LICENSE.txt",
     "README.rdoc"
@@ -27,6 +26,7 @@ Gem::Specification.new do |s|
     "Rakefile",
     "VERSION",
     "bin/drbqs-node",
+    "bin/drbqs-server",
     "drbqs.gemspec",
     "lib/drbqs.rb",
     "lib/drbqs/acl_file.rb",
@@ -35,6 +35,7 @@ Gem::Specification.new do |s|
     "lib/drbqs/message.rb",
     "lib/drbqs/queue.rb",
     "lib/drbqs/server.rb",
+    "lib/drbqs/server_define.rb",
     "lib/drbqs/task_client.rb",
     "spec/acl_file_spec.rb",
     "spec/data/acl.txt",

data/lib/drbqs/server.rb

@@ -21,6 +21,11 @@ module DRbQS
   class Server
     attr_reader :queue
 
+    # :port
+    # :acl
+    # :log_file
+    # :log_level
+    # :check_alive
     def initialize(opts = {})
       @port = opts[:port] || ROOT_DEFAULT_PORT
       @acl = acl_init(opts[:acl])

data/lib/drbqs/server_define.rb

@@ -0,0 +1,21 @@
+module DRbQS
+
+  @@server_create = nil
+
+  def self.define_server(&block)
+    if @@server_create
+      raise ArgumentError, "The server has already defined."
+    end
+    @@server_create = block
+  end
+
+  def self.start_server(options)
+    unless @@server_create
+      raise "Can not get server definition."
+    end
+    server = DRbQS::Server.new(options)
+    @@server_create.call(server)
+    server.start
+    server.wait
+  end
+end

data/lib/drbqs.rb

@@ -6,6 +6,8 @@ require 'drb/acl'
 require 'rinda/tuplespace'
 require 'rinda/rinda'
 
+require 'drbqs/server_define'
+
 module DRbQS
   autoload :Server, 'drbqs/server'
   autoload :Client, 'drbqs/client'

metadata

@@ -2,7 +2,7 @@
 name: drbqs
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors: 
 - Takayuki YAMAGUCHI
@@ -10,8 +10,8 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-28 00:00:00 +09:00
-default_executable: drbqs-node
+date: 2011-03-01 00:00:00 +09:00
+default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rspec
@@ -68,10 +68,11 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: *id005
-description: Queuing system over network that is implemented by dRuby.
+description: Task queuing system over network that is implemented by dRuby.
 email: d@ytak.info
 executables: 
 - drbqs-node
+- drbqs-server
 extensions: []
 
 extra_rdoc_files: 
@@ -86,6 +87,7 @@ files:
 - Rakefile
 - VERSION
 - bin/drbqs-node
+- bin/drbqs-server
 - drbqs.gemspec
 - lib/drbqs.rb
 - lib/drbqs/acl_file.rb
@@ -94,6 +96,7 @@ files:
 - lib/drbqs/message.rb
 - lib/drbqs/queue.rb
 - lib/drbqs/server.rb
+- lib/drbqs/server_define.rb
 - lib/drbqs/task_client.rb
 - spec/acl_file_spec.rb
 - spec/data/acl.txt
@@ -114,7 +117,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 4288822500604112980
+      hash: 1097812397295030278
       segments: 
       - 0
       version: "0"