CLI library user guide

Try it out! Here is a sample CLI resource file:

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="myCLI">
</cli>

Copy the stuff into a new empty.xml file.

Let's say we want to have C++. Launch the transformation from XML to C++ using the cli2cpp.py python script:

python ${CLI_DIR}/tools/cli2cpp.py empty.xml --output empty.cpp

That's all folks! Have a look at the generated C++ file if you want.

And it works with java as well!

python ${CLI_DIR}/tools/cli2java.py --cli-class-name "Empty" empty.xml --output Empty.java

Have a look at the generated Java file.

You're now ready to compile.

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Hello">
 <keyword string="say">
  <keyword string="hello">
   <endl></endl>
  </keyword>
 </keyword>
</cli>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Hello">
 <keyword string="say">
  <keyword string="hello">
   <endl></endl>
  </keyword>
 </keyword>
 <keyword string="shout">
  <keyword string="hello">
   <endl></endl>
  </keyword>
 </keyword>
</cli>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Hello">
 <keyword string="say">
  <keyword string="hello">
   <endl></endl>
  </keyword>
  <keyword string="bye">
   <endl></endl>
  </keyword>
 </keyword>
 <keyword string="shout">
  <keyword string="hello">
   <endl></endl>
  </keyword>
  <keyword string="bye">
   <endl></endl>
  </keyword>
 </keyword>
</cli>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Hello"><help lang="en">Hello menu</help><help lang="fr">Menu Hello</help>
 <keyword string="say"><help lang="en">Say something.</help><help lang="fr">Dire quelque chose.</help>
  <keyword string="hello"><help lang="en">Say hello.</help><help lang="fr">Dire bonjour.</help>
   <endl></endl>
  </keyword>
  <keyword string="bye"><help lang="en">Say goodbye.</help><help lang="fr">Dire au revoir.</help>
   <endl></endl>
  </keyword>
 </keyword>
</cli>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Hello">
 <keyword string="say">
  <keyword string="hello">
   <endl>
    <cpp>sayHello();</cpp>
    <java>HelloApi.sayHello();</java>
   </endl>
  </keyword>
 </keyword>
</cli>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Hello">
 <cpp option="include">#include "hello_api.h"</cpp>
 <java option="import">import cli.test.samples.HelloApi;</java>
 <keyword string="say">
  <keyword string="hello">
   <endl>
    <cpp>sayHello();</cpp>
    <java>HelloApi.sayHello();</java>
   </endl>
  </keyword>
 </keyword>
</cli>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Hello">
 <keyword string="say">
  <keyword string="hello">
   <endl>
    <cpp><out/> << "Hello world!" << cli::endl;</cpp>
    <java><out/>.put("Hello world!").endl();</java>
   </endl>
  </keyword>
 </keyword>
</cli>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Params">
 <keyword string="enter">
  <keyword string="string">
   <param type="string" id="a-string">
    <endl>
     <cpp><out/> << <value-of param="a-string"/> << cli::endl;</cpp>
     <java><out/>.put(<value-of param="a-string"/>).endl();</java>
    </endl>
   </param>
  </keyword>
  <keyword string="int">
   <param type="int" id="an-int">
    <endl>
     <cpp><out/> << <value-of param="an-int"/> << cli::endl;</cpp>
     <java><out/>.put(<value-of param="an-int"/>).endl();</java>
    </endl>
   </param>
  </keyword>
  <keyword string="float">
   <param type="float" id="a-float">
    <endl>
     <cpp><out/> << <value-of param="a-float"/> << cli::endl;</cpp>
     <java><out/>.put(<value-of param="a-float"/>).endl();</java>
    </endl>
   </param>
  </keyword>
  <keyword string="host">
   <param type="host" id="a-host">
    <endl>
     <cpp><out/> << <value-of param="a-host"/> << cli::endl;</cpp>
     <java><out/>.put(<value-of param="a-host"/>).endl();</java>
    </endl>
   </param>
  </keyword>
 </keyword>
</cli>

Consider the following object class:

