Expect for Groovy library

This library is an implementation of DSL Expect for Groovy language

License

License

Categories

Categories

Net ORM Data
GroupId

GroupId

net.itransformers
ArtifactId

ArtifactId

expect4groovy
Last Version

Last Version

1.0.5
Release Date

Release Date

Type

Type

jar
Description

Description

Expect for Groovy library
This library is an implementation of DSL Expect for Groovy language
Project URL

Project URL

https://github.com/iTransformers/expect4groovy
Project Organization

Project Organization

iTransformers Labs
Source Code Management

Source Code Management

https://github.com/iTransformers/expect4groovy

Download expect4groovy

How to add to project

<!-- https://jarcasting.com/artifacts/net.itransformers/expect4groovy/ -->
<dependency>
    <groupId>net.itransformers</groupId>
    <artifactId>expect4groovy</artifactId>
    <version>1.0.5</version>
</dependency>
// https://jarcasting.com/artifacts/net.itransformers/expect4groovy/
implementation 'net.itransformers:expect4groovy:1.0.5'
// https://jarcasting.com/artifacts/net.itransformers/expect4groovy/
implementation ("net.itransformers:expect4groovy:1.0.5")
'net.itransformers:expect4groovy:jar:1.0.5'
<dependency org="net.itransformers" name="expect4groovy" rev="1.0.5">
  <artifact name="expect4groovy" type="jar" />
</dependency>
@Grapes(
@Grab(group='net.itransformers', module='expect4groovy', version='1.0.5')
)
libraryDependencies += "net.itransformers" % "expect4groovy" % "1.0.5"
[net.itransformers/expect4groovy "1.0.5"]

Dependencies

compile (3)

Group / Artifact Type Version
net.itransformers : expect4java jar 1.0.5
org.codehaus.groovy : groovy-all jar 2.1.9
log4j : log4j jar 1.2.16

test (1)

Group / Artifact Type Version
org.testng : testng jar 6.1.1

Project Modules

  • examples

Building

  1. To build the expect4groovy.jar only use:

    mvn package

  2. To build the expect4groovy-jar-with-dependencies.jar use:

    mvn assembly:assembly

  3. Current build status Build Status for iTransformers/expect4groovy

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

  1. Running with expect4groovy-jar-with-dependencies.jar:

    java -jar expect4groovy-1.1-jar-with-dependencies.jar src\test\java\example.groovy

    or

    java -jar expect4groovy-1.1-jar-with-dependencies.jar src\test\java\example.groovy DEBUG

  2. 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.jar
    

    java groovy.lang.GroovyShell src\test\java\example.groovy

    or

    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 : SendClosure

    The send closure is used to send characters.

    Example of invoking this closure is: send("say hello\r")

  • expect : ExpectClosure

    The 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 : RegExpMatchClosure

    Match 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 : GlobMatchClosure

    Match 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 : TimeoutMatchClosure

    Match 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

Q&A / Issue tracker

Community forum

Issue tracker

net.itransformers

iTransformers Labs

networking research

Versions

Version
1.0.5
1.0.4
1.0.3
1.0.0