Expect

Expect

Original author(s)	Don Libes
Developer(s)	Nils Carlson
Stable release	5.45.4 / 4 February 2018; 11 months ago (2018-02-04)
Written in	Tcl
Operating system	POSIX, Windows
License	Public domain[1]
Website	core.tcl.tk/expect

This article is about the Unix tool. For a definition of the word "expect", see the Wiktionary entry expect.

Expect, an extension to the Tcl scripting language written by Don Libes, is a program that automates interactions with programs that expose a text terminal interface. Expect, originally written in 1990 for the Unix platform, has since become available also for Microsoft Windows and other systems.

• 
  Software Testing portal
  

Contents

• 
  1 Basics
  


• 
  2 Usage
  


• 
  3 Alternatives
  
  
  
  • 
    3.1 C#
    
  
  
  • 
    3.2 Java
    
  
  
  • 
    3.3 Scala
    
  
  
  • 
    3.4 Groovy
    
  
  
  • 
    3.5 Perl
    
  
  
  • 
    3.6 Python
    
  
  
  • 
    3.7 Ruby
    
  
  
  • 
    3.8 Shell
    
  
  
  • 
    3.9 Go
    
  
  
  
  


• 
  4 References
  


• 
  5 Further reading
  


• 
  6 External links
  

Basics

Expect is used to automate control of interactive applications such as Telnet, FTP, passwd, fsck, rlogin, tip, SSH, and others. Expect uses pseudo terminals (Unix) or emulates a console (Windows), starts the target program, and then communicates with it, just as a human would, via the terminal or console interface. Tk, another Tcl extension, can be used to provide a GUI.

Expect has regular expression pattern matching and general program capabilities, allowing simple scripts to intelligently control programs such as Telnet, FTP, and SSH, all of which lack a programming language, macros, or any other program mechanism.

Usage

Expect serves as a "glue" to link existing utilities together. The general idea is to figure out how to make Expect use the system's existing tools rather than figure out how to solve a problem inside of Expect.

A key usage of Expect involves commercial software products. Many of these products provide some type of command-line interface, but these usually lack the power needed to write scripts. They were built to service the users administering the product, but the company often does not spend the resources to fully implement a robust scripting language. An Expect script can spawn a shell, look up environmental variables, perform some Unix commands to retrieve more information, and then enter into the product's command-line interface armed with the necessary information to achieve the user's goal. After retrieving information by interacting with the product via its command-line interface, the script can make intelligent decisions about what action to take, if any.

Every time an Expect operation is completed, the results are stored in a local variable called $expect_out. This allows the script to harvest information to feedback to the user, and it also allows conditional behavior of what to send next based on the circumstances.

A common use of Expect is to set up a testing suite, whether it be for programs, utilities or embedded systems. DejaGnu is a testing suite written using Expect for use in testing. It has been used extensively for testing GCC and is very^{[citation needed]} well suited to testing remote targets such as embedded development.

One can automate the generation of an expect script using a tool called 'autoexpect'. This tool observes your actions and generates an expect script using heuristics. Though generated code may be large and somewhat cryptic, one can always tweak the generated script to get the exact code.

# Assume $remote_server, $my_user_id, $my_password, and $my_command were read in earlier

# in the script.

# Open a telnet session to a remote server, and wait for a username prompt.

spawn telnet $remote_server

expect "username:"

# Send the username, and then wait for a password prompt.

send "$my_user_idr"

expect "password:"

# Send the password, and then wait for a shell prompt.

send "$my_passwordr"

expect "%"

# Send the prebuilt command, and then wait for another shell prompt.

send "$my_commandr"

expect "%"

# Capture the results of the command into a variable. This can be displayed, or written to disk.

set results $expect_out(buffer)

# Exit the telnet session, and wait for a special end-of-file character.

send "exitr"

expect eof

Another example is a script that automates FTP:

# Set timeout parameter to a proper value.

# For example, the file size is indeed big and the network speed is really one problem,

# you'd better set this parameter a value.

set timeout -1

# Open an ftp session to a remote server, and wait for a username prompt.

spawn ftp $remote_server

expect "username:"

# Send the username, and then wait for a password prompt.

send "$my_user_idr"

expect "password:"

# Send the password, and then wait for an ftp prompt.

send "$my_passwordr"

expect "ftp>"

# Switch to binary mode, and then wait for an ftp prompt.

send "binr"

expect "ftp>"

# Turn off prompting.

send "promptr"

expect "ftp>"

# Get all the files

send "mget *r"

expect "ftp>"

# Exit the ftp session, and wait for a special end-of-file character.

send "byer"

expect eof

Below is an example that automates SFTP (with password):

#!/usr/bin/env expect -f



# procedure to attempt connecting; result 0 if OK, 1 otherwise

proc connect {passw} {

  expect {

    "Password:" {

      send "$passwr"

        expect {

          "sftp*" {

            return 0

          }

        }

    }

  }

  # timed out

  return 1

}



#read the input parameters

set user [lindex $argv 0]

set passw [lindex $argv 1]

set host [lindex $argv 2]

set location [lindex $argv 3]

set file1 [lindex $argv 4]

set file2 [lindex $argv 5]



#puts "Argument data:n";

#puts "user: $user";

#puts "passw: $passw";

#puts "host: $host";

#puts "location: $location";

#puts "file1: $file1";

#puts "file2: $file2";



#check if all were provided

if { $user == "" || $passw == "" || $host == "" || $location == "" || $file1 == "" || $file2 == "" }  {

  puts "Usage: <user> <passw> <host> <location> <file1 to send> <file2 to send>n"

  exit 1

}



#sftp to specified host and send the files

spawn sftp $user@$host



