rufus-decision 1.3.1 → 1.3.2

data/CHANGELOG.txt

@@ -2,6 +2,13 @@
 = rufus-decision CHANGELOG.txt
 
 
+== rufus-decision - 1.3.2    released 2010/05/28
+
+- ruote participant : passing the participant options to the decision table
+  Thanks Wes Gamble
+- accepting symbol or string as table option keys
+
+
 == rufus-decision - 1.3.1    released 2010/02/16
 
 - implemented Rufus::Decision::Participant, a ruote participant

data/CREDITS.txt

@@ -3,6 +3,7 @@
 
 == Feedback
 
+- Wes Gamble
 - ocgarlan
 - Fu Zhang
 

data/README.rdoc

@@ -7,10 +7,13 @@
   gem install rufus-decision
 
 
-== intro blog post
+== blog posts
 
 http://jmettraux.wordpress.com/2009/04/25/rufus-decision-11-ruby-decision-tables/
 
+http://jmettraux.wordpress.com/2010/02/17/ruote-and-decision-tables/
+
+
 
 == usage
 

data/Rakefile

@@ -37,6 +37,7 @@ CSV based Ruby decision tables
 
   gem.add_dependency 'rufus-dollar'
   gem.add_dependency 'rufus-treechecker'
+  gem.add_development_dependency 'rake'
   gem.add_development_dependency 'yard'
   gem.add_development_dependency 'jeweler'
   #gem.add_development_dependency 'ruote', '>= 2.1.7'

data/TODO.txt

@@ -11,3 +11,5 @@
 
 [ ] rufus-jig for GETting the table (304 ftw)
 
+[ ] participant : give decision table URL at runtime
+

data/examples/reimbursement.rb

@@ -0,0 +1,142 @@
+
+#
+# ruote + rufus-decision example
+#
+# featured in
+#
+#   http://jmettraux.wordpress.com/2010/02/17/ruote-and-decision-tables/
+#
+
+require 'rubygems'
+
+
+#
+# preparing the workflow engine
+
+require 'ruote'
+
+engine = Ruote::Engine.new(Ruote::Worker.new(Ruote::HashStorage.new()))
+  # for this example we use a transient, in-memory engine
+
+#engine.context.logger.noisy = true
+  # useful when debugging
+
+
+#
+# the process definition
+
+pdef = Ruote.process_definition :name => 'reimbursement', :revision => '1.0' do
+  cursor do
+    customer :task => 'fill form'
+    clerk :task => 'control form'
+    rewind :if => '${f:missing_info}'
+    determine_reimbursement_level
+    finance :task => 'reimburse customer'
+    customer :task => 'reimbursement notification'
+  end
+end
+
+
+#
+# the 'inbox/worklist' participant
+#
+# for this example, they are only STDOUT/STDIN participants
+
+class StdoutParticipant
+  include Ruote::LocalParticipant
+
+  def initialize (opts)
+  end
+
+  def consume (workitem)
+
+    puts '-' * 80
+    puts "participant : #{workitem.participant_name}"
+
+    if workitem.fields['params']['task'] == 'fill form'
+      puts " * reimbursement claim, please fill details :"
+      echo "description : "
+      workitem.fields['description'] = STDIN.gets.strip
+      echo "type of visit (doctor office / hospital visit / lab visit) : "
+      workitem.fields['type of visit'] = STDIN.gets.strip
+      echo "participating physician ? (yes or no) : "
+      workitem.fields['participating physician ?'] = STDIN.gets.strip
+    else
+      puts " . reimbursement claim :"
+      workitem.fields.each do |k, v|
+        puts "#{k} --> #{v.inspect}"
+      end
+    end
+
+    reply_to_engine(workitem)
+  end
+
+  def echo (s)
+    print(s); STDOUT.flush
+  end
+end
+
+engine.register_participant 'customer', StdoutParticipant
+engine.register_participant 'clerk', StdoutParticipant
+engine.register_participant 'finance', StdoutParticipant
+
+
+#
+# the "decision" participant
+
+#engine.register_participant 'determine_reimbursement_level' do |workitem|
+#  workitem.fields['reimbursement'] =
+#    case workitem.fields['type of visit']
+#      when 'doctor office'
+#        workitem.fields['participating physician ?'] == 'yes' ? '90%' : '50%'
+#      when 'hospital visit'
+#        workitem.fields['participating physician ?'] == 'yes' ? '0%' : '80%'
+#      when 'lab visit'
+#        workitem.fields['participating physician ?'] == 'yes' ? '0%' : '70%'
+#      else
+#        '0%'
+#    end
+#end
+
+require 'rufus/decision/participant'
+
+#engine.register_participant(
+#  'determine_reimbursement_level',
+#  Rufus::Decision::Participant,
+#  :table => %{
+#in:type of visit,in:participating physician ?,out:reimbursement
+#doctor office,yes,90%
+#doctor office,no,50%
+#hospital visit,yes,0%
+#hospital visit,no,80%
+#lab visit,yes,0%
+#lab visit,no,70%
+#  })
+
+engine.register_participant(
+  'determine_reimbursement_level',
+  Rufus::Decision::Participant,
+  :table => 'http://github.com/jmettraux/rufus-decision/raw/master/examples/reimbursement2.csv')
+
+
+#
+# running the example...
+
+puts '=' * 80
+puts "launching process"
+
+wfid = engine.launch(pdef)
+
+engine.wait_for(wfid)
+  # don't let the Ruby runtime exits until our [unique] process instance is over
+
+#ps = engine.process(wfid)
+#if ps
+#  puts ps.errors.first.message
+#  puts ps.errors.first.trace
+#end
+  # useful when debugging
+
+puts '=' * 80
+puts "done."
+

