rbpm 0.0.2 → 0.0.3

data/test/rbpm_simple_tests.rb

@@ -1,9 +1,14 @@
 require 'test/unit'
 
 begin
-  require 'rbpm'
+  require 'rubygems'
+  require_gem 'rbpm'
 rescue LoadError
-  require '../lib/rbpm'
+  begin
+    require '../lib/rbpm'
+  rescue LoadError
+    require 'lib/rbpm'
+  end
 end
 
 #a simple join node (this test is older than rbpm 0.0.1 ;-)

data/test/rbpm_state_tests.rb

@@ -1,9 +1,14 @@
 require 'test/unit'
 
 begin
-  require 'rbpm'
+  require 'rubygems'
+  require_gem 'rbpm'
 rescue LoadError
-  require '../lib/rbpm'
+  begin
+    require '../lib/rbpm'
+  rescue LoadError
+    require 'lib/rbpm'
+  end
 end
 
 class DemoWorkflow2 < Rbpm::Workflow

data/test/rbpm_task_role_tests.rb

@@ -1,9 +1,14 @@
 require 'test/unit'
 
 begin
-  require 'rbpm'
+  require 'rubygems'
+  require_gem 'rbpm'
 rescue LoadError
-  require '../lib/rbpm'
+  begin
+    require '../lib/rbpm'
+  rescue LoadError
+    require 'lib/rbpm'
+  end
 end
 
 #test, prototype, conceptual test - whatever

data/test/rbpm_transition_tests.rb

@@ -1,9 +1,14 @@
 require 'test/unit'
 
 begin
-  require 'rbpm'
+  require 'rubygems'
+  require_gem 'rbpm'
 rescue LoadError
-  require '../lib/rbpm'
+  begin
+    require '../lib/rbpm'
+  rescue LoadError
+    require 'lib/rbpm'
+  end
 end
 
 $mylog = {}
@@ -102,7 +107,7 @@ class RbpmTransitionActionTests < Test::Unit::TestCase
     ["no", "yes"].each do |no_yes|
       wf = TWf7.new
       t = wf.start :my_cond => no_yes
-      assert_equal (no_yes + "_end").to_sym, t.node
+      assert_equal((no_yes + "_end").to_sym, t.node)
     end
   end
 end

data/test/rbpm_versionning_tests.rb

@@ -1,13 +1,20 @@
 require 'test/unit'
 
 begin
-  require 'rbpm'
+  require 'rubygems'
+  require_gem 'rbpm'
 rescue LoadError
-  require '../lib/rbpm'
+  begin
+    require '../lib/rbpm'
+  rescue LoadError
+    require 'lib/rbpm'
+  end
 end
 
 module FooBarWorkflowVersion1
   class FooBarWorkflow 
+    def initialize(one_param)
+    end
     def foo
       "v1"
     end
@@ -19,6 +26,8 @@ end
 
 module FooBarWorkflowVersion3
   class FooBarWorkflow 
+    def initialize(one_param)
+    end
     def foo
       "v3"
     end
@@ -27,6 +36,8 @@ end
 
 module FooBarWorkflowVersion2
   class FooBarWorkflow 
+    def initialize(one_param)
+    end
     def foo
       "v2"
     end

data/test/ruby_lang_tests.rb

@@ -1,4 +1,5 @@
 require 'test/unit'
+require 'monitor'
 
 class FooClazz
   def self.foo
@@ -62,8 +63,28 @@ module MyV2
 end
 ecode
 
+def foo(&blk)
+  bar(&blk)
+end
+
+def bar(&blk)
+  blk.call "foobar"
+end
+
 class SimpleRubyLangTests < Test::Unit::TestCase
 
+ def test_sync_return
+   assert_equal 6, Monitor.new.synchronize { 6 }
+ end
+
+ def test_block_stuff
+   result = nil
+   foo do |arg|
+     result = arg
+   end
+   assert_equal "foobar", result
+ end
+
  def test_if_stuff
    a = 1
    a = 2 if false

data/test/ts_all.rb

@@ -1,34 +1,44 @@
 require 'test/unit'
 
 begin
