The cl-etcd Reference Manual

This is the cl-etcd Reference Manual, version 1, generated automatically by Declt version 4.0 beta 2 "William Riker" on Mon Feb 26 15:10:30 2024 GMT+0.

Table of Contents


1 Introduction


2 Systems

The main system appears first, followed by any subsystem dependency.


2.1 cl-etcd

Run etcd as an asynchronous inferior process.

Author

Anthony Green <>

License

AGPL3

Version

1

Dependencies
  • alexandria (system).
  • async-process (system).
  • bordeaux-threads (system).
  • cl-base64 (system).
  • cl-json (system).
  • cl-ppcre (system).
  • str (system).
  • drakma (system).
  • flexi-streams (system).
  • split-sequence (system).
Source

cl-etcd.asd.

Child Components

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.


3.1 Lisp


3.1.1 cl-etcd/cl-etcd.asd

Source

cl-etcd.asd.

Parent Component

cl-etcd (system).

ASDF Systems

cl-etcd.


3.1.2 cl-etcd/package.lisp

Source

cl-etcd.asd.

Parent Component

cl-etcd (system).

Packages

cl-etcd.


3.1.3 cl-etcd/etcd.lisp

Dependency

package.lisp (file).

Source

cl-etcd.asd.

Parent Component

cl-etcd (system).

Public Interface
Internals

4 Packages

Packages are listed by definition order.


4.1 cl-etcd

Source

package.lisp.

Use List

common-lisp.

Public Interface
Internals

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


5.1 Public Interface


5.1.1 Macros

Macro: with-etcd ((etcd config &key on-leader on-follower) &body body)

Create an etcd subprocess, ETCD. CONFIG is a hashtable of etcd config options: name, initial-advertise-peer-urls, listen-peer-urls, listen-client-urls, advertise-client-urls, initial-cluster, initial-cluster-state, initial-cluster-token. Otherwise, CONFIG is nil and we are creating a non-clustered etcd instance.

Package

cl-etcd.

Source

etcd.lisp.


5.1.2 Ordinary functions

Function: delete-dir-etcd (dir etcd &key error-on-missing)

Delete the directory DIR recursively from ETCD.

Package

cl-etcd.

Source

etcd.lisp.

Function: delete-etcd (key etcd &key error-on-missing)

Delete the KEY from ETCD.

Package

cl-etcd.

Source

etcd.lisp.

Function: get-etcd (key etcd)

Get the value of KEY from ETCD. Returns NIL if KEY not found. Throws an error on unexpected errors.

Package

cl-etcd.

Source

etcd.lisp.

Function: (setf get-etcd) (key etcd)

Put the KEY/VALUE pair into ETCD.

Package

cl-etcd.

Source

etcd.lisp.

Function: watch-etcd (etcd key)

Like GET-ETCD, but waits until value changes.

Package

cl-etcd.

Source

etcd.lisp.


5.1.3 Generic functions

Generic Reader: id (object)
Package

cl-etcd.

Methods
Reader Method: id ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

id.


5.1.4 Standalone methods

Method: initialize-instance :after ((etcd etcd) &key)
Source

etcd.lisp.


5.1.5 Classes

Class: etcd
Package

cl-etcd.

Source

etcd.lisp.

Direct methods
Direct slots
Slot: config
Initargs

:config

Readers

config.

Writers

This slot is read-only.

Slot: process
Readers

process.

Writers

This slot is read-only.

Slot: get-put-uri
Readers

get-put-uri.

Writers

This slot is read-only.

Slot: id
Readers

id.

Writers

This slot is read-only.

Slot: on-leader
Initargs

:on-leader

Readers

on-leader.

Writers

This slot is read-only.

Slot: on-follower
Initargs

:on-follower

Readers

on-follower.

Writers

This slot is read-only.

Slot: ready
Readers

ready.

Writers

This slot is read-only.

Slot: version
Readers

version.

Writers

This slot is read-only.

Slot: start-semaphore
Initform

(bordeaux-threads:make-semaphore)

Readers

start-semaphore.

Writers

This slot is read-only.

Slot: role
Readers

role.

Writers

This slot is read-only.


5.2 Internals


5.2.1 Special variables

Special Variable: +became-regex+
Package

cl-etcd.

Source

etcd.lisp.

Special Variable: +etcd-member-id-regex+
Package

cl-etcd.

Source

