Add SpinGroup.puts_above

[joshheinrichs-shopify]

This is useful for things like printing out a stream of logs while you have one or more spinners reporting on the current status. We could also add Spinner.puts_above, but when you have multiple Spinners, "above" is kind of ambiguous. We can add it later if the need becomes obvious.

[joshheinrichs-shopify]

small example

require 'cli/ui'

CLI::UI::StdoutRouter.enable

CLI::UI::Frame.open('frame') do |f|
  CLI::UI::SpinGroup.new do |sg|
    sg.failure_debrief {}
    sg.add("running tests: {{@widget/status:0:0:1:4}}") do |spinner|
      n_jobs = 5
      n_passed = 0
      n_failed = 0
      (1..(n_jobs)).each do |n|
        sleep(2.5)
        passed = n != 3
        if passed
          sg.puts_above("{{v}} job #{n} passed")
          n_passed += 1
        else
          sg.puts_above("{{x}} job #{n} failed\n{{red:  └── /path/to/output.log}}")
          n_failed += 1
        end
        spinner.update_title("running jobs: {{@widget/status:#{n_passed}:#{n_failed}:1:#{n_jobs - n}}}")
      end
      spinner.update_title("ran jobs: {{@widget/status:#{n_passed}:#{n_failed}:0:0}}")
      n_failed == 0 ? nil : CLI::UI::Spinner::TASK_FAILED
    end
  end
end

when run non-interactively we just print as normal. the status widget doesn't respond well to being written to a file yet