-  require 'test/rbpm_action_tests'
-  require 'test/rbpm_ctxvars_tests.rb'           
-  require 'test/rbpm_simple_tests.rb'            
-  require 'test/rbpm_versionning_tests.rb'
-  require 'test/rbpm_call_tests.rb'              
-  require 'test/rbpm_exceptions_tests.rb'        
-  require 'test/rbpm_state_tests.rb'             
-  require 'test/rbpm_condition_tests.rb'         
-  require 'test/rbpm_fork_join_tests.rb'       
-  require 'test/rbpm_transition_tests.rb'        
-  require 'test/rbpm_task_role_tests.rb'        
+  require 'test/rbpm_action_tests.rb'
+  require 'test/rbpm_ctxvars_tests'           
+  require 'test/rbpm_simple_tests'            
+  require 'test/rbpm_versionning_tests'
+  require 'test/rbpm_call_tests'              
+  require 'test/rbpm_exceptions_tests'        
+  require 'test/rbpm_state_tests'             
+  require 'test/rbpm_condition_tests'         
+  require 'test/rbpm_fork_join_tests'       
+  require 'test/rbpm_transition_tests'        
+  require 'test/rbpm_task_role_tests'        
 
-  require 'test/ruby_lang_tests.rb'
-rescue LoadError
+  require 'test/rbpm_fs2_persistence_tests'
   
-  #there must be a better way ;)
+  require 'test/rbpm_concurrency_fine_grained_graph_programming_sync_tests.rb'
+
+  require 'test/ruby_lang_tests'
+rescue LoadError => e
+  #puts "Load Error: #{e}"
+  #puts "Load path: #{$LOAD_PATH.join(', ')}, Pwd=#{`pwd`}, ls test=#{`ls test`}"
+  
+  #there must be a better way to handle this ;)
   
   require 'rbpm_action_tests'
-  require 'rbpm_ctxvars_tests.rb'           
-  require 'rbpm_simple_tests.rb'            
-  require 'rbpm_versionning_tests.rb'
-  require 'rbpm_call_tests.rb'              
-  require 'rbpm_exceptions_tests.rb'        
-  require 'rbpm_state_tests.rb'             
-  require 'rbpm_condition_tests.rb'         
-  require 'rbpm_fork_join_tests.rb'       
-  require 'rbpm_transition_tests.rb'        
-  require 'rbpm_task_role_tests.rb'        
+  require 'rbpm_ctxvars_tests'           
+  require 'rbpm_simple_tests'            
+  require 'rbpm_versionning_tests'
+  require 'rbpm_call_tests'              
+  require 'rbpm_exceptions_tests'        
+  require 'rbpm_state_tests'             
+  require 'rbpm_condition_tests'         
+  require 'rbpm_fork_join_tests'       
+  require 'rbpm_transition_tests'        
+  require 'rbpm_task_role_tests'        
+
+  require 'rbpm_fs2_persistence_tests'
+  
+  require 'rbpm_concurrency_fine_grained_graph_programming_sync_tests.rb'
 
-  require 'ruby_lang_tests.rb'
+  require 'ruby_lang_tests'
 end

data/tutorial/README

