appmap 0.51.1 → 0.53.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appmap
 version: !ruby/object:Gem::Version
-  version: 0.51.1
+  version: 0.53.0
 platform: ruby
 authors:
 - Kevin Gilpin
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2021-06-21 00:00:00.000000000 Z
+date: 2021-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -24,34 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: faraday
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: gli
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: method_source
   requirement: !ruby/object:Gem::Requirement
@@ -67,7 +39,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: parser
+  name: rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rack
+  name: reverse_markdown
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -112,16 +84,16 @@ dependencies:
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: 5.14.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: 5.14.4
 - !ruby/object:Gem::Dependency
   name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
@@ -307,7 +279,9 @@ dependencies:
 description: 
 email:
 - kgilpin@gmail.com
-executables: []
+executables:
+- appmap-agent-init
+- appmap-inspect
 extensions:
 - ext/appmap/extconf.rb
 extra_rdoc_files: []
@@ -335,14 +309,15 @@ files:
 - examples/mock_webapp/lib/mock_webapp/controller.rb
 - examples/mock_webapp/lib/mock_webapp/request.rb
 - examples/mock_webapp/lib/mock_webapp/user.rb
+- exe/appmap-agent-init
+- exe/appmap-inspect
 - ext/appmap/appmap.c
 - ext/appmap/extconf.rb
 - lib/appmap.rb
-- lib/appmap/algorithm/prune_class_map.rb
-- lib/appmap/algorithm/stats.rb
 - lib/appmap/class_map.rb
-- lib/appmap/command/record.rb
-- lib/appmap/command/stats.rb
+- lib/appmap/command/agent_setup/init.rb
+- lib/appmap/command/inspect.rb
+- lib/appmap/command_error.rb
 - lib/appmap/config.rb
 - lib/appmap/cucumber.rb
 - lib/appmap/event.rb
@@ -356,34 +331,17 @@ files:
 - lib/appmap/metadata.rb
 - lib/appmap/middleware/remote_recording.rb
 - lib/appmap/minitest.rb
+- lib/appmap/node_cli.rb
 - lib/appmap/open.rb
 - lib/appmap/railtie.rb
 - lib/appmap/record.rb
 - lib/appmap/rspec.rb
+- lib/appmap/service/guesser.rb
 - lib/appmap/trace.rb
 - lib/appmap/util.rb
 - lib/appmap/version.rb
-- lore/pages/2019-05-21-install-and-record/index.pug
-- lore/pages/2019-05-21-install-and-record/install_example_appmap.png
-- lore/pages/2019-05-21-install-and-record/metadata.yml
-- lore/pages/layout.pug
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap-grid.css
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap-grid.css.map
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap-grid.min.css
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap-grid.min.css.map
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap-reboot.css
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap-reboot.css.map
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap-reboot.min.css
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap-reboot.min.css.map
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap.css
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap.css.map
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap.min.css
-- lore/public/lib/bootstrap-4.1.3/css/bootstrap.min.css.map
-- lore/public/stylesheets/style.css
-- package-lock.json
 - package.json
 - release.sh
-- spec/abstract_controller_base_spec.rb
 - spec/class_map_spec.rb
 - spec/config_spec.rb
 - spec/fixtures/hook/attr_accessor.rb
@@ -548,6 +506,7 @@ files:
 - spec/fixtures/rails6_users_app/users_app/.gitignore
 - spec/hook_spec.rb
 - spec/open_spec.rb
+- spec/rails_recording_spec.rb
 - spec/rails_spec_helper.rb
 - spec/railtie_spec.rb
 - spec/record_net_http_spec.rb
@@ -555,6 +514,7 @@ files:
 - spec/remote_recording_spec.rb
 - spec/spec_helper.rb
 - spec/util_spec.rb
+- test/agent_setup_init_test.rb
 - test/bundle_vendor_test.rb
 - test/cucumber_test.rb
 - test/expectations/openssl_test_key_sign1.json
@@ -599,11 +559,13 @@ files:
 - test/fixtures/rspec_recorder/spec/labeled_hello_spec.rb
 - test/fixtures/rspec_recorder/spec/plain_hello_spec.rb
 - test/gem_test.rb
