behave_fun 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 935e48b4d598edb584ef80612774fec7028552597b1a6e56b4d2ec4b6283f616
-  data.tar.gz: 9a51961b11ec757601e3912eee99918a4ec9b39b7913d7dc95aaae25218bc627
+  metadata.gz: a7a9e0845eb973be63f59ba48dcceaf4e7a98ba28b4c29c1b11db4e5c98cc505
+  data.tar.gz: f4eda02740d8e094cc7191651053e8ba34c289d01381f4cd3c9493679d574e62
 SHA512:
-  metadata.gz: e2a1e6a8aa77715d47b2238920626da6b232e75e4fd92cc22b525c88d7de1036c54d1c704aa29dc5276fce1573876b164b48e6492102288a5168e0c1ccb3d41f
-  data.tar.gz: 5592475d04f9fb7198f4d6222673a98ebe6dbeec7ecd80e22fcf580022f4a8b7ced2901dfda2e8da887b5ca432fd1a48164ebdc5b6f89914405e14d77da69fe0
+  metadata.gz: 23c14f5aee8434fc001ff9579e64454247ca46b4ae9cf84260bb47575b81a16e662611ba7a57d86ac75769d2d87f0bcee605c9f2ebd8137cf76855dcc8faf7ad
+  data.tar.gz: 8335771314c4fbb5e09c0cef08d77da21a114cbd5d0f1cb6707966ca530ffb2ac80c2517aff056fd4ad6c8e490347f6e672121ae7999398d804c3d7c87c6b376

data/Gemfile.lock

@@ -1,14 +1,14 @@
 PATH
   remote: .
   specs:
-    behave_fun (0.1.2)
+    behave_fun (0.2.0)
       activesupport (~> 6.0.0)
       zeitwerk (~> 2.3.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.3)
+    activesupport (6.0.3.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)

data/README.md

@@ -13,36 +13,43 @@ Main features:
 
 Add this line to your application's Gemfile:
 
-```ruby
+``` ruby
 gem 'behave_fun'
 ```
 
 And then execute:
 
+```
 $ bundle install
+```
 
 Or install it yourself as:
 
+```
 $ gem install behave_fun
+```
 
 ## Usage
 
 To build a behavior tree:
 
 ``` ruby
+builder = BehaveFun.build_builder {
+  # add_task_type YourCustomTask
+}
 # ruby dsl
-tree = BehaveFun.build_tree { success }
+tree = builder.build_tree { success }
 # from hash
-tree = BehaveFun.build_tree_from_hash(type: :success)
+tree = builder.build_tree_from_hash(type: :success)
 # from json
-tree = BehaveFun.build_tree_from_json(json_string)
+tree = builder.build_tree_from_json(json_string)
 ```
 
 To build a complex behavior tree:
 
 ``` ruby
 # write_spec, write_code, run_spec, git_push and release_gem are customized tasks
