trailblazer-developer 0.0.23 → 0.0.24

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fabb29823b1f8422ec156cc7b8fc2878aef438281457fcaf0040dccf9cd179ed
-  data.tar.gz: dfe238f09fcd0635268ecc47112f50c99134d0a8435fd38321cf6d6de1625da8
+  metadata.gz: 23a6eb4a9f753e270064c377f75c08045ffcfffe1ee4643c82b52a59df0e38c6
+  data.tar.gz: 48f8e2b81baff35b7545deb747fa50e09dea67ea4eca1c55af5566a04edf917d
 SHA512:
-  metadata.gz: d35b2029fb0165b313ef78505a356e0a3549f49fa311e52a2f4c32ae7dbba3d976b404e2d5293bbf9e55aed83d88efd57be6f0176affcfa64af9b0b93ae5f123
-  data.tar.gz: 2cc21b452b8ddd2b72338c854938f548b952dd8ab4fef59e83387194bc18cab8311593d6bce747cff34f70ed92ddde73d501154882edaa6a35d372c9818a0536
+  metadata.gz: 1ec36ea0cfe3b6bafe10ab4029651dfa13db4557bad3fd121fae6e1d28629551f1d747793ad93f95a20a7eabc918254e929ce53eaac7337eb9a3d5db255961da
+  data.tar.gz: 3586db8c45fe02f4ccb99199690916e1ac6f208afe0a9f2a2d12bf5dcccccaae2b20bc65da32ef830bf39661276899fc94e4d5250879c7e02af3a2658be96e7d

data/.github/workflows/ci.yml

@@ -6,7 +6,7 @@ jobs:
       fail-fast: false
       matrix:
         # Due to https://github.com/actions/runner/issues/849, we have to use quotes for '3.0'
-        ruby: [2.5, 2.6, 2.7, '3.0', head, jruby, jruby-head]
+        ruby: [2.5, 2.6, 2.7, '3.0', head, jruby]
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v2

data/CHANGES.md

@@ -1,7 +1,11 @@
+# 0.0.24
+
+* Use `trailblazer-activity-dsl-linear` >= 1.0.
+
 # 0.0.23
 
 * Remove `representable` dependency.
-* Moved all editor-specific code to the `pro` gem.
+* Moved all editor-specific code to the `pro` gem (`client.rb` and `generate.rb`).
 
 # 0.0.22
 

data/Gemfile

@@ -6,4 +6,5 @@ gemspec
 # gem "trailblazer-activity", ">= 0.7.1"
 # gem "trailblazer-activity", path: "../trailblazer-activity"
 # gem "trailblazer-activity-dsl-linear", path: "../trailblazer-activity-dsl-linear"
-# gem "trailblazer-activity-dsl-linear", github: "trailblazer/trailblazer-activity-dsl-linear"
+gem "trailblazer-activity-dsl-linear", github: "trailblazer/trailblazer-activity-dsl-linear"
+gem "trailblazer-activity", github: "trailblazer/trailblazer-activity"

data/README.md

