CHICKEN client library for the sr.ht REST API
Add CLI program
Document lists service procedures where user is implicit
Document lists library

refs

master
browse log
0.1.3
browse .tar.gz

clone

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

Topham

CHICKEN Scheme client for sr.ht.

Resources

Installation

chicken-install topham

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.