piotrmurach/tty-option

View on GitHub
lib/tty/option/usage.rb

Summary

Maintainability
A
20 mins
Test Coverage
# frozen_string_literal: true

require_relative "deep_dup"

module TTY
  module Option
    class Usage
      # Create an usage
      #
      # @api public
      def self.create(**properties, &block)
        new(**properties, &block)
      end

      # Create an usage
      #
      # @api public
      def initialize(**properties, &block)
        @properties = {}
        @no_command = false
        properties.each do |key, val|
          case key.to_sym
          when :command
            key, val = :command, Array(val)
          when :desc, :description
            key, val = :desc, [Array(val)]
          when :header, :footer
            val = [Array(val)]
          when :example, :examples
            key, val = :example, [Array(val)]
          end
          @properties[key.to_sym] = val
        end

        instance_eval(&block) if block_given?
      end

      # Program name for display in help and error messages
      #
      # @param [String] name
      #
      # @api public
      def program(name = (not_set = true))
        if not_set
          @properties.fetch(:program) { ::File.basename($0, ".*") }
        else
          @properties[:program] = name
        end
      end

      # Action name for display in help and error messages
      #
      # @param [Array<String>] values
      #
      # @api public
      def command(*values)
        if values.empty?
          @properties.fetch(:command) { [] }
        else
          @properties[:command] = []
          values.each { |val| @properties[:command] << val }
        end
      end
      alias commands command

      # Remove default commands
      #
      # @api public
      def no_command
        @no_command = true
        @properties[:command] = []
      end

      # Whether or not to show command in usage
      #
      # @retrun [Boolean]
      #
      # @api public
      def no_command?
        @no_command
      end

      # Check for command definition
      #
      # @return [Boolean]
      #
      # @api public
      def command?
        @properties.key?(:command) && !@properties[:command].empty?
      end

      # Display info before anything else in the usage help
      #
      # @param [Array<String>] values
      #
      # @api public
      def header(*values)
        if values.empty?
          @properties.fetch(:header) { [] }
        else
          (@properties[:header] ||= []) << values
        end
      end

      # Whether or not to show header in usage
      #
      # @return [Boolean]
      #
      # @api public
      def header?
        @properties.key?(:header) && !@properties[:header].empty?
      end

      # Main way to show how all parameters can be used
      #
      # @param [String] value
      #
      # @api public
      def banner(value = (not_set = true))
        if not_set
          @properties[:banner]
        else
          @properties[:banner] = value
        end
      end

      # Whether or not to show banner in usage
      #
      # @return [Boolean]
      #
      # @api public
      def banner?
        @properties.key?(:banner) && !@properties[:banner].nil?
      end

      # Description
      #
      # @param [Array<String>] values
      #
      # @api public
      def desc(*values)
        if values.empty?
          @properties.fetch(:desc) { [] }
        else
          (@properties[:desc] ||= []) << values
        end
      end
      alias description desc

      # Whether or not to show description in usage
      #
      # @return [Boolean]
      #
      # @api public
      def desc?
        @properties.key?(:desc) && !@properties[:desc].empty?
      end
      alias description? desc?

      # Collects usage examples
      #
      # @param [Array<String>] values
      #
      # @api public
      def example(*values)
        if values.empty?
          @properties.fetch(:example) { [] }
        else
          (@properties[:example] ||= []) << values
        end
      end
      alias examples example

      # Whether or not to show example in usage
      #
      # @return [Boolean]
      #
      # @api public
      def example?
        @properties.key?(:example) && !@properties[:example].empty?
      end
      alias examples? example?

      # Display info after everyting else in the usage help
      #
      # @param [Array<String>] values
      #
      # @api public
      def footer(*values)
        if values.empty?
          @properties.fetch(:footer) { [] }
        else
          (@properties[:footer] ||= []) << values
        end
      end

      # Whether or not to show footer in usage
      #
      # @return [Boolean]
      #
      # @api public
      def footer?
        @properties.key?(:footer) && !@properties[:footer].empty?
      end

      # Return a hash of this usage properties
      #
      # @return [Hash] the names and values of this usage
      #
      # @api public
      def to_h(&block)
        if block_given?
          @properties.each_with_object({}) do |(key, val), acc|
            k, v = *block.(key, val)
            acc[k] = v
          end
        else
          DeepDup.deep_dup(@properties)
        end
      end
    end # Usage
  end # Option
end # TTY