appmap 0.18.1

data/lib/appmap.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+begin
+  require 'active_support'
+  require 'active_support/core_ext'
+rescue NameError
+  warn 'active_support is not available. AppMap execution will continue optimistically without it...'
+end
+
+require 'appmap/version'
+
+module AppMap
+  BATCH_HEADER_NAME = 'AppLand-Scenario-Batch'
+
+  class << self
+    # Simplified entry point to inspect code for features.
+    def inspect(config)
+      require 'appmap/inspect'
+      features = config.source_locations.map(&AppMap::Inspect.method(:detect_features)).flatten.compact
+      features = features.map(&:reparent)
+      features.each(&:prune)
+    end
+  end
+end
+
+require 'appmap/railtie' if defined?(::Rails::Railtie)

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

@@ -0,0 +1,51 @@
+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).
+    
+  

data/lore/pages/2019-05-21-install-and-record/metadata.yml

@@ -0,0 +1,5 @@
+title: Install the AppMap Rubygem and record a scenario
+authors:
+  - Kevin Gilpin
+tags:
+  []

data/lore/pages/layout.pug

@@ -0,0 +1,66 @@
+doctype html
+html
+  head
+    title= title
+    block styles
+      link(rel='stylesheet', href='/stylesheets/style.css')
+      link(rel='stylesheet', href='/lib/bootstrap-4.1.3/css/bootstrap.css')
+      if maincss
+        link(rel='stylesheet', href=maincss)
+    block scripts
+      if mainjs
+        script(src=mainjs, type="module")
+
+  body
+    .container
+      .row
+        .col-md-12
+          h2.title
+            a(href='/') AppMap Lore
+            span   >  
+            = title
+
+      .row
+        .col-md-12
+          h1 Objective
+      .row
+        .content-column.col-md-12
+          #objective.commentable
+            block objective
+              p TODO
+
+        .comment-column.col-md-4.hidden
+
+      .row
+        .col-md-12
+          h1 Approach
+      .row
+        .content-column.col-md-12
+          #approach.commentable
+            block approach
+              p TODO
+
+        .comment-column.col-md-4.hidden
+
+      .row
+        .col-md-12
+          h1 Results
+      .row
+        .content-column.col-md-12
+          #results.commentable
+            block results
+              p TODO
+
+        .comment-column.col-md-4.hidden
+
+      .row
+        .col-md-12
+          h1 Next Steps
+      .row
+
+        .content-column.col-md-12
+          #next-steps.commentable
+            block next_steps
+              p TODO
+
+        .comment-column.col-md-4.hidden