stuka 0.0.10 → 0.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c0aec6436fa3d99c39d9e6d8b3b03847e7ddaf88
-  data.tar.gz: cc6ce942894580b9b33eccd56996d7ef39bf7e57
+  metadata.gz: ca27a15c874129787e12f36fc8c2056ac0211f70
+  data.tar.gz: 943bea8f273e1df5e2225e93f645a1afb3e1e0a8
 SHA512:
-  metadata.gz: 106c3f25a2474d5cb6be2a5372cf342ef00dd6e487e553e9819cb1f2c07101e6d99e648a43cc2bd14797cce71ba9a7a8f064ebe862b0341739d6ca0a39363280
-  data.tar.gz: 6e058952ba790f50010a9a41220d260058b08aeb6c4454e81685f5578623cd2ac4307742263c0bfe773455f69232be6ccc24a560b2a7608e0ca1631789110d2e
+  metadata.gz: 5dc8f84801d5430d25f17bd6b4b3bac841322983000d30474da7d398709724eb421c9522facd668122432125aa35ef35ce4a05bff2dc8ebc7d56b648909f9a87
+  data.tar.gz: d4856b738eff0ca6d6977eddf3adc9ec99466f2ee9d151e4ffda848d86bed05f7d868a8e9200b05a1e48d85385f0a132817e113a1bfb114beff564cf9f68456d

data/.gitignore

@@ -21,4 +21,5 @@ tmp
 *.a
 mkmf.log
 vendor/
-/processes_source_test/
+/processes_source_test/
+spec/stdout.txt

data/lib/stuka/commands/command.rb

@@ -5,10 +5,6 @@ module Stuka
   class Command < Thor::Group
     include Thor::Actions
 
-    class << self
-      attr_accessor :pwd
-    end
-
     # root of project, from where we reference the templates
     def self.source_root
       File.dirname(__FILE__) + "/.."
@@ -31,10 +27,6 @@ module Stuka
       "#{command_name} description"
     end
 
-    def self.current_dir(cd)
-      pwd || Dir.pwd
-    end
-
   end
 
 end

data/lib/stuka/commands/public_commands/new_command.rb

@@ -1,6 +1,5 @@
 require_relative "../command"
 require_relative "../subcommands/create/create_project"
-require_relative "setup_command"
 
 module Stuka
 

data/lib/stuka/commands/public_commands/process_command.rb

@@ -1,5 +1,5 @@
 require_relative "../command"
-require_relative "../subcommands/create/create_process"
+require_relative "../subcommands/create/create_process_file"
 
 module Stuka
 
@@ -8,7 +8,7 @@ module Stuka
     argument :name, :desc => "Name of the process"
 
     def execute
-      Stuka::CreateProcess.new.create(name)
+      Stuka::CreateProcessFile.new.create(name)
     end
 
     def self.description

data/lib/stuka/commands/public_commands/setup_command.rb

@@ -1,9 +1,8 @@
-require_relative "../command"
-Dir["#{File.dirname(__FILE__)}/../subcommands/setup/*.rb"].each { |file| require_relative file }
-
-
 module Stuka
 
+  require_relative "../command"
+  Dir["#{File.dirname(__FILE__)}/../subcommands/setup/*.rb"].each { |file| require_relative file }
+
   class SetupCommand < Command
 
     def execute

data/lib/stuka/{stuka_cli.rb → commands/stuka_cli.rb}

@@ -1,12 +1,12 @@
-module Stuka
+require 'thor'
+Dir["#{File.dirname(__FILE__)}/public_commands/*.rb"].each { |file| require_relative file }
 
-  require 'thor'
-  Dir["#{File.dirname(__FILE__)}/commands/public_commands/*.rb"].each { |file| require_relative file }
+module Stuka
 
   class StukaCli < Thor
 
     # Retrieve all classes from the Stuka module that end with Command except Stuka::Command abstract class
-    # Register all those classes so they are available in the terminal as commands.
+    # Register all those classes so they are available in the terminal as commands using
     # register(class_name, subcommand_alias, usage_list_string, description_string)
     commands = Stuka.constants.select { |c| c.match(/\w+Command/) && Stuka.const_get(c).is_a?(Class) }
     commands.each do |command|

data/lib/stuka/commands/subcommands/create/{create_process.rb → create_process_file.rb}

@@ -2,12 +2,12 @@ require_relative "../../command"
 
 module Stuka
 
-  class CreateProcess < Command
+  class CreateProcessFile < Command
 
     def create(name)
       @name = name