class Circle {
public:
    Circle(void) : m_iX(0), m_iY(0), m_iR(1), m_ulColor(0) {}
    void SetXPosition(int X) { m_iX = X; }
    int GetXPosition(void) const { return m_iX; }
    void SetYPosition(int Y) { m_iY = Y; }
    int GetYPosition(void) const { return m_iY; }
    void SetRadius(int R) { m_iR = R; }
    int GetRadius(void) const { return m_iR; }
    void SetColor(unsigned long C) { m_ulColor = C; }
    unsigned long GetColor(void) const { return m_ulColor; }
private:
    int m_iX;
    int m_iY;
    int m_iR;
    unsigned long m_ulColor;
};
void Draw(const Circle& C) {}

or:

public class Circle {
    public Circle() { m_iX = 0; m_iY = 0; m_iR = 1; m_ulColor = 0; }
    public void setXPosition(int X) { m_iX = X; }
    public int getXPosition() { return m_iX; }
    public void setYPosition(int Y) { m_iY = Y; }
    public int getYPosition() { return m_iY; }
    public void setRadius(int R) { m_iR = R; }
    public int getRadius() { return m_iR; }
    public void setColor(long C) { m_ulColor = C; }
    public long getColor() { return m_ulColor; }
    public void draw() {}

    private int m_iX;
    private int m_iY;
    private int m_iR;
    private long m_ulColor;
}

Thanks to a tag, you can define an optional command line filling an object of this class:

,->
|
|
|
|
|
|
|
|
+--
|
|
|
|
|
|
+--
|
|
|
|
|
|
`--

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Circle">
 <cpp option="include">#include "circle.h"</cpp>
 <keyword string="add">
  <keyword string="circle">
   <cpp>Circle c;</cpp>
   <java>Circle c = new Circle();</java>
   <tag id="circle">
    <endl>
     <cpp>Draw(c);</cpp>
     <java>c.draw();</java>
    </endl>
    <keyword string="x_position">
     <param type="int" id="X">
      <cpp>c.SetXPosition(<value-of param="X"/>);</cpp>
      <java>c.setXPosition(<value-of param="X"/>);</java>
      <tag ref="circle" max="1"/>
     </param>
    </keyword>
    <keyword string="y_position">
     <param type="int" id="Y">
      <cpp>c.SetYPosition(<value-of param="Y"/>);</cpp>
      <java>c.setYPosition(<value-of param="Y"/>);</java>
      <tag ref="circle" max="1"/>
     </param>
    </keyword>
    <keyword string="radius">
     <param type="int" id="R">
      <cpp>c.SetRadius(<value-of param="R"/>);</cpp>
      <java>c.setRadius(<value-of param="R"/>);</java>
      <tag ref="circle" max="1"/>
     </param>
    </keyword>
   </tag>
  </keyword>
 </keyword>
</cli>

(1)



(2)




(3)






(3)






(3)

This example accepts the following command lines:

add circle
add circle x_position 1
add circle y_position 2
add circle radius 2
add circle x_position -1 y_position -1 radius 3
...

If you want parameters to be ordered, you could use the following pattern.

,--
|
|
|
|
+--
|
|
|
|
+--
|
|
|
|
+--
|
`->

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Circle">
 <cpp option="include">#include "circle.h"</cpp>
 <keyword string="add">
  <keyword string="circle">
   <cpp>Circle c;</cpp>
   <java>Circle c = new Circle();</java>
   <keyword string="black">
    <cpp>c.SetColor(0x000000);</cpp>
    <java>c.setColor(0x000000);</java>
    <tag ref="draw-circle"/>
   </keyword>
   <keyword string="blue">
    <cpp>c.SetColor(0x00ff00);</cpp>
    <java>c.setColor(0x00ff00);</java>
    <tag ref="draw-circle"/>
   </keyword>
   <keyword string="red">
    <cpp>c.SetColor(0xff0000);</cpp>
    <java>c.setColor(0xff0000);</java>
    <tag ref="draw-circle"/>
   </keyword>
   <keyword string="green">
    <cpp>c.SetColor(0x0000ff);</cpp>
    <java>c.setColor(0x0000ff);</java>
    <tag ref="draw-circle"/>
   </keyword>
   <tag id="draw-circle" hollow="yes">
    <endl>
     <cpp>Draw(c);</cpp>
     <java>c.draw();</java>
    </endl>
   </tag>
  </keyword>
 </keyword>