+- test/inspect_cli_test.rb
 - test/minitest_test.rb
 - test/openssl_test.rb
 - test/record_process_test.rb
 - test/rspec_test.rb
 - test/test_helper.rb
+- yarn.lock
 homepage: https://github.com/applandinc/appmap-ruby
 licenses:
 - MIT

data/lib/appmap/algorithm/prune_class_map.rb

@@ -1,67 +0,0 @@
-# frozen_string_literal: true
-
-module AppMap
-  module Algorithm
-    # Prune a class map so that only functions, classes and packages which are referenced
-    # by some event are retained.
-    class PruneClassMap
-      attr_reader :class_map
-      # Set this attribute to a function which will log algorithm events.
-      attr_writer :logger
-      attr_accessor :events
-
-      # Construct the algorithm, with a class map that will be pruned in place.
-      def initialize(class_map)
-        @class_map = class_map
-        @logger = ->(msg) {}
-      end
-
-      def perform
-        # This proc counts the number of objects in the class map whose type is 'k'
-        count = proc do |k, e|
-          n = 0
-          n += 1 if e['type'] == k
-          n += (e['children'] || []).map { |child| count.call(k, child) }.reduce(0, :+)
-          n
-        end
-
-        @logger.call "Full classMap contains #{class_map.map { |m| count.call('class', m) }.reduce(0, :+)} classes"
-
-        # Prune all the classes which fail a test.
-        reject = proc do |list, test|
-          list.tap do |_|
-            list.each do |item|
-              children = item['children']
-              next unless children
-
-              reject.call(children, test)
-            end
-            list.reject!(&test)
-          end
-        end
-
-        if events
-          locations = \
-            Set.new(events.select { |e| e['event'] == 'call' }
-            .map { |e| [ e['path'], e['lineno'] ].join(':') })
-
-          # Prune all functions which aren't called
-          reject.call class_map,
-                      ->(e) { e['type'] == 'function' && !locations.member?(e['location']) }
-        end
-
-        # Prune all empty classes
-        reject.call class_map,
-                    ->(e) { e['type'] == 'class' && (e['children'] || []).empty? }
-
-        # Prune all empty packages
-        reject.call class_map,
-                    ->(e) { e['type'] == 'package' && (e['children'] || []).empty? }
-
-        @logger.call "Pruned classMap contains #{class_map.map { |m| count.call('class', m) }.reduce(0, :+)} classes"
-
-        class_map
-      end
-    end
-  end
-end

data/lib/appmap/algorithm/stats.rb

@@ -1,91 +0,0 @@
-# frozen_string_literal: true
-
-module AppMap
-  module Algorithm
-    StatsStruct = Struct.new(:appmap)
-
-    # Compute AppMap statistics.
-    class Stats < StatsStruct
-      Result = Struct.new(:class_frequency, :method_frequency) do
-        def merge!(other)
-          merge = lambda do |freq, other_freq|
-            freq_by_name = freq.inject({}) do |table, entry|
-              table.tap do
-                table[entry.name] = entry
-              end
-            end
-            other_freq.each do |other_entry|
-              entry = freq_by_name[other_entry.name]
-              if entry
-                entry.count += other_entry.count
-              else
-                freq << other_entry
-              end
-            end
-          end
-          merge.call(class_frequency, other.class_frequency)
-          merge.call(method_frequency, other.method_frequency)
-
-          self
-        end
-
-        def sort!
-          comparator = ->(a,b) { b.count <=> a.count }
-          class_frequency.sort!(&comparator)
-          method_frequency.sort!(&comparator)
-
-          self
-        end
-
-        def limit!(limit)
-          self.class_frequency = class_frequency[0...limit]
-          self.method_frequency = method_frequency[0...limit]
-
-          self
-        end
-
-        def as_text
-          lines = [
-            "Class frequency:",
-            "----------------",
-          ] + class_frequency.map(&:to_a).map(&:reverse).map { |line | line.join("\t") } + [
-            "",
-            "Method frequency:",
-            "----------------",
-          ] + method_frequency.map(&:to_a).map(&:reverse).map { |line | line.join("\t") }
-          lines.join("\n")
-        end
-      end
-      Frequency = Struct.new(:name, :count)
-
-      def perform(limit: nil)
-        events = appmap['events'] || []
-        frequency_calc = lambda do |key_func|
-          events_by_key = events.inject(Hash.new(0))  do |memo, event|
-            key = key_func.call(event)
-            memo.tap do
-              memo[key] += 1 if key
-            end
-          end
-          events_by_key.map do |key, count|
-            Frequency.new(key, count)
-          end
-        end
-
-        class_name_func = ->(event) { event['defined_class'] }
-        full_name_func = lambda do |event|
-          call = event['event'] == 'call'
-          class_name = event['defined_class']
-          static = event['static']
-          function_name = event['method_id']
-          [ class_name, static ? '.' : '#', function_name ].join if call && class_name && !static.nil? && function_name
-        end
-
-        class_frequency = frequency_calc.call(class_name_func)
-        method_frequency = frequency_calc.call(full_name_func)
-
-        Result.new(class_frequency, method_frequency)
-      end
-    end
-  end
-end