-      template('templates/definitions/process.tt', "process_definition/processes/#{name}.rb")
-      say("Process #{name} created")
+      template('templates/definitions/process.tt', "process_definition/business/#{name}.rb")
+      say("Process file '#{name}.rb' created")
     end
 
   end

data/lib/stuka/commands/subcommands/setup/setup_directories.rb

@@ -1,4 +1,5 @@
 require_relative "../../command"
+require 'fileutils'
 
 module Stuka
 
@@ -6,17 +7,16 @@ module Stuka
 
     def setup
       processes_dir_exists = File.directory?("#{Dir.pwd}/process_definition/processes")
-      steps_dir_exists = File.directory?("#{Dir.pwd}/process_definition/steps")
 
-      if processes_dir_exists && steps_dir_exists
-        say("Stuka is already setup")
+      if processes_dir_exists
+        say("Stuka dsl source directories are already setup")
         return
       end
 
-      template('templates/samples/my_first_step.tt', "process_definition/steps/example/my_first_step.rb")
-      template('templates/samples/my_second_step.tt', "process_definition/steps/example/my_second_step.rb")
-      template('templates/samples/my_process.tt', "process_definition/processes/my_process.rb")
+      FileUtils.mkdir_p "process_definition"
+
       say("Source directories setup")
+   
     end
 
   end

data/lib/stuka/external/action_finder.rb

@@ -0,0 +1,25 @@
+require 'stuka/external/unknown_action'
+
+module Stuka
+
+  class ActionFinder
+
+    def find_action action, process
+      namespace, name = action.split "::"
+      class_namespace = namespace.split('_').collect!{ |w| w.capitalize }.join
+      class_name = name.split('_').collect!{ |w| w.capitalize }.join
+      begin
+        clazz = Object.const_get("#{class_namespace}::#{class_name}")
+      rescue NameError
+        file_path = "#{Stuka::StukaPaths::PROCESSES_SOURCE_PATH}/#{namespace}/#{name}"
+        raise Stuka::UnknownAction.new(action) unless File.file?("#{file_path}.rb")
+        require_relative file_path
+        clazz = Object.const_get("#{class_namespace}::#{class_name}")
+      end
+      clazz.new(process)
+    end
+
+  end
+
+
+end

data/lib/stuka/external/business_action.rb

@@ -0,0 +1,18 @@
+module Stuka
+
+  class BusinessAction
+
+    attr_reader :process
+
+    def initialize(process)
+      @process = process
+    end
+
+    def method_missing(name, args, &block)
+      super unless @process.can_transition_to? name
+      @process.transition args, name
+    end
+
+  end
+
+end

data/lib/stuka/external/business_process.rb

@@ -0,0 +1,85 @@
+require 'observer'
+require 'stuka/external/dispatcher'
+require 'stuka/external/action_finder'
+
+Dir["#{File.dirname(__FILE__)}/process_states/*.rb"].each { |file| require_relative file }
+
+module Stuka
+
+  class BusinessProcess
+
+    PROCESS_STATES = {
+      inactive: InactiveState.new,
+      starting: StartingState.new,
+      started: StartedState.new,
+      finished: FinishedState.new
+    }
+
+    include Observable
+
+    attr_reader :options, :process_id, :start_action, :current_action, :current_state, :process_params, :action_params, :transition_helper, :dispatcher, :action_finder
+
+    def initialize(process_id: nil, options: {}, dispatcher: Dispatcher.new, action_finder: ActionFinder.new)
+      @options = options
+      @process_id = process_id
+      @dispatcher = dispatcher
+      @action_finder = action_finder
+      change_state :inactive
+      yield(@dispatcher) if block_given?
+    end
+
+    def run(params = {})
+      set_process_params params
+      transition(params, nil)
+    end
+
+    def transition(params, transition)
+      set_action_params params
+      notify
+      current_state.handle_transition(self, transition)
+    end
+
+    def can_transition_to?(transition)
+      transition_map.has_key?(current_action) && transition_map[current_action].has_key?(transition)
+    end
+
+    private
+
+    def next_action(transition)
+      raise "transition not defined" unless can_transition_to?(transition)
+      return transition_map[current_action][transition]
+    end
+
+    def method_missing(name, args)
+      change_state :finished
+      if dispatcher.can_end_with? name
+        dispatcher.call(name.to_sym, args)
+      else
+        super
+      end
+    end
+
+    def set_current_action(new_action)
+      @current_action = new_action
+    end
+
+    def change_state(new_state)
+      @current_state = PROCESS_STATES[new_state]
+    end
+
+    def set_process_params(params)
+      @process_params = params
+    end
+
+    def set_action_params(params)
+      @action_params = params
+    end
+
+    def notify
+      changed true
+      notify_observers(self)
+    end
+
+  end
+
+end