@@ -0,0 +1,65 @@
+README * RBPM TUTORIAL
+
+(the following instructions assume that you have checked out rbpm from svn and 
+that you start all demos from the "tutorial" directory.)
+
+hello_world.rb
+	A Hello World workflow (runnable)
+	shell> ruby hello_world.rb
+
+rbpm_tutorial.rb
+	Another very simple workflow (runnable)
+	shell> ruby rbpm_tutorial.rb
+
+workflow_template.rb
+	A nonsense-workflow which uses all available rbpm node types (not runnable)
+
+sample_state_2_wf.rb
+	A more complex workflow: A fork node creates 4 child tokens. Two tokens
+	take transitions to a state node and the other 2 child tokens take
+	transitions to call node. Therefore, a sub workflow is called twice. The
+	root token of the sub workflow - which is instantiated twice - take
+	the transition to a state node. Thus, after start, there are 4 tokens
+	waiting in state nodes and need to be signaled. After all four
+	tokens have been signaled, the workflow's root token can take the
+	transition to the end node. Well, take a look at the code which is simpler
+	than this - bloody :) - description. 
+	This is a demo of the file system based workflow instance persistence.
+	(sample_state_2_wf.rb is not runnable by itself - it's only the process definition)
+
+signal_sample_state2.sh
+	Creates and starts a new workflow instance (sample_state_2_wf.rb). The workflow 
+	instance will be persisted, because at least one token is waiting in
+	a state node.
+
+start_sample_state2.sh
+	Sends a signal to a token (of a persisted workflow) waiting in a state node.
+	Every signal_sample_state2.sh call has to be followed by
+	4 start_sample_state2.sh in order to complete the workflow. This script
+	takes a token id as parameter.
+	
+	shell> ./start_sample_state2.sh 
+	arriving in :decision of SampleState2Workflow, token.ref=1
+	arriving in :no_call (state) of SampleState2Workflow, token.ref=1
+	arriving in :decision of SampleState2Workflow, token.ref=2
+	arriving in :state (state) of SampleState2SubWorkflow, token.ref=5
+	arriving in :decision of SampleState2Workflow, token.ref=3
+	arriving in :state (state) of SampleState2SubWorkflow, token.ref=6
+	arriving in :decision of SampleState2Workflow, token.ref=4
+	arriving in :no_call (state) of SampleState2Workflow, token.ref=4
+	0
+	
+	shell> ./signal_sample_state2.sh 1
+	arriving in :join of SampleState2Workflow, token.ref=1
+	
+	shell> ./signal_sample_state2.sh 5
+	arriving in :end of SampleState2SubWorkflow, token.ref=5
+	arriving in :join of SampleState2Workflow, token.ref=2
+	
+	shell> ./signal_sample_state2.sh 6
+	arriving in :end of SampleState2SubWorkflow, token.ref=6
+	arriving in :join of SampleState2Workflow, token.ref=3
+	
+	shell> ./signal_sample_state2.sh 4
+	arriving in :join of SampleState2Workflow, token.ref=4
+	arriving in :end of SampleState2Workflow, token.ref=0

data/tutorial/hello_world.rb

@@ -0,0 +1,17 @@
+begin
+  require 'rubygems'
+  require_gem 'rbpm', '>= 0.0.2'
+rescue LoadError
+  require '../lib/rbpm'
+end
+
+class HelloWorldWorkflow < Rbpm::Workflow
+  start_node :start, :trans => :end
+  end_node   :end
+  
+  leave(:start) do
+    puts "Hello World"
+  end
+end
+
+HelloWorldWorkflow.new.start

data/tutorial/rbpm_tutorial.rb

@@ -0,0 +1,46 @@
+begin
+  require 'rubygems'
+  require_gem 'rbpm', '>= 0.0.2'
+  puts "rbpm.gem loaded"
+rescue LoadError
+  require '../lib/rbpm'
+  puts "rbpm.local loaded"
+end
+
+class TutorialDemoWorkflow < Rbpm::Workflow
+  
+  start_node :start,      :trans => :hello_wait
+  state_node :hello_wait, :trans => :end
+  end_node   :end
+  
+  enter(:start) do |token,caller|
+    puts "Entering hello node"
+  end
+  
+  enter(:hello_wait) do |token,caller|
+    puts "Entering hello_wait node"
+  end
+  
+  enter(:end) do |token,caller|
+    puts "Entering end node"
+  end
+end
+
+puts "I will start the workflow now..."
+
+wf = Rbpm::WorkflowVersionManager.create_workflow_instance("TutorialDemoWorkflow")
+t = wf.start
+
+puts "And now I will send a signal to the workflow's root token..."
+
+t.signal
+
+puts "End"
+
+#Expected output:
+#   I will start the workflow now...
+#   Entering hello node
+#   Entering hello_wait node
+#   And now I will send a signal to the workflow's root token...
+#   Entering end node
+#   End

data/tutorial/sample_state_2_wf.rb

@@ -0,0 +1,56 @@
+begin
+  require 'rubygems'
+  require_gem 'rbpm', '>= 0.0.3'
+rescue LoadError
+  require '../lib/rbpm'
+end
+
+class SampleState2SubWorkflow < Rbpm::Workflow
+  start_node :start, :trans => :state
+  state_node :state, :trans => :end
+  end_node :end
+  
+  enter(:state) do |token, caller|
+    $stderr.puts "arriving in :state (state) of SampleState2SubWorkflow, token.ref=#{token.ref}"
+  end
+  
+  enter(:end) do |token, caller|
+    $stderr.puts "arriving in :end of SampleState2SubWorkflow, token.ref=#{token.ref}"
+  end
+end
+
+class SampleState2Workflow < Rbpm::Workflow
+  start_node :start, :trans => :fork
+  fork_node :fork, :trans => :decision,
+      :children_ctx => :sub_ctxs,
+      :on_enter => lambda { |token,caller| token[:sub_ctxs] = [{:call => false}, {:call => true}, {:call => true}, {:call => false}] }
+  node :decision,
+      :call_trans => :call,
+      :call_trans_cond => "token[:call]",
+      :no_call_trans => :no_call,
+      :no_call_trans_cond => "not token[:call]"
+  call_node :call, 
+      :workflow => :SampleState2SubWorkflow, 
+      :call_in => {},  
+      :call_out => {}, 
+      :trans => :join
+  state_node :no_call, :trans => :join
+  join_node :join, :trans => :end
+  end_node :end
+  
+  enter(:decision) do |token, caller|
+    $stderr.puts "arriving in :decision of SampleState2Workflow, token.ref=#{token.ref}"
+  end
+  
+  enter(:no_call) do |token, caller|
+    $stderr.puts "arriving in :no_call (state) of SampleState2Workflow, token.ref=#{token.ref}"
+  end
+  
+  enter(:join) do |token, caller|
+    $stderr.puts "arriving in :join of SampleState2Workflow, token.ref=#{token.ref}"
+  end
+  
+  enter(:end) do |token, caller|
+    $stderr.puts "arriving in :end of SampleState2Workflow, token.ref=#{token.ref}"
+  end
+end

data/tutorial/signal_sample_state2.sh

@@ -0,0 +1 @@
+./../bin/signal.sh sample_state_2_wf.rb $1 

data/tutorial/start_sample_state2.sh

@@ -0,0 +1 @@
+./../bin/start.sh sample_state_2_wf.rb SampleState2Workflow

data/tutorial/workflow_template.rb

@@ -0,0 +1,73 @@
+begin
+  require '../lib/rbpm'
+rescue LoadError 
+  require 'rubygems'
+  require_gem 'rbpm', '>= 0.0.2' #0.0.2 for transit and for Bpm:: module
+end
+
+module TemplateWorkflowVersion1
+  class TemplateWorkflow < Rbpm::Workflow
+    #nodes and transitions
+    
+    node :node_name,
+       :trans => :target_node_name,             #(shortcut for) :default_trans
+       :trans_cond => "ruby expr.",             #(optional) default="true"
+       :trans_name_trans => :target_node_name,  #2nd transition
+       :trans_name_trans_cond => "ruby expr.", #2nd transition's condition
+       :exception => :node_name                 #(optional)
+    
+    node :my_decision,
+       :success_trans => :success,
+       :success_trans_cond => "token[:bytes_transferred] > 1024",
+       :repeat_trans => :try_again,
+       :repeat_trans_cond => "token[:bytes_transferred] > 0 and token[:bytes_transferred] < 1024",
+       :failed_trans => :failed,
+       :failed_trans_cond => "token[:bytes_transferred] == 0"
+       
+    start_node :start_node_name, :trans => :target_node_name #only one start_node per workflow
+    
+    end_node :end_node_name #outgoing transitions not allowed
+    
+    state_node :state_node_name, :trans => :target_node_name
+    
+    fork_node :fork_node_name,
+        :children_ctx => :children_ctx_token_variable_name, #children_ctx token var stores initial vars of all children
+        :trans => :target_node_name                         #only one transition (default_trans) is supported
+
+    join_node :join_node_name, :trans => :end
+        
+    call_node :call_node_name, 
+        :workflow => :ChildWorkflowClassName, 
+        :workflow_version => 1,                                     #(optional) version number or :latest
+        :call_in => {:parent_wf_token_var => :child_wf_token_var},  #input-param mapping
+        :call_out => {:child_wf_token_var => :parent_wf_token_var}, #output-param mapping
+        :trans => :end                                              #only one transition (default_trans) is supported
+         
+    #event actions
+    
+    enter(:node_name) do |token,caller|
+      #modify token variables, call business delegate methods, ...
+    end
+    
+    leave(:node_name) do |token,caller|
+      #modify token variables, call business delegate methods, ...
+    end
+    
+    transit(:my_decision, :success) do |token,caller|
+      $mylog[:transit] = "foo"
+    end
+  end
+end
+
+#class ForkJoinDemoWorkflow < Rbpm::Workflow
+#  start_node :start, :trans => :fork
+#  fork_node :fork, 
+#      :trans => :join, 
+#      :children_ctx => :sub_ctxs,
+#     :on_enter => lambda { |token,caller| token[:sub_ctxs] = [{:msg => "Hello"}, {:msg => "World"}] }
+#  join_node :join, 
+#      :trans => :end,
+#      :on_enter => lambda { |token,caller| puts token[:msg] }
+#  end_node :end
+#end
+#ForkJoinDemoWorkflow.new.start #output Hello\nWorld