test::expect(3pm) [debian man page]

Test::Expect(3pm)					User Contributed Perl Documentation					 Test::Expect(3pm)

NAME

       Test::Expect - Automated driving and testing of terminal-based programs

SYNOPSIS

	 # in a t/*.t file:
	 use Test::Expect;
	 use Test::More tests => 13;
	 expect_run(
	   command => "perl testme.pl",
	   prompt  => 'testme: ',
	   quit    => 'quit',
	 );
	 expect("ping", "pong", "expect");
	 expect_send("ping", "expect_send");
	 expect_is("* Hi there, to testme", "expect_is");
	 expect_like(qr/Hi there, to testme/, "expect_like");

DESCRIPTION

       Test::Expect is a module for automated driving and testing of terminal-based programs.  It is handy for testing interactive programs which
       have a prompt, and is based on the same concepts as the Tcl Expect tool.  As in Expect::Simple, the Expect object is made available for
       tweaking.

       Test::Expect is intended for use in a test script.

SUBROUTINES

   expect_run
       The expect_run subroutine sets up Test::Expect. You must pass in the interactive program to run, what the prompt of the program is, and
       which command quits the program:

	 expect_run(
	   command => "perl testme.pl",
	   prompt  => 'testme: ',
	   quit    => 'quit',
	 );

   expect
       The expect subroutine is the catch all subroutine. You pass in the command, the expected output of the subroutine and an optional comment.

	 expect("ping", "pong", "expect");

   expect_send
       The expect_send subroutine sends a command to the program. You pass in the command and an optional comment.

	 expect_send("ping", "expect_send");

   expect_is
       The expect_is subroutine tests the output of the program like Test::More's is. It has an optional comment:

	 expect_is("* Hi there, to testme", "expect_is");

   expect_like
       The expect_like subroutine tests the output of the program like Test::More's like. It has an optional comment:

	 expect_like(qr/Hi there, to testme/, "expect_like");

   expect_handle
       This returns the Expect object.

expect_quit
       Closes the Expect handle.

SEE ALSO

       Expect, Expect::Simple.

AUTHOR

       Leon Brocard, "<acme@astray.com>"

COPYRIGHT

       Copyright (C) 2005, Leon Brocard

       This module is free software; you can redistribute it or modify it under the same terms as Perl itself.

perl v5.12.3							    2011-06-12							 Test::Expect(3pm)

DISLOCATE(1)                                                  General Commands Manual                                                 DISLOCATE(1)

NAME

       Dislocate - disconnect and reconnect processes

SYNOPSIS

       dislocate [ program args...  ]

INTRODUCTION

       Dislocate allows processes to be disconnected and reconnected to the terminal.  Possible uses:

              o   You can disconnect a process from a terminal at work and reconnect from home, to continue working.

              o   After having your line be dropped due to noise, you can get back to your process without having to restart it from scratch.

              o   If  you  have  a problem that you would like to show someone, you can set up the scenario at your own terminal, disconnect, walk
                  down the hall, and reconnect on another terminal.

              o   If you are in the middle of a great game (or whatever) that does not allow you to save, and someone else kicks you off the  ter-
                  minal, you can disconnect, and reconnect later.

USAGE

       When run with no arguments, Dislocate tells you about your disconnected processes and lets you reconnect to one.  Otherwise, Dislocate runs
       the named program along with any arguments.

       By default, ^] is an escape that lets you talk to Dislocate itself.  At that point, you can disconnect (by pressing ^D) or  suspend  Dislo-
       cate (by pressing ^Z).

       Any  Tcl  or  Expect  command  is also acceptable at this point.  For example, to insert the contents of a the file /etc/motd as if you had
       typed it, say:

            send -i $out [exec cat /etc/motd]

       To send the numbers 1 to 100 in response to the prompt "next #", say:

            for {set i 0} {$i<100} {incr i} {
                expect -i $in "next #"
                send -i $out "$i
"
            }

       Scripts can also be prepared and sourced in so that you don't have to type them on the spot.

       Dislocate is actually just a simple Expect script.  Feel free to make it do what you want it to do or just  use  Expect  directly,  without
       going through Dislocate.  Dislocate understands a few special arguments.  These should appear before any program name.  Each should be sep-
       arated by whitespace.  If the arguments themselves takes arguments, these should also be separated by whitespace.

       The -escape flag sets the escape to whatever follows.  The default escape is ^].

CAVEATS

       This program was written by the author as an exercise to show that communicating with disconnected processes is easy.  There are many  fea-
       tures that could be added, but that is not the intent of this program.

SEE ALSO

       Tcl(3), libexpect(3)
       "Exploring Expect: A Tcl-Based Toolkit for Automating Interactive Programs" by Don Libes, O'Reilly and Associates, January 1995.

AUTHOR

       Don Libes, National Institute of Standards and Technology

                                                                  7 October 1993                                                      DISLOCATE(1)