@@ -10,8 +10,11 @@ Find the complete documentation on the project website: [https://trailblazer.to/
 
 The `developer` gem provides the following neat tools.
 
-* Quick rendering of activities, including their taskWraps.
-* `wtf?` mode™: Run a broken activity and trace where an exception happened.
-* Connect to the visual TRB-editor: load, store, organize and render your app's activities.
-* Generate {Intermediate} data structures from TRB-editor.js files.
-* Debugging mode: run and debug workflows in the TRB-editor.
+## `wtf?` mode™
+
+Run an activity and see its flow on the command line. Or - run a _broken_ activity and trace where an exception happened.
+
+![Tracing is awesome!](https://trailblazer.to/images/sketch/wtf.png)
+
+
+## Quick rendering of activities, including their taskWraps.

data/lib/trailblazer/developer/render/linear.rb

@@ -6,15 +6,15 @@ module Trailblazer
   # NOTE: this is absolutely to be considered as prototyping and acts more like a test helper ATM as
 
   module Developer
-    def self.railway(*args)
-      Render::Linear.(*args)
+    def self.railway(*args, **kws)
+      Render::Linear.(*args, **kws)
     end
 
     module Render
       module Linear
         module_function
 
-        def call(operation, options = {style: :line})
+        def call(operation, style: :line)
           graph = Activity::Introspect::Graph(operation)
 
           rows = graph.collect do |node, i|
@@ -27,7 +27,7 @@ module Trailblazer
 
           rows = rows[1..-1] # remove start
 
-          return inspect_line(rows) if options[:style] == :line
+          return inspect_line(rows) if  style == :line
 
           return inspect_rows(rows)
         end

data/lib/trailblazer/developer/trace.rb

@@ -43,9 +43,15 @@ module Trailblazer::Developer
     #
     # @private
     def merge_plan
-      Activity::TaskWrap::Pipeline::Merge.new(
-        [Activity::TaskWrap::Pipeline.method(:insert_before), "task_wrap.call_task", ["task_wrap.capture_args",   Trace.method(:capture_args)]],
-        [Activity::TaskWrap::Pipeline.method(:append),        nil,                   ["task_wrap.capture_return", Trace.method(:capture_return)]],
+      Activity::TaskWrap::Extension.new(
+        {
+          insert: [Activity::Adds::Insert.method(:Prepend), "task_wrap.call_task"],
+          row:    Activity::TaskWrap::Pipeline.Row("task_wrap.capture_args", Trace.method(:capture_args))
+        },
+        {
+          insert: [Activity::Adds::Insert.method(:Append)], # append to the very end of tW.
+          row:    Activity::TaskWrap::Pipeline.Row("task_wrap.capture_return", Trace.method(:capture_return))
+        },
       )
     end
 

data/lib/trailblazer/developer/version.rb

@@ -1,7 +1,7 @@
 module Trailblazer
   module Version
     module Developer
-      VERSION = "0.0.23"
+      VERSION = "0.0.24"
     end
   end
 end

data/trailblazer-developer.gemspec

@@ -23,7 +23,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "minitest-line"
   spec.add_development_dependency "rake"
 
-  spec.add_dependency "trailblazer-activity", ">= 0.12.2", "< 1.0.0"
-  spec.add_dependency "trailblazer-activity-dsl-linear", ">= 0.4.1", "< 1.0.0"
+  spec.add_dependency "trailblazer-activity-dsl-linear", ">= 1.0.0", "< 1.1.0"
   spec.add_dependency "hirb"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trailblazer-developer
 version: !ruby/object:Gem::Version
-  version: 0.0.23
+  version: 0.0.24
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-16 00:00:00.000000000 Z
+date: 2022-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,46 +66,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: trailblazer-activity
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.12.2
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.12.2
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: trailblazer-activity-dsl-linear
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.1
+        version: 1.0.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.1
+        version: 1.0.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: hirb
   requirement: !ruby/object:Gem::Requirement
@@ -147,7 +127,6 @@ files:
 - lib/trailblazer/developer/version.rb
 - lib/trailblazer/developer/wtf.rb
 - lib/trailblazer/developer/wtf/renderer.rb
-- lib/trailblazer/diagram/bpmn.rb
 - trailblazer-developer.gemspec
 homepage: http://trailblazer.to
 licenses:

data/lib/trailblazer/diagram/bpmn.rb

@@ -1,338 +0,0 @@
-require "representable"
-require "representable/xml"
-
-require "trailblazer/developer/activity"
-
-module Trailblazer
-  module Diagram
-    module BPMN # rubocop:disable Metrics/ModuleLength
-      Plane  = Struct.new(:element, :shapes, :edges)
-      Shape  = Struct.new(:id, :element, :bounds)
-      Edge   = Struct.new(:id, :element, :waypoints)
-      Bounds = Struct.new(:x, :y, :width, :height)
-      Waypoint = Struct.new(:x, :y)
-
-      require "tsort"
-      # Helps sorting the tasks in a process "topologically", which is basically what the
-      # Sequence does for us, but this works for any kind of process.
-      # DISCUSS: should we work on the Model or Graph interface?
-      def self.topological_sort(model)
-        edges = {}
-        model.end_events.each { |task| edges[task.id] = {} }
-        model.sequence_flow.each do |edge|
-          edges[edge.sourceRef] ||= []
-          edges[edge.sourceRef] << edge.targetRef
-        end
-
-        # g = {1=>[2, 3], 2=>[4], 3=>[2, 4], 4=>[]}
-        each_node = ->(&b) { edges.each_key(&b) }
-        each_child = ->(n, &b) { edges[n].each(&b) }
-        TSort.tsort(each_node, each_child).reverse #=> [4, 2, 3, 1]
-      end
-
-      # FIXME: this should be called "linear layouter or something"
-      # Render an `Activity`'s circuit to a BPMN 2.0 XML `<process>` structure.
-      # @param activity Activity
-      # @param linear_task_ids [String] A list of task IDs that should be layouted sequentially in the provided order.
-      def self.to_xml(activity, linear_task_ids = nil) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-        model = Trailblazer::Developer::Activity::Graph.to_model(activity.graph)
-
-        linear_task_ids ||= topological_sort(model)
-
-        # this layouter doesn't want End events in the linear part, we arrange them manually.
-        linear_task_ids -= model.end_events.map(&:id)
-        linear_task_ids -= model.start_events.map(&:id)
-        linear_tasks = linear_task_ids.collect do |id|
-          model.task.find { |task| task.id == id } || raise("task #{id} is not in model!")
-        end
-
-        start_x = 200
-        y_right = 200
-        y_left  = 300
-
-        event_width = 54
-
-        shape_width  = 81
-        shape_height = 54
-        shape_to_shape = 45
-
-        current = start_x
-        shapes = []
-
-        # add start.
-        shapes << Shape.new(
-          "Shape_#{model.start_events[0][:id]}",
-          model.start_events[0][:id],
-          Bounds.new(current, y_right, event_width, event_width)
-        )
-        current += event_width + shape_to_shape
-
-        # add tasks.
-        linear_tasks.each do |task|
-          is_right = %i[pass step].include?(task.options[:created_by])
-
-          shapes << Shape.new(
-            "Shape_#{task[:id]}",
-            task[:id],
-            Bounds.new(current, is_right ? y_right : y_left, shape_width, shape_height)
-          )
-          current += shape_width + shape_to_shape
-        end
-
-        # add ends.
-        horizontal_end_offset = 90
-
-        defaults = {
-          "End.success" => {y: y_right},
-          "End.failure" => {y: y_left},
-          "End.pass_fast" => {y: y_right - 90},
-          "End.fail_fast" => {y: y_left + 90}
-        }
-
-        success_end_events = []
-        failure_end_events = [] # rubocop:disable Lint/UselessAssignment
-
-        model.end_events.each do |evt|
-          id = evt[:id]
-          y  = defaults[id] ? defaults[id][:y] : success_end_events.last + horizontal_end_offset
-
-          success_end_events << y
-
-          shapes << Shape.new("Shape_#{id}", id, Bounds.new(current, y, event_width, event_width))
-        end
-
-        edges = []
-        model.sequence_flow.each do |flow|
-          source = shapes.find { |shape| shape.id == "Shape_#{flow.sourceRef}" }.bounds
-          target = shapes.find { |shape| shape.id == "Shape_#{flow.targetRef}" }.bounds
-
-          edges << Edge.new("SequenceFlow_#{flow[:id]}", flow[:id], Path(source, target, target.x != current))
-        end
-
-        diagram = Struct.new(:plane).new(Plane.new(model.id, shapes, edges))
-
-        # render XML.
-        Representer::Definitions.new(Definitions.new(model, diagram)).to_xml
-      end
-
-      def self.Path(source, target, do_straight_line) # rubocop:disable Metrics/AbcSize
-        if source.y == target.y # --->
-          [Waypoint.new(*fromRight(source)), Waypoint.new(*toLeft(target))]
-        elsif do_straight_line
-          [Waypoint.new(*fromBottom(source)), Waypoint.new(*toLeft(target))]
-        elsif target.y > source.y # target below source.
-          [
-            l = Waypoint.new(*fromBottom(source)),
-            r = Waypoint.new(l.x, target.y + target.height / 2),
-            Waypoint.new(target.x, r.y)
-          ]
-        else # target above source.
-          [l = Waypoint.new(*fromTop(source)), r = Waypoint.new(l.x, target.y + target.height / 2), Waypoint.new(target.x, r.y)]
-        end
-      end
-
-      def self.fromRight(left)
-        [left.x + left.width, left.y + left.height / 2]
-      end
-
-      def self.toLeft(bounds)
-        [bounds.x, bounds.y + bounds.height / 2]
-      end
-
-      def self.fromBottom(bounds)
-        [bounds.x + bounds.width / 2, bounds.y + bounds.height]
-      end
-
-      def self.fromTop(bounds)
-        [bounds.x + bounds.width / 2, bounds.y]
-      end
-
-      Definitions = Struct.new(:process, :diagram)
-
-      # Representers for BPMN XML.
-      module Representer
-        class Task < Representable::Decorator
-          include Representable::XML
-          include Representable::XML::Namespace
-          namespace "http://www.omg.org/spec/BPMN/20100524/MODEL"
-
-          self.representation_wrap = :task # overridden via :as.
-
-          property :id,   attribute: true
-          property :name, attribute: true
-
-          collection :outgoing, exec_context: :decorator
-          collection :incoming, exec_context: :decorator
-
-          def outgoing
-            represented.outgoing.collect { |edge| edge[:id] }
-          end
-
-          def incoming
-            represented.incoming.collect { |edge| edge[:id] }
-          end
-        end
-
-        class SequenceFlow < Representable::Decorator
-          include Representable::XML
-          include Representable::XML::Namespace
-          self.representation_wrap = :sequenceFlow
-          namespace "http://www.omg.org/spec/BPMN/20100524/MODEL"
-
-          property :id, attribute: true
-          property :sourceRef, attribute: true, exec_context: :decorator
-          property :targetRef, attribute: true, exec_context: :decorator
-          property :direction, as: :conditionExpression
-
-          def sourceRef
-            represented.sourceRef
-          end
-
-          def targetRef
-            represented.targetRef
-          end
-        end
-
-        class Process < Representable::Decorator
-          include Representable::XML
-          include Representable::XML::Namespace
-          self.representation_wrap = :process
-
-          namespace "http://www.omg.org/spec/BPMN/20100524/MODEL"
-
-          property :id, attribute: true
-
-          collection :start_events, as: :startEvent, decorator: Task
-          collection :end_events, as: :endEvent, decorator: Task
-          collection :task, decorator: Task
-          collection :sequence_flow, decorator: SequenceFlow, as: :sequenceFlow
-        end
-
-        module Diagram
-          class Bounds < Representable::Decorator
-            include Representable::XML
-            include Representable::XML::Namespace
-            self.representation_wrap = :Bounds
-
-            namespace "http://www.omg.org/spec/DD/20100524/DC"
-
-            property :x,      attribute: true
-            property :y,      attribute: true
-            property :width,  attribute: true
-            property :height, attribute: true
-          end
-
-          class Diagram < Representable::Decorator
-            feature Representable::XML
-            feature Representable::XML::Namespace
-            self.representation_wrap = :BPMNDiagram
-
-            namespace "http://www.omg.org/spec/BPMN/20100524/DI"
-
-            property :plane, as: "BPMNPlane" do
-              self.representation_wrap = :plane
-
-              property :element, as: :bpmnElement, attribute: true
-
-              namespace "http://www.omg.org/spec/BPMN/20100524/DI"
-
-              collection :shapes, as: "BPMNShape" do
-                self.representation_wrap = :BPMNShape
-                namespace "http://www.omg.org/spec/BPMN/20100524/DI"
-
-                property :id,                        attribute: true
-                property :element, as: :bpmnElement, attribute: true
-
-                property :bounds, as: "Bounds", decorator: Bounds
-              end
-
-              collection :edges, as: "BPMNEdge" do
-                self.representation_wrap = :BPMNEdge
-                namespace "http://www.omg.org/spec/BPMN/20100524/DI"
-
-                property :id,                        attribute: true
-                property :element, as: :bpmnElement, attribute: true
-
-                # <di:waypoint xsi:type="dc:Point" x="136" y="118" />
-                collection :waypoints, as: :waypoint do
-                  namespace "http://www.omg.org/spec/DD/20100524/DI"
-
-                  property :type, as: "xsi:type", exec_context: :decorator, attribute: true
-                  property :x, attribute: true
-                  property :y, attribute: true
-
-                  def type
-                    "dc:Point"
-                  end
-                end
-              end
-            end
-
-            # namespace "http://www.w3.org/2001/XMLSchema-instance" # xsi
-          end
-        end
-
-        class Definitions < Representable::Decorator
-          include Representable::XML
-          include Representable::XML::Namespace
-          self.representation_wrap = :definitions
-
-          namespace "http://www.omg.org/spec/BPMN/20100524/MODEL"
-          namespace_def bpmn: "http://www.omg.org/spec/BPMN/20100524/MODEL"
-          namespace_def bpmndi: "http://www.omg.org/spec/BPMN/20100524/DI"
-          namespace_def di: "http://www.omg.org/spec/DD/20100524/DI"
-
-          namespace_def dc: "http://www.omg.org/spec/DD/20100524/DC" # <cd:Bounds>
-          namespace_def xsi: "http://www.w3.org/2001/XMLSchema-instance" # used in waypoint.
-
-          property :process, decorator: Process
-          property :diagram, decorator: Diagram::Diagram, as: :BPMNDiagram
-        end
-      end
-    end
-  end
-end
-
-# <bpmndi:BPMNDiagram id="BPMNDiagram_1">
-#   <bpmndi:BPMNPlane id="BPMNPlane_1">
-#      <bpmndi:BPMNShape id="_BPMNShape_Task_2" bpmnElement="Task_2">
-#         <dc:Bounds x="100" y="100" width="36" height="36" />
-#      </bpmndi:BPMNShape>
-#      <bpmndi:BPMNShape id="_BPMNShape_Task_3" bpmnElement="Task_3">
-#         <dc:Bounds x="236" y="78" width="100" height="80" />
-#      </bpmndi:BPMNShape>
-#      <bpmndi:BPMNEdge id="_BPMNConnection_Flow_4" bpmnElement="Flow_4">
-#         <di:waypoint xsi:type="dc:Point" x="136" y="118" />
-#         <di:waypoint xsi:type="dc:Point" x="236" y="118" />
-#      </bpmndi:BPMNEdge>
-#      <bpmndi:BPMNShape id="_BPMNShape_Task_5" bpmnElement="Task_5">
-#         <dc:Bounds x="436" y="78" width="100" height="80" />
-#      </bpmndi:BPMNShape>
-#      <bpmndi:BPMNEdge id="_BPMNConnection_Flow_6" bpmnElement="Flow_6">
-#         <di:waypoint xsi:type="dc:Point" x="336" y="118" />
-#         <di:waypoint xsi:type="dc:Point" x="436" y="118" />
-#      </bpmndi:BPMNEdge>
-#      <bpmndi:BPMNShape id="_BPMNShape_Task_1" bpmnElement="Task_1">
-#         <dc:Bounds x="636" y="100" width="36" height="36" />
-#      </bpmndi:BPMNShape>
-#      <bpmndi:BPMNShape id="_BPMNShape_Task_8" bpmnElement="Task_8">
-#         <dc:Bounds x="636" y="266" width="100" height="80" />
-#      </bpmndi:BPMNShape>
-#      <bpmndi:BPMNEdge id="_BPMNConnection_Flow_7" bpmnElement="Flow_7">
-#         <di:waypoint xsi:type="dc:Point" x="536" y="118" />
-#         <di:waypoint xsi:type="dc:Point" x="636" y="118" />
-#      </bpmndi:BPMNEdge>
-#      <bpmndi:BPMNEdge id="_BPMNConnection_Flow_9" bpmnElement="Flow_9">
-#         <di:waypoint xsi:type="dc:Point" x="536" y="118" />
-#         <di:waypoint xsi:type="dc:Point" x="586" y="118" />
-#         <di:waypoint xsi:type="dc:Point" x="586" y="306" />
-#         <di:waypoint xsi:type="dc:Point" x="636" y="306" />
-#      </bpmndi:BPMNEdge>
-#      <bpmndi:BPMNEdge id="_BPMNConnection_Flow_10" bpmnElement="Flow_10">
-#         <di:waypoint xsi:type="dc:Point" x="686" y="266" />
-#         <di:waypoint xsi:type="dc:Point" x="686" y="201" />
-#         <di:waypoint xsi:type="dc:Point" x="654" y="201" />
-#         <di:waypoint xsi:type="dc:Point" x="654" y="136" />
-#      </bpmndi:BPMNEdge>
-#   </bpmndi:BPMNPlane>
-# </bpmndi:BPMNDiagram>