Application initializes the qi framework, it extract –qi-* commandline arguments and initialise various options accordingly. It also provides facilities to connect the main session. This ease the creation of console applications that connects to a session or want to be standalone.
You can pass the following arguments to your application to control the session:
- –qi-url : address of the session to connect to
- –qi-listen-url : address on which the session will listen
- –qi-standalone : make a standalone session (use –qi-listen-url to set the listen url)
If raw is specified there wont be a session embedded into the application and you are free to create and connect a session yourself if needed.
if autoExit is set to True, a session disconnection will quit the program. Set autoExit to False to inhibit this behavior. By default autoExit is True.
Application will parse your arguments and catch –qi-* arguments.
For a normal application you have to call start to let the Session embedded into the application connect. If you want to handle –help yourself you can do that before the application starts avoiding a useless connection to the session.
__init__(args=None, autoExit=True, url=None, raw=False)¶
- args – the list of arguments (if None sys.argv is used)
- autoExit – By default the Application quit on session disconnection, set to False to avoid this behavior (default to True)
- url – The default value to use for qi-url (default to tcp://127.0.0.1:9559)
- raw – If set to True this does not include a Session into the Application. (advanced user only)
initialise the Application
start the Application. Once start is called, your Application is fully working. The session is connected and available.
stop the Application. (unblock an application previously launched with run)
block until stop is called. This calls start if it was not already called.
return the current session.
Url given to the session to connect to.
Deprecated since version 2.0.1.
Use qi.Application instead.
Simple example that lists all ALMemory keys:
import qi import sys from pprint import pprint if __name__ == "__main__": app = qi.Application(sys.argv) # start the eventloop app.start() almemory = app.session.service("ALMemory") pprint(almemory.getDataListName()) #no app.run() needed because we want to exit once getDataListName returns
If you put the content of this script in a listmemory.py file, then you can:
#connect to tcp://127.0.0.1:9559 $ python monscript.py #connect to tcp://192.168.0.42:9559 $ python monscript.py --qi-url=tcp://192.168.0.42:9559
Simple example that exports a service:
import qi import sys class Foo: def bar(self): print("bar") if __name__ == "__main__": app = qi.Application(sys.argv) # start the session app.start() app.session.registerService("foo", Foo()) app.run() # will exit when the connection is over
If you put the content of this script in a foo.py file, then you can:
#connect to tcp://127.0.0.1:9559 $ python foo.py #connect to tcp://192.168.0.42:9559 $ python foo.py --qi-url=tcp://192.168.0.42:9559 #run a standalone session $ python foo.py --qi-standalone #run a standalone session on tcp://0.0.0.0:10000 $ python foo.py --qi-standalone --qi-listen-url="tcp://0.0.0.0:10000" #let's use qicli to introspect the service $ qicli info foo --qi-url=tcp://127.0.0.1:10000