README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

# desmoctl

[![desmoctl](https://github.com/jantuomi/desmoctl/actions/workflows/desmoctl.yml/badge.svg)](https://github.com/jantuomi/desmoctl/actions/workflows/desmoctl.yml)

A tool for controlling a desmofylakas cluster written in Chicken Scheme.

## Installation

Install [Chicken Scheme](https://wiki.call-cc.org/platforms).

You also need to have these tools or libraries:

    tar
    make
	openssl (with dev headers)
	pkg-config
	
Note: on some systems you need to set `PKG_CONFIG_PATH` to a path that contains `openssl.pc`. On MacOS w/ Homebrew this would be:

    export PKG_CONFIG_PATH="$(brew --prefix openssl)/lib/pkgconfig"

Install dependencies, build and install to your preferred location:

    make deps
	make test    # optionally run tests
    make dynamic # or make static
    PREFIX=$HOME/.local/bin/ make install

## Usage

See `desmoctl help`.

## Development

Run the tool in the interpreter:

    csi -s run.scm  # run CLI
	csi -s test.scm # run unit tests
	
In my workflow, loading `desmoctl.scm` to a long-lived REPL is pretty convenient.

## Copyright

© Desmofylakas Core Team 2024