hob 0.1

A multi-language code generator for the Opera Scope Protocol. Code is generated from Google Protocol Buffer definitions.

Introduction

Hob is a multi-language code generator for the Opera Scope Protocol. It generates code from Google Protocol Buffer files (.proto), which describes the services, messages, commands and events.

The Scope Protocol is an RPC system used in the Opera web browser. This allows external and embedded clients to debug, inspect or perform other operations on any running Opera instance.

Hob consists of the following components:

• The hob command line tool which is used to generate code and other output formats.

• A library for working with Google Protocol Buffer definitions. It can read .proto files and has classes and functions for working with protobuf elements.

• Support for third party extensions which can add additional commands.

Dependencies

argparse:

http://code.google.com/p/argparse/

mako:

http://www.makotemplates.org/

If you install hob using easy_install these dependencies will be installed automatically.

Usage

usage: hob [-h] [-v] [--verbose] [--quiet] [--config-file CONFIG_FILE] [-w
           [WARNING [WARNING ...]]]
           command ...

commands:
    xml                 Generate XML structures of protocol definitions
    proto               Generate Protocol Buffer definitions
    js                  Create service interfaces for JavaScript. If no files
                        are specified, the following files will be added in
                        the 'service' folder: console_logger.py,
                        http_logger.py, scope.py, window_manager.py,
                        ecmascript_debugger.py. Files can also be specified
                        with the service name, e.g. just ecmascript-debugger.
                        scope.py and window_manager.py will always be added.
    extensions          Lists all enabled extensions
    rst-doc             Create reST documentation of selected services. If no
                        files are specified all services are added.
    validate            Validates services, commands, events, messages and
                        fields according to the style guide
    dk-maps             Create maps for dragonkeeper to pretty print messages.
                        If no files are specified all services are added.

options:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  --verbose             increase verbosity
  --quiet               be silent
  --config-file CONFIG_FILE
                        use specific config file instead of system-wide/local
                        config files
  -w [WARNING [WARNING ...]], --warning [WARNING [WARNING ...]]
                        enable a warning flag, pick from all, field-id-gap,
                        field-id-sequence

Changelog

See the CHANGELOG file in the top distribution directory.

Contact

Hob is maintained by the Opera Dragonfly team. The authors are:

• Jan Borsodi <[e-mail]>

• Christian Krebs <[e-mail]>

Additional help from:

• Johannes Hoff <[e-mail]>

• Rune Halvorsen <[e-mail]>

• Anders Hartvoll Ruud <[e-mail]>

License

See the LICENSE file in the top distribution directory.