Documentation Archive

Developer

Mac Automation Scripting Guide

On This Page

Calling Command-Line Tools

In AppleScript, the do shell script command is used to execute command-line tools. This command is implemented by the Standard Additions scripting addition included with OS X.

Executing Commands

The direct parameter of the do shell script command is a string containing the shell code you want to execute, as demonstrated in Listing 39-1, which simply lists a directory.

APPLESCRIPT

Open in Script Editor

Listing 39-1AppleScript: Executing a simple shell command that lists the contents of a directory
  1. do shell script "ls /Applications/"
  2. (*
  3. --> Result:
  4. "App Store.app
  5. Automator.app
  6. Calculator.app
  7. Calendar.app
  8. ..."
  9. *)

Since the direct parameter of do shell script is a string, you can concatenate it with other strings at run time. Listing 39-2, for example, concatenates a shell command to a previously defined parameter value.

APPLESCRIPT

Open in Script Editor

Listing 39-2AppleScript: Concatenating a command with a value
  1. set theHostName to "www.apple.com"
  2. do shell script "ping -c1 " & theHostName

Quoting Strings

The shell uses space characters to separate parameters and gives special meaning to certain punctuation marks, such as $, (, ), and *. To ensure that strings are treated as expected—for example, spaces aren’t seen as delimiters—it’s best to wrap strings in quotes. This process is known as quoting. If your string contains quotes, they must also be escaped (preceded by a / character) so they are interpreted as part of the string. Listing 39-3 shows an example of an error occurring as a result of a parameter that contains a space.

APPLESCRIPT

Open in Script Editor

Listing 39-3AppleScript: An error resulting from a string containing a space
  1. set thePath to "/Library/Application Support/"
  2. do shell script "ls " & thePath
  3. --> Result: error "ls: /Library/Application: No such file or directory\rls: Support: No such file or directory" number 1

The easiest way to quote a string is to use the quoted form property of the text class, as demonstrated in Listing 39-4. This property returns the string in a form that’s safe from further interpretation by the shell, regardless of its contents.

APPLESCRIPT

Open in Script Editor

Listing 39-4AppleScript: Quoting a string to prevent errors
  1. set thePath to quoted form of "/Library/Application Support/"
  2. --> Result: "'/Library/Application Support/'"
  3. do shell script "ls " & thePath
  4. (*
  5. --> Result:
  6. "App Store
  7. Apple
  8. ...
  9. "
  10. *)

More Information

For more information about the do shell script command, see Commands Reference in AppleScript Language Guide and Technical Note TN2065.