</cli>

(1)


(2)




(2)




(2)




(2)





(3)

This example accepts the following command lines:

add circle black
add circle blue
add circle red
add circle green

Comment line patterns are defined through comment elements directly within the cli root node.

This example defines three comment line patterns: lines starting with '#', '//' or '--' will be interpreted as comment lines.

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="Comments">
 <!-- Comment line patterns -->
 <comment start="#"/>
 <comment start="//"/>
 <comment start="--"/>
 <!-- Regular command lines -->
 <keyword string="hello"><help lang="en">Say hello to somebody</help>
  <param type="string" id="who"><help lang="en">Somebody's name</help>
   <endl></endl>
  </param>
 </keyword>
</cli>

In as much as these patterns are applicable to all the menus and sub-menus of the CLI, they are reminded to the user in the beginning of the help message of any menu:

Comments>help
  Start with '#', '//' or '--' for a comment line
  cls             Clean screen
  exit            Exit menu 'Comments'
  hello           Say hello to somebody
  help            Get help
  pwm             Print Working Menu
  quit            Quit
Comments>

$ xmllint --schema ${CLI_DIR}/tools/cli.xsd --noout my-cli.xml
my-cli.xml validates

$ xmllint --relaxng ${CLI_DIR}/tools/cli.rng --noout --noout my-cli.xml
my-cli.xml validates

python ${CLI_DIR}/tools/cli2help.py clisample.xml --output clisample.html

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="UI">
 <cpp option="include">#include "cli/ui_line.h"</cpp>
 <keyword string="enter">
  <keyword string="line">
   <endl>
    <!-- Note: blocking execution integration only! -->
    <!-- C++ implementation -->
    <cpp><out/> << "Enter line: ";</cpp>
    <cpp>cli::ui::Line ui_Line(GetShell(), cli::tk::String(10, ""), 0, 1024);</cpp>
    <cpp>ui_Line.Run();</cpp>
    <cpp><out/> << "User entered '" << ui_Line.GetLine() << "'" << cli::endl;</cpp>
    <!-- Java implementation -->
    <java><out/>.put("Enter line: ");</java>
    <java>cli.ui.Line ui_Line = new cli.ui.Line(getShell(), "", 0, 1024);</java>
    <java>ui_Line.run();</java>
    <java><out/>.put("User entered '" + ui_Line.getLine() + "'").endl();</java>
   </endl>
  </keyword>
 </keyword>
</cli>

UI>enter line
Enter line: Hello world
User entered 'Hello world'
UI>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="UI">
 <cpp option="include">#include "cli/ui_password.h"</cpp>
 <keyword string="enter">
  <keyword string="password">
   <endl>
    <!-- Note: blocking execution integration only! -->
    <!-- C++ implementation -->
    <cpp><out/> << "Enter password: ";</cpp>
    <cpp>cli::ui::Password ui_Password(GetShell(), true, 0, 1024);</cpp>
    <cpp>ui_Password.Run();</cpp>
    <cpp><out/> << "User entered '" << ui_Password.GetPassword() << "'" << cli::endl;</cpp>
    <!-- Java implementation -->
    <java><out/>.put("Enter password: ");</java>
    <java>cli.ui.Password ui_Password = new cli.ui.Password(getShell(), true, 0, 1024);</java>
    <java>ui_Password.run();</java>
    <java><out/>.put("User entered '" + ui_Password.getPassword() + "'").endl();</java>
   </endl>
  </keyword>
 </keyword>
</cli>

