trailblazer-developer 0.0.27 → 0.1.0

data/trailblazer-developer.gemspec

@@ -22,9 +22,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "minitest"
   spec.add_development_dependency "minitest-line"
   spec.add_development_dependency "rake"
-  spec.add_development_dependency "trailblazer-operation"
+  spec.add_development_dependency "trailblazer-operation", ">= 0.10.0"
 
-  spec.add_dependency "trailblazer-activity-dsl-linear", ">= 1.1.0", "< 1.2.0"
-  # FIXME: Activity 0.14.1
+  spec.add_dependency "trailblazer-activity-dsl-linear", ">= 1.2.0", "< 1.3.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.27
+  version: 0.1.0
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-12-14 00:00:00.000000000 Z
+date: 2023-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -72,34 +72,34 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.10.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.10.0
 - !ruby/object:Gem::Dependency
   name: trailblazer-activity-dsl-linear
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: 1.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: 1.3.0
 - !ruby/object:Gem::Dependency
   name: hirb
   requirement: !ruby/object:Gem::Requirement
@@ -122,9 +122,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/workflows/ci.yml"
-- ".github/workflows/ci_jruby.yml"
-- ".github/workflows/ci_legacy.yml"
-- ".github/workflows/ci_truffleruby.yml"
 - ".gitignore"
 - CHANGES.md
 - Gemfile
@@ -134,16 +131,21 @@ files:
 - bin/console
 - bin/setup
 - lib/trailblazer/developer.rb
+- lib/trailblazer/developer/debugger.rb
+- lib/trailblazer/developer/debugger/normalizer.rb
 - lib/trailblazer/developer/introspect.rb
+- lib/trailblazer/developer/introspect/graph.rb
 - lib/trailblazer/developer/render/circuit.rb
 - lib/trailblazer/developer/render/linear.rb
 - lib/trailblazer/developer/render/task_wrap.rb
 - lib/trailblazer/developer/trace.rb
-- lib/trailblazer/developer/trace/debugger.rb
-- lib/trailblazer/developer/trace/debugger/normalizer.rb
+- lib/trailblazer/developer/trace/node.rb
+- lib/trailblazer/developer/trace/parent_map.rb
 - lib/trailblazer/developer/trace/present.rb
+- lib/trailblazer/developer/trace/snapshot.rb
+- lib/trailblazer/developer/trace/snapshot/value.rb
+- lib/trailblazer/developer/trace/snapshot/versions.rb
 - lib/trailblazer/developer/trace/stack.rb
-- lib/trailblazer/developer/trace/tree.rb
 - lib/trailblazer/developer/version.rb
 - lib/trailblazer/developer/wtf.rb
 - lib/trailblazer/developer/wtf/renderer.rb

data/.github/workflows/ci_jruby.yml

@@ -1,19 +0,0 @@
-## This file is managed by Terraform.
-## Do not modify this file directly, as it may be overwritten.
-## Please open an issue instead.
-name: CI JRuby
-on: [push, pull_request]
-jobs:
-  test:
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby: [jruby, jruby-head]
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v3
-    - uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby }}
-        bundler-cache: true
-    - run: bundle exec rake

data/.github/workflows/ci_legacy.yml

@@ -1,19 +0,0 @@
-## This file is managed by Terraform.
-## Do not modify this file directly, as it may be overwritten.
-## Please open an issue instead.
-name: CI with EOL ruby versions
-on: [push, pull_request]
-jobs:
-  test:
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby: [2.5, 2.6]
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v3
-    - uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby }}
-        bundler-cache: true
-    - run: bundle exec rake

data/.github/workflows/ci_truffleruby.yml

@@ -1,19 +0,0 @@
-## This file is managed by Terraform.
-## Do not modify this file directly, as it may be overwritten.
-## Please open an issue instead.
-name: CI TruffleRuby
-on: [push, pull_request]
-jobs:
-  test:
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby: [truffleruby, truffleruby-head]
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v3
-    - uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby }}
-        bundler-cache: true
-    - run: bundle exec rake

data/lib/trailblazer/developer/trace/debugger/normalizer.rb

