opd 202

NAME

OPD - Original Programmer Daemon

SYNOPSIS

opd
opd <cmd> [key=val] [key==val]
opd [-a] [-c] [-v]

DESCRIPTION

OPD is a python3 library implementing the 'opd' package. It
provides all the tools to program a bot, such as disk perisistence
for configuration files, event handler to handle the client/server
connection, code to introspect modules for commands, deferred
exception handling to not crash on an error, a parser to parse
commandline options and values, etc.

OPD provides a demo bot, it can connect to IRC, fetch and
display RSS feeds, take todo notes, keep a shopping list
and log text. You can also copy/paste the service file and run
it under systemd for 24/7 presence in a IRC channel.

OPD is Public Domain.

INSTALL

$ pipx install opd
$ pipx ensurepath

USAGE

without any argument the program starts itself as a daemon

$ opd
$

if there is already a daemon running the program won't start

$ bin/opd
daemon is already running.

provding a command it will run it in the cli

$ opd cmd
cmd,err,mod,req,thr,ver
$

the -c option starts a console

$ opd -c
>

the -v option turns on verbose

$ opd -cv
OPD CV started Sat Feb 10 13:50:56 2024
>

use mod= to load additional modules

$ opd mod=irc,rss
$

the ``mod`` command shows a list of modules

$ opd mod
cmd,err,fnd,irc,log,mod,req,rss,tdo,thr
$

the -a option will load all available modules

CONFIGURATION

irc

$ opd cfg server=<server>
$ opd cfg channel=<channel>
$ opd cfg nick=<nick>

sasl

$ opd pwd <nsvnick> <nspass>
$ opd cfg password=<frompwd>

rss

$ opd rss <url>
$ opd dpl <url> <item1,item2>
$ opd rem <url>
$ opd nme <url> <name>

COMMANDS

cmd - commands
cfg - irc configuration
dlt - remove a user
dpl - sets display items
fnd - find objects
log - log some text
met - add a user
mre - displays cached output
pwd - sasl nickserv name/pass
rem - removes a rss feed
req - reconsider
rss - add a feed
thr - show the running threads

SYSTEMD

save the following in /etc/systemd/system/opd.service and
replace "<user>" with the user running pipx

[Unit]
Description=Original Programmer Daemon
Requires=network.target
After=network.target

[Service]
Type=simple
User=<user>
Group=<user>
WorkingDirectory=/home/<user>/.opd
ExecStart=/home/<user>/.local/pipx/venvs/opd/bin/opd
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

then run this

$ mkdir ~/.opd
$ sudo systemctl enable opd --now

default channel/server is #opd on localhost

FILES

~/.opd
~/.local/bin/opd
~/.local/pipx/venvs/opd/
~/.local/pipx/venvs/opd/share/doc/opd/README.rst

AUTHOR

Bart Thate <bthate@dds.nl>

COPYRIGHT

OPD is Public Domain.