UI>enter password
Enter password: *****
User entered 'hello'
UI>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="UI">
 <cpp option="include">#include "cli/ui_int.h"</cpp>
 <keyword string="enter">
  <keyword string="int">
   <endl>
    <!-- Note: blocking execution integration only! -->
    <!-- C++ implementation -->
    <cpp><out/> << "Enter integer number: ";</cpp>
    <cpp>cli::ui::Int ui_Int(GetShell(), 0, -1000, 1000);</cpp>
    <cpp>ui_Int.Run();</cpp>
    <cpp><out/> << "User entered " << ui_Int.GetInt() << cli::endl;</cpp>
    <!-- Java implementation -->
    <java><out/>.put("Enter integer number: ");</java>
    <java>cli.ui.Int ui_Int = new cli.ui.Int(getShell(), 0, -1000, 1000);</java>
    <java>ui_Int.run();</java>
    <java><out/>.put("User entered " + ui_Int.getInt()).endl();</java>
   </endl>
  </keyword>
 </keyword>
</cli>

UI>enter int
Enter integer number: 107
User entered 107
UI>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="UI">
 <cpp option="include">#include "cli/ui_float.h"</cpp>
 <keyword string="enter">
  <keyword string="float">
   <endl>
    <!-- Note: blocking execution integration only! -->
    <!-- C++ implementation -->
    <cpp><out/> << "Enter floating point number: ";</cpp>
    <cpp>cli::ui::Float ui_Float(GetShell(), 0, - 1000.0, 1000.0);</cpp>
    <cpp>ui_Float.Run();</cpp>
    <cpp><out/> << "User entered " << ui_Float.GetFloat() << cli::endl;</cpp>
    <!-- Java implementation -->
    <java><out/>.put("Enter floating point number: ");</java>
    <java>cli.ui.Float ui_Float = new cli.ui.Float(getShell(), 0, -1000.0, 1000.0);</java>
    <java>ui_Float.run();</java>
    <java><out/>.put("User entered " + ui_Float.getFloat()).endl();</java>
   </endl>
  </keyword>
 </keyword>
</cli>

UI>enter float
Enter floating point number: -3.14
User entered -3.14
UI>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="UI">
 <cpp option="include">#include "cli/ui_yesno.h"</cpp>
 <keyword string="enter">
  <keyword string="yesno">
   <endl>
    <!-- Note: blocking execution integration only! -->
    <!-- C++ implementation -->
    <cpp><out/> << "Please select [YES/no]: ";</cpp>
    <cpp>cli::ui::YesNo ui_YesNo(GetShell(), true);</cpp>
    <cpp>ui_YesNo.Run();</cpp>
    <cpp><out/> << "User entered " << (ui_YesNo.GetYesNo() ? "true" : "false") << "/'" << ui_YesNo.GetstrChoice().GetString(GetShell().GetLang()) << "'" << cli::endl;</cpp>
    <!-- Java implementation -->
    <java><out/>.put("Please select [YES/no]: ");</java>
    <java>cli.ui.YesNo ui_YesNo = new cli.ui.YesNo(getShell(), true);</java>
    <java>ui_YesNo.run();</java>
    <java><out/>.put("User entered " + ui_YesNo.getYesNo() + "/'" + ui_YesNo.getstrChoice().getString(getShell().getLang()) + "'").endl();</java>
   </endl>
  </keyword>
 </keyword>
</cli>