-tree = BehaveFun.build_tree {
+tree = builder.build_tree {
   sequence {
     until_success {
       sequence {
@@ -57,7 +64,7 @@ tree = BehaveFun.build_tree {
 }
 ```
 
-To create customized task, create a class that extends `BehaveFun::Task`. Don't forget call `running` `success` or `fail` in `#execute` method at the end.
+To create customized task, create a class that extends `BehaveFun::Task` (or use a lambda if only need to overwrite `#execute` method). Don't forget call `running` `success` or `fail` in `#execute` method at the end.
 
 ``` ruby
 # a task that increase data by 1, always success
@@ -66,18 +73,17 @@ class Counter < BehaveFun::Task
     context[:counter] += 1
     success
   end
-
-  add_to_task_builder
 end
 
 # a task that detect tree data is even or not
-class IsCounterEven < BehaveFun::Task
-  def execute
-    context[:counter].even? ? success : fail
-  end
+is_counter_even = -> { context[:counter].even? ? success : fail }
 
-  add_to_task_builder
-end
+# add these tasks to your builder
+builder = BehaveFun.build_builder {
+  add_task_type Counter
+  add_lambda_task_type :is_counter_even, &is_counter_even
+}
+builder.build_tree { counter }
 ```
 
 To run a tree:

data/lib/behave_fun.rb

@@ -9,35 +9,8 @@ loader.setup
 module BehaveFun
   module_function
 
-  def build_task(&block)
-    task = build_tree(&block).root
-    task.control = nil
-    task
-  end
-
-  def build_tree(&block)
-    builder = TaskBuilder.new(Tree.new)
-    builder.instance_eval(&block)
-    builder.control
-  end
-
-  def build_tree_from_hash(hash)
-    build_tree do
-      build_from_hash(hash[:root])
-    end
-  end
-
-  def build_tree_from_json(json)
-    hash = ActiveSupport::JSON.decode(json).deep_symbolize_keys
-    build_tree_from_hash(hash)
-  end
-
-  def as_json(tree)
-    tree.as_json
-  end
-
-  def to_json(tree)
-    ActiveSupport::JSON.encode(as_json(tree))
+  def build_builder(&block)
+    BehaveFun::TaskBuilderFactory.new(&block)
   end
 
   class Error < StandardError; end

data/lib/behave_fun/branch_tasks/dynamic_guard_selector.rb

@@ -26,7 +26,5 @@ module BehaveFun
     def child_fail
       fail
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/branch_tasks/random_selector.rb

@@ -16,7 +16,5 @@ module BehaveFun
     def serializable_status_fields
       [:current_child_idx, :order]
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/branch_tasks/random_sequence.rb

@@ -16,7 +16,5 @@ module BehaveFun
     def serializable_status_fields
       [:current_child_idx, :order]
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/branch_tasks/selector.rb

@@ -31,7 +31,5 @@ module BehaveFun
     def serializable_status_fields
       [:current_child_idx]
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/branch_tasks/sequence.rb

@@ -31,7 +31,5 @@ module BehaveFun
     def serializable_status_fields
       [:current_child_idx]
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/decorators/always_fail.rb

@@ -3,7 +3,5 @@ module BehaveFun
     def child_success
       fail
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/decorators/always_succeed.rb

@@ -3,7 +3,5 @@ module BehaveFun
     def child_fail
       success
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/decorators/invert.rb

@@ -7,7 +7,5 @@ module BehaveFun
     def child_success
       fail
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/decorators/repeat.rb

@@ -2,21 +2,16 @@ module BehaveFun
   class Decorators::Repeat < Decorator
     attr_accessor :counter
 
-    def initialize(times: -1)
-      super
-      @times = times
-    end
-
     def start
       super
       @counter = 0
     end
 
     def child_success
-      return @children[0].reset if @times == -1
+      return @children[0].reset unless params[:times]
 
       @counter += 1
-      if @counter < @times
+      if @counter < params[:times]
         @children[0].reset
       else
         success
@@ -30,7 +25,5 @@ module BehaveFun
     def serializable_status_fields
       [:counter]
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/decorators/until_fail.rb

@@ -3,7 +3,5 @@ module BehaveFun
     def child_fail
       success
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/decorators/until_success.rb

@@ -3,7 +3,5 @@ module BehaveFun
     def child_success
       success
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/leaf_tasks/failure.rb

@@ -3,7 +3,5 @@ module BehaveFun
     def execute
       fail
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/leaf_tasks/success.rb

@@ -3,7 +3,5 @@ module BehaveFun
     def execute
       success
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/leaf_tasks/wait.rb

@@ -2,18 +2,13 @@ module BehaveFun
   class LeafTasks::Wait < Task
     attr_accessor :counter
 
-    def initialize(duration: )
-      super
-      @duration = duration
-    end
-
     def start
       super
       @counter = 0
     end
 
     def execute
-      if @counter < @duration
+      if @counter < params[:duration]
         @counter += 1
         running
       else
@@ -24,7 +19,5 @@ module BehaveFun
     def serializable_status_fields
       [:counter]
     end
-
-    add_to_task_builder
   end
 end

data/lib/behave_fun/task.rb

@@ -5,7 +5,7 @@ module BehaveFun
     attr_accessor :control, :guard
     attr_reader :context, :children, :params, :status
 
-    def initialize(**params)
+    def initialize(params = {})
       @params = params
       @children = []
       @status = :fresh
@@ -15,10 +15,6 @@ module BehaveFun
       name.demodulize.underscore
     end
 
-    def self.add_to_task_builder(name = task_name)
-      BehaveFun::TaskBuilder.add_task_type(self, name: name)
-    end
-
     def context=(context)
       @context = context
       children.each { _1.context = context }
@@ -119,5 +115,11 @@ module BehaveFun
       @status = :fresh
       children.each { |child| child.reset }
     end
+
+    def dup
+      cloned = self.class.new(params)
+      children.each { cloned.add_child(_1.dup) }
+      cloned
+    end
   end
 end

data/lib/behave_fun/task_builder_factory.rb

@@ -0,0 +1,130 @@
+module BehaveFun
+  class TaskBuilderFactory
+    attr_reader :tasks
+
+    def initialize(&block)
+      @tasks = {}
+
+      add_task_type BehaveFun::LeafTasks::Success
+      add_task_type BehaveFun::LeafTasks::Failure
+      add_task_type BehaveFun::LeafTasks::Wait
+      add_task_type BehaveFun::Decorators::AlwaysSucceed
+      add_task_type BehaveFun::Decorators::AlwaysFail
+      add_task_type BehaveFun::Decorators::UntilSuccess
+      add_task_type BehaveFun::Decorators::UntilFail
+      add_task_type BehaveFun::Decorators::Invert
+      add_task_type BehaveFun::Decorators::Repeat
+      add_task_type BehaveFun::BranchTasks::Sequence
+      add_task_type BehaveFun::BranchTasks::Selector
+      add_task_type BehaveFun::BranchTasks::RandomSequence
+      add_task_type BehaveFun::BranchTasks::RandomSelector
+      add_task_type BehaveFun::BranchTasks::DynamicGuardSelector
+
+      instance_eval(&block) if block_given?
+    end
+
+    def add_task_type(type, name: type.task_name)
+      tasks[name.to_sym] = type
+    end
+
+    def add_lambda_task_type(task_name, &block)
+      type = Class.new(Task) do
+        def name
+          task_name
+        end
+
+        define_method(:execute, &block)
+      end
+      tasks[task_name.to_sym] = type
+    end
+
+    def build_task(&block)
+      task = build_tree(&block).root
+      task.control = nil
+      task
+    end
+
+    def build_tree(&block)
+      builder = Builder.new(self, Tree.new)
+      builder.instance_eval(&block)
+      builder.control
+    end
+
+    def build_task_from_hash(hash)
+      tree = build_tree do
+        build_from_hash(hash)
+      end
+      tree.root
+    end
+
+    def build_tree_from_hash(hash)
+      build_tree do
+        build_from_hash(hash[:root])
+      end
+    end
+
+    def build_tree_from_json(json)
+      hash = ActiveSupport::JSON.decode(json).deep_symbolize_keys
+      build_tree_from_hash(hash)
+    end
+
+    def as_json(tree)
+      tree.as_json
+    end
+
+    def to_json(tree)
+      ActiveSupport::JSON.encode(as_json(tree))
+    end
+
+    class Builder
+      attr_reader :factory, :control
+
+      def initialize(factory, control)
+        @factory = factory
+        @control = control
+      end
+
+      def add_task(type, params = {}, &block)
+        task = type.new(params)
+        @control.add_child(task)
+
+        if block
+          builder = Builder.new(factory, task)
+          builder.instance_eval(&block)
+        end
+      end
+
+      def guard_with(&block)
+        builder = Builder.new(factory, Tree.new)
+        builder.instance_eval(&block)
+        control.guard = builder.control.root
+      end
+
+      def include(task)
+        cloned_task = task.dup
+        @control.add_child(cloned_task)
+      end
+
+      def build_from_hash(task_hash)
+        type_name, params, guard_with, children =
+          task_hash.values_at(:type, :params, :guard_with, :children)
+        params ||= {}
+        children ||= []
+        type = factory.tasks[type_name.to_sym]
+        add_task type, **params do
+          guard_with { build_from_hash(guard_with) } if guard_with
+          children.each { build_from_hash(_1) }
+        end
+      end
+
+      def method_missing(name, *args, &block)
+        type = factory.tasks[name.to_sym]
+        if type
+          add_task(type, *args, &block)
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/lib/behave_fun/version.rb

@@ -1,3 +1,3 @@
 module BehaveFun
-  VERSION = '0.1.2'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: behave_fun
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - ayaya zhao
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-05-17 00:00:00.000000000 Z
+date: 2020-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -74,7 +74,7 @@ files:
 - lib/behave_fun/leaf_tasks/success.rb
 - lib/behave_fun/leaf_tasks/wait.rb
 - lib/behave_fun/task.rb
-- lib/behave_fun/task_builder.rb
+- lib/behave_fun/task_builder_factory.rb
 - lib/behave_fun/task_serializer.rb
 - lib/behave_fun/tree.rb
 - lib/behave_fun/version.rb

data/lib/behave_fun/task_builder.rb

@@ -1,53 +0,0 @@
-module BehaveFun
-  class TaskBuilder
-    attr_reader :control
-
-    def initialize(control)
-      @control = control
-    end
-
-    def add_task(type, **params, &block)
-      task = type.new(**params)
-      @control.add_child(task)
-
-      if block
-        builder = TaskBuilder.new(task)
-        builder.instance_eval(&block)
-      end
-    end
-
-    def guard_with(&block)
-      builder = TaskBuilder.new(Tree.new)
-      builder.instance_eval(&block)
-      control.guard = builder.control.root
-    end
-
-    def include(task)
-      cloned_task = BehaveFun.build_task { build_from_hash(task.as_json) }
-      @control.add_child(cloned_task)
-    end
-
-    def build_from_hash(task_hash)
-      type_name, params, guard_with, children =
-        task_hash.values_at(:type, :params, :guard_with, :children)
-      params ||= {}
-      children ||= []
-      type = self.class.tasks[type_name.to_sym]
-      add_task type, **params do
-        guard_with { build_from_hash(guard_with) } if guard_with
-        children.each { build_from_hash(_1) }
-      end
-    end
-
-    def self.tasks
-      @tasks ||= {}
-    end
-
-    def self.add_task_type(type, name: type.task_name)
-      tasks[name.to_sym] = type
-      define_method name do |params = {}, &block|
-        add_task(type, **params, &block)
-      end
-    end
-  end
-end