CHICKEN client library for the sr.ht REST API
Add key creation and deletion to CLI
Add missing dependency from cli program to meta module
Add meta endpoints to CLI program

refs

master
browse log
0.1.6
browse .tar.gz

clone

read-only
https://git.sr.ht/~evhan/topham
read/write
git@git.sr.ht:~evhan/topham

You can also use your local clone with git send-email.

Topham

CHICKEN Scheme client for sr.ht.

Resources

Installation

Use your distribution's package manager to install CHICKEN 5.0 or newer, then run:

chicken-install -s topham

On some platforms you may be required to install OpenSSL development headers first.

Examples

Using the Extension Library

Create a new job on builds.sr.ht and fetch information about it:

(import (topham)
        (topham builds))

(access-token "your-access-token-goes-here")

(create (job manifest: "xyz"))
; => ((#:service "builds" #:path "/api/jobs")
;     (id . 1234))

(retrieve (job 1234))
; => ((#:service "builds" #:path "/api/jobs/1234")
;     (id . 1234)
;     (status . "running")
;     (setup_log ...)
;     (tasks . #(...))
;     (runner ...))

(retrieve (manifest 1234))
; => "xyz"

Using the Command Line Interface

As above, but using the topham CLI program.

$ export SRHT_ACCESS_TOKEN="your-access-token-goes-here"

$ topham create job --manifest build.yaml --note "Example build"
((id . 1234))

$ topham get job 1234
((id . 1234)
 (status . "running")
 (setup_log ...)
 (tasks . #(...))
 (runner ...))

$ topham get job 1234 -o json | jq
{
  "id": 1234,
  "status": "running",
  "setup_log": ...,
  "tasks": [...],
  "note": "Example build",
  "runner": ...
}

License

Three-clause BSD. See LICENSE for details.