data/examples/reimbursement2.csv

@@ -0,0 +1,7 @@
+in:type of visit,in:participating physician ?,out:reimbursement
+doctor office,yes,90%
+doctor office,no,50%
+hospital visit,yes,0%
+hospital visit,no,80%
+lab visit,yes,0%
+lab visit,no,70%

data/lib/rufus/decision/participant.rb

@@ -34,6 +34,17 @@ module Rufus::Decision
   # Make sure you have the gem "rufus-decision" installed in order to
   # use this decision participant.
   #
+  #
+  # == blog post
+  #
+  # This Rufus::Decision::Participant was introduced in the "ruote and
+  # decision tables" blog post :
+  #
+  # http://jmettraux.wordpress.com/2010/02/17/ruote-and-decision-tables/
+  #
+  #
+  # == example
+  #
   # In this example, a participant named 'decide_team_member' is bound in the
   # ruote engine and, depending on the value of the workitem fields 'topic'
   # and region, sets the value of the field named 'team_member' :
@@ -72,6 +83,28 @@ module Rufus::Decision
   #
   # would thus get routed to Gilbert.
   #
+  # To learn more about decision tables :
+  #
+  # http://github.com/jmettraux/rufus-decision
+  #
+  #
+  # == pointing to a table via a URI
+  #
+  # Note that you can reference the table by its URI :
+  #
+  #   engine.register_participant(
+  #     :decide_team_member
+  #     Rufus::Decision::Participant,
+  #     :table => 'http://decisions.example.com/journalists.csv')
+  #
+  # If the table were a Google Spreadsheet, it would look like (note the
+  # trailing &output=csv) :
+  #
+  #   engine.register_participant(
+  #     :decide_team_member
+  #     Rufus::Decision::Participant,
+  #     :table => 'http://spreadsheets.google.com/pub?key=pCZNVR1TQ&output=csv')
+  #
   class Participant
     include Ruote::LocalParticipant
 
@@ -85,7 +118,7 @@ module Rufus::Decision
       table = @options['table']
       raise(ArgumentError.new("'table' option is missing")) unless table
 
-      table = Rufus::Decision::Table.new(table)
+      table = Rufus::Decision::Table.new(table, @options)
 
       workitem.fields = table.run(workitem.fields)
 

data/lib/rufus/decision/table.rb

@@ -340,7 +340,9 @@ module Decision
 
       optnames.each do |oname|
 
-        v = options[oname]
+        oname = oname.to_s
+
+        v = options[oname.intern] || options[oname]
         next unless v != nil
         instance_variable_set("@#{optnames.first.to_s}", v)
         return

data/lib/rufus/decision/version.rb

@@ -1,7 +1,7 @@
 
 module Rufus
 module Decision
-  VERSION = '1.3.1'
+  VERSION = '1.3.2'
 end
 end
 

