bumbleworks 0.0.55 → 0.0.56

data/README.md

@@ -33,18 +33,23 @@ Bumbleworks.configure do |c|
   # c.storage = {}
 end
 
-# this next block is optional - it's only needed
-# if you want to load custom participants
-Bumbleworks.register_participants do
-  # foo FooParticipant
-  # bar BarParticipant
-  # ...
-end
-
-# Load all process definitions in lib/process_definitions
-Bumbleworks.load_definitions!
-
-# Start a worker in the background
+# Initialize Bumbleworks (autoloads necessary classes/modules)
+Bumbleworks.initialize!
+
+# Optionally, bootstrap in the initializer - don't do this in
+# production, since every time this file is loaded, definitions and
+# participant registrations will be overwritten, which will cause
+# problems with any running workers.  But if you've configured
+# a Hash storage (see above) for dev/test, you have to bootstrap within
+# the same process.
+# In production, you'd separately run the `bumbleworks:bootstrap` rake
+# task to load definitions and participant registration.
+Bumbleworks.bootstrap!
+
+# Start a worker in the background - this, too, should not be done
+# in the initializer in a production environment - instead, the worker
+# should be run in a separate process, using the `bumbleworks:start_worker`
+# rake task.
 Bumbleworks.start_worker!
 ```
 
@@ -129,6 +134,27 @@ Bumbleworks.configure do |c|
 end
 ```
 
+### Participant Registration File
+
+If your app has a `participants.rb` file at Bumbleworks.root (see Determining the Root Directory), Bumbleworks will load this file when you run `Bumbleworks.bootstrap!` (or run the `bumbleworks:bootstrap` rake task), which will create the registered participant list.  The file should contain a block such as the following:
+
+```ruby
+Bumbleworks.register_participants do
+  # foo FooParticipant
+  # bar BarParticipant
+  # ...
+end
+```
+
+You can customize the path to this file by setting Bumbleworks.participant_registration_file:
+
+```ruby
+Bumbleworks.configure do |c|
+  c.participant_registration_file = '/absolute/path/to/participant/registration/file.rb'
+  # ...
+end
+```
+
 ### Determining the Root Directory
 
 By default, Bumbleworks will attempt in several ways to find your root directory.  In the most common cases (Rails, Sinatra, or Rory), it usually won't have trouble guessing the directory.  The default `Bumbleworks.root` directory will be the framework's root with `lib/bumbleworks` appended.
@@ -150,7 +176,7 @@ Process definitions are just ruby files with blocks following Ruote's [Ruby DSL
 To actually load your process definitions from the directory:
 
 ```ruby
-Bumbleworks.load_definitions!
+Bumbleworks.bootstrap!
 ```
 
 Keep in mind that any changed process definitions will overwrite previously loaded ones - in other words, after running this command successfully, all process definitions loaded into Bumbleworks will be in sync with the files in your definitions directory.
@@ -172,6 +198,8 @@ end
 
 Unless you add it yourself, Bumbleworks will register a "catchall" participant at the end of your participant list, which will catch any workitems not picked up by a participant higher in the list.  Those workitems then fall into ruote's StorageParticipant, from where Bumbleworks will assemble its task queue.
 
+This block should be placed in the Participant Registration File (see above), and then it will automatically be loaded when running `Bumbleworks.bootstrap!` (or the `bumbleworks:bootstrap` rake task).
+
 ### Starting Work
 
 Without running a "worker," Bumbleworks won't do anything behind the scenes - no workitems will proceed through their workflow, no schedules will be checked, etc.  Running a worker is done using the following command:
@@ -182,7 +210,7 @@ Bumbleworks.start_worker!
 
 You can add this to the end of your initializer, but, while this is handy in development and testing, it's not a good practice to follow in production.  In an actual production environment, you will likely have multiple workers running in their own threads, or even on separate servers.  So the **preferred way** is to call the `Bumbleworks.start_worker!` method outside of the initializer, most likely in a Rake task that has your environment loaded.
 