set rez [connect $passw]

if { $rez == 0 } {

  send "cd $locationr"

  set timeout -1

  send "put $file2r"

  send "put $file1r"

  send "ls -lr"

  send "quitr"

  expect eof

  exit 0

}

puts "nError connecting to server: $host, user: $user and password: $passw!n"

exit 1

it should be noted that using passwords as command-line arguments, like in this example, is a huge security hole, as any other user on the machine can read this password by running "ps". You can, however, add code that will prompt you for your password rather than giving your password as an argument. This should be more secure. See the example below.

stty -echo

send_user -- "Enter Password: "

expect_user -re "(.*)n"

send_user "n"

stty echo

set PASS $expect_out(1,string)

Another example of automated ssh login in user machine:

#timeout is a predefined variable in expect which by default is set to 10 sec

#spawn_id is another default variable in expect.

#It is good practice to close spawn_id handle created by spawn command

set timeout 60

spawn ssh $user@machine

while {1} {

  expect {



    eof                          {break}

    "The authenticity of host"   {send "yesr"}

    "password:"                  {send "$passwordr"}

    "*]"                        {send "exitr"}

  }

}

wait

close $spawn_id

Alternatives

Various projects implement Expect-like functionality in other languages, such as C#, Java, Scala, Groovy, Perl, Python, Ruby, Shell and Go. These are generally not exact clones of the original Expect, but the concepts tend to be very similar.

C#

• 
  Expect.NET — Expect functionality for C# (.NET)


• 
  DotNetExpect — An Expect-inspired console automation library for .NET

Java

• 
  ExpectIt — a pure Java 1.6+ implementation of the Expect tool. It is designed to be simple, easy to use and extensible.


• 
  expect4j — an attempt at a Java clone of the original Expect


• 
  ExpectJ — a Java implementation of the Unix expect utility


• 
  Expect-for-Java — pure Java implementation of the Expect tool


• 
  expect4java  - a Java implementation of the Expect tool, but supports nested clousures. There is also wrapper for Groovy language DSL.

Scala

• 
  scala-expect — a Scala implementation of a very small subset of the Expect tool.

Groovy

• 
  expect4groovy  - a Groovy DSL implementation of Expect tool.

Perl

• 
  Expect.pm — Perl module (newest version at metacpan.org)

Python

• 
  Pexpect — Python module for controlling interactive programs in a pseudo-terminal


• 
  winpexpect — port of pexpect to the Windows platform

Ruby

• 
  RExpect — a drop in replacement for the expect.rb module in the standard library.


• 
  Expect4r — Interact with Cisco IOS, IOS-XR, and Juniper JUNOS CLI

Shell

• 
  Empty — expect-like utility to run interactive commands in the UNIX shell-scripts


• 
  sexpect — Expect for Shells. It's implemented in the client/server model which also supports attach/detach (like GNU screen).

Go

• 
  GoExpect - expect-like package for the Go language


• 
  go-expect - an expect-like golang library to automate control of terminal or console based programs.

References

1. 
   ^ "Expect FAQ: Our company policy requires a license to use Expect. Where can we get a license?"..mw-parser-output cite.citation{font-style:inherit}.mw-parser-output .citation q{quotes:"""""""'""'"}.mw-parser-output .citation .cs1-lock-free a{background:url("//upload.wikimedia.org/wikipedia/commons/thumb/6/65/Lock-green.svg/9px-Lock-green.svg.png")no-repeat;background-position:right .1em center}.mw-parser-output .citation .cs1-lock-limited a,.mw-parser-output .citation .cs1-lock-registration a{background:url("//upload.wikimedia.org/wikipedia/commons/thumb/d/d6/Lock-gray-alt-2.svg/9px-Lock-gray-alt-2.svg.png")no-repeat;background-position:right .1em center}.mw-parser-output .citation .cs1-lock-subscription a{background:url("//upload.wikimedia.org/wikipedia/commons/thumb/a/aa/Lock-red-alt-2.svg/9px-Lock-red-alt-2.svg.png")no-repeat;background-position:right .1em center}.mw-parser-output .cs1-subscription,.mw-parser-output .cs1-registration{color:#555}.mw-parser-output .cs1-subscription span,.mw-parser-output .cs1-registration span{border-bottom:1px dotted;cursor:help}.mw-parser-output .cs1-ws-icon a{background:url("//upload.wikimedia.org/wikipedia/commons/thumb/4/4c/Wikisource-logo.svg/12px-Wikisource-logo.svg.png")no-repeat;background-position:right .1em center}.mw-parser-output code.cs1-code{color:inherit;background:inherit;border:inherit;padding:inherit}.mw-parser-output .cs1-hidden-error{display:none;font-size:100%}.mw-parser-output .cs1-visible-error{font-size:100%}.mw-parser-output .cs1-maint{display:none;color:#33aa33;margin-left:0.3em}.mw-parser-output .cs1-subscription,.mw-parser-output .cs1-registration,.mw-parser-output .cs1-format{font-size:95%}.mw-parser-output .cs1-kern-left,.mw-parser-output .cs1-kern-wl-left{padding-left:0.2em}.mw-parser-output .cs1-kern-right,.mw-parser-output .cs1-kern-wl-right{padding-right:0.2em}
   

Further reading

• 
  Libes, Don (1995). Exploring Expect: A Tcl-Based Tool for Automating Interactive Programs. O'Reilly & Associates, Inc. ISBN 1-565-92090-2.
  


• "Advanced Programming in Expect: A Bulletproof Interface"

External links

• Official website


• 
  Expect on SourceForge.net
  


• 
  Expect page — on The Tcler's Wiki


• IBM Blog

This page is only for reference, If you need detailed information, please check here