xenial (1) hconsole.1.gz

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 <oak at helsinkinet fi>.

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.