free_mutant/lib/mutant/reporter/cli/format.rb

module Mutant
  class Reporter
    class CLI
      # CLI output format
      class Format
        include AbstractType, Anima.new(:tty)

        # Return start representation
        #
        # @param [Env] env
        #
        # @return [String]
        #
        # @api private
        #
        abstract_method :start

        # Return progress representation
        #
        # @param [Runner::Status] status
        #
        # @return [String]
        #
        # @api private
        #
        abstract_method :progress

        # Output abstraction to decouple tty? from buffer
        class Output
          include Concord.new(:tty, :buffer)

          # Test if output is a tty
          #
          # @return [Boolean]
          #
          # @api private
          #
          def tty?
            @tty
          end

          [:puts, :write].each do |name|
            define_method(name) do |*args, &block|
              buffer.public_send(name, *args, &block)
            end
          end
        end # Output

      private

        # Format object with printer
        #
        # @param [Class:Printer] printer
        # @param [Object] object
        #
        # @return [String]
        #
        # @api private
        #
        def format(printer, object)
          buffer = new_buffer
          printer.run(Output.new(tty, buffer), object)
          buffer.rewind
          buffer.read
        end

        # Format for progressive non rewindable output
        class Progressive < self

          # Initialize object
          #
          # @return [undefined]
          #
          # @api private
          #
          def initialize(*)
            @seen = Set.new

            super
          end

          # Return start representation
          #
          # @return [String]
          #
          # @api private
          #
          def start(env)
            format(Printer::Config, env.config)
          end

          # Return progress representation
          #
          # @return [String]
          #
          # @api private
          #
          def progress(status)
            current = status.env_result.subject_results.flat_map(&:mutation_results)
            new = current.reject(&@seen.method(:include?))
            @seen = current.to_set
            new.map do |mutation_result|
              format(Printer::MutationProgressResult, mutation_result)
            end.join(EMPTY_STRING)
          end

        private

          # Return new buffer
          #
          # @return [StringIO]
          #
          # @api private
          #
          def new_buffer
            StringIO.new
          end

        end # Progressive

        # Format for framed rewindable output
        class Framed < self
          include anima.add(:tput)

          BUFFER_FLAGS = 'a+'.freeze

          # Format start
          #
          # @param [Env] env
          #
          # @return [String]
          #
          # @api private
          #
          def start(_env)
            tput.prepare
          end

          # Format progress
          #
          # @param [Runner::Status] status
          #
          # @return [String]
          #
          # @api private
          #
          def progress(status)
            format(Printer::Status, status)
          end

        private

          # Return new buffer
          #
          # @return [StringIO]
          #
          # @api private
          #
          def new_buffer
            # For some reason this raises an Ernno::EACCESS errror:
            #
            #  StringIO.new(Tput::INSTANCE.restore, BUFFER_FLAGS)
            #
            buffer = StringIO.new
            buffer << tput.restore
          end

        end # Framed
      end # Format
    end # CLI
  end # Reporter
end # Mutant