404 Not Found

PATH: opt / alt / ruby18 / lib64 / ruby / 1.8

#
# shellwords.rb: Manipulates strings a la UNIX Bourne shell
#

#
# This module manipulates strings according to the word parsing rules
# of the UNIX Bourne shell.
#
# The shellwords() function was originally a port of shellwords.pl,
# but modified to conform to POSIX / SUSv3 (IEEE Std 1003.1-2001).
#
# Authors:
#   - Wakou Aoyama
#   - Akinori MUSHA <knu@iDaemons.org>
#
# Contact:
#   - Akinori MUSHA <knu@iDaemons.org> (current maintainer)
#
module Shellwords
  #
  # Splits a string into an array of tokens in the same way the UNIX
  # Bourne shell does.
  #
  #   argv = Shellwords.split('here are "two words"')
  #   argv #=> ["here", "are", "two words"]
  #
  # +String#shellsplit+ is a shorthand for this function.
  #
  #   argv = 'here are "two words"'.shellsplit
  #   argv #=> ["here", "are", "two words"]
  #
  def shellsplit(line)
    line = String.new(line) rescue
      raise(ArgumentError, "Argument must be a string")
    line.lstrip!
    words = []
    until line.empty?
      field = ''
      loop do
	if line.sub!(/\A"(([^"\\]|\\.)*)"/, '') then
	  snippet = $1.gsub(/\\(.)/, '\1')
	elsif line =~ /\A"/ then
	  raise ArgumentError, "Unmatched double quote: #{line}"
	elsif line.sub!(/\A'([^']*)'/, '') then
	  snippet = $1
	elsif line =~ /\A'/ then
	  raise ArgumentError, "Unmatched single quote: #{line}"
	elsif line.sub!(/\A\\(.)?/, '') then
	  snippet = $1 || '\\'
	elsif line.sub!(/\A([^\s\\'"]+)/, '') then
	  snippet = $1
	else
	  line.lstrip!
	  break
	end
	field.concat(snippet)
      end
      words.push(field)
    end
    words
  end

alias shellwords shellsplit

module_function :shellsplit, :shellwords

class << self
    alias split shellsplit
  end

#
  # Escapes a string so that it can be safely used in a Bourne shell
  # command line.
  #
  # Note that a resulted string should be used unquoted and is not
  # intended for use in double quotes nor in single quotes.
  #
  #   open("| grep #{Shellwords.escape(pattern)} file") { |pipe|
  #     # ...
  #   }
  #
  # +String#shellescape+ is a shorthand for this function.
  #
  #   open("| grep #{pattern.shellescape} file") { |pipe|
  #     # ...
  #   }
  #
  def shellescape(str)
    # An empty argument will be skipped, so return empty quotes.
    return "''" if str.empty?

str = str.dup

# Process as a single byte sequence because not all shell
    # implementations are multibyte aware.
    str.gsub!(/([^A-Za-z0-9_\-.,:\/@\n])/n, "\\\\\\1")

# A LF cannot be escaped with a backslash because a backslash + LF
    # combo is regarded as line continuation and simply ignored.
    str.gsub!(/\n/, "'\n'")

return str
  end

module_function :shellescape

class << self
    alias escape shellescape
  end

#
  # Builds a command line string from an argument list +array+ joining
  # all elements escaped for Bourne shell and separated by a space.
  #
  #   open('|' + Shellwords.join(['grep', pattern, *files])) { |pipe|
  #     # ...
  #   }
  #
  # +Array#shelljoin+ is a shorthand for this function.
  #
  #   open('|' + ['grep', pattern, *files].shelljoin) { |pipe|
  #     # ...
  #   }
  #
  def shelljoin(array)
    array.map { |arg| shellescape(arg) }.join(' ')
  end

module_function :shelljoin

class << self
    alias join shelljoin
  end
end

class String
  #
  # call-seq:
  #   str.shellsplit => array
  #
  # Splits +str+ into an array of tokens in the same way the UNIX
  # Bourne shell does.  See +Shellwords::shellsplit+ for details.
  #
  def shellsplit
    Shellwords.split(self)
  end

#
  # call-seq:
  #   str.shellescape => string
  #
  # Escapes +str+ so that it can be safely used in a Bourne shell
  # command line.  See +Shellwords::shellescape+ for details.
  #
  def shellescape
    Shellwords.escape(self)
  end
end

class Array
  #
  # call-seq:
  #   array.shelljoin => string
  #
  # Builds a command line string from an argument list +array+ joining
  # all elements escaped for Bourne shell and separated by a space.
  # See +Shellwords::shelljoin+ for details.
  #
  def shelljoin
    Shellwords.join(self)
  end
end

[+] rinda
[+] yaml
[-] rational.rb [edit]
[-] matrix.rb [edit]
[+] rdoc
[-] shell.rb [edit]
[-] ostruct.rb [edit]
[-] eregex.rb [edit]
[-] scanf.rb [edit]
[+] dl
[-] ftools.rb [edit]
[+] runit
[-] gserver.rb [edit]
[-] getoptlong.rb [edit]
[-] thread.rb [edit]
[-] sync.rb [edit]
[-] delegate.rb [edit]
[-] open-uri.rb [edit]
[-] openssl.rb [edit]
[-] debug.rb [edit]
[+] irb
[-] ping.rb [edit]
[-] digest.rb [edit]
[-] Env.rb [edit]
[-] yaml.rb [edit]
[-] sha1.rb [edit]
[-] forwardable.rb [edit]
[-] weakref.rb [edit]
[-] benchmark.rb [edit]
[-] profiler.rb [edit]
[-] uri.rb [edit]
[-] English.rb [edit]
[-] jcode.rb [edit]
[-] timeout.rb [edit]
[+] xsd
[+] bigdecimal
[-] tracer.rb [edit]
[-] resolv.rb [edit]
[+] uri
[-] tsort.rb [edit]
[-] find.rb [edit]
[-] logger.rb [edit]
[-] parsedate.rb [edit]
[-] importenv.rb [edit]
[-] profile.rb [edit]
[-] optparse.rb [edit]
[-] md5.rb [edit]
[-] getopts.rb [edit]
[-] pp.rb [edit]
[+] test
[-] date.rb [edit]
[+] drb
[+] io
[+] webrick
[-] cgi.rb [edit]
[-] pathname.rb [edit]
[+] xmlrpc
[-] mutex_m.rb [edit]
[+] rss
[+] wsdl
[+] racc
[-] complex.rb [edit]
[+] ..
[-] prettyprint.rb [edit]
[-] csv.rb [edit]
[-] kconv.rb [edit]
[-] securerandom.rb [edit]
[-] abbrev.rb [edit]
[-] resolv-replace.rb [edit]
[+] digest
[-] mathn.rb [edit]
[+] rexml
[+] soap
[-] mailread.rb [edit]
[-] e2mmap.rb [edit]
[-] shellwords.rb [edit]
[-] rss.rb [edit]
[-] time.rb [edit]
[+] openssl
[+] date
[-] finalize.rb [edit]
[-] readbytes.rb [edit]
[-] fileutils.rb [edit]
[-] generator.rb [edit]
[+] net
[-] monitor.rb [edit]
[-] tempfile.rb [edit]
[-] parsearg.rb [edit]
[-] cgi-lib.rb [edit]
[-] un.rb [edit]
[-] mkmf.rb [edit]
[-] base64.rb [edit]
[-] thwait.rb [edit]
[-] webrick.rb [edit]
[-] erb.rb [edit]
[-] rubyunit.rb [edit]
[+] shell
[-] expect.rb [edit]
[-] open3.rb [edit]
[+] cgi
[-] tmpdir.rb [edit]
[-] ipaddr.rb [edit]
[-] pstore.rb [edit]
[-] singleton.rb [edit]
[-] set.rb [edit]
[-] observer.rb [edit]
[-] drb.rb [edit]
[-] irb.rb [edit]
[+] x86_64-linux
[-] date2.rb [edit]
[+] optparse