9.3. Development

The hsh program allows for a convenient building and testing environment when developing functions for the Halon scripting language. The hsh program will call the following plugin functions.

Halon_version()

Halon_hsl_register()

Halon_init()

Halon_cleanup()

Other function such as delivery functions has to be built and tested using external testing frameworks or by using smtpd in a testing environment.

We recommend to use any of the examples in our GitHub repository as the boilerplate to get started quickly.

9.3.1. hsh

The hsh program will load all plugins in the --config file specified, and the plugins app configuration from the plugins section in the --appconf file specified (optional).

9.3.1.1. hsh.yaml

version: "5.6"
plugins:
  - id: myplugin
    path: myplugin.so
    config:
     setting1: true

9.3.1.2. hsh-app.yaml

version: "5.6"
plugins:
  - id: myplugin
    config:
     setting2: true

Run the hsh program with the --plugin flag for each plugin to load.

hsh --config hsh.yaml --appconf hsh-app.yaml --plugin myplugin test.hsl