-> Strictly speaking, the entire environment doesn't need to be loaded; only Bumbleworks.storage needs to be set before starting a worker.  However, it's best practice to configure Bumbleworks in one place, to ensure you don't get your storage configurations out of sync.
+> Strictly speaking, the entire environment doesn't need to be loaded; only Bumbleworks.storage and Bumbleworks.root need to be set (the latter will have a reasonable default if using a popular framework), and `Bumbleworks.initialize!` must be run, before starting a worker.  However, it's best practice to configure Bumbleworks in one place, to ensure you don't get your storage configurations out of sync.
 
 You can run as many workers as you want in parallel, and as long as they're accessing the same storage, no concurrency issues should arise.
 
@@ -226,9 +254,9 @@ The tasks are:
 
   This task starts a Bumbleworks worker, and does not return.  It will expect Bumbleworks to be required and for Bumbleworks' storage to be configured.
 
-2. `rake bumbleworks:reload_definitions`
+2. `rake bumbleworks:bootstrap`
 
-  All process definitions will be reloaded from the configured `definitions_directory`.
+  All process definitions will be loaded from the configured `definitions_directory`, and the participant registration file (at the configured `participant_registration_file` path) will be loaded.  This operation will overwrite the current definitions and participant list, which is fine as long as no workers are currently running.
 
 ## Contributing
 

data/doc/QUICKSTART.md

@@ -28,7 +28,7 @@
         c.storage = Redis.new
     end
 
-    Bumbleworks.load_definitions!
+    Bumbleworks.initialize!
   ```
 
 1. Add your first process definition at `lib/bumbleworks/process_definitions/` (or `lib/bumbleworks/processes`):
@@ -43,25 +43,19 @@
 
 1. (*optional*) Put any [custom participants](http://ruote.rubyforge.org/implementing_participants.html) in `lib/bumbleworks/participants`.
 
-1. Create an initializer file (e.g. `config/initializers/bumbleworks.rb` for Rails) with the following:
+1. (*optional*) Create a participant registration file at `lib/bumbleworks/participants.rb` with the following:
 
   ```ruby
-    Bumbleworks.configure do |c|
-        c.storage = Hash.new
-    end
-
-    # this next block is optional - it's only needed
-    # if you want to load custom participants
     Bumbleworks.register_participants do
         # foo FooParticipant
         # bar BarParticipant
-        # ...
+        # ... any other custom participants you created
     end
-
-    Bumbleworks.load_definitions!
-    Bumbleworks.start_worker!
   ```
 
+1. Run the `bumbleworks:bootstrap` rake task to load your process definitions and participant list
+into your process storage (the Redis database).
+
 1. You can now launch processes using `Bumbleworks.launch!('process_definition_name')`.  `#launch!` takes a hash as an optional second argument - anything set here will become workitem fields.  A special key, `:entity`, can be used to specify a persistent business entity for the process, which will be retrievable from process tasks (using `Task#entity`).
 
 1. Any expressions of the form `[role] :task => [task_name]` will be turned into tasks retrievable at `Bumbleworks::Task.all`; you can get tasks specific to a role or roles using `Bumbleworks::Task.for_roles([role1, role2, ...])`.

data/lib/bumbleworks.rb

@@ -102,14 +102,30 @@ module Bumbleworks
     #     plumber PlumberClass
     #   end
     def register_participants(&block)
-      Bumbleworks::ParticipantRegistration.autoload_all
+      autoload_participants
       Bumbleworks::Ruote.register_participants(&block)
     end
 
+    # @public
+    # Syntactic sugar to register participants without supplying a
+    # block - ends up registering only default participants (such
+    # as the error handler and storage).
+    #
+    def register_default_participants
+      register_participants
+    end
+
+    # @public
+    # Autoloads all files in the configured participants_directory.
+    #
+    def autoload_participants
+      Bumbleworks::ParticipantRegistration.autoload_all
+    end
+
     # @public
     # Autoloads all files in the configured tasks_directory.
     #
