HCONSOLE(1)

NAME
hconsole - Interactive Python console for using Hatari's remote API

SYNOPSIS
hconsole.py [[consoleoptions] [commandfile] --] [hatarioptions]

DESCRIPTION
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).

USAGE
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.

EXAMPLES
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 --

FILES
By default hconsole and its examples are installed under the /usr/share/hatari/hconsole/ directory.

SEE ALSO
hatari(1), hatariui(1)

AUTHOR
Written by Eero Tamminen <eerot@users.berlios.de>.

LICENSE
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.

NO WARRANTY
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.