1HCONSOLE(1)                    Hatari utilities                    HCONSOLE(1)
2
3
4

NAME

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

SYNOPSIS

9       hconsole.py [[consoleoptions] [commandfile] --] [hatarioptions]
10

DESCRIPTION

12       Hconsole  is  a  Python script that invokes Hatari and then provides an
13       interactive shell (with full readline editing capabilities) for execut‐
14       ing Hatari remote API commands.
15
16       It can be useful for first exploring Hatari's remote API usage interac‐
17       tively and then writing  scripts  that  somehow  automate  your  Hatari
18       usage.   They can invoke hconsole functionality simply by doing "import
19       hconsole" and calling appropriate methods (see example.py  coming  with
20       hconsole).
21

USAGE

23       Normally  hconsole forwards  all of its arguments to Hatari instance it
24       invoked.  If you want to give arguments for hconsole itself,  you  need
25       to  add '--' argument after the hconsole arguments and before the argu‐
26       ments going to Hatari.
27
28       If you give a file name as hconsole argument, commands in  it  will  be
29       read and executed through Hatari's remote API before you get into hcon‐
30       sole interactive shell.
31
32       Hconsole accepts following options:
33
34       --exit Exit after starting Hatari and parsing arguments.
35
36       --help, -h
37              Show command line help.
38

EXAMPLES

40       Start Hatari with all of the given arguments:
41            hconsole.py --monitor mono -d test/
42
43       Start Hatari without extra arguments, execute commands from  the  given
44       commands.txt file, exit after the file ends:
45            hconsole.py commands.txt --exit --
46

FILES

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

SEE ALSO

52       hatari(1), hatariui(1)
53

AUTHOR

55       Written by Eero Tamminen <oak at helsinkinet fi>.
56

LICENSE

58       This program is free software; you can redistribute it and/or modify it
59       under  the  terms of the GNU General Public License as published by the
60       Free Software Foundation; either version 2 of the License, or (at  your
61       option) any later version.
62

NO WARRANTY

64       This  program  is  distributed  in the hope that it will be useful, but
65       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
66       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
67       Public License for more details.
68
69
70
71Hatari                            2010-10-10                       HCONSOLE(1)
Impressum