data/lib/stuka/external/dispatcher.rb

@@ -0,0 +1,27 @@
+module Stuka
+
+  class Dispatcher
+
+    attr_reader :callbacks
+
+    def initialize
+      @callbacks = {}
+    end
+
+    def can_end_with?(name)
+      @callbacks.has_key?(name)
+    end
+
+    def method_missing(name, *args, &block)
+      callbacks[name] = block
+    end
+
+    def call(name, args)
+      name = name.to_sym
+      cb = callbacks[name]
+      cb ? cb.call(args) : false
+    end
+
+  end
+
+end

data/lib/stuka/external/process_states/finished_state.rb

@@ -0,0 +1,13 @@
+module Stuka
+
+  class FinishedState
+
+    def handle_transition(context, transition = nil)
+      context.instance_eval do
+        return
+      end
+    end
+
+  end
+
+end

data/lib/stuka/external/process_states/inactive_state.rb

@@ -0,0 +1,16 @@
+module Stuka
+
+  class InactiveState
+
+    def handle_transition(context, transition = nil)
+      context.instance_eval do
+        change_state(:started)
+        set_current_action(start_action)
+        start_action_instance = action_finder.find_action(start_action, self)
+        start_action_instance.run(action_params)
+      end
+    end
+
+  end
+
+end

data/lib/stuka/external/process_states/started_state.rb

@@ -0,0 +1,21 @@
+module Stuka
+
+  class StartedState
+
+    def handle_transition(context, transition)
+      context.instance_eval do
+        action_desc = next_action(transition)
+        if action_desc.start_with?("process::")
+          process_message = action_desc.split("::")[1]
+          send(process_message.to_sym, action_params)
+        else
+          set_current_action(action_desc)
+          action_instance = action_finder.find_action(action_desc, context)
+          action_instance.run(action_params)
+        end
+      end
+    end
+
+  end
+
+end

data/lib/stuka/external/process_states/starting_state.rb

@@ -0,0 +1,16 @@
+module Stuka
+
+  class StartingState
+
+    def handle_transition(context, transition)
+      context.instance_eval do
+        set_current_action(start_action)
+        start_action_class = transition_helper.find_action(start_action)
+        change_state(:started)
+        start_action_class.new(context).run(action_params)
+      end
+    end
+
+  end
+
+end

data/lib/stuka/external/unknown_action.rb

@@ -0,0 +1,9 @@
+module Stuka
+
+  class UnknownAction < StandardError
+    def initialize(action_name)
+      super("action definition for '#{action_name}' can't be found")
+    end
+  end
+
+end

data/lib/stuka/internal/domain/action.rb

@@ -0,0 +1,32 @@
+require_relative "domain"
+
+module Stuka
+
+  class Action < Domain
+
+    # must not be nil
+    ATTRS = ["name", "description", "namespace"]
+
+    # must not be empty
+    REQUIRED_ATTRS = ["name", "namespace"]
+
+    def initialize(name, description = nil, namespace = nil)
+      super()
+      @name = name
+      @description = description
+      @namespace = namespace
+    end
+
+    # redefined
+    def namespace(namespace = nil)
+      raise "'process' namespace is reserved" if namespace == "process"
+      if namespace
+        @namespace = namespace
+      else
+        @namespace
+      end
+    end
+
+  end
+
+end

data/lib/stuka/internal/domain/domain.rb

@@ -0,0 +1,29 @@
+module Stuka
+
+  class Domain
+
+    def initialize
+      self.class.define_basic_methods()
+    end
+
+    def get_binding
+      binding()
+    end
+
+    def self.define_basic_methods()
+      subclass = self
+      subclass::ATTRS.each do |arg_name|
+        next if subclass.method_defined? arg_name.to_sym
+        subclass.send(:define_method, arg_name.to_sym) do |arg = nil|
+          if arg
+            instance_variable_set("@#{arg_name}".to_sym, arg)
+          else
+            instance_variable_get("@#{arg_name}")
+          end
+        end
+      end
+    end
+
+  end
+
+end

data/lib/stuka/internal/domain/process.rb

@@ -0,0 +1,32 @@
+require_relative "domain"
+
+module Stuka
+
+  class Process < Domain
+
+    attr_reader :transitions
+
+    # must not be nil
+    ATTRS = ["name", "description", "start_action"]
+
+    # must not be empty
+    REQUIRED_ATTRS = ["name", "start_action"]
+
+    def initialize(name, description = nil, arguments = nil, start_action = nil)
+      super()
+      @arguments = []
+      @name = name
+      @description = description
+      @arguments = arguments
+      @start_action = start_action
+      @transitions = {}
+    end
+
+    def action_transition(action_name, transition_hash)
+      new_transition = { action_name => transition_hash }
+      transitions.merge!(new_transition)
+    end
+
+  end
+
+end

