By CodingWithoutComments


2008-08-05 12:56:52 8 Comments

How do I call shell commands from inside of a Ruby program? How do I then get output from these commands back into Ruby?

20 comments

@Steve Willard 2008-08-05 14:42:45

This explanation is based on a commented Ruby script from a friend of mine. If you want to improve the script, feel free to update it at the link.

First, note that when Ruby calls out to a shell, it typically calls /bin/sh, not Bash. Some Bash syntax is not supported by /bin/sh on all systems.

Here are ways to execute a shell script:

cmd = "echo 'hi'" # Sample string that can be used
  1. Kernel#` , commonly called backticks – `cmd`

    This is like many other languages, including Bash, PHP, and Perl.

    Returns the result of the shell command.

    Docs: http://ruby-doc.org/core/Kernel.html#method-i-60

    value = `echo 'hi'`
    value = `#{cmd}`
    
  2. Built-in syntax, %x( cmd )

    Following the x character is a delimiter, which can be any character. If the delimiter is one of the characters (, [, {, or <, the literal consists of the characters up to the matching closing delimiter, taking account of nested delimiter pairs. For all other delimiters, the literal comprises the characters up to the next occurrence of the delimiter character. String interpolation #{ ... } is allowed.

    Returns the result of the shell command, just like the backticks.

    Docs: http://www.ruby-doc.org/docs/ProgrammingRuby/html/language.html

    value = %x( echo 'hi' )
    value = %x[ #{cmd} ]
    
  3. Kernel#system

    Executes the given command in a subshell.

    Returns true if the command was found and run successfully, false otherwise.

    Docs: http://ruby-doc.org/core/Kernel.html#method-i-system

    wasGood = system( "echo 'hi'" )
    wasGood = system( cmd )
    
  4. Kernel#exec

    Replaces the current process by running the given external command.

    Returns none, the current process is replaced and never continues.

    Docs: http://ruby-doc.org/core/Kernel.html#method-i-exec

    exec( "echo 'hi'" )
    exec( cmd ) # Note: this will never be reached because of the line above
    

Here's some extra advice: $?, which is the same as $CHILD_STATUS, accesses the status of the last system executed command if you use the backticks, system() or %x{}. You can then access the exitstatus and pid properties:

$?.exitstatus

For more reading see:

@Omer Aslam 2012-10-01 17:37:18

I need to log the outputs of my executable on production server but found no way. I used puts #{cmd} and logger.info(#{cmd}). Is there any way to log their outputs on production ?

@hughdbrown 2013-02-06 23:20:46

And IO#popen() and Open3#popen3(). mentalized.net/journal/2010/03/08/…

@sschuberth 2013-02-15 16:19:44

For the sake of completeness (as I first thought this would also be a Ruby command): Rake has sh which does "Run the system command cmd. If multiple arguments are given the command is not run with the shell (same semantics as Kernel::exec and Kernel::system)".

@sschuberth 2013-02-15 16:29:47

Also, this blog post additionally covers spawn and open3.

@Andrei Botalov 2013-02-17 22:19:50

Backticks don't capture STDERR by default. Append ` 2>&1` to command if you want to capture

@6ft Dan 2014-04-28 13:34:36

exec is nice because you can see the output on the console.

@sshaw 2015-02-12 16:29:39

If you're going to be shelling out via exec and system and passing along some options I suggest you checkout my library optout.

@james 2015-03-02 00:59:46

I have a small issue with ssh connection state. Please help me - stackoverflow.com/questions/28799593/… thanks.

@skagedal 2015-03-12 15:05:10

I think this answer would be slightly improved if it said that backticks and %x returned the "output", rather than the "result", of the given command. The latter could be mistaken for exit status. Or is that just me?

@baitisj 2015-05-18 23:09:36

Here's a (good?) example of how spawn can be used in conjunction with an embedded shell script within a ruby program: github.com/baitisj/spark-ping/blob/master/spark-ping Look at lines 76 - 94.

@oals 2016-05-19 10:39:35

Kernel#system also has a no-shell-involved mode (as of Ruby 1.9). It's in the documentation you linked to. AFAIK only Kernel#system and popen variants have that feature. It's highly desirable for security (no need to escape shell metacharacters) and efficiency (no extra fork).

@Mark E. Hamilton 2016-09-15 20:09:53

This answer says ruby 'typically calls /bin/sh'. How do you make it call /bin/bash instead?

@lucaortis 2018-07-05 12:55:22

Not really an answer but maybe someone will find this useful, and its regarding to this.

When using TK GUI on Windows, and u need to call shell commands from rubyw, u will always have an annoying cmd window popping up for less then a sec.

To avoid this u can use

WIN32OLE.new('Shell.Application').ShellExecute('ipconfig > log.txt','','','open',0)

or

WIN32OLE.new('WScript.Shell').Run('ipconfig > log.txt',0,0)

Both will store ipconfig's output inside 'log.txt', but no windows will come up.

U will need to require 'win32ole' inside your script.

system(), exec() and spawn() will all pop up that annoying window when using TK and rubyw.

@barlop 2017-12-19 05:54:55

Given a command eg attrib

require 'open3'

a="attrib"
Open3.popen3(a) do |stdin, stdout, stderr|
  puts stdout.read
end

I've found that while this method isn't as memorable as e.g. system("thecommand") or thecommand in backticks, a good thing about this method compared to other methods.. is e.g. backticks doesn't seem to let me 'puts' the command I run / store the command I want to run in a variable, and system("thecommand") doesn't seem to let me get the output. Whereas this method lets me do both of those things, and it lets me access stdin, stdout and stderr independently.

https://blog.bigbinary.com/2012/10/18/backtick-system-exec-in-ruby.html

http://ruby-doc.org/stdlib-2.4.1/libdoc/open3/rdoc/Open3.html

@dragon788 2017-06-02 20:14:02

If you really need Bash, per the note in the "best" answer.

First, note that when Ruby calls out to a shell, it typically calls /bin/sh, not Bash. Some Bash syntax is not supported by /bin/sh on all systems.

If you need to use Bash, insert bash -c "your Bash-only command" inside of your desired calling method.

quick_output = system("ls -la")

quick_bash = system("bash -c 'ls -la'")

To test:

system("echo $SHELL") system('bash -c "echo $SHELL"')

Or if you are running an existing script file (eg script_output = system("./my_script.sh")) Ruby should honor the shebang, but you could always use system("bash ./my_script.sh") to make sure (though there may be a slight overhead from /bin/sh running /bin/bash, you probably won't notice.

@Alex Lorsung 2017-03-30 18:13:13

easiest way is, for example:

reboot = `init 6`
puts reboot

@ysk 2017-02-16 09:58:31

  • backticks ` method is the easiest one to call shell commands from ruby. It returns the result of the shell command.

     url_request = 'http://google.com'
     result_of_shell_command = `curl #{url_request}`
    

@Utensil 2013-06-07 02:07:04

The answers above are already quite great, but I really want to share the following summary article: "6 Ways to Run Shell Commands in Ruby"

Basically, it tells us:

Kernel#exec:

exec 'echo "hello $HOSTNAME"'

system and $?:

system 'false' 
puts $?

Backticks (`):

today = `date`

IO#popen:

IO.popen("date") { |f| puts f.gets }

Open3#popen3 -- stdlib:

require "open3"
stdin, stdout, stderr = Open3.popen3('dc') 

Open4#popen4 -- a gem:

require "open4" 
pid, stdin, stdout, stderr = Open4::popen4 "false" # => [26327, #<IO:0x6dff24>, #<IO:0x6dfee8>, #<IO:0x6dfe84>]

@Mateusz Piotrowski 2015-11-03 23:00:27

the link is dead

@Ian 2016-05-19 17:01:00

Here's a flowchart based on this answer. See also, using script to emulate a terminal.

enter image description here

@Josh Bodah 2016-12-19 16:01:30

Wow haha. Very useful even though the fact this has to exist is unfortunate

@Kashyap 2015-12-11 14:57:01

If you have a more complex case than the common case (that can not be handled with ``) then check out Kernel.spawn() here. This seems to be the most generic/full-featured provided by stock Ruby to execute external commands.

E.g. you can use it to:

  • create process groups (Windows)
  • redirect in, out, error to files/each-other.
  • set env vars, umask
  • change dir before executing command
  • set resource limits for CPU/data/...
  • Do everything that can be done with other options in other answers, but with more code.

Official ruby documentation has good enough examples.

env: hash
  name => val : set the environment variable
  name => nil : unset the environment variable
command...:
  commandline                 : command line string which is passed to the standard shell
  cmdname, arg1, ...          : command name and one or more arguments (no shell)
  [cmdname, argv0], arg1, ... : command name, argv[0] and zero or more arguments (no shell)
options: hash
  clearing environment variables:
    :unsetenv_others => true   : clear environment variables except specified by env
    :unsetenv_others => false  : dont clear (default)
  process group:
    :pgroup => true or 0 : make a new process group
    :pgroup => pgid      : join to specified process group
    :pgroup => nil       : dont change the process group (default)
  create new process group: Windows only
    :new_pgroup => true  : the new process is the root process of a new process group
    :new_pgroup => false : dont create a new process group (default)
  resource limit: resourcename is core, cpu, data, etc.  See Process.setrlimit.
    :rlimit_resourcename => limit
    :rlimit_resourcename => [cur_limit, max_limit]
  current directory:
    :chdir => str
  umask:
    :umask => int
  redirection:
    key:
      FD              : single file descriptor in child process
      [FD, FD, ...]   : multiple file descriptor in child process
    value:
      FD                        : redirect to the file descriptor in parent process
      string                    : redirect to file with open(string, "r" or "w")
      [string]                  : redirect to file with open(string, File::RDONLY)
      [string, open_mode]       : redirect to file with open(string, open_mode, 0644)
      [string, open_mode, perm] : redirect to file with open(string, open_mode, perm)
      [:child, FD]              : redirect to the redirected file descriptor
      :close                    : close the file descriptor in child process
    FD is one of follows
      :in     : the file descriptor 0 which is the standard input
      :out    : the file descriptor 1 which is the standard output
      :err    : the file descriptor 2 which is the standard error
      integer : the file descriptor of specified the integer
      io      : the file descriptor specified as io.fileno
  file descriptor inheritance: close non-redirected non-standard fds (3, 4, 5, ...) or not
    :close_others => false : inherit fds (default for system and exec)
    :close_others => true  : dont inherit (default for spawn and IO.popen)

@MonsieurDart 2015-11-04 15:04:26

Don't forget the spawn command to create a background process to execute the specified command. You can even wait for its completion using the Process class and the returned pid:

pid = spawn("tar xf ruby-2.0.0-p195.tar.bz2")
Process.wait pid

pid = spawn(RbConfig.ruby, "-eputs'Hello, world!'")
Process.wait pid

The doc says: This method is similar to #system but it doesn't wait for the command to finish.

@Kashyap 2015-12-11 14:24:03

Kernel.spawn() seems to be far more versatile than all other options.

@JayCrossler 2014-10-14 20:12:11

Here's a cool one that I use in a ruby script on OS X (so that I can start a script and get an update even after toggling away from the window):

cmd = %Q|osascript -e 'display notification "Server was reset" with title "Posted Update"'|
system ( cmd )

@Steve Willard 2008-08-05 13:24:16

I'm definitely not a Ruby expert, but I'll give it a shot:

$ irb 
system "echo Hi"
Hi
=> true

You should also be able to do things like:

cmd = 'ls'
system(cmd)

@Nick Brosnahan 2008-08-07 05:10:35

Some things to think about when choosing between these mechanisms are:

  1. Do you just want stdout or do you need stderr as well? or even separated out?
  2. How big is your output? Do you want to hold the entire result in memory?
  3. Do you want to read some of your output while the subprocess is still running?
  4. Do you need result codes?
  5. Do you need a ruby object that represents the process and lets you kill it on demand?

You may need anything from simple backticks (``), system(), and IO.popen to full-blown Kernel.fork/Kernel.exec with IO.pipe and IO.select.

You may also want to throw timeouts into the mix if a subprocess takes too long to execute.

Unfortunately, it very much depends.

@Mihai A 2008-09-02 11:05:10

Here's the best article in my opinion about running shell scripts in Ruby: "6 Ways to Run Shell Commands in Ruby".

If you only need to get the output use backticks.

I needed more advanced stuff like STDOUT and STDERR so I used the Open4 gem. You have all the methods explained there.

@Mei 2011-11-22 17:58:02

The post described here doesn't discuss the %x syntax option.

@Brandan 2012-11-19 22:02:37

+1 for Open4. I had already started trying to implement my own version of its spawn method when I found this.

@james 2015-03-02 01:00:12

@MihaiA - I have a small issue with ssh connection state. Please help me - stackoverflow.com/questions/28799593/… thanks.

@j-g-faustus 2010-06-16 02:13:05

One more option:

When you:

  • need stderr as well as stdout
  • can't/won't use Open3/Open4 (they throw exceptions in NetBeans on my Mac, no idea why)

You can use shell redirection:

puts %x[cat bogus.txt].inspect
  => ""

puts %x[cat bogus.txt 2>&1].inspect
  => "cat: bogus.txt: No such file or directory\n"

The 2>&1 syntax works across Linux, Mac and Windows since the early days of MS-DOS.

@nkm 2012-02-19 18:07:16

We can achieve it in multiple ways.

Using Kernel#exec, nothing after this command is executed:

exec('ls ~')

Using backticks or %x

`ls ~`
=> "Applications\nDesktop\nDocuments"
%x(ls ~)
=> "Applications\nDesktop\nDocuments"

Using Kernel#system command, returns true if successful, false if unsuccessful and returns nil if command execution fails:

system('ls ~')
=> true

@Ryan Tate 2012-02-20 23:36:45

Using the answers here and linked in Mihai's answer, I put together a function that meets these requirements:

  1. Neatly captures STDOUT and STDERR so they don't "leak" when my script is run from the console.
  2. Allows arguments to be passed to the shell as an array, so there's no need to worry about escaping.
  3. Captures the exit status of the command so it is clear when an error has occurred.

As a bonus, this one will also return STDOUT in cases where the shell command exits successfully (0) and puts anything on STDOUT. In this manner, it differs from system, which simply returns true in such cases.

Code follows. The specific function is system_quietly:

require 'open3'

class ShellError < StandardError; end

#actual function:
def system_quietly(*cmd)
  exit_status=nil
  err=nil
  out=nil
  Open3.popen3(*cmd) do |stdin, stdout, stderr, wait_thread|
    err = stderr.gets(nil)
    out = stdout.gets(nil)
    [stdin, stdout, stderr].each{|stream| stream.send('close')}
    exit_status = wait_thread.value
  end
  if exit_status.to_i > 0
    err = err.chomp if err
    raise ShellError, err
  elsif out
    return out.chomp
  else
    return true
  end
end

#calling it:
begin
  puts system_quietly('which', 'ruby')
rescue ShellError
  abort "Looks like you don't have the `ruby` command. Odd."
end

#output: => "/Users/me/.rvm/rubies/ruby-1.9.2-p136/bin/ruby"

@cynicalman 2008-08-05 14:08:13

The way I like to do this is using the %x literal, which makes it easy (and readable!) to use quotes in a command, like so:

directorylist = %x[find . -name '*test.rb' | sort]

Which, in this case, will populate file list with all test files under the current directory, which you can process as expected:

directorylist.each do |filename|
  filename.chomp!
  # work with file
end

@x-yuri 2014-06-02 13:24:18

Does %x[ cmd ] returns an array to you?

@Nasser 2015-06-22 20:24:53

the above does not work for me. ``<main>': undefined method each' for :String (NoMethodError) how did it work for you? I am using ruby -v ruby 1.9.3p484 (2013-11-22 revision 43786) [i686-linux] Are you sure an array is returned from the command so that the loop will actually work?

@Ian Ellis 2016-12-07 20:28:18

%x[ cmd ].split("\n") will return a list though :)

@anshul 2008-09-18 17:47:37

My favourite is Open3

  require "open3"

  Open3.popen3('nroff -man') { |stdin, stdout, stderr| ... }

@severin 2013-05-06 07:39:57

I also like open3, especially Open3.capture3: ruby-doc.org/stdlib-1.9.3/libdoc/open3/rdoc/… -> stdout, stderr, status = Open3.capture3('nroff -man', :stdin_data => stdin)

@Pred 2016-11-29 15:30:15

Is there any documentation on how to perform Spec and Unit testing with Open3, or other Open's in the Ruby std-lib? Its hard to test shell outs at my current level of understanding.

@Rufo Sanchez 2008-08-05 13:57:47

You can also use the backtick operators (`), similar to Perl:

directoryListing = `ls /`
puts directoryListing # prints the contents of the root directory

Handy if you need something simple.

Which method you want to use depends on exactly what you're trying to accomplish; check the docs for more details about the different methods.

Related Questions

Sponsored Content

56 Answered Questions

[SOLVED] Calling an external command in Python

14 Answered Questions

[SOLVED] How to echo shell commands as they are executed

  • 2010-05-18 00:03:09
  • Jack Nock
  • 586160 View
  • 703 Score
  • 14 Answer
  • Tags:   shell trace

13 Answered Questions

[SOLVED] How do I set a variable to the output of a command in Bash?

14 Answered Questions

[SOLVED] Running shell command and capturing the output

23 Answered Questions

[SOLVED] How to specify the private SSH-key to use when executing shell command on Git?

  • 2010-12-30 19:42:01
  • Christoffer
  • 842099 View
  • 851 Score
  • 23 Answer
  • Tags:   git bash shell ssh

14 Answered Questions

[SOLVED] How to reload .bash_profile from the command line?

16 Answered Questions

[SOLVED] How to call shell script from another shell script?

  • 2011-12-02 07:05:17
  • Praveen
  • 784965 View
  • 585 Score
  • 16 Answer
  • Tags:   bash shell

34 Answered Questions

[SOLVED] Check if a directory exists in a shell script

  • 2008-09-12 20:06:25
  • Grundlefleck
  • 2532533 View
  • 3339 Score
  • 34 Answer
  • Tags:   shell unix posix

15 Answered Questions

[SOLVED] In the shell, what does " 2>&1 " mean?

  • 2009-05-03 22:57:00
  • Tristan Havelick
  • 953875 View
  • 1964 Score
  • 15 Answer
  • Tags:   bash shell unix redirect

33 Answered Questions

[SOLVED] How do I get the current absolute URL in Ruby on Rails?

Sponsored Content