Class: String

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses: YARD::Docstring, YARD::Server::HTTPUtils::FormData
Inherits:	Object
Defined in:	lib/yard/core_ext/string.rb

Instance Method Summary

#shell_split ⇒ Array

Splits text into tokens the way a shell would, handling quoted text as a single token.

Instance Method Details

#shell_split ⇒ Array

Splits text into tokens the way a shell would, handling quoted text as a single token. Use '\"' and "\'" to escape quotes and '\' to escape a backslash.

Returns:

(Array) —
an array representing the tokens

[ GitHub ]

# File 'lib/yard/core_ext/string.rb', line 8


def shell_split
  out = [String.new("")]
  state = :none
  escape_next = false
  quote = String.new("")
  strip.split(//).each do |char|
    case state
    when :none, :space
      case char
      when /\s/
        out << String.new("") unless state == :space
        state = :space
        escape_next = false
      when "\\"
        if escape_next
          out.last << char
          escape_next = false
        else
          escape_next = true
        end
      when '"', "'"
        if escape_next
          out.last << char
          escape_next = false
        else
          state = char
          quote = String.new("")
        end
      else
        state = :none
        out.last << char
        escape_next = false
      end
    when '"', "'"
      case char
      when '"', "'"
        if escape_next
          quote << char
          escape_next = false
        elsif char == state
          out.last << quote
          state = :none
        else
          quote << char
        end
      when '\\'
        if escape_next
          quote << char
          escape_next = false
        else
          escape_next = true
        end
      else
        quote << char
        escape_next = false
      end
    end
  end
  out
end