data/lib/stuka/internal/domain_builders/action_domain_builder.rb

@@ -0,0 +1,19 @@
+require 'stuka/internal/domain/action'
+require_relative 'domain_builder'
+
+module Stuka
+
+  class ActionDomainBuilder < DomainBuilder
+
+    def action(name, &block)
+      act = Action.new(name)
+      act.instance_eval(&block)
+      @instances << act
+      act
+    end
+
+
+
+  end
+
+end

data/lib/stuka/internal/domain_builders/domain_builder.rb

@@ -0,0 +1,32 @@
+module Stuka
+
+  class DomainBuilder
+
+    DOMAIN_OBJECTS = ["process", "action"]
+
+    attr_accessor :instances
+
+    def initialize
+      @instances = []
+    end
+
+    DOMAIN_OBJECTS.each do |object_name|
+      define_method object_name.to_sym do |*arg|
+        #empty process and action method so it does not raise method not found
+      end
+    end
+
+    def domain_files
+      Dir["#{Stuka::StukaPaths::PROCESSES_DEFINITION_PATH}/**/*.rb"]
+    end
+
+    def build_domain
+      domain_files.each do |path|
+        instance_eval(File.read(path), path, __LINE__)
+      end
+      self
+    end
+
+  end
+
+end

data/lib/stuka/internal/domain_builders/process_domain_builder.rb

@@ -0,0 +1,17 @@
+require 'stuka/internal/domain/process'
+require_relative 'domain_builder'
+
+module Stuka
+
+  class ProcessDomainBuilder < DomainBuilder
+
+    def process(name, &block)
+      proc = Process.new(name)
+      proc.instance_eval(&block)
+      @instances << proc
+      proc
+    end
+
+  end
+
+end

data/lib/stuka/internal/process_cleaner.rb

@@ -1,5 +1,3 @@
-require_relative '../stuka_paths'
-
 module Stuka
 
   class ProcessCleaner

data/lib/stuka/internal/source_builders/action_builder.rb

@@ -0,0 +1,32 @@
+require 'stuka/internal/domain_builders/action_domain_builder'
+require_relative 'source_builder'
+
+module Stuka
+
+  class ActionBuilder < SourceBuilder
+
+    def self.build
+      
+      adb = ActionDomainBuilder.new
+      adb.build_domain
+
+      template_file = "#{templates_path}/source/action.tt"
+      renderer = ERB.new(File.read(template_file))
+
+      FileUtils.mkdir_p Stuka::StukaPaths::PROCESSES_SOURCE_PATH
+
+      adb.instances.each do |acc|
+        out_file = File.new("#{source_path}/#{acc.name}_action.rb", "w")
+        out_file.puts(renderer.result(acc.get_binding))
+        out_file.close
+      end
+
+    end
+
+    def self.source_path
+      Stuka::StukaPaths::PROCESSES_SOURCE_PATH
+    end
+
+  end
+
+end

data/lib/stuka/internal/source_builders/process_builder.rb

@@ -0,0 +1,38 @@
+require 'stuka/internal/domain_builders/process_domain_builder'
+require 'stuka/internal/validator'
+require_relative 'source_builder'
+
+module Stuka
+
+  class ProcessBuilder < SourceBuilder
+
+    def self.build
+      pdb = ProcessDomainBuilder.new
+      pdb.build_domain
+
+      validator = Stuka::Validator.new
+      raise validator.message unless validator.process_set_valid? pdb.instances
+
+      template_file = "#{templates_path}/source/process.tt"
+      renderer = ERB.new(File.read(template_file))
+
+      FileUtils.mkdir_p source_path
+
+      #raise pdb.instances.to_s
+
+      pdb.instances.each do |proc|
+        raise validator.message unless validator.process_valid? proc
+        out_file = File.new("#{source_path}/#{proc.name}.rb", "w")
+        out_file.puts(renderer.result(proc.get_binding))
+        out_file.close
+      end
+    
+    end
+
+    def self.source_path
+      Stuka::StukaPaths::PROCESSES_SOURCE_PATH
+    end
+
+  end
+
+end

data/lib/stuka/internal/source_builders/source_builder.rb

@@ -0,0 +1,14 @@
+require 'fileutils'
+require 'erb'
+
+module Stuka
+
+  class SourceBuilder
+
+    def self.templates_path
+      Stuka::StukaPaths::TEMPLATES_PATH
+    end
+
+  end
+
+end