shard-spectator/spec/runnable_example_spec.cr

require "./spec_helper"

def new_runnable_example(group : Spectator::ExampleGroup? = nil, symbolic = false)
  actual_group = group || Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
  PassingExample.new(actual_group, Spectator::Internals::SampleValues.empty, symbolic).tap do |example|
    actual_group.children = [example.as(Spectator::ExampleComponent)]
  end
end

def run_example(example_type : Spectator::Example.class, hooks : Spectator::ExampleHooks? = nil, conditions : Spectator::ExampleConditions? = nil)
  group = Spectator::RootExampleGroup.new(hooks || Spectator::ExampleHooks.empty, conditions || Spectator::ExampleConditions.empty)
  run_example(example_type, group)
end

def run_example(example_type : Spectator::Example.class, group : Spectator::ExampleGroup? = nil)
  actual_group = group || Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
  example = example_type.new(actual_group, Spectator::Internals::SampleValues.empty)
  actual_group.children = [example.as(Spectator::ExampleComponent)]
  Spectator::Internals::Harness.run(example)
end

def run_example(hooks : Spectator::ExampleHooks? = nil, conditions : Spectator::ExampleConditions? = nil, &block)
  example = SpyExample.create(hooks || Spectator::ExampleHooks.empty, conditions || Spectator::ExampleConditions.empty, &block)
  Spectator::Internals::Harness.run(example)
end