@@ -1,68 +0,0 @@
-module Trailblazer
-  module Developer
-    module Trace
-      module Debugger
-        # @private
-        # Public entry point to add Debugger::Node normalizer steps.
-        def self.add_normalizer_step!(step, id:, normalizer: Normalizer::PIPELINES.last, **options)
-          task = Normalizer.Task(step)
-
-          # We have a TaskWrap::Pipeline (a very simple style of "activity" used for normalizers) and
-          # add another step using the "friendly interface" from {Activity::Adds}.
-          options = {append: nil} unless options.any?
-
-          pipeline_extension = Activity::TaskWrap::Extension.build([task, id: id, **options])
-
-          Normalizer::PIPELINES << pipeline_extension.(normalizer)
-        end
-
-        module Normalizer
-          def self.Task(user_step) # TODO: we could keep this in the {activity} gem.
-            Activity::TaskWrap::Pipeline::TaskAdapter.for_step(user_step, option: false) # we don't need Option as we don't have ciruit_options here, and no {:exec_context}
-          end
-
-          # Default steps for the Debugger::Node options pipeline, following the step-interface.
-          module Default
-            def self.compile_id(ctx, task_map_for_activity:, task:, **)
-              ctx[:compile_id] = task_map_for_activity.fetch(task)[:id]
-            end
-
-            def self.compile_path(ctx, parent_map:, captured_node:, **)
-              ctx[:compile_path] = Trace::Tree::ParentMap.path_for(parent_map, captured_node)
-            end
-
-            def self.runtime_id(ctx, compile_id:, **)
-              ctx[:runtime_id] = compile_id
-            end
-
-            def self.runtime_path(ctx, runtime_id:, compile_path:, **)
-              return ctx[:runtime_path] = compile_path if compile_path.empty? # FIXME: this currently only applies to root.
-
-              ctx[:runtime_path] = compile_path[0..-2] + [runtime_id]
-            end
-
-            def self.label(ctx, label: nil, runtime_id:, **)
-              ctx[:label] = label || runtime_id
-            end
-
-            def self.data(ctx, data: {}, **)
-              ctx[:data] = data
-            end
-          end
-
-          default_steps = {
-            compile_id:       Normalizer.Task(Default.method(:compile_id)),
-            compile_path:     Normalizer.Task(Default.method(:compile_path)),
-            runtime_id:       Normalizer.Task(Default.method(:runtime_id)),
-            runtime_path:     Normalizer.Task(Default.method(:runtime_path)),
-            label:            Normalizer.Task(Default.method(:label)),
-            data:             Normalizer.Task(Default.method(:data)),
-          }.
-          collect { |id, task| Activity::TaskWrap::Pipeline.Row(id, task) }
-
-          PIPELINES = [Activity::TaskWrap::Pipeline.new(default_steps)] # we do mutate this constant at compile-time. Maybe # DISCUSS and find a better way.
-        end
-      end
-    end
-  end
-end

data/lib/trailblazer/developer/trace/debugger.rb