-    def register_tasks(&block)
+    def autoload_tasks
       Bumbleworks::Task.autoload_all
     end
 
@@ -118,7 +134,9 @@ module Bumbleworks
     # with the Ruote engine.
     #
     def load_definitions!(options = {})
-      Bumbleworks::ProcessDefinition.create_all_from_directory!(definitions_directory, options)
+      if directory = definitions_directory
+        Bumbleworks::ProcessDefinition.create_all_from_directory!(directory, options)
+      end
     end
 
     # @public
@@ -130,6 +148,23 @@ module Bumbleworks
       Bumbleworks::Ruote.reset!
     end
 
+    # @public
+    # Autoloads all necessary files for the Bumbleworks environment
+    #
+    def initialize!
+      autoload_tasks
+      autoload_participants
+    end
+
+    # @public
+    # Loads process definitions, and loads participant registration file at
+    # configured participant_registration_file path.
+    #
+    def bootstrap!(options = {})
+      load_definitions!(options)
+      Bumbleworks::ParticipantRegistration.register!
+    end
+
     # @public
     # Launches the process definition with the given process name, as long as
     # that definition name is already registered with Bumbleworks.  If options

data/lib/bumbleworks/configuration.rb

@@ -49,7 +49,11 @@ module Bumbleworks
 
     # Path to the folder which holds the ruote definition files. Bumbleworks
     # will load all definition files by recursively traversing the directory
-    # tree under this folder. No specific loading order is guaranteed
+    # tree under this folder. No specific loading order is guaranteed.
+    # These definition files will be loaded when Bumbleworks.bootstrap! is
+    # called, not Bootstrap.initialize! (since you don't want to re-register
+    # the participant list every time Bumbleworks is set up, but rather as an
+    # explicit task, for instance on deploy).
     #
     # default: ${Bumbleworks.root}/process_definitions then ${Bumbleworks.root}/processes
     define_setting :definitions_directory
@@ -69,6 +73,14 @@ module Bumbleworks
     # default: ${Bumbleworks.root}/tasks
     define_setting :tasks_directory
 
+    # Path to the file in which participant registration is defined.  This file will
+    # be `load`ed when Bumbleworks.bootstrap! is called, not Bootstrap.initialize!
+    # (since you don't want to re-register the participant list every time Bumbleworks
+    # is set up, but rather as an explicit task, for instance on deploy).
+    #
+    # default: ${Bumbleworks.root}/participants.rb
+    define_setting :participant_registration_file
+
     # Bumbleworks requires a dedicated key-value storage for process information.  Three
     # storage solutions are currently supported: Hash, Redis and Sequel.  The latter
     # two require the bumbleworks-redis and bumbleworks-sequel gems, respectively.
@@ -160,6 +172,7 @@ module Bumbleworks
     def initialize
       @storage_adapters = []
       @storage_options = {}
+      @cached_paths = {}
       @timeout ||= 5
     end
 
@@ -168,7 +181,10 @@ module Bumbleworks
     # relative to Bumbleworks.root.
     #
     def definitions_directory
-      @definitions_folder ||= default_definition_directory
+      @cached_paths[:definitions_directory] ||= look_up_configured_path(
+        :definitions_directory,
+        :defaults => ['process_definitions', 'processes']
+      )
     end
 
     # Path where Bumbleworks will look for ruote participants to load.
@@ -176,7 +192,10 @@ module Bumbleworks
     # relative to Bumbleworks.root.
     #
     def participants_directory
-      @participants_folder ||= default_participant_directory
+      look_up_configured_path(
+        :participants_directory,
+        :defaults => ['participants']
+      )
     end
 
     # Path where Bumbleworks will look for task modules to load.
