seeing_is_believing 3.1.1 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ee80ef63960aa8529058bcc47ecfa53e1eb80443
-  data.tar.gz: 8194f95036da74d4aa45e968e774211cb5f2169b
+  metadata.gz: fd4c625530426d55efef82e47755e16b6178a677
+  data.tar.gz: 72bd371886e9f902eaf9cb4989c9ff3dc322ede6
 SHA512:
-  metadata.gz: f45e44395230ffd260610ce06a9f4bb9ffea63b006bc76b701432cf47c1c73b10cc35c6bdb1d61938861b5e6f5215986b082a944d986dc3ee888304c9dab16f6
-  data.tar.gz: aed2c640442c6cf6a2c84e863fe1dce8a0713a6e87f431a4dba52cd07d5170265454674704662c1e4911e8bcbf265a2b99e749923cc6a47566d850832dd0b258
+  metadata.gz: 94ff5a19f0e9292bc25400263d1772aaef661768fc0a922e0f7b9b65577d8bb6227a03b90a35e6cfa1ebe315292969bf7aaf2cc19084e9dee0cc4c2a07de8c18
+  data.tar.gz: 975e4ef13344fb4f96eacccddb6f2f862304c73a77552cb5c54b6788ea7326ce55dd5525fd6ec5c61c29e85a963ed8aee147efdff9ebc596bc4adb8682da8b10

data/.travis.yml

@@ -7,3 +7,4 @@ rvm:
   - 2.1.2
   - 2.2.0
   - 2.3.1
+  - 2.4.0

data/Rakefile

@@ -1,8 +1,8 @@
 desc 'Have Bundler setup a standalone environment -- run tests in this, b/c its faster and safer'
 task :install do
-  `which bundle`
-  unless $?.success?
-    sh 'gem', 'install', 'bundler'
+  exe_path = which("bundle")
+  unless exe_path
+    sh 'gem', 'install', 'bundler', '--no-ri', '--no-rdoc'
   end
 
   unless Dir.exist? 'bundle'
@@ -14,12 +14,13 @@ end
 desc 'Remove generated and irrelevant files'
 task :clean do
   rm_rf [
-    'bundle',
-    '.bundle',
-    'Gemfile.lock',
-    'proving_grounds',
-    *Dir['*.gem'],
-  ]
+            'bundle',
+            '.bundle',
+            'Gemfile.lock',
+            'proving_grounds',
+            'tags',
+            *Dir['*.gem'],
+        ]
 end
 
 directory 'bundle' do
@@ -33,26 +34,52 @@ def require_paths
     spec.require_paths.map do |path|
       File.join(spec.full_gem_path, path)
     end
-  }.flat_map { |p| ['-I', p ] }
+  }.flat_map { |p| ['-I', p] }
+end
+
+desc 'Print the require paths for arbitrary binary execution'
+task :require_paths, [:delimiter] => :bundle do |delimiter: ' '|
+  puts require_paths.join(delimiter)
 end
 
 desc 'Run specs'
 task spec: :bundle do
-  sh 'ruby', '--disable-gem', *require_paths, '-S', 'bundle/bin/mrspec'
+  sh 'ruby', '--disable-gem', *require_paths, '-S', 'bundle/bin/rspec', '--fail-fast'
 end
 
 desc 'Run cukes'
 task cuke: :bundle do
   require 'bundler'
+  platform_filter = Gem.win_platform? ? %W[--tags ~@not-windows] : []
+  sh 'ruby', '--disable-gem',
+     *require_paths,
+     '-S', 'bundle/bin/cucumber',
+     '--tags', '~@not-implemented',
+     '--tags', "~@not-#{RUBY_VERSION}",
+      *platform_filter
+end
+
+desc 'Generate tags for quick navigation'
+task tags: :bundle do
+  excludes = %w[tmp tmpgem bundle proving_grounds].map { |dir| "--exclude=#{dir}" }
   sh 'ruby', '--disable-gem',
-             *require_paths,
-             '-S', 'bundle/bin/cucumber',
-             '--tags', '~@not-implemented',
-             '--tags', "~@not-#{RUBY_VERSION}"
+     *require_paths,
+     '-S', 'bundle/bin/ripper-tags',
+     '-R', *excludes
 end
+task ctags: :tags # an alias
+
 
 desc 'Run all specs and cukes'
 task default: [:spec, :cuke]
 
 desc 'Install dependencies and run tests (mainly for Travis CI)'
