This repository has been archived by the owner on Jul 8, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
81 lines (49 loc) · 2.15 KB
/
INSTALL
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
INSTALL
=======
I haven't had time to "bundle" or "package" stuff. For now just copy files into the right places
manually - it's simple enough at present. The files are:
CONFIG:
iam_config.l.dist:
Template for the config-file used by the server, client and chatbot.
Eventually the server will source both /etc/iam_config.l and one of [config-from-runtime-arg]
or [pwd]/iam_config.l, but for now it just uses /etc/iam_config.l
The interactive client & chatbot attempt to source /etc/iam_config.l, then ~/iam_config.l,
then one of [config-from-runtime-arg] or [pwd]/iam_config.l
Copy the template to one of those locations, then edit and chown/chmod to protect passwords
(but with enough perms to be readable by the client/bot/server).
SERVER:
iamd.l:
The server. Better run from an init-script (I'll get around to writing one soon), otherwise:
(setsid ./iamd.l </dev/null >/dev/null 2>&1 &)
Requires: picolisp
CLIENTS:
iamc.py:
The main interactive client.
Requires: python
Imports: sys, socket, re, subprocess, termios
iam.sh:
Minimal commandline posix-shell-client to just post statuses. Self-contained, doesn't require
anything, doesn't source configs (so you must edit the script for custom settings). Can be
useful to also include a symlink "iam" in the PATH, pointing to this (typing ".sh" gets
annoying after a while)
Requires: posix-shell
BOT:
iambot.py:
Chatbot (Jabber only for now) for relaying status-instructions from a chatroom to the
status-server, or for requesting status-server output to the chatroom. Can be run from anywhere
you are able to login to the chat server.
Requires: python
Imports: sys, socket, xmpp, jabberbot
LIBS:
iam_common.py:
Common python function libs. Must be in same directory as iamc.py/iambot.py or in the python-path.
Requires: python
Imports: sys, os
iam_sexp.py
Hyper-minimal python s-expression lib (just enough for reading the config-format). Must be in same
directory as iamc.py/iambot.py or in the python-path.
Requires: python
Imports: re, itertools
MISC:
cron.d_iamd-rotate:
Example system-crontab for rotating status-logs at midnight every Sunday