describe Spectator::RunnableExample do
  describe "#run" do
    context "with a passing test" do
      it "returns a successful result" do
        run_example(PassingExample).should be_a(Spectator::SuccessfulResult)
      end

      {% for hook_type in %i[before_all before_each] %}
        context "{{hook_type.id}} hooks" do
          it "runs a hook" do
            called = false
            hooks = new_hooks({{hook_type.id}}: ->{ called = true; nil })
            run_example(PassingExample, hooks)
            called.should be_true
          end

          it "runs multiple hooks" do
            call_count = 0
            hooks = new_hooks({{hook_type.id}}: [
              ->{ call_count += 1; nil },
              ->{ call_count += 2; nil },
              ->{ call_count += 3; nil },
            ])
            run_example(PassingExample, hooks)
            call_count.should eq(6)
          end

          it "runs them in the correct order" do
            calls = [] of Symbol
            hooks = new_hooks({{hook_type.id}}: [
              ->{ calls << :a; nil },
              ->{ calls << :b; nil },
              ->{ calls << :c; nil },
            ])
            run_example(PassingExample, hooks)
            calls.should eq(\%i[a b c])
          end

          it "runs parent group hooks" do
            called = false
            hooks = new_hooks({{hook_type.id}}: -> { called = true; nil })
            root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(PassingExample, group)
            called.should be_true
          end

          it "runs parent group hooks first" do
            calls = [] of Symbol
            root_hooks = new_hooks({{hook_type.id}}: -> { calls << :a; nil })
            group_hooks = new_hooks({{hook_type.id}}: -> { calls << :b; nil })
            root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(PassingExample, group)
            calls.should eq(\%i[a b])
          end

          it "runs the hook before the test code" do
            calls = [] of Symbol
            hooks = new_hooks({{hook_type.id}}: ->{ calls << :a; nil })
            run_example(hooks) do
              calls << :b
            end
            calls.should eq(\%i[a b])
          end
        end
      {% end %}

      it "runs before_all hooks prior to before_each hooks" do
        calls = [] of Symbol
        hooks = new_hooks(
          before_all: ->{ calls << :a; nil },
          before_each: ->{ calls << :b; nil }
        )
        run_example(PassingExample, hooks)
        calls.should eq(%i[a b])
      end

      {% for hook_type in %i[after_all after_each] %}
        context "{{hook_type.id}} hooks" do
          it "runs a hook" do
            called = false
            hooks = new_hooks({{hook_type.id}}: ->{ called = true; nil })
            run_example(PassingExample, hooks)
            called.should be_true
          end

          it "runs multiple hooks" do
            call_count = 0
            hooks = new_hooks({{hook_type.id}}: [
              ->{ call_count += 1; nil },
              ->{ call_count += 2; nil },
              ->{ call_count += 3; nil },
            ])
            run_example(PassingExample, hooks)
            call_count.should eq(6)
          end

          it "runs them in the correct order" do
            calls = [] of Symbol
            hooks = new_hooks({{hook_type.id}}: [
              ->{ calls << :a; nil },
              ->{ calls << :b; nil },
              ->{ calls << :c; nil },
            ])
            run_example(PassingExample, hooks)
            calls.should eq(\%i[a b c])
          end

          it "runs parent group hooks" do
            called = false
            hooks = new_hooks({{hook_type.id}}: -> { called = true; nil })
            root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(PassingExample, group)
            called.should be_true
          end

          it "runs parent group hooks last" do
            calls = [] of Symbol
            root_hooks = new_hooks({{hook_type.id}}: -> { calls << :a; nil })
            group_hooks = new_hooks({{hook_type.id}}: -> { calls << :b; nil })
            root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(PassingExample, group)
            calls.should eq(\%i[b a])
          end

          it "runs the hook after the test code" do
            calls = [] of Symbol
            hooks = new_hooks({{hook_type.id}}: ->{ calls << :a; nil })
            run_example(hooks) do
              calls << :b
            end
            calls.should eq(\%i[b a])
          end
        end
      {% end %}

      it "runs after_each hooks prior to after_all hooks" do
        calls = [] of Symbol
        hooks = new_hooks(
          after_each: ->{ calls << :a; nil },
          after_all: ->{ calls << :b; nil }
        )
        run_example(PassingExample, hooks)
        calls.should eq(%i[a b])
      end

      context "around_each hooks" do
        it "runs a hook" do
          called = false
          hooks = new_hooks(around_each: ->(proc : ->) { called = true; proc.call })
          run_example(PassingExample, hooks)
          called.should be_true
        end

        it "runs multiple hooks" do
          call_count = 0
          hooks = new_hooks(around_each: [
            ->(proc : ->) { call_count += 1; proc.call },
            ->(proc : ->) { call_count += 2; proc.call },
            ->(proc : ->) { call_count += 3; proc.call },
          ])
          run_example(PassingExample, hooks)
          call_count.should eq(6)
        end

        it "runs them in the correct order" do
          calls = [] of Symbol
          hooks = new_hooks(around_each: [
            ->(proc : ->) { calls << :a; proc.call },
            ->(proc : ->) { calls << :b; proc.call },
            ->(proc : ->) { calls << :c; proc.call },
          ])
          run_example(PassingExample, hooks)
          calls.should eq(%i[a b c])
        end

        it "runs parent group hooks" do
          called = false
          hooks = new_hooks(around_each: ->(proc : ->) { called = true; proc.call })
          root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(PassingExample, group)
          called.should be_true
        end

        it "runs parent group hooks first" do
          calls = [] of Symbol
          root_hooks = new_hooks(around_each: ->(proc : ->) { calls << :a; proc.call })
          group_hooks = new_hooks(around_each: ->(proc : ->) { calls << :b; proc.call })
          root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(PassingExample, group)
          calls.should eq(%i[a b])
        end

        it "runs around_each hooks after the before hooks" do
          calls = [] of Symbol
          hooks = new_hooks(
            before_all: ->{ calls << :b; nil },
            before_each: ->{ calls << :b; nil },
            around_each: ->(proc : ->) { calls << :c; proc.call }
          )
          run_example(PassingExample, hooks)
          calls.should eq(%i[b b c])
        end

        it "runs around_each hooks prior to after hooks" do
          calls = [] of Symbol
          hooks = new_hooks(
            around_each: ->(proc : ->) { calls << :c; proc.call },
            after_each: ->{ calls << :a; nil },
            after_all: ->{ calls << :a; nil },
          )
          run_example(PassingExample, hooks)
          calls.should eq(%i[c a a])
        end
      end

      {% for condition in %i[pre post] %}
        context "{{condition.id}}-conditions" do
          it "checks a single condition" do
            called = false
            conditions = new_conditions({{condition.id}}: -> { called = true; nil })
            run_example(PassingExample, conditions: conditions)
            called.should be_true
          end

          it "checks multiple conditions" do
            call_count = 0
            conditions = new_conditions({{condition.id}}: [
              -> { call_count += 1; nil },
              -> { call_count += 2; nil },
              -> { call_count += 3; nil },
            ])
            run_example(PassingExample, conditions: conditions)
            call_count.should eq(6)
          end

          it "checks them in the correct order" do
            calls = [] of Symbol
            conditions = new_conditions({{condition.id}}: [
              -> { calls << :a; nil },
              -> { calls << :b; nil },
              -> { calls << :c; nil },
            ])
            run_example(PassingExample, conditions: conditions)
            calls.should eq(\%i[a b c])
          end

          it "checks parent group conditions" do
            called = false
            conditions = new_conditions({{condition.id}}: -> { called = true; nil })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(PassingExample, group)
            called.should be_true
          end

          {% if condition == :pre %}
            it "runs prior to the test code" do
              calls = [] of Symbol
              conditions = new_conditions({{condition.id}}: ->{ calls << :a; nil })
              run_example(conditions: conditions) do
                calls << :b
              end
              calls.should eq(\%i[a b])
            end

            it "checks parent group conditions first" do
              calls = [] of Symbol
              root_conditions = new_conditions({{condition.id}}: -> { calls << :a; nil })
              group_conditions = new_conditions({{condition.id}}: -> { calls << :b; nil })
              root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
              group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
              root.children = [group.as(Spectator::ExampleComponent)]
              run_example(PassingExample, group)
              calls.should eq(\%i[a b])
            end
          {% else %}
            it "runs after the test code" do
              calls = [] of Symbol
              conditions = new_conditions({{condition.id}}: ->{ calls << :b; nil })
              run_example(conditions: conditions) do
                calls << :a
              end
              calls.should eq(\%i[a b])
            end

            it "checks parent group conditions last" do
              calls = [] of Symbol
              root_conditions = new_conditions({{condition.id}}: -> { calls << :a; nil })
              group_conditions = new_conditions({{condition.id}}: -> { calls << :b; nil })
              root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
              group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
              root.children = [group.as(Spectator::ExampleComponent)]
              run_example(PassingExample, group)
              calls.should eq(\%i[b a])
            end
          {% end %}
        end
      {% end %}

      it "runs before hooks prior to pre-conditions" do
        calls = [] of Symbol
        hooks = new_hooks(
          before_all: ->{ calls << :b; nil },
          before_each: ->{ calls << :b; nil }
        )
        conditions = new_conditions(pre: ->{ calls << :p; nil })
        run_example(PassingExample, hooks, conditions)
        calls.should eq(%i[b b p])
      end

      it "runs around_each hooks prior to pre-conditions" do
        calls = [] of Symbol
        hooks = new_hooks(
          around_each: ->(proc : ->) { calls << :c; proc.call }
        )
        conditions = new_conditions(pre: ->{ calls << :p; nil })
        run_example(PassingExample, hooks, conditions)
        calls.should eq(%i[c p])
      end

      it "runs post-conditions prior to after hooks" do
        calls = [] of Symbol
        hooks = new_hooks(
          after_all: ->{ calls << :a; nil },
          after_each: ->{ calls << :a; nil }
        )
        conditions = new_conditions(pre: ->{ calls << :p; nil })
        run_example(PassingExample, hooks, conditions)
        calls.should eq(%i[p a a])
      end

      context "failing pre-condition" do
        it "fails the test" do
          conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
          result = run_example(PassingExample, conditions: conditions)
          result.should be_a(Spectator::FailedResult)
        end

        it "prevents the test code from running" do
          called = false
          conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
          run_example(conditions: conditions) do
            called = true
          end
          called.should be_false
        end

        it "prevents additional pre-conditions from running" do
          called = false
          conditions = new_conditions(pre: [
            ->{ report_expectations(0, 1) },
            ->{ called = true; nil },
          ])
          run_example(PassingExample, conditions: conditions)
          called.should be_false
        end

        it "prevents additional post-conditions from running" do
          called = false
          conditions = new_conditions(
            pre: ->{ report_expectations(0, 1) },
            post: ->{ called = true; nil }
          )
          run_example(PassingExample, conditions: conditions)
          called.should be_false
        end

        context "in a parent group" do
          it "fails the test" do
            conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            result = run_example(PassingExample, group)
            result.should be_a(Spectator::FailedResult)
          end

          it "prevents the test code from running" do
            called = false
            conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            example = SpyExample.new(group, Spectator::Internals::SampleValues.empty)
            group.children = [example.as(Spectator::ExampleComponent)]
            example.block = ->{ called = true; nil }
            Spectator::Internals::Harness.run(example)
            called.should be_false
          end

          it "doesn't run child pre-conditions" do
            called = false
            root_conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            group_conditions = new_conditions(pre: ->{ called = true; nil })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
            root.children = [group.as(Spectator::ExampleComponent)]
            example = PassingExample.new(group, Spectator::Internals::SampleValues.empty)
            group.children = [example.as(Spectator::ExampleComponent)]
            Spectator::Internals::Harness.run(example)
            called.should be_false
          end

          it "doesn't run child post-conditions" do
            called = false
            root_conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            group_conditions = new_conditions(post: ->{ called = true; nil })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
            root.children = [group.as(Spectator::ExampleComponent)]
            example = PassingExample.new(group, Spectator::Internals::SampleValues.empty)
            group.children = [example.as(Spectator::ExampleComponent)]
            Spectator::Internals::Harness.run(example)
            called.should be_false
          end
        end
      end

      context "failing post-condition" do
        it "fails the test" do
          conditions = new_conditions(post: ->{ report_expectations(0, 1) })
          result = run_example(PassingExample, conditions: conditions)
          result.should be_a(Spectator::FailedResult)
        end

        it "prevents additional post-conditions from running" do
          called = false
          conditions = new_conditions(post: [
            ->{ report_expectations(0, 1) },
            ->{ called = true; nil },
          ])
          run_example(PassingExample, conditions: conditions)
          called.should be_false
        end

        context "in a parent group" do
          it "fails the test" do
            conditions = new_conditions(post: ->{ report_expectations(0, 1) })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            result = run_example(PassingExample, group)
            result.should be_a(Spectator::FailedResult)
          end

          it "doesn't run parent post-conditions" do
            called = false
            root_conditions = new_conditions(post: ->{ called = true; nil })
            group_conditions = new_conditions(post: ->{ report_expectations(0, 1) })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
            root.children = [group.as(Spectator::ExampleComponent)]
            example = PassingExample.new(group, Spectator::Internals::SampleValues.empty)
            group.children = [example.as(Spectator::ExampleComponent)]
            Spectator::Internals::Harness.run(example)
            called.should be_false
          end
        end
      end
    end

    context "with a failing test" do
      it "returns a failed result" do
        run_example(FailingExample).should be_a(Spectator::FailedResult)
      end

      {% for hook_type in %i[before_all before_each] %}
        context "{{hook_type.id}} hooks" do
          it "runs a hook" do
            called = false
            hooks = new_hooks({{hook_type.id}}: ->{ called = true; nil })
            run_example(FailingExample, hooks)
            called.should be_true
          end

          it "runs multiple hooks" do
            call_count = 0
            hooks = new_hooks({{hook_type.id}}: [
              ->{ call_count += 1; nil },
              ->{ call_count += 2; nil },
              ->{ call_count += 3; nil },
            ])
            run_example(FailingExample, hooks)
            call_count.should eq(6)
          end

          it "runs them in the correct order" do
            calls = [] of Symbol
            hooks = new_hooks({{hook_type.id}}: [
              ->{ calls << :a; nil },
              ->{ calls << :b; nil },
              ->{ calls << :c; nil },
            ])
            run_example(FailingExample, hooks)
            calls.should eq(\%i[a b c])
          end

          it "runs parent group hooks" do
            called = false
            hooks = new_hooks({{hook_type.id}}: -> { called = true; nil })
            root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(FailingExample, group)
            called.should be_true
          end

          it "runs parent group hooks first" do
            calls = [] of Symbol
            root_hooks = new_hooks({{hook_type.id}}: -> { calls << :a; nil })
            group_hooks = new_hooks({{hook_type.id}}: -> { calls << :b; nil })
            root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(FailingExample, group)
            calls.should eq(\%i[a b])
          end
        end
      {% end %}

      it "runs before_all hooks prior to before_each hooks" do
        calls = [] of Symbol
        hooks = new_hooks(
          before_all: ->{ calls << :a; nil },
          before_each: ->{ calls << :b; nil }
        )
        run_example(FailingExample, hooks)
        calls.should eq(%i[a b])
      end

      {% for hook_type in %i[after_all after_each] %}
        context "{{hook_type.id}} hooks" do
          it "runs a hook" do
            called = false
            hooks = new_hooks({{hook_type.id}}: ->{ called = true; nil })
            run_example(FailingExample, hooks)
            called.should be_true
          end

          it "runs multiple hooks" do
            call_count = 0
            hooks = new_hooks({{hook_type.id}}: [
              ->{ call_count += 1; nil },
              ->{ call_count += 2; nil },
              ->{ call_count += 3; nil },
            ])
            run_example(FailingExample, hooks)
            call_count.should eq(6)
          end

          it "runs them in the correct order" do
            calls = [] of Symbol
            hooks = new_hooks({{hook_type.id}}: [
              ->{ calls << :a; nil },
              ->{ calls << :b; nil },
              ->{ calls << :c; nil },
            ])
            run_example(FailingExample, hooks)
            calls.should eq(\%i[a b c])
          end

          it "runs parent group hooks" do
            called = false
            hooks = new_hooks({{hook_type.id}}: -> { called = true; nil })
            root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(FailingExample, group)
            called.should be_true
          end

          it "runs parent group hooks last" do
            calls = [] of Symbol
            root_hooks = new_hooks({{hook_type.id}}: -> { calls << :a; nil })
            group_hooks = new_hooks({{hook_type.id}}: -> { calls << :b; nil })
            root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(FailingExample, group)
            calls.should eq(\%i[b a])
          end
        end
      {% end %}

      it "runs after_each hooks prior to after_all hooks" do
        calls = [] of Symbol
        hooks = new_hooks(
          after_each: ->{ calls << :a; nil },
          after_all: ->{ calls << :b; nil }
        )
        run_example(FailingExample, hooks)
        calls.should eq(%i[a b])
      end

      context "around_each hooks" do
        it "runs a hook" do
          called = false
          hooks = new_hooks(around_each: ->(proc : ->) { called = true; proc.call })
          run_example(FailingExample, hooks)
          called.should be_true
        end

        it "runs multiple hooks" do
          call_count = 0
          hooks = new_hooks(around_each: [
            ->(proc : ->) { call_count += 1; proc.call },
            ->(proc : ->) { call_count += 2; proc.call },
            ->(proc : ->) { call_count += 3; proc.call },
          ])
          run_example(FailingExample, hooks)
          call_count.should eq(6)
        end

        it "runs them in the correct order" do
          calls = [] of Symbol
          hooks = new_hooks(around_each: [
            ->(proc : ->) { calls << :a; proc.call },
            ->(proc : ->) { calls << :b; proc.call },
            ->(proc : ->) { calls << :c; proc.call },
          ])
          run_example(FailingExample, hooks)
          calls.should eq(%i[a b c])
        end

        it "runs parent group hooks" do
          called = false
          hooks = new_hooks(around_each: ->(proc : ->) { called = true; proc.call })
          root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(FailingExample, group)
          called.should be_true
        end

        it "runs parent group hooks first" do
          calls = [] of Symbol
          root_hooks = new_hooks(around_each: ->(proc : ->) { calls << :a; proc.call })
          group_hooks = new_hooks(around_each: ->(proc : ->) { calls << :b; proc.call })
          root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(FailingExample, group)
          calls.should eq(%i[a b])
        end

        it "runs around_each hooks after the before hooks" do
          calls = [] of Symbol
          hooks = new_hooks(
            before_all: ->{ calls << :b; nil },
            before_each: ->{ calls << :b; nil },
            around_each: ->(proc : ->) { calls << :c; proc.call }
          )
          run_example(FailingExample, hooks)
          calls.should eq(%i[b b c])
        end

        it "runs around_each hooks prior to after hooks" do
          calls = [] of Symbol
          hooks = new_hooks(
            around_each: ->(proc : ->) { calls << :c; proc.call },
            after_each: ->{ calls << :a; nil },
            after_all: ->{ calls << :a; nil },
          )
          run_example(FailingExample, hooks)
          calls.should eq(%i[c a a])
        end
      end

      context "pre-conditions" do
        it "checks a single condition" do
          called = false
          conditions = new_conditions(pre: ->{ called = true; nil })
          run_example(FailingExample, conditions: conditions)
          called.should be_true
        end

        it "checks multiple conditions" do
          call_count = 0
          conditions = new_conditions(pre: [
            ->{ call_count += 1; nil },
            ->{ call_count += 2; nil },
            ->{ call_count += 3; nil },
          ])
          run_example(FailingExample, conditions: conditions)
          call_count.should eq(6)
        end

        it "checks them in the correct order" do
          calls = [] of Symbol
          conditions = new_conditions(pre: [
            ->{ calls << :a; nil },
            ->{ calls << :b; nil },
            ->{ calls << :c; nil },
          ])
          run_example(FailingExample, conditions: conditions)
          calls.should eq(%i[a b c])
        end

        it "checks parent group conditions" do
          called = false
          conditions = new_conditions(pre: ->{ called = true; nil })
          root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
          group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(FailingExample, group)
          called.should be_true
        end

        it "checks parent group conditions first" do
          calls = [] of Symbol
          root_conditions = new_conditions(pre: ->{ calls << :a; nil })
          group_conditions = new_conditions(pre: ->{ calls << :b; nil })
          root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
          group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(FailingExample, group)
          calls.should eq(%i[a b])
        end
      end

      it "runs before hooks prior to pre-conditions" do
        calls = [] of Symbol
        hooks = new_hooks(
          before_all: ->{ calls << :b; nil },
          before_each: ->{ calls << :b; nil }
        )
        conditions = new_conditions(pre: ->{ calls << :p; nil })
        run_example(FailingExample, hooks, conditions)
        calls.should eq(%i[b b p])
      end

      it "runs around_each hooks prior to pre-conditions" do
        calls = [] of Symbol
        hooks = new_hooks(
          around_each: ->(proc : ->) { calls << :c; proc.call }
        )
        conditions = new_conditions(pre: ->{ calls << :p; nil })
        run_example(FailingExample, hooks, conditions)
        calls.should eq(%i[c p])
      end

      context "failing pre-condition" do
        it "fails the test" do
          conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
          result = run_example(FailingExample, conditions: conditions)
          result.should be_a(Spectator::FailedResult)
        end

        it "prevents additional pre-conditions from running" do
          called = false
          conditions = new_conditions(pre: [
            ->{ report_expectations(0, 1) },
            ->{ called = true; nil },
          ])
          run_example(FailingExample, conditions: conditions)
          called.should be_false
        end

        it "prevents additional post-conditions from running" do
          called = false
          conditions = new_conditions(
            pre: ->{ report_expectations(0, 1) },
            post: ->{ called = true; nil }
          )
          run_example(FailingExample, conditions: conditions)
          called.should be_false
        end

        context "in a parent group" do
          it "fails the test" do
            conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            result = run_example(FailingExample, group)
            result.should be_a(Spectator::FailedResult)
          end

          it "doesn't run child pre-conditions" do
            called = false
            root_conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            group_conditions = new_conditions(pre: ->{ called = true; nil })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
            root.children = [group.as(Spectator::ExampleComponent)]
            example = FailingExample.new(group, Spectator::Internals::SampleValues.empty)
            group.children = [example.as(Spectator::ExampleComponent)]
            Spectator::Internals::Harness.run(example)
            called.should be_false
          end

          it "doesn't run child post-conditions" do
            called = false
            root_conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            group_conditions = new_conditions(post: ->{ called = true; nil })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
            root.children = [group.as(Spectator::ExampleComponent)]
            example = FailingExample.new(group, Spectator::Internals::SampleValues.empty)
            group.children = [example.as(Spectator::ExampleComponent)]
            Spectator::Internals::Harness.run(example)
            called.should be_false
          end
        end
      end

      it "doesn't run post-conditions" do
        called = false
        conditions = new_conditions(post: ->{ called = true; nil })
        run_example(FailingExample, conditions: conditions)
        called.should be_false
      end

      it "doesn't run parent group post-conditions" do
        called = false
        conditions = new_conditions(post: ->{ called = true; nil })
        root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
        group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
        root.children = [group.as(Spectator::ExampleComponent)]
        run_example(FailingExample, group)
        called.should be_false
      end
    end

    context "with an errored test" do
      it "returns an errored result" do
        run_example(ErroredExample).should be_a(Spectator::ErroredResult)
      end

      {% for hook_type in %i[before_all before_each] %}
        context "{{hook_type.id}} hooks" do
          it "runs a hook" do
            called = false
            hooks = new_hooks({{hook_type.id}}: ->{ called = true; nil })
            run_example(ErroredExample, hooks)
            called.should be_true
          end

          it "runs multiple hooks" do
            call_count = 0
            hooks = new_hooks({{hook_type.id}}: [
              ->{ call_count += 1; nil },
              ->{ call_count += 2; nil },
              ->{ call_count += 3; nil },
            ])
            run_example(ErroredExample, hooks)
            call_count.should eq(6)
          end

          it "runs them in the correct order" do
            calls = [] of Symbol
            hooks = new_hooks({{hook_type.id}}: [
              ->{ calls << :a; nil },
              ->{ calls << :b; nil },
              ->{ calls << :c; nil },
            ])
            run_example(ErroredExample, hooks)
            calls.should eq(\%i[a b c])
          end

          it "runs parent group hooks" do
            called = false
            hooks = new_hooks({{hook_type.id}}: -> { called = true; nil })
            root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(ErroredExample, group)
            called.should be_true
          end

          it "runs parent group hooks first" do
            calls = [] of Symbol
            root_hooks = new_hooks({{hook_type.id}}: -> { calls << :a; nil })
            group_hooks = new_hooks({{hook_type.id}}: -> { calls << :b; nil })
            root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(ErroredExample, group)
            calls.should eq(\%i[a b])
          end
        end
      {% end %}

      it "runs before_all hooks prior to before_each hooks" do
        calls = [] of Symbol
        hooks = new_hooks(
          before_all: ->{ calls << :a; nil },
          before_each: ->{ calls << :b; nil }
        )
        run_example(ErroredExample, hooks)
        calls.should eq(%i[a b])
      end

      {% for hook_type in %i[after_all after_each] %}
        context "{{hook_type.id}} hooks" do
          it "runs a hook" do
            called = false
            hooks = new_hooks({{hook_type.id}}: ->{ called = true; nil })
            run_example(ErroredExample, hooks)
            called.should be_true
          end

          it "runs multiple hooks" do
            call_count = 0
            hooks = new_hooks({{hook_type.id}}: [
              ->{ call_count += 1; nil },
              ->{ call_count += 2; nil },
              ->{ call_count += 3; nil },
            ])
            run_example(ErroredExample, hooks)
            call_count.should eq(6)
          end

          it "runs them in the correct order" do
            calls = [] of Symbol
            hooks = new_hooks({{hook_type.id}}: [
              ->{ calls << :a; nil },
              ->{ calls << :b; nil },
              ->{ calls << :c; nil },
            ])
            run_example(ErroredExample, hooks)
            calls.should eq(\%i[a b c])
          end

          it "runs parent group hooks" do
            called = false
            hooks = new_hooks({{hook_type.id}}: -> { called = true; nil })
            root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(ErroredExample, group)
            called.should be_true
          end

          it "runs parent group hooks last" do
            calls = [] of Symbol
            root_hooks = new_hooks({{hook_type.id}}: -> { calls << :a; nil })
            group_hooks = new_hooks({{hook_type.id}}: -> { calls << :b; nil })
            root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
            group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            run_example(ErroredExample, group)
            calls.should eq(\%i[b a])
          end
        end
      {% end %}

      it "runs after_each hooks prior to after_all hooks" do
        calls = [] of Symbol
        hooks = new_hooks(
          after_each: ->{ calls << :a; nil },
          after_all: ->{ calls << :b; nil }
        )
        run_example(ErroredExample, hooks)
        calls.should eq(%i[a b])
      end

      context "around_each hooks" do
        it "runs a hook" do
          called = false
          hooks = new_hooks(around_each: ->(proc : ->) { called = true; proc.call })
          run_example(ErroredExample, hooks)
          called.should be_true
        end

        it "runs multiple hooks" do
          call_count = 0
          hooks = new_hooks(around_each: [
            ->(proc : ->) { call_count += 1; proc.call },
            ->(proc : ->) { call_count += 2; proc.call },
            ->(proc : ->) { call_count += 3; proc.call },
          ])
          run_example(ErroredExample, hooks)
          call_count.should eq(6)
        end

        it "runs them in the correct order" do
          calls = [] of Symbol
          hooks = new_hooks(around_each: [
            ->(proc : ->) { calls << :a; proc.call },
            ->(proc : ->) { calls << :b; proc.call },
            ->(proc : ->) { calls << :c; proc.call },
          ])
          run_example(ErroredExample, hooks)
          calls.should eq(%i[a b c])
        end

        it "runs parent group hooks" do
          called = false
          hooks = new_hooks(around_each: ->(proc : ->) { called = true; proc.call })
          root = Spectator::RootExampleGroup.new(hooks, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(ErroredExample, group)
          called.should be_true
        end

        it "runs parent group hooks first" do
          calls = [] of Symbol
          root_hooks = new_hooks(around_each: ->(proc : ->) { calls << :a; proc.call })
          group_hooks = new_hooks(around_each: ->(proc : ->) { calls << :b; proc.call })
          root = Spectator::RootExampleGroup.new(root_hooks, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new("what", root, group_hooks, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(ErroredExample, group)
          calls.should eq(%i[a b])
        end

        it "runs around_each hooks after the before hooks" do
          calls = [] of Symbol
          hooks = new_hooks(
            before_all: ->{ calls << :b; nil },
            before_each: ->{ calls << :b; nil },
            around_each: ->(proc : ->) { calls << :c; proc.call }
          )
          run_example(ErroredExample, hooks)
          calls.should eq(%i[b b c])
        end

        it "runs around_each hooks prior to after hooks" do
          calls = [] of Symbol
          hooks = new_hooks(
            around_each: ->(proc : ->) { calls << :c; proc.call },
            after_each: ->{ calls << :a; nil },
            after_all: ->{ calls << :a; nil },
          )
          run_example(ErroredExample, hooks)
          calls.should eq(%i[c a a])
        end
      end

      context "pre-conditions" do
        it "checks a single condition" do
          called = false
          conditions = new_conditions(pre: ->{ called = true; nil })
          run_example(ErroredExample, conditions: conditions)
          called.should be_true
        end

        it "checks multiple conditions" do
          call_count = 0
          conditions = new_conditions(pre: [
            ->{ call_count += 1; nil },
            ->{ call_count += 2; nil },
            ->{ call_count += 3; nil },
          ])
          run_example(ErroredExample, conditions: conditions)
          call_count.should eq(6)
        end

        it "checks them in the correct order" do
          calls = [] of Symbol
          conditions = new_conditions(pre: [
            ->{ calls << :a; nil },
            ->{ calls << :b; nil },
            ->{ calls << :c; nil },
          ])
          run_example(ErroredExample, conditions: conditions)
          calls.should eq(%i[a b c])
        end

        it "checks parent group conditions" do
          called = false
          conditions = new_conditions(pre: ->{ called = true; nil })
          root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
          group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(ErroredExample, group)
          called.should be_true
        end

        it "checks parent group conditions first" do
          calls = [] of Symbol
          root_conditions = new_conditions(pre: ->{ calls << :a; nil })
          group_conditions = new_conditions(pre: ->{ calls << :b; nil })
          root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
          group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
          root.children = [group.as(Spectator::ExampleComponent)]
          run_example(ErroredExample, group)
          calls.should eq(%i[a b])
        end
      end

      it "runs before hooks prior to pre-conditions" do
        calls = [] of Symbol
        hooks = new_hooks(
          before_all: ->{ calls << :b; nil },
          before_each: ->{ calls << :b; nil }
        )
        conditions = new_conditions(pre: ->{ calls << :p; nil })
        run_example(ErroredExample, hooks, conditions)
        calls.should eq(%i[b b p])
      end

      it "runs around_each hooks prior to pre-conditions" do
        calls = [] of Symbol
        hooks = new_hooks(
          around_each: ->(proc : ->) { calls << :c; proc.call }
        )
        conditions = new_conditions(pre: ->{ calls << :p; nil })
        run_example(ErroredExample, hooks, conditions)
        calls.should eq(%i[c p])
      end

      context "failing pre-condition" do
        it "fails the test" do
          conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
          result = run_example(ErroredExample, conditions: conditions)
          result.should be_a(Spectator::FailedResult)
        end

        it "prevents additional pre-conditions from running" do
          called = false
          conditions = new_conditions(pre: [
            ->{ report_expectations(0, 1) },
            ->{ called = true; nil },
          ])
          run_example(ErroredExample, conditions: conditions)
          called.should be_false
        end

        it "prevents additional post-conditions from running" do
          called = false
          conditions = new_conditions(
            pre: ->{ report_expectations(0, 1) },
            post: ->{ called = true; nil }
          )
          run_example(ErroredExample, conditions: conditions)
          called.should be_false
        end

        context "in a parent group" do
          it "fails the test" do
            conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
            root.children = [group.as(Spectator::ExampleComponent)]
            result = run_example(ErroredExample, group)
            result.should be_a(Spectator::FailedResult)
          end

          it "doesn't run child pre-conditions" do
            called = false
            root_conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            group_conditions = new_conditions(pre: ->{ called = true; nil })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
            root.children = [group.as(Spectator::ExampleComponent)]
            example = ErroredExample.new(group, Spectator::Internals::SampleValues.empty)
            group.children = [example.as(Spectator::ExampleComponent)]
            Spectator::Internals::Harness.run(example)
            called.should be_false
          end

          it "doesn't run child post-conditions" do
            called = false
            root_conditions = new_conditions(pre: ->{ report_expectations(0, 1) })
            group_conditions = new_conditions(post: ->{ called = true; nil })
            root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, root_conditions)
            group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, group_conditions)
            root.children = [group.as(Spectator::ExampleComponent)]
            example = ErroredExample.new(group, Spectator::Internals::SampleValues.empty)
            group.children = [example.as(Spectator::ExampleComponent)]
            Spectator::Internals::Harness.run(example)
            called.should be_false
          end
        end
      end

      it "doesn't run post-conditions" do
        called = false
        conditions = new_conditions(post: ->{ called = true; nil })
        run_example(ErroredExample, conditions: conditions)
        called.should be_false
      end

      it "doesn't run parent group post-conditions" do
        called = false
        conditions = new_conditions(post: ->{ called = true; nil })
        root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, conditions)
        group = Spectator::NestedExampleGroup.new("what", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
        root.children = [group.as(Spectator::ExampleComponent)]
        run_example(ErroredExample, group)
        called.should be_false
      end
    end

    context "when an error is raised in a before_all hook" do
      it "raises the exception" do
        hooks = new_hooks(before_all: ->{ raise "oops"; nil })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
      end

      it "passes along the original exception" do
        error = Exception.new("oops")
        hooks = new_hooks(before_all: ->{ raise error; nil })
        begin
          run_example(PassingExample, hooks)
        rescue ex
          ex.cause.should eq(error)
        end
      end

      it "doesn't run the test code" do
        called = false
        hooks = new_hooks(before_all: ->{ raise "oops"; nil })
        expect_raises(Exception) do
          run_example(hooks) do
            called = true
          end
        end
        called.should be_false
      end

      it "doesn't run any additional before_all hooks" do
        called = false
        hooks = new_hooks(before_all: [
          ->{ raise "oops"; nil },
          ->{ called = true; nil },
        ])
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should be_false
      end

      it "doesn't run any additional hooks" do
        called = :none
        hooks = new_hooks(
          before_all: ->{ raise "oops"; nil },
          before_each: ->{ called = :before_each; nil },
          after_all: ->{ called = :after_all; nil },
          after_each: ->{ called = :after_each; nil },
          around_each: ->(proc : ->) { called = :around_each; proc.call })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should eq(:none)
      end
    end

    context "when an error is raised in a before_each hook" do
      it "raises the exception" do
        hooks = new_hooks(before_each: ->{ raise "oops"; nil })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
      end

      it "passes along the original exception" do
        error = Exception.new("oops")
        hooks = new_hooks(before_each: ->{ raise error; nil })
        begin
          run_example(PassingExample, hooks)
        rescue ex
          ex.cause.should eq(error)
        end
      end

      it "doesn't run the test code" do
        called = false
        hooks = new_hooks(before_each: ->{ raise "oops"; nil })
        expect_raises(Exception) do
          run_example(hooks) do
            called = true
          end
        end
        called.should be_false
      end

      it "doesn't run any additional before_each hooks" do
        called = false
        hooks = new_hooks(before_each: [
          ->{ raise "oops"; nil },
          ->{ called = true; nil },
        ])
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should be_false
      end

      it "doesn't run any additional hooks" do
        called = :none
        hooks = new_hooks(
          before_each: ->{ raise "oops"; nil },
          after_all: ->{ called = :after_all; nil },
          after_each: ->{ called = :after_each; nil },
          around_each: ->(proc : ->) { called = :around_each; proc.call })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should eq(:none)
      end
    end

    context "when an error is raised in an after_all hook" do
      it "raises the exception" do
        hooks = new_hooks(after_all: ->{ raise "oops"; nil })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
      end

      it "passes along the original exception" do
        error = Exception.new("oops")
        hooks = new_hooks(after_all: ->{ raise error; nil })
        begin
          run_example(PassingExample, hooks)
        rescue ex
          ex.cause.should eq(error)
        end
      end

      it "doesn't run any additional after_all hooks" do
        called = false
        hooks = new_hooks(after_all: [
          ->{ raise "oops"; nil },
          ->{ called = true; nil },
        ])
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should be_false
      end
    end

    context "when an error is raised in an after_each hook" do
      it "raises the exception" do
        hooks = new_hooks(after_each: ->{ raise "oops"; nil })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
      end

      it "passes along the original exception" do
        error = Exception.new("oops")
        hooks = new_hooks(after_each: ->{ raise error; nil })
        begin
          run_example(PassingExample, hooks)
        rescue ex
          ex.cause.should eq(error)
        end
      end

      it "doesn't run any additional after_each hooks" do
        called = false
        hooks = new_hooks(after_each: [
          ->{ raise "oops"; nil },
          ->{ called = true; nil },
        ])
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should be_false
      end

      it "doesn't run any additional hooks" do
        called = :none
        hooks = new_hooks(
          before_all: ->{ nil },
          before_each: ->{ nil },
          after_all: ->{ called = :after_all; nil },
          after_each: ->{ raise "oops"; nil },
          around_each: ->(proc : ->) { proc.call })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should eq(:none)
      end
    end

    context "when an error is raised in an around_each hook" do
      it "raises the exception" do
        hooks = new_hooks(around_each: ->(proc : ->) { raise "oops"; proc.call })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
      end

      it "passes along the original exception" do
        error = Exception.new("oops")
        hooks = new_hooks(around_each: ->(proc : ->) { raise error; proc.call })
        begin
          run_example(PassingExample, hooks)
        rescue ex
          ex.cause.should eq(error)
        end
      end

      it "doesn't run the test code" do
        called = false
        hooks = new_hooks(around_each: ->(proc : ->) { raise "oops"; proc.call })
        expect_raises(Exception) do
          run_example(hooks) do
            called = true
          end
        end
        called.should be_false
      end

      it "doesn't run any additional around_each hooks" do
        called = false
        hooks = new_hooks(around_each: [
          ->(proc : ->) { raise "oops"; proc.call },
          ->(proc : ->) { called = true; proc.call },
        ])
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should be_false
      end

      it "doesn't run any additional hooks" do
        called = :none
        hooks = new_hooks(
          after_all: ->{ called = :after_all; nil },
          after_each: ->{ called = :after_each; nil },
          around_each: ->(proc : ->) { raise "oops"; proc.call })
        expect_raises(Exception) do
          run_example(PassingExample, hooks)
        end
        called.should eq(:none)
      end
    end
  end

  describe "#finished?" do
    it "is initially false" do
      new_runnable_example.finished?.should be_false
    end

    it "is true after #run is called" do
      example = new_runnable_example
      Spectator::Internals::Harness.run(example)
      example.finished?.should be_true
    end
  end

  describe "#group" do
    it "is the expected value" do
      group = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
      example = new_runnable_example(group)
      example.group.should eq(group)
    end
  end

  describe "#example_count" do
    it "is one" do
      new_runnable_example.example_count.should eq(1)
    end
  end

  describe "#[]" do
    it "returns self" do
      example = new_runnable_example
      example[0].should eq(example)
    end
  end

  describe "#to_s" do
    it "contains #what" do
      example = new_runnable_example
      example.to_s.should contain(example.what)
    end

    it "contains the group's #what" do
      root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
      group = Spectator::NestedExampleGroup.new("GROUP", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
      root.children = [group.as(Spectator::ExampleComponent)]
      example = new_runnable_example(group)
      example.to_s.should contain(group.what.to_s)
    end

    context "when #symbolic? is true" do
      context "and the group is symbolic" do
        it "omits the space" do
          root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new(:Group, root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          example = new_runnable_example(group, true)
          group.symbolic?.should be_true
          example.symbolic?.should be_true
          example.to_s.should_not contain(' ')
        end
      end

      context "and the group isn't symbolic" do
        it "inserts a space" do
          root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new("GROUP", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          example = new_runnable_example(group, true)
          group.symbolic?.should be_false
          example.symbolic?.should be_true
          example.to_s.should contain(' ')
        end
      end
    end

    context "when #symbolic? is false" do
      context "and the group is symbolic" do
        it "inserts a space" do
          root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new(:Group, root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          example = new_runnable_example(group, false)
          group.symbolic?.should be_true
          example.symbolic?.should be_false
          example.to_s.should contain(' ')
        end
      end

      context "and the group isn't symbolic" do
        it "inserts a space" do
          root = Spectator::RootExampleGroup.new(Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          group = Spectator::NestedExampleGroup.new("GROUP", root, Spectator::ExampleHooks.empty, Spectator::ExampleConditions.empty)
          root.children = [group.as(Spectator::ExampleComponent)]
          example = new_runnable_example(group, false)
          group.symbolic?.should be_false
          example.symbolic?.should be_false
          example.to_s.should contain(' ')
        end
      end
    end
  end
end