JzConsole – standard input/output interaction module

JzConsole is a very simple module for agent’s interaction with standard input/output console.

In its first version it is even extremely simple, as it can handle on single words.

Query interface

• read – prints the provided query formula/text block and subsequently asks the user to fill all of the provided uninstantiated variables by a single word

Update interface

• print – prints the provided update formula/text block and subsequently prints IDs and values for each provided variable of the variable substitution

Notifications

• initialize – non obligatory notification – simply prints the provided formula
• finalize – non obligatory notification – simply prints the provided formula
• cycle – non obligatory notification – simply prints the provided formula

Variables

Variables are treated as standard strings. Variables contain only simple words, i.e. strings not including a blank character.

Example

test-console.jzz:

declare module environment as console

notify environment on cycle [{This is cycle notification!}]

when read environment (X,Y,Z) [{Provide variables please:}]
then 
{
        when read environment (X,Y,W) [{Provide variables again: }]
        then print environment(W,Y) [{Here are the variables:}]
}

The corresponding code execution then looks like:

$ jazzyk test-console.jzz -n 2

Provide variables please:
Provide a value for X: Peter
Provide a value for Y: Martin
Provide a value for Z: Fred
Provide variables again: 
Provide a value for W: Tweety
Here are the variables:
W = Tweety
Y = Martin
This is cycle notification!
Provide variables please:
Provide a value for X: Vilma
Provide a value for Y: Jane
Provide a value for Z: Ester
Provide variables again: 
Provide a value for W: Kathrin
Here are the variables:
W = Kathrin
Y = Jane
This is cycle notification!

Installation

To compile the module code simply execute the standard sequence:

$ ./configure
$ make
$ make install

You might need root rights on your system to install the module properly.

Dependencies

• Jazzyk
• Boost

jzConsole KR module was developed and tested with Boost version 1.34, but should work with latter versions as well.

Credits

The JzConsole module was developed by Peter Novak.