data/rufus-decision.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rufus-decision}
-  s.version = "1.3.1"
+  s.version = "1.3.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["John Mettraux"]
-  s.date = %q{2010-02-16}
+  s.date = %q{2010-05-28}
   s.default_executable = %q{rufus_decide}
   s.description = %q{
 CSV based Ruby decision tables
@@ -40,6 +40,8 @@ CSV based Ruby decision tables
      "examples/journalists.rb",
      "examples/readme_example.rb",
      "examples/reimbursement.csv",
+     "examples/reimbursement.rb",
+     "examples/reimbursement2.csv",
      "lib/rufus-decision.rb",
      "lib/rufus/decision.rb",
      "lib/rufus/decision/hashes.rb",
@@ -66,7 +68,7 @@ CSV based Ruby decision tables
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{rufus}
-  s.rubygems_version = %q{1.3.5}
+  s.rubygems_version = %q{1.3.6}
   s.summary = %q{CSV based Ruby decision tables}
   s.test_files = [
     "test/test.rb"
@@ -79,17 +81,20 @@ CSV based Ruby decision tables
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<rufus-dollar>, [">= 0"])
       s.add_runtime_dependency(%q<rufus-treechecker>, [">= 0"])
+      s.add_development_dependency(%q<rake>, [">= 0"])
       s.add_development_dependency(%q<yard>, [">= 0"])
       s.add_development_dependency(%q<jeweler>, [">= 0"])
     else
       s.add_dependency(%q<rufus-dollar>, [">= 0"])
       s.add_dependency(%q<rufus-treechecker>, [">= 0"])
+      s.add_dependency(%q<rake>, [">= 0"])
       s.add_dependency(%q<yard>, [">= 0"])
       s.add_dependency(%q<jeweler>, [">= 0"])
     end
   else
     s.add_dependency(%q<rufus-dollar>, [">= 0"])
     s.add_dependency(%q<rufus-treechecker>, [">= 0"])
+    s.add_dependency(%q<rake>, [">= 0"])
     s.add_dependency(%q<yard>, [">= 0"])
     s.add_dependency(%q<jeweler>, [">= 0"])
   end

data/test/dt_0_basic.rb

@@ -292,6 +292,14 @@ e,f,2
     do_test(table, wi, { 'fz' => '3' }, false)
   end
 
+  def test_ruby_eval_string_key
+
+    table = Rufus::Decision::Table.new(CSV9, 'ruby_eval' => true)
+
+    wi = { 'fx' => 'c', 'fy' => 'd' }
+    do_test(table, wi, { 'fz' => '3' }, false)
+  end
+
   CSV10 = %{
 in:fx,in:fx,out:fz
 >90,<92,ok

metadata

@@ -1,7 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: rufus-decision
 version: !ruby/object:Gem::Version 
-  version: 1.3.1
+  prerelease: false
+  segments: 
+  - 1
+  - 3
+  - 2
+  version: 1.3.2
 platform: ruby
 authors: 
 - John Mettraux
@@ -9,49 +14,69 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-16 00:00:00 +09:00
+date: 2010-05-28 00:00:00 +09:00
 default_executable: rufus_decide
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rufus-dollar
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 0
         version: "0"
-    version: 
+  type: :runtime
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: rufus-treechecker
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
   type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 0
         version: "0"
-    version: 
+  type: :development
+  version_requirements: *id003
 - !ruby/object:Gem::Dependency 
   name: yard
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 0
         version: "0"
-    version: 
+  type: :development
+  version_requirements: *id004
 - !ruby/object:Gem::Dependency 
   name: jeweler
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 0
         version: "0"
-    version: 
+  type: :development
+  version_requirements: *id005
 description: "\n\
   CSV based Ruby decision tables\n  "
 email: jmettraux@gmail.com
@@ -82,6 +107,8 @@ files:
 - examples/journalists.rb
 - examples/readme_example.rb
 - examples/reimbursement.csv
+- examples/reimbursement.rb
+- examples/reimbursement2.csv
 - lib/rufus-decision.rb
 - lib/rufus/decision.rb
 - lib/rufus/decision/hashes.rb
@@ -116,18 +143,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: rufus
-rubygems_version: 1.3.5
+rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: CSV based Ruby decision tables