-task ci: [:install, :spec, :cuke]
+task ci: [:spec, :cuke]
+
+def which(exe)
+  dirs = ENV["PATH"].split(File::PATH_SEPARATOR)
+  exts = [""]
+  exts.concat(ENV["PathExt"].to_s.split(File::PATH_SEPARATOR))
+  candidates = dirs.product(exts) { |dir, ext| File.join(dir, exe + ext) }
+  exe_path = candidates.find { |c| File.executable?(c) }
+end

data/Readme.md

@@ -1,265 +1,50 @@
-[![Stories in Ready](https://badge.waffle.io/JoshCheek/seeing_is_believing.png?label=ready&title=Ready)](https://waffle.io/JoshCheek/seeing_is_believing)
-[![Build Status](https://secure.travis-ci.org/JoshCheek/seeing_is_believing.png?branch=master)](http://travis-ci.org/JoshCheek/seeing_is_believing)
+Unix/Mac: [![Unix Build Status](https://secure.travis-ci.org/JoshCheek/seeing_is_believing.png?branch=master)](http://travis-ci.org/JoshCheek/seeing_is_believing)    Windows: [![Windows Build Status](https://ci.appveyor.com/api/projects/status/32r7s2skrgm9ubva?svg=true)](https://ci.appveyor.com/project/JoshCheek/seeing-is-believing)
 
 Seeing Is Believing
 ===================
 
 Evaluates Ruby code, recording the results of each line.
-Integrates with any extensible editor (I've integrated it with many already, see [the list](https://github.com/JoshCheek/seeing_is_believing#editor-integration)).
+Integrates with any extensible editor (I've integrated it with many already, see [the list](https://github.com/JoshCheek/seeing_is_believing/wiki/Editor-Integration)).
 If you like Swift Playgrounds, you'll like SiB.
 
 ![example](https://s3.amazonaws.com/josh.cheek/images/scratch/sib-example1.gif)
 
-Watch a [longer video](http://vimeo.com/73866851).
 
+Helpful links
+-------------
 
-Install
-=======
+* [Install](https://github.com/JoshCheek/seeing_is_believing/wiki/Installation)
+* [Integrate with your editor](https://github.com/JoshCheek/seeing_is_believing/wiki/Editor-Integration)
+* [Use as a library](https://github.com/JoshCheek/seeing_is_believing/wiki/Library-example)
+* [Use on the command line](https://github.com/JoshCheek/seeing_is_believing/wiki/Command-Line-Usage)
+* [Pro Tips (useful patterns)](https://github.com/JoshCheek/seeing_is_believing/wiki/Pro-Tips)
+* [Features](https://github.com/JoshCheek/seeing_is_believing/tree/master/features)
+* [Potential Future Features](https://github.com/JoshCheek/seeing_is_believing/wiki/Potential-future-features)
+* [Set up it up for development work](https://github.com/JoshCheek/seeing_is_believing/wiki/Setting-it-up-for-Development)
 
-Requires Ruby >= 2.1
 
-```sh
-$ gem install seeing_is_believing
-```
+Examples
+--------
 
-Verify the install with
-
-```sh
-$ seeing_is_believing -e '1 + 1'
-1 + 1  # => 2
-```
-
-
-Use The Binary
-==============
-
-Given the file `simple_example.rb`
-
-```ruby
-5.times do |i|
-  i * 2
-end
-```
-
-`$ seeing_is_believing simple_example.rb` will print:
-
-```ruby
-5.times do |i|  # => 5
-  i * 2         # => 0, 2, 4, 6, 8
-end             # => 5
-```
-
-`$ seeing_is_believing simple_example.rb --json` will print:
-
-```json
-{"stdout":"","stderr":"","exitstatus":0,"exception":null,"lines":{"1":["5"],"2":["0","2","4","6","8"],"3":["5"]}}
-```
-
-Protips
-=======
-
-These things have been useful for integrating.
-
-If you want to execute from some specific dir (eg if your editor is in the wrong dir)
-try using `Dir.chdir` at the top of the script.
-Eg I used that [here](https://github.com/JoshCheek/seeing_is_believing/issues/58#issuecomment-91600783)
-so I could run with a full Rails app available in "Completely against the real env".
-
-If you want some specific file to be available in that environment, require the fullpath to the file.
-Eg I used that [here](https://github.com/JoshCheek/seeing_is_believing/issues/58#issuecomment-91600783)
-to load up the Rils schema in "Running against the real schema".
-
-You can also set the `$LOAD_PATH` to a gem you're working on and then require files as if
-it was installed.
-
-You work with `gets` by setting `$stdin` to the `DATA` segment and writing inputs there.
-
-```ruby
-$stdin = DATA
-
-puts "What's your name?"
-name = gets.chomp
-puts "What's your favourite colour?"
-colour = gets.chomp
-puts "#{name}'s favourite colour is #{colour}."
-
-# >> What's your name?
-# >> What's your favourite colour?
-# >> Josh's favourite colour is brown.
-
-__END__
-Josh
-brown
-```
-
-Rescue lines you expect to explode so that it displays the expected result and continues evaluating.
-
-```ruby
-lambda { |x| x }.call()     rescue $!  # => #<ArgumentError: wrong number of arguments (given 0, expected 1)>
-lambda { |x| x }.call(1)               # => 1
-lambda { |x| x }.call(1, 2) rescue $!  # => #<ArgumentError: wrong number of arguments (given 2, expected 1)>
-```
-
-Use `fork` to look at what a program does when run two different ways.
-
-```ruby
-class A
-  fork && raise("omg")  # => nil
-rescue
-  $!                    # => #<RuntimeError: omg>
-else
-  :nothing_raised       # => :nothing_raised
-end                     # => #<RuntimeError: omg>, :nothing_raised
-```
-
-Use The Lib
-===========
-
-```ruby
-require 'seeing_is_believing'
-
-# There are a lot of options you can pass here, including a custom handler
-handler = SeeingIsBelieving.call("[:a, :b, :c].each do |i|
-                                    i.upcase
-                                  end")
-result = handler.result
-
-result[2]            # => [":A", ":B", ":C"]
-result[2][0]         # => ":A"
-result[2][1]         # => ":B"
-result[2][2]         # => ":C"
-result[2].join(", ") # => ":A, :B, :C"
-
-result.stdout    # => ""
-result.stderr    # => ""
-result.exception # => nil
-```
-
-
-
-Editor Integration
-==================
-
-* [Atom](https://github.com/JoshCheek/atom-seeing-is-believing) (prob has best installation instructions, overall best integration, but config and filesystem events are iffy)
-* [Sublime 2 and 3](https://github.com/JoshCheek/sublime-text-2-and-3-seeing-is-believing) (works reasonably, but isn't integrated with the package manager)
-* [TextMate 1](https://github.com/JoshCheek/text_mate_1-seeing-is_believing)
-* [TextMate 2](https://github.com/JoshCheek/text_mate_2-seeing-is_believing) (TM2 is actually looking really nice these days -- Josh Cheek, 18 Feb 2015)
-
-
-Vim
----
-
-These packages support SiB:
-
-* [vim-seeing-is-believing](https://github.com/hwartig/vim-seeing-is-believing)
-* [vim-ruby-xmpfilter](https://github.com/t9md/vim-ruby-xmpfilter)
-
-Personally, I had difficulty with them, but this configuration has gotten me pretty far:
-
-```viml
-" ===== Seeing Is Believing =====
-" Assumes you have a Ruby with SiB available in the PATH
-" If it doesn't work, you may need to `gem install seeing_is_believing -v 3.0.0.beta.6`
-" ...yeah, current release is a beta, which won't auto-install
-
-" Annotate every line
-  nmap <leader>b :%!seeing_is_believing --timeout 12 --line-length 500 --number-of-captures 300 --alignment-strategy chunk<CR>;
-" Annotate marked lines
-  nmap <leader>n :%.!seeing_is_believing --timeout 12 --line-length 500 --number-of-captures 300 --alignment-strategy chunk --xmpfilter-style<CR>;
-" Remove annotations
-  nmap <leader>c :%.!seeing_is_believing --clean<CR>;
-" Mark the current line for annotation
-  nmap <leader>m A # => <Esc>
-" Mark the highlighted lines for annotation
-  vmap <leader>m :norm A # => <Esc>
-```
-
-
-Emacs Integration
------------------
-
-You can use my friend's configuration [file](https://github.com/jcinnamond/seeing-is-believing).
-You can see him use it in [this](http://brightonruby.com/2016/the-point-of-objects-john-cinnamond/?utm_source=rubyweekly&utm_medium=email)
-presentation at 10 minutes.
-
-Alternatively, adding this function to your Emacs configuration will get you pretty far:
-
-```scheme
-(defun seeing-is-believing ()
-  "Replace the current region (or the whole buffer, if none) with the output
-of seeing_is_believing."
-  (interactive)
-  (let ((beg (if (region-active-p) (region-beginning) (point-min)))
-        (end (if (region-active-p) (region-end) (point-max)))
-        (origin (point)))
-    (shell-command-on-region beg end "seeing_is_believing" nil 'replace)
-    (goto-char origin)))
-```
-
-You can now call `seeing-is-believing` to replace the current region
-or current buffer contents with the output of running it through
-`seeing_is_believing`.
-
-
-Features
-========
-
-Check the [features](features) directory.
+* Watch a [longer video](http://vimeo.com/73866851).
+* Watch John Cinnamond use it in a [presentation](http://brightonruby.com/2016/the-point-of-objects-john-cinnamond/)
+  at the 10 minute mark.
+* [Avdi](https://github.com/avdi) uses it in [Ruby Tapas](https://www.rubytapas.com/),
+  an amazing resource for developers in general and Ruby Developers in particular!
 
 
 Known Issues
-============
+------------
 
-* `begin; else; break; end` this code (an else without a resecue) will emit a warning in Ruby, and is omitted from `Parser`'s AST.
+* Assumes utf-8 everywhere. If this is an issue, please see the [encodings](https://github.com/JoshCheek/seeing_is_believing/wiki/Encodings) section of the wiki.
+* `begin; else; break; end` this code (an else without a rescue) will emit a warning in Ruby, and is omitted from `Parser`'s AST.
   As such, I doubt that anyone will ever write it. But if you were to write it, it would blow up, because SiB rewrites your code, wrapping every expression that could have a value.
-  This code will be wrapped. But using the value is **syntactically** invalid in Ruby, because it constitutes a "void value expression" (aka a pointless timesink and the cause of many bugs in SiB).
-  Unfortunately, I can't easily check it to seee if it's void since it's not in the parsed AST.  But it's so edge that I don't think it's worth worrying about.
-
-Setting up Development
-======================
-
-* Make sure you have Ruby (I use [chruby](https://github.com/postmodern/chruby) and [ruby-install](https://github.com/postmodern/ruby-install) for this).
-* Make sure you have bundler and rake (`gem install bundler rake`)
-* Fork the repo (there's a button on Github)
-* Clone your fork (`git clone git@github.com:YOUR_GITHUB_NAME/seeing_is_believing.git`)
-* Install the dependencies (`rake install`) This approach is painful, but it means the test suite is like 30s instead of 5min.
-* Get a list of rake tasks (`rake -T`)
-* Run the full test suite (`rake`)
-* Run the rspec tests `bundle exec rspec` from here you can pass options you want, such as a tag for the tests you're interested in.
-* Run the Cucumber tests `bundle exec cucumber` (these literally invoke the executable, as a user would)
-
-
-Some stuff that might happen one day
-====================================
-
-* Add default to number of captures (1000), require user to explicitly set it to infinity
-* Expose markers via the CLI
-* Spruce up editor integration
-  * Integrate with package managers where they are available
-  * Expose options to use the streaming API (update as events are seen)
-  * Ship with Traveling Ruby so that new users can just press a button and it works,
-    rather than having to figure out all the compmlex ecosystem around installing
-  * Would be nice to have real integration with Emacs
-  * Would be nice to support Ruby Mine
-* How about if begin/rescue/end was able to record the result on the rescue section
-* How about if you could configure which kinds of results you were interested in
-  (e.g. turn on/off recording of method definitions, and other results)
-* What about recording the result of a line inside of a string interpolation,
-  e.g. "a#{\n1\n}b" could record line 2 is 1 and line 3 is "a\n1\nb"
-  This would require smarter annotators.
-* Allow debugger to take a filename (ie debug to a file insteaad of to stderr)
-* `--cd dir` cd to that dir before executing the code
-* `--cd -` cd to the dir of the file being executed before executing it
-* `--only-show-lines` output only on specified lines (doesn't change stdout/stderr/exceptions)
-* More alignment strategies e.g. `min=40` would align to 40, unless that was too short.
-  Could have fallback strategies, so e.g. `-s min=40,fallback=line`
-* Package Ruby with the editor downloads so that they don't require you to know so fkn much to set it up.
-* Allow user to set marker
-* Maybe rename xmpfilter style, not many people know what that is, so the name doesn't help users
+  This code will be wrapped. But using the value is **syntactically** invalid in Ruby, because it constitutes a "void value expression" (aka a pointless time sink and the cause of many bugs in SiB).
+  Unfortunately, I can't easily check it to see if it's void since it's not in the parsed AST.  But it's so edge that I don't think it's worth worrying about.
 
 
 Inspiration
-===========
+-----------
 
 * [Xmpfilter](http://www.rubydoc.info/gems/rcodetools/0.8.5.0/Rcodetools/XMPFilter), which is a part of the [rcodetools gem](https://rubygems.org/gems/rcodetools).
 * Bret Victor's completely inspiring talk [Inventing on Principle](https://www.youtube.com/watch?v=PUv66718DII).
@@ -267,7 +52,7 @@ Inspiration
 
 
 Shout outs
-==========
+----------
 
 * Whitequark for all the work on [Parser](http://github.com/whitequark/parser/), which dramatically dramatically improved SiB (I used to have my own horribly shitty line-based parser)
 * [Travis CI](https://travis-ci.org/JoshCheek/seeing_is_believing)... I love you times a million! So many difficult bugs have been caught by this.
@@ -275,7 +60,7 @@ Shout outs
   I literally have a Travis CI sticker on my laptop, I love you that much.
 
 License
-=======
+-------
 
 <a href="http://www.wtfpl.net/"><img src="http://www.wtfpl.net/wp-content/uploads/2012/12/wtfpl.svg" height="20" alt="WTFPL" /></a>
 

data/appveyor.yml

@@ -0,0 +1,29 @@
+# Based this off of https://github.com/rspec/rspec-core/blob/22ed96bb3dbb0214dc48d6b8490ade04cdf8eedd/appveyor.yml
+# Docs are at https://www.appveyor.com/docs
+
+# I don't really understand what this is for
+version: "{build}"
+
+# This will build all PRs targetting matching branches.
+# Without this, each PR builds twice -- once for the PR branch HEAD,
+# and once for the merge commit that github creates for each mergable PR.
+branches:
+  only:
+    - master
+    - /.*-maintenance$/
+
+# Disable normal Windows builds in favor of our test script.
+build: off
+
+install:
+  - SET PATH=C:\Ruby%ruby_version%\bin;%PATH%
+  - ruby --version
+  - gem --version
+  - rake install
+
+test_script:
+  - bundle exec rake ci
+
+environment:
+  matrix:
+    - ruby_version: '21'

data/bin/seeing_is_believing

@@ -1,6 +1,7 @@
 #!/usr/bin/env ruby
 
-$LOAD_PATH.unshift File.expand_path '../../lib', __FILE__
+lib_dir = File.realpath('../lib', __dir__)
+$LOAD_PATH.unshift lib_dir
 
 require 'seeing_is_believing/binary'
 exit SeeingIsBelieving::Binary.call(ARGV, $stdin, $stdout, $stderr)

data/features/deprecated-flags.feature

@@ -70,3 +70,22 @@ Feature: Flags that are deprecated
     Error: not_a_file.rb does not exist!
     Deprecated: `--inherit-exit-status` Dash has been removed for consistency, use --inherit-exitstatus
     """
+
+  Scenario: -K without errors
+    Given the file "deprecated_K.rb" "__ENCODING__"
+    When I run "seeing_is_believing -Ke deprecated_K.rb"
+    Then stdout is '__ENCODING__  # => #<Encoding:EUC-JP>'
+    And stderr is empty
+    When I run "seeing_is_believing -Ku deprecated_K.rb"
+    Then stdout is '__ENCODING__  # => #<Encoding:UTF-8>'
+    And stderr is empty
+
+  Scenario: -K with errors
+    Given the file "deprecated_K.rb" "__ENCODING__"
+    When I run "seeing_is_believing -Ke not_a_file.rb"
+    Then stdout is empty
+    And stderr is:
+    """
+    Error: not_a_file.rb does not exist!
+    Deprecated: `-Ke` The ability to set encodings is deprecated. If you need this, details are at https://github.com/JoshCheek/seeing_is_believing/wiki/Encodings
+    """

data/features/errors.feature

@@ -48,6 +48,63 @@ Feature: Running the binary unsuccessfully
     # ~> requires_exception_raising_code.rb:9:in `<main>'
     """
 
+  @not-windows
+  Scenario: Raising multiple exceptions
+    Given the file "multiple_exceptions.rb":
+    """
+    if pid = fork #
+      Process.wait pid #
+      raise "parent"
+    else
+      raise "child"
+    end
+
+    """
+    When I run "seeing_is_believing multiple_exceptions.rb"
+    Then stderr is empty
+    And the exit status is 1
+    And stdout is:
+    """
+    if pid = fork #
+      Process.wait pid #
+      raise "parent"  # ~> RuntimeError: parent
+    else
+      raise "child"   # ~> RuntimeError: child
+    end
+
+    # ~> RuntimeError
+    # ~> child
+    # ~>
+    # ~> multiple_exceptions.rb:5:in `<main>'
+
+    # ~> RuntimeError
+    # ~> parent
+    # ~>
+    # ~> multiple_exceptions.rb:3:in `<main>'
+    """
+    When I run "seeing_is_believing multiple_exceptions.rb -x"
+    Then stderr is empty
+    And the exit status is 1
+    And stdout is:
+    """
+    if pid = fork #
+      Process.wait pid #
+      raise "parent" # ~> RuntimeError: parent
+    else
+      raise "child" # ~> RuntimeError: child
+    end
+
+    # ~> RuntimeError
+    # ~> child
+    # ~>
+    # ~> multiple_exceptions.rb:5:in `<main>'
+
+    # ~> RuntimeError
+    # ~> parent
+    # ~>
+    # ~> multiple_exceptions.rb:3:in `<main>'
+    """
+
   Scenario: Syntactically invalid file
     Given the file "invalid_syntax.rb":
     """

data/features/examples.feature

@@ -258,6 +258,7 @@ Feature: Running the binary successfully
     """
     And the exit status is 0
 
+  @not-windows
   Scenario: Fork records data in parent and child, parent exec does not affect it.
     Given the file "fork_exec_parent.rb":
     """
@@ -289,12 +290,13 @@ Feature: Running the binary successfully
     # >> hello
     """
 
+  @not-windows
   Scenario: Fork records data in parent and child, child exec does not affect it.
     Given the file "fork_exec_child.rb":
     """
     :both
     if fork #
-      sleep 1
+      sleep 1 #
       :parent
     else
       :child
@@ -309,7 +311,7 @@ Feature: Running the binary successfully
     """
     :both                   # => :both
     if fork #
-      sleep 1               # => 1
+      sleep 1 #
       :parent               # => :parent
     else
       :child                # => :child

data/features/flags.feature

@@ -154,7 +154,7 @@ Feature: Using flags
 
 
   Scenario: --encoding
-    Given the file "utf-8.rb" "'ç'"
+    Given the binary file "utf-8.rb" "'ç'"
     When I run "seeing_is_believing --encoding u utf-8.rb"
     Then stderr is empty
     And the exit status is 0
@@ -445,7 +445,32 @@ Feature: Using flags
     2  # => 2
     """
 
-  Scenario: --json
+  Scenario: --json without exceptions
+    Given the file "simple_json.rb":
+    """
+    3.times do |i|
+      i.to_s
+    end
+    """
+    When I run "seeing_is_believing --json simple_json.rb"
+    Then stderr is empty
+    And the exit status is 0
+    And stdout is the JSON:
+    """
+      { "lines": {
+          "1": ["3"],
+          "2": ["\"0\"", "\"1\"", "\"2\""],
+          "3": ["3"]
+        },
+        "exception":  null,
+        "exceptions": [],
+        "stdout":     "",
+        "stderr":     "",
+        "exitstatus": 0
+      }
+    """
+
+  Scenario: --json with exceptions
     Given the file "all_kinds_of_output.rb":
     """
     3.times do |i|
@@ -458,6 +483,8 @@ Feature: Using flags
     When I run "seeing_is_believing --json all_kinds_of_output.rb"
     Then stderr is empty
     And  the exit status is 0
+    # Use the exceptions array rather than the singule exception, it's less correct
+    # as there can be multiple exceptions. It only exists for backwards compatibility.
     And  stdout is the JSON:
     """
       { "lines": {
@@ -474,6 +501,12 @@ Feature: Using flags
           "message":                  "omg",
           "backtrace":                ["all_kinds_of_output.rb:6:in `<main>'"]
         },
+        "exceptions": [{
+          "line_number_in_this_file": 6,
+          "class_name":               "RuntimeError",
+          "message":                  "omg",
+          "backtrace":                ["all_kinds_of_output.rb:6:in `<main>'"]
+        }],
         "stdout": "b\n",
         "stderr": "c\n",
         "exitstatus": 1