sigil-discourse

A Sigil library for the Discourse forum REST API.

Modules

Usage

Add sigil-discourse as a dependency in your package.sgl:

(from-git url: "codeberg:sigil/sigil-discourse" package: "sigil-discourse")

Then import the modules you need:

(import (discourse topics)
        (discourse users))

(define base-url "https://forum.example.com")
(define api-key (getenv "DISCOURSE_API_KEY"))
(define username (getenv "DISCOURSE_USERNAME"))

;; List latest topics
(discourse-list-latest-topics base-url api-key username)

;; Create a new topic
(discourse-create-topic base-url api-key username
                        "Hello World" "This is the body" 5)

;; Get a user
(discourse-get-user base-url api-key username "david")

Authentication

Discourse uses Api-Key and Api-Username headers. Every library function takes (base-url api-key username ...) as its first three parameters.

Building

sigil deps install
sigil build
sigil test

License

BSD-3-Clause