Module: SyntaxTree::CLI

Defined in:

lib/syntax_tree/cli.rb

Overview

Syntax Tree ships with the ‘stree` CLI, which can be used to inspect and manipulate Ruby code. This module is responsible for powering that CLI.

Defined Under Namespace

Classes: AST, Action, Check, Color, ConfigFile, Debug, Doc, FileItem, Format, Json, Match, Options, STDINItem, Write

Constant Summary

HELP =

The help message displayed if the input arguments are not correctly ordered or formatted.

"\#{Color.bold(\"stree ast [--plugins=...] [--print-width=NUMBER] FILE\")}\n  Print out the AST corresponding to the given files\n\n\#{Color.bold(\"stree check [--plugins=...] [--print-width=NUMBER] FILE\")}\n  Check that the given files are formatted as syntax tree would format them\n\n\#{Color.bold(\"stree debug [--plugins=...] [--print-width=NUMBER] FILE\")}\n  Check that the given files can be formatted idempotently\n\n\#{Color.bold(\"stree doc [--plugins=...] FILE\")}\n  Print out the doc tree that would be used to format the given files\n\n\#{Color.bold(\"stree format [--plugins=...] [--print-width=NUMBER] FILE\")}\n  Print out the formatted version of the given files\n\n\#{Color.bold(\"stree json [--plugins=...] FILE\")}\n  Print out the JSON representation of the given files\n\n\#{Color.bold(\"stree match [--plugins=...] FILE\")}\n  Print out a pattern-matching Ruby expression that would match the given files\n\n\#{Color.bold(\"stree help\")}\n  Display this help message\n\n\#{Color.bold(\"stree lsp [--plugins=...] [--print-width=NUMBER]\")}\n  Run syntax tree in language server mode\n\n\#{Color.bold(\"stree version\")}\n  Output the current version of syntax tree\n\n\#{Color.bold(\"stree write [--plugins=...] [--print-width=NUMBER] FILE\")}\n  Read, format, and write back the source of the given files\n\n--plugins=...\n  A comma-separated list of plugins to load.\n\n--print-width=NUMBER\n  The maximum line width to use when formatting.\n"

Class Method Summary

• .run(argv) ⇒ Object

  Run the CLI over the given array of strings that make up the arguments passed to the invocation.

Class Method Details

.run(argv) ⇒ Object

Run the CLI over the given array of strings that make up the arguments passed to the invocation.

# File 'lib/syntax_tree/cli.rb', line 320

def run(argv)
  name, *arguments = argv

  config_file = ConfigFile.new
  arguments.unshift(*config_file.arguments)

  options = Options.new
  options.parse(arguments)

  action =
    case name
    when "a", "ast"
      AST.new(options)
    when "c", "check"
      Check.new(options)
    when "debug"
      Debug.new(options)
    when "doc"
      Doc.new(options)
    when "help"
      puts HELP
      return 0
    when "j", "json"
      Json.new(options)
    when "lsp"
      require "syntax_tree/language_server"
      LanguageServer.new(print_width: options.print_width).run
      return 0
    when "m", "match"
      Match.new(options)
    when "f", "format"
      Format.new(options)
    when "version"
      puts SyntaxTree::VERSION
      return 0
    when "w", "write"
      Write.new(options)
    else
      warn(HELP)
      return 1
    end

  # If we're not reading from stdin and the user didn't supply and
  # filepaths to be read, then we exit with the usage message.
  if $stdin.tty? && arguments.empty?
    warn(HELP)
    return 1
  end

  # We're going to build up a queue of items to process.
  queue = Queue.new

  # If we're reading from stdin, then we'll just add the stdin object to
  # the queue. Otherwise, we'll add each of the filepaths to the queue.
  if $stdin.tty? || arguments.any?
    arguments.each do |pattern|
      Dir
        .glob(pattern)
        .each do |filepath|
          queue << FileItem.new(filepath) if File.file?(filepath)
        end
    end
  else
    queue << STDINItem.new
  end

  # At the end, we're going to return whether or not this worker ever
  # encountered an error.
  if process_queue(queue, action)
    action.failure
    1
  else
    action.success
    0
  end
end