UI>enter yesno
Please select [YES/no]: No
User entered false/'No'
UI>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="UI">
 <cpp option="include">#include "cli/ui_choice.h"</cpp>
 <cpp option="include">#include "cli/string_device.h"</cpp>
 <keyword string="enter">
  <keyword string="choice">
   <param type="int" id="count">
    <endl>
     <!-- Note: blocking execution integration only! -->
     <!-- C++ implementation -->
     <cpp><out/> << "Select choice: ";</cpp>
     <cpp>cli::tk::Queue<cli::ResourceString> tk_Choices(<value-of param="count"/>);</cpp>
     <cpp>for (int i=0; i<<value-of param="count"/>; i++) {</cpp>
     <cpp>    cli::StringDevice cli_Choice(1024, false); cli_Choice << "Choice#" << (i + 1);</cpp>
     <cpp>    tk_Choices.AddTail(cli::ResourceString().SetString(cli::ResourceString::LANG_EN, cli_Choice.GetString()));</cpp>
     <cpp>}</cpp>
     <cpp>cli::ui::Choice ui_Choice(GetShell(), 0, tk_Choices);</cpp>
     <cpp>ui_Choice.Run();</cpp>
     <cpp><out/> << "User entered " << ui_Choice.GetChoice() << "/'" << ui_Choice.GetstrChoice().GetString(GetShell().GetLang()) << "'" << cli::endl;</cpp>
     <!-- Java implementation -->
     <java><out/>.put("Select choice: ");</java>
     <java>java.util.Vector<cli.ResourceString> j_Choices = new java.util.Vector<cli.ResourceString>();</java>
     <java>for (int i=0; i<<value-of param="count"/>; i++) {</java>
     <java>    j_Choices.add(new cli.ResourceString().setString(cli.ResourceString.LANG_EN, "Choice#" + (i + 1)));</java>
     <java>}</java>
     <java>cli.ui.Choice ui_Choice = new cli.ui.Choice(getShell(), 0, j_Choices);</java>
     <java>ui_Choice.run();</java>
     <java><out/>.put("User entered " + ui_Choice.getChoice() + "/'" + ui_Choice.getstrChoice().getString(getShell().getLang()) + "'").endl();</java>
    </endl>
   </param>
  </keyword>
 </keyword>
</cli>

UI>enter choice 10
Select choice: Choice#6
User entered 5/'Choice#6'
UI>

static void FillText(const cli::OutputDevice& CLI_UI, const unsigned int UI_Count) {
    for (unsigned int i=1; (i<=UI_Count) && (i<1024); i++) {
        CLI_UI << i << ": ";
        for (unsigned int j=1; j<=i; j++) CLI_UI << "*";
        CLI_UI << cli::endl;
    }
}

public class UISampleText {
    public static void fillText(cli.OutputDevice.Interface CLI_UI, int I_Count) {
        for (int i=1; (i<=I_Count) && (i<1024); i++) {
            CLI_UI.put(i + ": ");
            for (int j=1; j<=i; j++) CLI_UI.put("*");
            CLI_UI.endl();
        }
    }
}

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="UI">
 <cpp option="include">#include "cli/ui_more.h"</cpp>
 <cpp option="include">#include "ui_sample_text.h"</cpp>
 <keyword string="more">
  <param type="int" id="count">
   <endl>
    <!-- C++ implementation -->
    <cpp>cli::ui::More ui_More(GetShell(), 1024, <value-of param="count"/>);</cpp>
    <cpp>FillText(ui_More.GetText(), <value-of param="count"/>);</cpp>
    <cpp>ui_More.Run();</cpp>
    <!-- Java implementation -->
    <java>cli.ui.More ui_More = new cli.ui.More(getShell());</java>
    <java>UISampleText.fillText(ui_More.getText(), <value-of param="count"/>);</java>
    <java>ui_More.run();</java>
   </endl>
  </param>
 </keyword>
</cli>

UI>more 100
1: *
2: **
3: ***
4: ****
5: *****
6: ******
7: *******
8: ********
9: *********
10: **********
11: ***********
12: ************
13: *************
14: **************
15: ***************
16: ****************
17: *****************
18: ******************
19: *******************
--- More ---

20: ********************
--- More ---

21: *********************
22: **********************
23: ***********************
24: ************************
25: *************************
26: **************************
27: ***************************
28: ****************************
29: *****************************
30: ******************************
31: *******************************
32: ********************************
33: *********************************
34: **********************************
35: ***********************************
36: ************************************
37: *************************************
38: **************************************
39: ***************************************
--- More ---

UI>

<?xml version="1.0" encoding="utf-8"?>
<cli xmlns="http://alexis.royer.free.fr/CLI" name="UI">
 <cpp option="include">#include "cli/ui_less.h"</cpp>
 <cpp option="include">#include "ui_sample_text.h"</cpp>
 <keyword string="less">
  <param type="int" id="count">
   <endl>
    <!-- C++ implementation -->
    <cpp>cli::ui::Less ui_Less(GetShell(), 80, <value-of param="count"/>);</cpp>
    <cpp>FillText(ui_Less.GetText(), <value-of param="count"/>);</cpp>
    <cpp>ui_Less.Run();</cpp>
    <!-- Java implementation -->
    <java>cli.ui.Less ui_Less = new cli.ui.Less(getShell());</java>
    <java>UISampleText.fillText(ui_Less.getText(), <value-of param="count"/>);</java>
    <java>ui_Less.run();</java>
   </endl>
  </param>
 </keyword>