@@ -184,7 +203,22 @@ module Bumbleworks
     # relative to Bumbleworks.root.
     #
     def tasks_directory
-      @tasks_folder ||= default_tasks_directory
+      @cached_paths[:tasks_directory] ||= look_up_configured_path(
+        :tasks_directory,
+        :defaults => ['tasks']
+      )
+    end
+
+    # Path where Bumbleworks will look for the participant registration
+    # file. The path can be relative or absolute.  Relative paths are
+    # relative to Bumbleworks.root.
+    #
+    def participant_registration_file
+      @cached_paths[:participant_registration_file] ||= look_up_configured_path(
+        :participant_registration_file,
+        :defaults => ['participants.rb'],
+        :file => true
+      )
     end
 
     # Default history storage to true
@@ -250,14 +284,15 @@ module Bumbleworks
     def clear!
       defined_settings.each {|setting| instance_variable_set("@#{setting}", nil)}
       @storage_adapters = []
-      @definitions_folder = @participants_folder = @tasks_folder = nil
+      @cached_paths = {}
     end
 
     def error_handlers
       @error_handlers ||= [Bumbleworks::ErrorLogger]
     end
 
-    private
+  private
+
     def defined_settings
       self.class.defined_settings
     end
@@ -271,41 +306,46 @@ module Bumbleworks
       end
     end
 
-    def default_definition_directory
-      default_folders = ['process_definitions', 'processes']
-      find_folder(default_folders, @definitions_directory, "Definitions folder not found")
+    def path_resolves?(path, options = {})
+      if options[:file]
+        File.file?(path.to_s)
+      else
+        File.directory?(path.to_s)
+      end
     end
 
-    def default_participant_directory
-      default_folders = ['participants']
-      find_folder(default_folders, @participants_directory, "Participants folder not found")
+    def user_configured_path(path_type)
+      user_defined_path = instance_variable_get("@#{path_type}")
+      if user_defined_path
+        if user_defined_path[0] == '/'
+          user_defined_path
+        else
+          File.join(root, user_defined_path)
+        end
+      end
     end
 
-    def default_tasks_directory
-      default_folders = ['tasks']
-      find_folder(default_folders, @tasks_directory, "Tasks folder not found")
+    def first_existing_default_path(possible_paths, options = {})
+      defaults = [possible_paths].flatten.compact.map { |d| File.join(root, d) }
+      defaults.detect do |default|
+        path_resolves?(default, :file => options[:file])
+      end
     end
 
-    def find_folder(default_directories, user_defined_directory, message)
-      if user_defined_directory
-        # use user-defined directory if specified
-        defined_directory = if user_defined_directory[0] == '/'
-          user_defined_directory
+    # If the user explicitly declared a path, raises an exception if the
+    # path was not found.  Missing default paths do not raise an exception
+    # since no paths are required.
+    def look_up_configured_path(path_type, options = {})
+      return @cached_paths[path_type] if @cached_paths.has_key?(path_type)
+      if user_defined_path = user_configured_path(path_type)
+        if path_resolves?(user_defined_path, :file => options[:file])
+          return user_defined_path
         else
-          File.join(root, user_defined_directory)
-        end
-      else
-        # next look in default directory structure
-        defined_directory = default_directories.detect do |default_folder|
-          folder = File.join(root, default_folder)
-          next unless File.directory?(folder)
-          break folder
+          raise Bumbleworks::InvalidSetting, "#{Bumbleworks::Support.humanize(path_type)} not found (looked for #{user_defined_path || defaults.join(', ')})"
         end
       end
 
-      return defined_directory if File.directory?(defined_directory.to_s)
-
-      raise Bumbleworks::InvalidSetting, "#{message} (looked in #{user_defined_directory || default_directories.join(', ')})"
+      first_existing_default_path(options[:defaults], :file => options[:file])
     end
   end
 end

