Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

readme: explaining the "catchall"

closes gh-22
  • Loading branch information...
commit 38a7ed7abeef9200f39c92c881537bbacada750f 1 parent 289f6e8
@jmettraux jmettraux authored
Showing with 32 additions and 5 deletions.
  1. +32 −5 README.mdown
37 README.mdown
@@ -18,7 +18,7 @@ environment. Before running ruote-kit for the first time you need to install
Bundler (gem install bundler) and then run:
- $ bundle install
+$ bundle install
Bundler will download all the required gems and install them for you.
@@ -204,16 +204,43 @@ ruote participants may be registered using the register method of the engine.
It expects a block containing of participant and one or less _catchall_ calls.
-require 'ruote/part/no_op_participant'
+RuoteKit.engine.register do
+ participant 'no_op', Ruote::NoOpParticipant
+ catchall
+This example binds the identifier "no_op" to the `Ruote::NoOpParticipant` implementation.
+The catchall is synonymous for
+participant /.+/, Ruote::StorageParticipant
+With such a definition and since it comes last, it means that all the workitems that are not for participant "no_op" end up in the storage participant. Thus
+Ruote.define do
+ concurrence do
+ ceo
+ no_op
+ cto
+ end
+will route three concurrent workitems, one for "ceo" and one for "cto" to the storage participant (see the "workitems" tab in your ruote-kit interface) and one to "no_op", the no operation participant (which will reply immediately).
+When playing initially with ruote-kit it's probably better to leave the registration block to:
RuoteKit.engine.register do
- participant 'no-op', Ruote::NoOpParticipant
-Note that all _participant_ calls after a _catchall_ one are pretty useless:
-The catchall will eat all their cookies.
+So that all the workitems are placed in a storage participant.
If you want to learn more about ruote's participants, have a look at
Please sign in to comment.
Something went wrong with that request. Please try again.