etcd.lisp.


5.2.2 Ordinary functions

Function: %get-etcd (key etcd wait)

Get the value of KEY from ETCD, but wait for a change first if WAIT. Returns NIL if KEY not found. Throws an error on unexpected errors.

Package

cl-etcd.

Source

etcd.lisp.

Function: delete-process (process)
Package

cl-etcd.

Source

etcd.lisp.

Function: get-process-output-string (process)
Package

cl-etcd.

Source

etcd.lisp.

Function: monitor-etcd-output (etcd s)
Package

cl-etcd.

Source

etcd.lisp.

Function: process-send-input (process string)
Package

cl-etcd.

Source

etcd.lisp.

Function: run-process (command &key name output-callback output-callback-type directory)
Package

cl-etcd.

Source

etcd.lisp.

Function: write-to-buffer (process string)
Package

cl-etcd.

Source

etcd.lisp.


5.2.3 Generic functions

Generic Reader: config (object)
Package

cl-etcd.

Methods
Reader Method: config ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

config.

Generic Reader: get-put-uri (object)
Package

cl-etcd.

Methods
Reader Method: get-put-uri ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

get-put-uri.

Generic Reader: on-follower (object)
Package

cl-etcd.

Methods
Reader Method: on-follower ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

on-follower.

Generic Reader: on-leader (object)
Package

cl-etcd.

Methods
Reader Method: on-leader ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

on-leader.

Generic Reader: process (object)
Package

cl-etcd.

Methods
Reader Method: process ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

process.

Generic Reader: process-buffer-stream (object)
Package

cl-etcd.

Methods
Reader Method: process-buffer-stream ((process process))

automatically generated reader method

Source

etcd.lisp.

Target Slot

buffer-stream.

Generic Reader: process-command (object)
Package

cl-etcd.

Methods
Reader Method: process-command ((process process))

automatically generated reader method

Source

etcd.lisp.

Target Slot

command.

Generic Reader: process-name (object)
Package

cl-etcd.

Methods
Reader Method: process-name ((process process))

automatically generated reader method

Source

etcd.lisp.

Target Slot

name.

Generic Reader: process-output-callback (object)
Package

cl-etcd.

Methods
Reader Method: process-output-callback ((process process))

automatically generated reader method

Source

etcd.lisp.

Target Slot

output-callback.

Generic Reader: process-output-callback-type (object)
Package

cl-etcd.

Methods
Reader Method: process-output-callback-type ((process process))

automatically generated reader method

Source

etcd.lisp.

Target Slot

callback-type.

Generic Reader: process-pointer (object)
Package

cl-etcd.

Methods
Reader Method: process-pointer ((process process))

automatically generated reader method

Source

etcd.lisp.

Target Slot

pointer.

Generic Reader: process-read-thread (object)
Package

cl-etcd.

Methods
Reader Method: process-read-thread ((process process))

automatically generated reader method

Source

etcd.lisp.

Target Slot

read-thread.

Generic Reader: ready (object)
Package

cl-etcd.

Methods
Reader Method: ready ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

ready.

Generic Reader: role (object)
Package

cl-etcd.

Methods
Reader Method: role ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

role.

Generic Writer: set-process-read-thread (new-value object)
Package

cl-etcd.

Methods
Writer Method: set-process-read-thread ((new-value process) process)

automatically generated writer method

Source

etcd.lisp.

Target Slot

read-thread.

Generic Reader: start-semaphore (object)
Package

cl-etcd.

Methods
Reader Method: start-semaphore ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

start-semaphore.

Generic Reader: version (object)
Package

cl-etcd.

Methods
Reader Method: version ((etcd etcd))

automatically generated reader method

Source

etcd.lisp.

Target Slot

version.


5.2.4 Classes

Class: process
Package

cl-etcd.

Source

etcd.lisp.

Direct methods
Direct slots
Slot: pointer
Initargs

:pointer

Readers

process-pointer.

Writers

This slot is read-only.

Slot: name
Initargs

:name

Readers

process-name.

Writers

This slot is read-only.

Slot: command
Initargs

:command

Readers

process-command.

Writers

This slot is read-only.

Slot: buffer-stream
Initargs

:buffer-stream

Readers

process-buffer-stream.

Writers

This slot is read-only.

Slot: read-thread
Initargs

:read-thread

Readers

process-read-thread.

Writers