data/lib/bumbleworks/participant_registration.rb

@@ -9,9 +9,18 @@ module Bumbleworks
       # should define `GoatChallenge`.
       #
       def autoload_all(options = {})
-        options[:directory] ||= Bumbleworks.participants_directory
-        Bumbleworks::Support.all_files(options[:directory], :camelize => true).each do |path, name|
-          Object.autoload name.to_sym, path
+        if directory = options[:directory] || Bumbleworks.participants_directory
+          Bumbleworks::Support.all_files(directory, :camelize => true).each do |path, name|
+            Object.autoload name.to_sym, path
+          end
+        end
+      end
+
+      def register!(options = {})
+        if file = options[:file] || Bumbleworks.participant_registration_file
+          Kernel.load file
+        else
+          Bumbleworks.register_default_participants
         end
       end
     end

data/lib/bumbleworks/support.rb

@@ -34,7 +34,7 @@ module Bumbleworks
 
     def tokenize(string)
       return nil if string.nil?
-      string = string.gsub(/&/, ' and ').
+      string = string.to_s.gsub(/&/, ' and ').
         gsub(/[ \/]+/, '_').
         gsub(/([a-z\d])([A-Z])/,'\1_\2').
         downcase

data/lib/bumbleworks/task.rb

@@ -25,9 +25,10 @@ module Bumbleworks
       # should define `ChewCudTask`.
       #
       def autoload_all(options = {})
-        options[:directory] ||= Bumbleworks.tasks_directory
-        Bumbleworks::Support.all_files(options[:directory], :camelize => true).each do |path, name|
-          Object.autoload name.to_sym, path
+        if directory = options[:directory] || Bumbleworks.tasks_directory
+          Bumbleworks::Support.all_files(directory, :camelize => true).each do |path, name|
+            Object.autoload name.to_sym, path
+          end
         end
       end
 

data/lib/bumbleworks/version.rb

@@ -1,3 +1,3 @@
 module Bumbleworks
-  VERSION = "0.0.55"
+  VERSION = "0.0.56"
 end

data/lib/tasks/bumbleworks.rake

@@ -5,10 +5,10 @@ namespace :bumbleworks do
     Bumbleworks.start_worker!(:join => true, :verbose => verbose)
   end
 
-  desc 'Reload all process definitions from directory'
-  task :reload_definitions => :environment do
-    puts "Reloading all Bumbleworks process definitions..." if verbose == true
-    Bumbleworks.load_definitions!(:verbose => verbose)
+  desc 'Load process definitions and participant list'
+  task :bootstrap => :environment do
+    puts "Bootstrapping Bumbleworks definitions and participant list..." if verbose == true
+    Bumbleworks.bootstrap!(:verbose => verbose)
   end
 
   desc 'Launch a given Bumbleworks process'

data/spec/fixtures/apps/with_default_directories/full_initializer.rb

@@ -3,11 +3,6 @@ Bumbleworks.configure! do |c|
   c.storage = {}
 end
 
-Bumbleworks.register_participants do
-  honey_maker    HoneyParticipant
-  molasses_maker MolassesParticipant
-end
-
-Bumbleworks.register_tasks
-Bumbleworks.load_definitions!
+Bumbleworks.bootstrap!
+Bumbleworks.initialize!
 Bumbleworks.start_worker!

data/spec/fixtures/apps/with_default_directories/participants.rb

@@ -0,0 +1,4 @@
+Bumbleworks.register_participants do
+  honey_maker    HoneyParticipant
+  molasses_maker MolassesParticipant
+end

data/spec/lib/bumbleworks/configuration_spec.rb

@@ -92,23 +92,18 @@ describe Bumbleworks::Configuration do
       configuration.definitions_directory.should == '/Root/processes'
     end
 
-    it 'raises an error if default folder not found' do
+    it 'returns nil if default folder not found' do
       configuration.root = '/Root'
