CLI integration

[riza]

A CLI framework features an interface for defining command specification, parsing, and executing a command.

Features

• Portable across desktop (windows, macosx, linux, etc) and mobile platforms (symbian, windows mobile, iphone, android, etc.)
• User may access the UI by telneting to the app, and be able to operate the app as if it's a desktop app

Enhancements to existing console UI

• Command (auto)completion, e.g. one can specify "makecall" or "make" or "m". The system will detect if a fraction of a word makes up unique command
• arguments completion, i.e. user may specify the arguments together with the command, or if not, he will be asked to provide them.
• command history (the use of up and down arrow)

Telnet interface

• will provide interface exactly the same as console interface on desktop
• may provide different logging level for each client

Command specification

The command specification includes:

• Definition in an xml file
• Command/argument name
• Command/argument id
• Argument data type (int, string, choice)
• Argument mandatory type (optional/mandatory)
• Text description (to show in help screen)
• Each command could contain argument list or other command
• Callback handler

XML example of a command specification:

<CMD name='vid' id='0' desc="">
       <CMD name='help' id='0' desc='' />
       <CMD name='enable' id='0' desc='' />
       <CMD name='disable' id='0' desc='' />
       <CMD name='call' id='0' desc='' >
                <CMD name='add' id='101' desc='...' />
                <CMD name='cap' id='102' desc='...' >
                   <ARG name='streamno' type='int' desc='...' id='1'/>
                   <ARG name='devid' type='int' optional='1' id='2'/>
                </CMD>
       </CMD>
</CMD>
<CMD name='disable_codec' id=0 desc="">
	<ARG name='codec_list' type='choice' id='3'>
	    <CHOICE value='g711'/>
	    <CHOICE value='g722'/>
	</ARG>
</CMD>

[riza]

In 4440:

Re #1643: add initial support for CLI

[bennylp]

In 4459:

More re #1643: changed svn file type property to native

[riza]

In 4461:

Re #1643: Code restructure+add callback to support symbian gui app

[riza]

In 4476:

Re #1643: Code restructure + modification to handle non blocking mode

[riza]

In 4489:

Re #1643: Modification to avoid namespace conflict with pjsua

[riza]

In 4513:

Re #1643: - Modification to shortcut handling(execution&display).

• Add exact match check to the parse input command process.

[riza]

In 4522:

Re #1643:

• Fix duplicate shortcut for video commands
• Fix restart command bug on legacy mode
• Fix restart bug when using add-buddy options

[riza]

In 4525:

Re #1643: Restore configuration reset with added modification on app destroy. It was deleted from code to enable cli retain config values when restarted

[riza]

In 4589:

Re #1643: Fix crash due to insufficient command buffer size in get_cmd_name()

[riza]

In 4634:

Re #1643: Fix some build warnings detected on VS2012

[ming]

In 4752:

Re #1643: Fixed accidental removal of pj_run_app() call