JarCastingBuilding
-
To build the expect4groovy.jar only use:
mvn package -
To build the expect4groovy-jar-with-dependencies.jar use:
mvn assembly:assembly -
Current build status
Get a stable release from a Maven Repo
In your maven POM file add:
<dependency>
<groupId>net.itransformers</groupId>
<artifactId>expect4groovy</artifactId>
<version>1.0.0</version>
</dependency>
Running
-
Running with expect4groovy-jar-with-dependencies.jar:
java -jar expect4groovy-1.1-jar-with-dependencies.jar src\test\java\example.groovyor
java -jar expect4groovy-1.1-jar-with-dependencies.jar src\test\java\example.groovy DEBUG -
Running with expect4groovy.jar
export CLASSPATH=expect4groovy-1.1.jar:groovy-all-2.1.9.jar:\ commons-net-3.0.1.jar:jsch-0.1.44-1.jar:log4j-1.2.16.jar:\ oro-2.0.8.jar:commons-lang3-3.3.1.jarjava groovy.lang.GroovyShell src\test\java\example.groovyor
java groovy.lang.GroovyShell src\test\java\example.groovy DEBUG
excpect4groovy closures
This library is registers the following Groovy closures into the groovy script's bindings:
-
send: SendClosureThe send closure is used to send characters.
Example of invoking this closure is:
send("say hello\r") -
expect: ExpectClosureThe expect closure has several overloads:
-
expect(string)Example of invoking this closure overload is:
expect("login:") -
expect(string, closure)Example of invoking this closure overload is:
expect("login:") { // the closure code invoked if there is a match } -
expect(Match[] mathes)Example of invoking this closure overload is:
expect ([ _gl("hello\r"){ println("Matched hello") it.exp_continue() }, _re("hello [0-9]+\r"){ net.itransformers.expect4java.ExpectContext expectState -> println("Matched: "+expectState.getMatch()) expectState.exp_continue() } ])
-
-
_re: RegExpMatchClosureMatch closure object used for matching characters received into input stream using regular expression pattern.
This Match closure can be used as an array element of parameter of expect closure.
The _re closure has two overloads:
_re(string_re_pattern)_re(string_re_pattern,closure)
The second one has a closure parameter which will be invoked if the regexp matches.
-
_gl: GlobMatchClosureMatch closure object used for matching characters received into input stream using glob pattern.
This Match closure can be used as an array element of parameter of expect closure.
The _re closure has two overloads:
_gl(string)_gl(string,closure)The second one has a closure parameter which will be invoked if the regexp matches.
-
timeout: TimeoutMatchClosureMatch closure object used to handle expect timeouts.
This Match closure can be used as an array element of parameter of expect closure.
For example:
expect ([ timeout(){ // some code is executed here if there is timeout } ])or:
expect ([ timeout(1000L) ]) -
eof: EofMatchClosure
Inside each match closure the following object is available: net.itransformers.expect4java.ExpectContext.
This object has the following most important methods:
void exp_continue();void exp_continue_reset_timer();String getBuffer();String getMatch(int groupnum);String getMatch();
Registering groovy closures
The above Groovy closures are registered into script bindings with one of the following overloads of createBindings method:
void Expect4Groovy.createBindings(CLIConnection cliConnection, Binding binding, boolean withLogging);
Map<String, Object> Expect4Groovy.createBindings(CLIConnection cliConnection);
Map<String, Object> Expect4Groovy.createBindings(InputStream is, OutputStream os);
Example:
CLIConnection conn = new RawSocketCLIConnection()
conn.connect(["user":"v","password":"123","address":"localhost:23"])
Expect4Groovy.createBindings(conn, getBinding(), true)
Another available connections are:
- net.itransformers.expect4groovy.cliconnection.impl.SshCLIConnection
- net.itransformers.expect4groovy.cliconnection.impl.EchoCLIConnection
- net.itransformers.expect4groovy.cliconnection.impl.RawSocketCLIConnection
- net.itransformers.expect4groovy.cliconnection.impl.TelnetCLIConnection
Example expect4groovy script
import net.itransformers.expect4groovy.Expect4Groovy
import net.itransformers.expect4groovy.cliconnection.CLIConnection
import net.itransformers.expect4groovy.cliconnection.impl.EchoCLIConnection
import net.itransformers.expect4java.ExpectContext
import org.apache.log4j.Level
import org.apache.log4j.LogManager
if (args.length == 0){
LogManager.getRootLogger().setLevel(Level.INFO);
} else {
LogManager.getRootLogger().setLevel(Level.toLevel(args[0]));
}
CLIConnection conn = new EchoCLIConnection()
def params = [:] // empty map for echo connection
conn.connect(params)
Expect4Groovy.createBindings(conn, getBinding(), true)
expect.setTimeout(1000){
println "Timeout while expecting"
}
// simple send to echo connection
send("echo\n")
send("test\n")
expect ("echo\n") {
// Example how to use nested expect closures
expect("test\n") {
send("hello\n") // send to echo connection again
}
}
// expect hello as it should be send already to the echo connection
expect("hello\n");
// Example usage of '_re' closure
send ("echo1234")
expect (_re("[a-z]+([0-9]+)"){
println("Captured: "+it.getMatch(1))
})
// More complicated examples with array of Match closures.
// Shows also how to use exp_continue of ExpectContext
send ("echo1234\n")
send ("5678echo\n")
send ("ZZZ\n")
expect ([
_re("[a-z]+([0-9]+)"){ ExpectContext it ->
println("Captured: "+it.getMatch(1))
it.exp_continue();
},
_re("([0-9]+)[a-z]+"){
println("Captured: "+it.getMatch())
it.exp_continue();
},
_gl("ZZZ"){
println("Captured: ZZZ")
}
])
//Shows how the global timeout closure will be invoked.
send("hello\n")
expect("John"){
println("This text should not appear in console")
}
//Shows how the local timeout closure will be invoked.
send("test\n")
expect([
_gl("Smith") {
println("This text should not appear in console")
},
_timeout(500){
println("This is a timeout example")
}
])
// Lets close echo connection
conn.disconnect()
// Even the connection is closed the eof will be in the expect buffer
// so lets expect for eof (end of file).
expect _eof()
Dependencies
expect4groovy runtime depends on the following other libraries.
- Maven: org.codehaus.groovy:groovy-all:2.1.9
- Maven: org.apache.commons:commons-net:3.3.1
- Maven: com.jcraft:jsch:0.1.44-1 (optional for ssh connections)
- Maven: commons-net:commons-net:3.0.1
- Maven: oro:oro:2.0.8
- Maven: log4j:log4j:1.2.16