-      expect {
-        configuration.definitions_directory
-      }.to raise_error(
-        Bumbleworks::InvalidSetting,
-        "Definitions folder not found (looked in process_definitions, processes)"
-      )
+      configuration.definitions_directory.should be_nil
     end
 
-    it 'raises an error if specific folder not found' do
+    it 'raises error if specific folder not found' do
       configuration.definitions_directory = '/mumbo/jumbo'
       expect {
         configuration.definitions_directory
       }.to raise_error(
         Bumbleworks::InvalidSetting,
-        "Definitions folder not found (looked in /mumbo/jumbo)"
+        "Definitions directory not found (looked for /mumbo/jumbo)"
       )
     end
   end
@@ -126,23 +121,18 @@ describe Bumbleworks::Configuration do
       configuration.participants_directory.should == '/Root/participants'
     end
 
-    it 'raises an error if default folder not found' do
+    it 'returns nil if default folder not found' do
       configuration.root = '/Root'
-      expect {
-        configuration.participants_directory
-      }.to raise_error(
-        Bumbleworks::InvalidSetting,
-        "Participants folder not found (looked in participants)"
-      )
+      configuration.participants_directory.should be_nil
     end
 
-    it 'raises an error if specific folder not found' do
+    it 'raises error if specific folder not found' do
       configuration.participants_directory = '/mumbo/jumbo'
       expect {
         configuration.participants_directory
       }.to raise_error(
         Bumbleworks::InvalidSetting,
-        "Participants folder not found (looked in /mumbo/jumbo)"
+        "Participants directory not found (looked for /mumbo/jumbo)"
       )
     end
   end
@@ -160,23 +150,47 @@ describe Bumbleworks::Configuration do
       configuration.tasks_directory.should == '/Root/tasks'
     end
 
-    it 'raises an error if default folder not found' do
+    it 'returns nil if default folder not found' do
       configuration.root = '/Root'
+      configuration.tasks_directory.should be_nil
+    end
+
+    it 'raises error if specific folder not found' do
+      configuration.tasks_directory = '/mumbo/jumbo'
       expect {
         configuration.tasks_directory
       }.to raise_error(
         Bumbleworks::InvalidSetting,
-        "Tasks folder not found (looked in tasks)"
+        "Tasks directory not found (looked for /mumbo/jumbo)"
       )
     end
+  end
 
-    it 'raises an error if specific folder not found' do
-      configuration.tasks_directory = '/mumbo/jumbo'
+  describe "#participant_registration_file" do
+    it 'returns the path which was set by the client app' do
+      File.stub(:file?).with('/can/i/get/a/rooster.rb').and_return(true)
+      configuration.participant_registration_file = '/can/i/get/a/rooster.rb'
+      configuration.participant_registration_file.should == '/can/i/get/a/rooster.rb'
+    end
+
+    it 'returns the default folder if not set by client app' do
+      File.stub(:file?).with('/Root/participants.rb').and_return(true)
+      configuration.root = '/Root'
+      configuration.participant_registration_file.should == '/Root/participants.rb'
+    end
+
+    it 'returns nil if default path not found' do
+      configuration.root = '/Root'
+      configuration.participant_registration_file.should be_nil
+    end
+
+    it 'raises error if specific path not found' do
+      configuration.participant_registration_file = '/do/not/eat/friendly/people.rb'
       expect {
-        configuration.tasks_directory
+        configuration.participant_registration_file
       }.to raise_error(
         Bumbleworks::InvalidSetting,
-        "Tasks folder not found (looked in /mumbo/jumbo)"
+        "Participant registration file not found (looked for /do/not/eat/friendly/people.rb)"
       )
     end
   end

data/spec/lib/bumbleworks/participant_registration_spec.rb

@@ -1,13 +1,48 @@
 describe Bumbleworks::ParticipantRegistration do