@@ -1,81 +0,0 @@
-module Trailblazer
-  module Developer
-    module Trace
-      module Debugger
-        class Node < Struct.new(:captured_node, :task, :activity, :compile_id, :compile_path, :runtime_id, :runtime_path, :label, :data, :captured_input, :captured_output, :level, keyword_init: true)
-          # The idea is to only work with {Activity} instances on this level, as that's the runtime concept.
-
-            # TODO: class, "type",
-            # which track, return signal, etc
-
-
-          # we always key options for specific nodes by Stack::Captured::Input, so we don't confuse activities if they were called multiple times.
-          def self.build(tree, enumerable_tree, node_options: {}, normalizer: Debugger::Normalizer::PIPELINES.last, **options_for_nodes)
-            parent_map = Trace::Tree::ParentMap.build(tree).to_h # DISCUSS: can we use {enumerable_tree} for {ParentMap}?
-
-
-            container_activity = enumerable_tree[0].captured_input.activity # TODO: any other way to grab the container_activity? Maybe via {activity.container_activity}?
-
-  # TODO: cache activity graph
-            top_activity = enumerable_tree[0].captured_input.task
-
-            task_maps_per_activity = {
-              container_activity => {top_activity => {id: nil}} # exposes {Introspect::TaskMap}-compatible interface.
-            }
-
-            # DISCUSS: this might change if we introduce a new Node type for Trace.
-            debugger_nodes = enumerable_tree[0..-1].collect do |node|
-              activity      = node.captured_input.activity
-              task          = node.captured_input.task
-              # it's possible to pass per-node options, like {label: "Yo!"} via {:node_options[<captured_input>]}
-              options       = node_options[node.captured_input] || {}
-
-
-
-              task_map_for_activity = task_maps_per_activity[activity] || Activity::Introspect.TaskMap(activity)
-
-              options_for_debugger_node, _ = normalizer.(
-                {
-                  captured_node:          node,
-                  task:                   task,
-                  activity:               activity,
-                  parent_map:             parent_map,
-                  task_map_for_activity:  task_map_for_activity,
-                  **options
-                },
-                []
-              )
-
-              options_for_debugger_node = options_for_debugger_node.slice(*(options_for_debugger_node.keys - [:parent_map, :task_map_for_activity]))
-
-              # these attributes are not changing with the presentation
-              Debugger::Node.new(
-                captured_node:  node,
-                activity:       activity,
-                task:           task,
-
-                level: node.level,
-                captured_input: node.captured_input,
-                captured_output: node.captured_output,
-
-                **options_for_debugger_node,
-              ).freeze
-            end
-          end
-
-          def self.build_for_stack(stack, **options_for_debugger_nodes)
-            tree, processed = Trace.Tree(stack.to_a)
-
-            enumerable_tree = Trace::Tree.Enumerable(tree)
-
-            Debugger::Node.build(
-              tree,
-              enumerable_tree,
-              **options_for_debugger_nodes,
-            )
-          end
-        end
-      end # Debugger
-    end # Trace
-  end
-end

data/lib/trailblazer/developer/trace/tree.rb

@@ -1,86 +0,0 @@
-module Trailblazer
-  module Developer
-    module Trace
-      # Datastructure representing a trace.
-      class Tree
-        # This could also be seen as {tree.to_a}.
-        def self.Enumerable(node)
-          Enumerable.nodes_for(node)
-        end
-
-        module Enumerable
-          # @private
-          def self.nodes_for(node)
-            [node, *node.nodes.collect { |n| nodes_for(n) } ].flatten
-          end
-        end # Enumerable
-
-        # Map each {Node} instance to its parent {Node}.
-        module ParentMap
-          def self.build(node)
-            children_map = []
-            node.nodes.each { |n| children_map += ParentMap.build(n) }#.flatten(1)
-
-            node.nodes.collect { |n| [n, node] } + children_map
-          end
-
-          # @public
-          def self.path_for(parent_map, node)
-            path = []
-
-            while parent = parent_map[node] # DISCUSS: what if the graphs are cached and present, already?
-              node_id = Activity::Introspect::TaskMap(node.captured_input.activity)[node.captured_input.task][:id]
-              path << node_id
-
-              node = parent
-            end
-
-            path.reverse
-          end
-        end
-
-        class Node < Struct.new(:level, :captured_input, :captured_output, :nodes)
-        end
-      end # Tree
-
-
-      # Builds a tree graph from a linear stack.
-      # Consists of {Tree::Node} structures.
-      def self.Tree(stack_end, level: 0, parent: nil)
-        processed = []
-        nodes     = []
-
-        # for {captured_input} we're gonna build a {Node}!
-        captured_input, remaining = stack_end[0], stack_end[1..-1]
-
-            raise unless captured_input.is_a?(Captured::Input)
-
-        while next_captured = remaining[0]
-          if next_captured.is_a?(Captured::Input)
-
-            bla, _processed = Tree(remaining, level: level+1)
-            nodes += [bla]
-            processed += _processed
-
-
-            remaining = remaining - processed
-
-          else # Captured::Output
-
-            raise unless next_captured.is_a?(Captured::Output)
-            raise if next_captured.activity != captured_input.activity
-
-            node = Tree::Node.new(level, captured_input, next_captured, nodes)
-
-            return node,
-              [captured_input, *processed, next_captured] # what nodes did we process here?
-
-          end
-
-        end
-
-
-      end # Tree
-    end
-  end # Developer
-end