set-process-read-thread.

Slot: output-callback
Initargs

:output-callback

Readers

process-output-callback.

Writers

This slot is read-only.

Slot: callback-type
Initargs

:output-callback-type

Readers

process-output-callback-type.

Writers

This slot is read-only.


Appendix A Indexes


A.1 Concepts


A.2 Functions

Jump to:   %   (  
C   D   F   G   I   M   O   P   R   S   V   W  
Index Entry  Section

%
%get-etcd: Private ordinary functions

(
(setf get-etcd): Public ordinary functions

C
config: Private generic functions
config: Private generic functions

D
delete-dir-etcd: Public ordinary functions
delete-etcd: Public ordinary functions
delete-process: Private ordinary functions

F
Function, %get-etcd: Private ordinary functions
Function, (setf get-etcd): Public ordinary functions
Function, delete-dir-etcd: Public ordinary functions
Function, delete-etcd: Public ordinary functions
Function, delete-process: Private ordinary functions
Function, get-etcd: Public ordinary functions
Function, get-process-output-string: Private ordinary functions
Function, monitor-etcd-output: Private ordinary functions
Function, process-send-input: Private ordinary functions
Function, run-process: Private ordinary functions
Function, watch-etcd: Public ordinary functions
Function, write-to-buffer: Private ordinary functions

G
Generic Function, config: Private generic functions
Generic Function, get-put-uri: Private generic functions
Generic Function, id: Public generic functions
Generic Function, on-follower: Private generic functions
Generic Function, on-leader: Private generic functions
Generic Function, process: Private generic functions
Generic Function, process-buffer-stream: Private generic functions
Generic Function, process-command: Private generic functions
Generic Function, process-name: Private generic functions
Generic Function, process-output-callback: Private generic functions
Generic Function, process-output-callback-type: Private generic functions
Generic Function, process-pointer: Private generic functions
Generic Function, process-read-thread: Private generic functions
Generic Function, ready: Private generic functions
Generic Function, role: Private generic functions
Generic Function, set-process-read-thread: Private generic functions
Generic Function, start-semaphore: Private generic functions
Generic Function, version: Private generic functions
get-etcd: Public ordinary functions
get-process-output-string: Private ordinary functions
get-put-uri: Private generic functions
get-put-uri: Private generic functions

I
id: Public generic functions
id: Public generic functions
initialize-instance: Public standalone methods

M
Macro, with-etcd: Public macros
Method, config: Private generic functions
Method, get-put-uri: Private generic functions
Method, id: Public generic functions
Method, initialize-instance: Public standalone methods
Method, on-follower: Private generic functions
Method, on-leader: Private generic functions
Method, process: Private generic functions
Method, process-buffer-stream: Private generic functions
Method, process-command: Private generic functions
Method, process-name: Private generic functions
Method, process-output-callback: Private generic functions
Method, process-output-callback-type: Private generic functions
Method, process-pointer: Private generic functions
Method, process-read-thread: Private generic functions
Method, ready: Private generic functions
Method, role: Private generic functions
Method, set-process-read-thread: Private generic functions
Method, start-semaphore: Private generic functions
Method, version: Private generic functions
monitor-etcd-output: Private ordinary functions

O
on-follower: Private generic functions
on-follower: Private generic functions
on-leader: Private generic functions
on-leader: Private generic functions

P
process: Private generic functions
process: Private generic functions
process-buffer-stream: Private generic functions
process-buffer-stream: Private generic functions
process-command: Private generic functions
process-command: Private generic functions
process-name: Private generic functions
process-name: Private generic functions
process-output-callback: Private generic functions
process-output-callback: Private generic functions
process-output-callback-type: Private generic functions
process-output-callback-type: Private generic functions
process-pointer: Private generic functions
process-pointer: Private generic functions
process-read-thread: Private generic functions
process-read-thread: Private generic functions
process-send-input: Private ordinary functions

R
ready: Private generic functions
ready: Private generic functions
role: Private generic functions
role: Private generic functions
run-process: Private ordinary functions

S
set-process-read-thread: Private generic functions
set-process-read-thread: Private generic functions
start-semaphore: Private generic functions
start-semaphore: Private generic functions

V
version: Private generic functions
version: Private generic functions

W
watch-etcd: Public ordinary functions
with-etcd: Public macros
write-to-buffer: Private ordinary functions


A.3 Variables