Ruby y su mundo

Argumentos de la línea de comandos

ruby [
            opciones
            ] [--] [
            archivoprograma
            ] [
            argumentos
            ]

% ruby -w - "Hello World"

Opciones de la línea de comandos

-0[octal}

' The number ``0'' flag specifies the record separator character (\0, if no digit follows). -00 indicates paragraph mode: records are separated by two successive default record separator characters. -0777 reads the entire file at once (as it is an illegal character). Sets $/.

-a

' Auto split mode when used with -n or -p; equivalent to executing {$F at the top of each loop iteration.

-C directorio

' Cambia el directorio de trabajo a directorio antes de la ejecución.

-c

' Comprueba solo la sintaxis; no ejecuta el programa.

--copyright

Imprime la información sobre los derechos de autor y sale.

-d, --debug

' Establece $DEBUG a true. Ésto podrías usarlo en tus programas para activar trazas adicionales.

-e 'comando'

' Ejecuta comando como una línea de código Ruby. Se permiten varios -e, y los comandos se tratan como múltiples líneas en el mismo programa. Si archivoprograma se omite cuando -e está presente, la ejecución se detiene después de que los comandos -e se ejecuten.

-F patrón

' Especifica el separador de campos ($;) a usar por defecto en split() (afecta a -a).

-h, --help

' Muestra una pequeña pantalla de ayuda.

-I directorios

' Especifica los directorios que deben añadirse al comienzo de $LOAD_PATH ($:). La opcion -I puede aparecer varias veces, y también pueden aparecer varios directorios a continuación de cada -I. Los directorios deben separarse por ``:'' en sistemas tipo Unix y por ``;'' en sistemas DOS/Windows.

-i [extensión}

' Edits ARGV files in place. For each file named in ARGV, anything you write to standard output will be saved back as the contents of that file. A backup copy of the file will be made if extension is supplied.

% ruby -pi.bak -e "gsub(/Perl/, 'Ruby')" *.txt

-K kcode

' Especifica el conjunto de caracteres a usar. Esta opción es útil principalmente cuando se usa Ruby para procesado del idioma japonés. kcode puede tomar los siguientes valores: e, E para EUC; s, S para SJIS; u, U para UTF-8; o a, A, n, N para ASCII.

-l

' Habilita el procesado automático del fin de línea; establece $\ al valor de $/ y procesa todas las líneas de entrada automáticamente.

-n

' Coloca el bucle ``while gets; ...; end'' alrededor de tu programa Por ejemplo, un comando grep simple podría implemetarse así:

% ruby -n -e "print if /wombat/"  *.txt

-p

' Coloca tu código dentro del bucle ``while gets; ...; print; end.''

% ruby -p -e "$_.downcase!" *.txt

-r librería

' Hace un require de la librería indicada antes de la ejecución.

-S

' Busca el archivo del programa usando las variables de entorno RUBYPATH o PATH.

-s

' Cualquier opción de línea de comandos que aparezca entre el nombre del programa y el nombre de un archivo o un --, se borra de ARGV y se crea una variable global con el nombre de esa opción. En el siguiente ejemplo, se crearía una variable $opt con valor ``electric''.

% ruby -s prog -opt=electric ./mydata

-T[level}

' Establece el nivel de seguridad, el cual entre otras cosas habilita las comprobaciones de contaminación. (consultar página 253). Establece $SAFE.

-v, --verbose

' Activa el modo informativo e imprime el número de versión. En modo informativo se muestran las advertencias de compilación. Si no se especifica nombre de programa en la lína de comandos, Ruby sale.

--version

Muestra el número de versión de Ruby y sale.

-w

' Activa el modo informativo. Al contrario que -v, lee el programa desde la entrada estándar si no se especifica ningún archivo de programa. Recomendamos que ejecutes tus programas Ruby con -w.

-X directorio

' Cambia el directorio de trabajo a directorio antes de la ejecución. Equivalente a -C directorio.

-x [directorio}

' Elimina el texto anterior a la línea #!ruby y cambia el directorio de trabajo a directorio si se indica.

-y, --yydebug

' Habilita la depuración de yacc en el procesador de código (waaay muchísima información).

ARGV

% ruby -w ptest "Hello World" a1 1.6180

Finalización de un programa

Variables de entorno

Variables de entorno usadas por Ruby Nombre de la variable Descripción RUBYOPT Opciones de línea de comandos adicionales para Ruby; se examina después de que las opciones reales de la línea de comandos sean procesadas ($SAFE debe valer 0). RUBYLIB Rutas de búsqueda adicionales para los programas Ruby ($SAFE debe valer 0). RUBYPATH Con la opción -S, establece la ruta para la búsqueda de programas Ruby (por defecto se busca en PATH). RUBYSHELL Shell a usar cuando se creen nuevos procesos; si no está establecida también se consultará SHELL o COMSPEC. DLN_LIBRARY_PATH Ruta de búsqueda para módulos cargados dinámicamente. RUBYLIB_PREFIX (Solo Windows) Altera la ruta de búsqueda RUBYLIB añadiendo este prefijo a cada componente.

Escribir en variables de entorno

puts "In parent, term = #{ENV['TERM']}"
fork do
  puts "Start of child 1, term = #{ENV['TERM']}"
  ENV['TERM'] = "ansi"
  fork do
    puts "Start of child 2, term = #{ENV['TERM']}"
  end
  Process.wait
  puts "End of child 1, term = #{ENV['TERM']}"
end
Process.wait
puts "Back in parent, term = #{ENV['TERM']}"

In parent, term = xterm
Start of child 1, term = xterm
Start of child 2, term = ansi
End of child 1, term = ansi
Back in parent, term = xterm

Dónde busca Ruby sus módulos

% ruby -e 'puts $:'

/usr/local/lib/ruby/site_ruby/1.6/i686-linux
/usr/local/lib/ruby/site_ruby/1.6
/usr/local/lib/ruby/site_ruby
/usr/local/lib/ruby/1.6/i686-linux
/usr/local/lib/ruby/1.6
.

Entorno de compilación