first version of scripting

Author: casperstorm

Cargo.lock

@@ -23,6 +23,7 @@
 - [Pronunciation](guides/pronunciation.md)
 - [Reduce Noise](guides/reduce-noise.md)
 - [Single Pane](guides/single-pane.md)
+- [Scripts](guides/scripts.md)
 - [Storing Passwords in a File](guides/password-file.md)
 - [Unix Signals](guides/unix-signals.md)
 - [Text Formatting](guides/text-formatting.md)
@@ -91,6 +92,7 @@
   - [SOCKS5](configuration/proxy/socks5.md)
   - [Tor](configuration/proxy/tor.md)
 - [Scale factor](configuration/scale-factor.md)
+- [Scripts](configuration/scripts/README.md)
 - [Servers](configuration/servers/README.md)
   - [Filters](configuration/servers/filters.md)
   - [SASL External](configuration/servers/sasl-external.md)

book/src/SUMMARY.md

@@ -42,6 +42,7 @@ Following notifications are available:
 | `monitored_online`      | Triggered when a user you're monitoring is online  | N/A                               |
 | `monitored_offline`     | Triggered when a user you're monitoring is offline | N/A                               |
 | `reconnected`           | Triggered when a server reconnects                 | N/A                               |
+| `scripts`               | Triggered by script callbacks via `ctx:notification` | Notification body               |
 
 `channel` is an array of tables, with each entry a notification for a single
 channel.  For example, the following shows a toast notification for every
@@ -52,6 +53,13 @@ message in `#halloy`:
 show_toast = true
 ```
 
+`scripts` is also an array of tables, with each entry keyed by script name:
+
+```toml
+[notifications.scripts."my_script"]
+show_toast = true
+```
+
 ## Built-in Sounds
 
 The following table shows all available built-in sounds

book/src/configuration/notifications/README.md

@@ -0,0 +1,24 @@
+# Scripts
+
+Script configuration options.
+
+For scripting help, see the [Scripts guide](../../guides/scripts.md).
+
+- [Scripts](#scripts)
+  - [Configuration](#configuration)
+    - [autorun](#autorun)
+
+## Configuration
+
+### autorun
+
+Specify the script filename(s) to load when Halloy starts.
+
+```toml
+# Type: array of strings
+# Values: exact script filenames
+# Default: []
+
+[scripts]
+autorun = ["hello.lua", "auto-op.lua"]
+```