+  before(:each) do
+    Bumbleworks.reset!
+    Bumbleworks.root = File.join(fixtures_path, 'apps', 'with_default_directories')
+  end
+
   describe '.autoload_all' do
     it 'autoloads all participants in directory' do
-      Bumbleworks.reset!
-      Bumbleworks.root = File.join(fixtures_path, 'apps', 'with_default_directories')
       Object.should_receive(:autoload).with(:HoneyParticipant,
         File.join(Bumbleworks.root, 'participants', 'honey_participant.rb'))
       Object.should_receive(:autoload).with(:MolassesParticipant,
         File.join(Bumbleworks.root, 'participants', 'molasses_participant.rb'))
-      Bumbleworks::ParticipantRegistration.autoload_all
+      described_class.autoload_all
+    end
+
+    it 'does nothing if using default path and directory does not exist' do
+      Bumbleworks.root = File.join(fixtures_path, 'apps', 'minimal')
+      described_class.autoload_all
+    end
+
+    it 'raises exception if using custom path and participants file does not exist' do
+      Bumbleworks.participants_directory = 'oysters'
+      expect {
+        described_class.autoload_all
+      }.to raise_error(Bumbleworks::InvalidSetting)
+    end
+  end
+
+  describe '.register!' do
+    it 'loads registration file' do
+      Kernel.should_receive(:load).with(File.join(Bumbleworks.root, 'participants.rb'))
+      described_class.register!
+    end
+
+    it 'registers default participants if using default path and file does not exist' do
+      Bumbleworks.root = File.join(fixtures_path, 'apps', 'minimal')
+      Bumbleworks.should_receive(:register_default_participants)
+      described_class.register!
+    end
+
+    it 'raises exception if using custom path and participants file does not exist' do
+      Bumbleworks.participant_registration_file = 'oysters'
+      expect {
+        described_class.register!
+      }.to raise_error(Bumbleworks::InvalidSetting)
     end
   end
 end

data/spec/lib/bumbleworks/support_spec.rb

@@ -72,6 +72,10 @@ describe Bumbleworks::Support do
     it 'returns nil if given nil' do
       described_class.tokenize(nil).should be_nil
     end
+
+    it 'also handles symbols' do
+      described_class.tokenize(:yourFaceIsNice).should == 'your_face_is_nice'
+    end
   end
 
   describe '.humanize' do

data/spec/lib/bumbleworks/task_spec.rb

@@ -34,7 +34,20 @@ describe Bumbleworks::Task do
         File.join(Bumbleworks.root, 'tasks', 'make_some_honey_task.rb'))
       Object.should_receive(:autoload).with(:TasteThatMolassesTask,
         File.join(Bumbleworks.root, 'tasks', 'taste_that_molasses_task.rb'))
-      Bumbleworks::Task.autoload_all
+      described_class.autoload_all
+    end
+
+    it 'does nothing if using default path and directory does not exist' do
+      Bumbleworks.root = File.join(fixtures_path, 'apps', 'minimal')
+      described_class.autoload_all
+    end
+
+    it 'raises exception if using custom path and participants file does not exist' do
+      Bumbleworks.root = File.join(fixtures_path, 'apps', 'minimal')
+      Bumbleworks.tasks_directory = 'oysters'
+      expect {
+        described_class.autoload_all
+      }.to raise_error(Bumbleworks::InvalidSetting)
     end
   end
 

data/spec/lib/bumbleworks_spec.rb

@@ -60,29 +60,76 @@ describe Bumbleworks do
     end
   end
 
-  describe '.register_tasks' do
+  describe '.autoload_tasks' do
     it 'autoloads task modules' do
       Bumbleworks::Task.should_receive(:autoload_all)