data/lib/appmap/command/record.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-module AppMap
-  module Command
-    RecordStruct = Struct.new(:config, :program)
-
-    class Record < RecordStruct
-      def perform(&block)
-        tracer = AppMap.tracing.trace
-
-        events = []
-        quit = false
-        event_thread = Thread.new do
-          while tracer.event? || !quit
-            event = tracer.next_event
-            if event
-              events << event.to_h
-            else
-              sleep 0.0001
-            end
-          end
-        end
-        event_thread.abort_on_exception = true
-
-        at_exit do
-          quit = true
-          event_thread.join
-          yield AppMap::APPMAP_FORMAT_VERSION,
-                AppMap.detect_metadata,
-                AppMap.class_map(tracer.event_methods),
-                events
-        end
-
-        load program if program
-      end
-    end
-  end
-end

data/lib/appmap/command/stats.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-module AppMap
-  module Command
-    StatsStruct = Struct.new(:appmap)
-
-    class Stats < StatsStruct
-      def perform(limit: nil)
-        require 'appmap/algorithm/stats'
-        AppMap::Algorithm::Stats.new(appmap).perform(limit: limit)
-      end
-    end
-  end
-end

data/lore/pages/2019-05-21-install-and-record/index.pug

@@ -1,51 +0,0 @@
-extends ../layout
-
-block objective
-  div.
-    Installation of the AppMap client for Ruby is a key step in the user adoption flow.
-    Let's create an example program which installs the #[code appmap] Ruby gem and runs it to record a
-    scenario of a sample app.
-
-block approach
-  :markdown-it
-    The [examples](https://github.com/applandinc/appmap-ruby/blob/master/examples/) folder in this project contains a sample project called `mock_webapp`, which 
-    performs the following:
-
-    * Requests a `User` object by id ("alice").
-    * The request is handled by a `Controller`.
-    * The `Controller` looks up the id in a `User` model.
-    * The `User` model looks up the id and returns a `User` object, or raises an error.
-    * The `Controller` renders the response as a Hash and returns it to the client.
-
-    A test program called `install.rb` installs the `appmap` Ruby gem and then records the `mock_webapp`.
-    To create an appmap of `install.rb`:
-
-    ```
-    bundle exec exe/record examples/install.rb
-    ```
-
-    To upload the AppMap to AppLand:
-
-    ```
-    bundle exec exe/upload appmap.json
-    ```
-
-block results
-  :markdown-it
-    ## AppMap of `install.rb`
-
-    [![AppMap of `install.rb`](install_example_appmap.png)](https://appland-staging.herokuapp.com/scenarios/ba2fc385-a96d-42bf-9ef8-cdbdab8a475d)
-
-  button(onclick="document.querySelector('#show-test-program').style.display = 'block';") Show test program code
-  div#show-test-program(style='display: none;')
-    pre
-      include ../../../examples/install.rb
-
-block next_steps
-  :markdown-it
-
-    A related feature is the AppLand server receiving the scenario file and displaying it.
-
-    Here is an [AppMap of the server receiving a scenario file](https://appland-staging.herokuapp.com/scenarios/beb49bc7-b2ca-49b6-bac3-5d2eec2df062).
-    
-