</cli>

UI>less 100
1: *
2: **
3: ***
4: ****
5: *****
6: ******
7: *******
8: ********
9: *********
10: **********
11: ***********
12: ************
13: *************
14: **************
15: ***************
16: ****************
17: *****************
18: ******************
19: *******************
:

2: **
3: ***
4: ****
5: *****
6: ******
7: *******
8: ********
9: *********
10: **********
11: ***********
12: ************
13: *************
14: **************
15: ***************
16: ****************
17: *****************
18: ******************
19: *******************
20: ********************
:

UI>

First of all, inherit from TelnetServer. All you have to do is to override onNewConnection to allocate resources for new network connections, and onCloseConnection to free them when the thing is done.

class MyServer extends cli.TelnetServer {
    public MyServer() {
        // Up to 10 clients on port 9012.
        super(10, 9012, cli.ResourceString.LANG_EN);
    }
    protected cli.ExecutionContext.Interface onNewConnection(cli.TelnetConnection CLI_NewConnection) {
        // Create CLI and Shell instances for that new connection.
        cli.Cli cli_Cli = new MyCli();
        cli.Shell cli_Shell = new cli.Shell(cli_Cli);
        return cli_Shell;
    }
    protected void onCloseConnection(cli.TelnetConnection CLI_ConnectionClosed, cli.ExecutionContext.Interface CLI_Context) {
        // Free connection resources: the garbage collector does the thing for us in Java.
        // Note: CLI_Context corresponds to the cli.Shell instance we have created in onNewConnection().
    }
}

Eventually call startServer and that's it.

MyServer cli_Server = new MyServer();
cli_Server.startServer(); // Blocking call

Start your server, and connect to it thanks to teraterm for instance:

teraterm telnet settings

cli.Cli cli_Cli = new MyCli();
cli.Shell cli_Shell = new cli.Shell(cli_Cli);
MyNonBlockingIODevice cli_Device = new MyNonBlockingIODevice(); // extends cli.NonBlockingIODevice

// Since cli_Device is a non-blocking device, the following call does not block the execution thread.
cli_Shell.run(cli_Device);
// cli_Shell is still running at this point!

// Let's push characters...
cli_Device.onKey(cli.OutputDevice.KEY_q);
cli_Device.onKey(cli.OutputDevice.KEY_u);
cli_Device.onKey(cli.OutputDevice.KEY_i);
cli_Device.onKey(cli.OutputDevice.KEY_t);
cli_Device.onKey(cli.OutputDevice.ENTER);
// Since the 'quit' command has been pushed, cli_Shell is not running anymore at this point!

final MyNonBlockingIODevice cli_Device = new MyNonBlockingIODevice(); // extends cli.NonBlockingIODevice
final cli.ui.Line ui_Line = new cli.ui.Line(cli_Shell, "", 0, 1024);
cli_Device.put("Enter line: ");
ui_Line.watchResult(
    new cli.ExecutionResult() {
        // This method will be called when the control is done
        protected void onResult(cli.ExecutionContext.Interface CLI_Context) {
            cli_Device.put("End of execution: ").put(ui_Line.getLine()).endl();
        }
    }
);
ui_Line.run();
cli_Device.onKey(cli.OutputDevice.KEY_h);
cli_Device.onKey(cli.OutputDevice.KEY_e);
cli_Device.onKey(cli.OutputDevice.KEY_l);
cli_Device.onKey(cli.OutputDevice.KEY_l);
cli_Device.onKey(cli.OutputDevice.KEY_o);
cli_Device.onKey(cli.OutputDevice.ENTER);
// "End of execution: hello" printed out there