-      described_class.register_tasks
+      described_class.autoload_tasks
+    end
+  end
+
+  describe '.autoload_participants' do
+    it 'autoloads participant classes' do
+      Bumbleworks::ParticipantRegistration.should_receive(:autoload_all)
+      described_class.autoload_participants
+    end
+  end
+
+  describe '.initialize!' do
+    it 'autoloads task modules and participant classes' do
+      described_class.should_receive(:autoload_participants)
+      described_class.should_receive(:autoload_tasks)
+      described_class.initialize!
     end
   end
 
   describe '.register_participants' do
-    it 'autoloads and registers participants' do
+    it 'autoloads participant classes and registers given participant list' do
       the_block = lambda {  }
-      Bumbleworks::ParticipantRegistration.should_receive(:autoload_all)
+      described_class.should_receive(:autoload_participants)
       Bumbleworks::Ruote.should_receive(:register_participants).with(&the_block)
       described_class.register_participants &the_block
     end
   end
 
+  describe '.register_default_participants' do
+    it 'registers default participants' do
+      described_class.should_receive(:autoload_participants).never
+      described_class.should_receive(:register_participants)
+      described_class.register_default_participants
+    end
+  end
+
   describe '.load_definitions!' do
     it 'creates all definitions from directory' do
       described_class.stub(:definitions_directory).and_return(:defs_dir)
-      described_class.storage = {}
+      # described_class.storage = {}
       Bumbleworks::ProcessDefinition.should_receive(:create_all_from_directory!).with(:defs_dir, :fake_options)
       described_class.load_definitions!(:fake_options)
     end
+
+    it 'does nothing if using default path and directory does not exist' do
+      described_class.reset!
+      described_class.root = File.join(fixtures_path, 'apps', 'minimal')
+      Bumbleworks::ProcessDefinition.should_receive(:create_all_from_directory!).never
+      described_class.load_definitions!
+    end
+
+    it 'raises exception if using custom path and directory does not exist' do
+      described_class.reset!
+      described_class.root = File.join(fixtures_path, 'apps', 'minimal')
+      described_class.definitions_directory = 'oysters'
+      expect {
+        described_class.load_definitions!
+      }.to raise_error(Bumbleworks::InvalidSetting)
+    end
+  end
+
+  describe '.bootstrap!' do
+    it 'loads definitions and participant registration list' do
+      described_class.should_receive(:load_definitions!)
+      Bumbleworks::ParticipantRegistration.should_receive(:register!)
+      described_class.bootstrap!
+    end
   end
 
   describe '.configuration' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bumbleworks
 version: !ruby/object:Gem::Version
-  version: 0.0.55
+  version: 0.0.56
   prerelease: 
 platform: ruby
 authors:
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-14 00:00:00.000000000 Z
+date: 2014-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruote
@@ -198,6 +198,7 @@ files:
 - lib/tasks/bumbleworks.rake
 - spec/fixtures/apps/with_default_directories/config_initializer.rb
 - spec/fixtures/apps/with_default_directories/full_initializer.rb
+- spec/fixtures/apps/with_default_directories/participants.rb
 - spec/fixtures/apps/with_default_directories/participants/honey_participant.rb
 - spec/fixtures/apps/with_default_directories/participants/molasses_participant.rb
 - spec/fixtures/apps/with_default_directories/process_definitions/garbage_collector.rb
@@ -261,7 +262,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2137363993883985375
+      hash: 1303608967349520599
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -270,7 +271,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2137363993883985375
+      hash: 1303608967349520599
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23
@@ -280,6 +281,7 @@ summary: Framework around ruote[http://github.com/jmettraux/ruote] workflow engi
 test_files:
 - spec/fixtures/apps/with_default_directories/config_initializer.rb
 - spec/fixtures/apps/with_default_directories/full_initializer.rb
+- spec/fixtures/apps/with_default_directories/participants.rb
 - spec/fixtures/apps/with_default_directories/participants/honey_participant.rb
 - spec/fixtures/apps/with_default_directories/participants/molasses_participant.rb
 - spec/fixtures/apps/with_default_directories/process_definitions/garbage_collector.rb