hconsole - Interactive Python console for using Hatari's remote API
hconsole.py [[consoleoptions]
[commandfile]
--]
[hatarioptions]
Hconsole is a Python script that invokes Hatari and then provides an
interactive shell (with full readline editing capabilities) for executing
Hatari remote API commands.
It can be useful for first exploring Hatari's remote API usage interactively and
then writing scripts that somehow automate your Hatari usage. They can invoke
hconsole functionality simply by doing "import hconsole" and calling
appropriate methods (see example.py coming with hconsole).
Normally hconsole forwards all of its arguments to Hatari instance it invoked.
If you want to give arguments for hconsole itself, you need to add '--'
argument after the hconsole arguments and before the arguments going to
Hatari.
If you give a file name as hconsole argument, commands in it will be read and
executed through Hatari's remote API before you get into hconsole interactive
shell.
Hconsole accepts following options:
- --exit
- Exit after starting Hatari and parsing arguments.
- --help, -h
- Show command line help.
Start Hatari with all of the given arguments:
hconsole.py --monitor mono -d test/
Start Hatari without extra arguments, execute commands from the given
commands.txt file, exit after the file ends:
hconsole.py commands.txt --exit --
By default hconsole and its examples are installed under the
/usr/share/hatari/hconsole/ directory.
hatari(1),
hatariui(1)
Written by Eero Tamminen <oak at helsinkinet fi>.
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more
details.