nixbot 172

NIXBOT

NAME

nixbot - NIXBOT

SYNOPSIS

nixbot <cmd> [key=val] [key==val]

nixbot -cvaw [init=mod1,mod2]

nixbot -d

nixbot -s

DESCRIPTION

NIXT has all you need to program a unix cli program, such as disk perisistence for configuration files, event handler to handle the client/server connection, deferred exception handling to not crash on an error, etc.

NIXT contains python3 code to program objects in a functional way. it provides an “clean namespace” Object class that only has dunder methods, so the namespace is not cluttered with method names. This makes storing and reading to/from json possible.

NIXBOT is a python3 IRC bot, it can connect to IRC, fetch and display RSS feeds, take todo notes, keep a shopping list and log text. You can run it under systemd for 24/7 presence in a IRC channel.

NIXBOT is Public Domain.

INSTALL

installation is done with pipx

$ pipx install nixbot

$ pipx ensurepath

<new terminal>

$ nixbot srv > nixbot.service

$ sudo mv nixbot.service /etc/systemd/system/

$ sudo systemctl enable nixbot --now

joins #nixbot on localhost

USAGE

use nixbot to control the program, default it does nothing

$ nixbot

$

see list of commands

$ nixbot cmd

cfg,cmd,dne,dpl,err,exp,imp,log,mod,mre,nme,

pwd,rem,req,res,rss,srv,syn,tdo,thr,upt

start console

$ nixbot -c

start console and run irc and rss clients

$ nixbot -c init=irc,rss

list available modules

$ nixbot mod

err,flt,fnd,irc,llm,log,mbx,mdl,mod,req,rss,

rst,slg,tdo,thr,tmr,udp,upt

start daemon

$ nixbot -d

$

start service

$ nixbot -s

<runs until ctrl-c>

COMMANDS

here is a list of available commands

cfg - irc configuration

cmd - commands

dpl - sets display items

err - show errors

exp - export opml (stdout)

imp - import opml

log - log text

mre - display cached output

pwd - sasl nickserv name/pass

rem - removes a rss feed

res - restore deleted feeds

req - reconsider

rss - add a feed

syn - sync rss feeds

tdo - add todo item

thr - show running threads

upt - show uptime

CONFIGURATION

irc

$ nixbot cfg server=<server>

$ nixbot cfg channel=<channel>

$ nixbot cfg nick=<nick>

sasl

$ nixbot pwd <nsnick> <nspass>

$ nixbot cfg password=<frompwd>

rss

$ nixbot rss <url>

$ nixbot dpl <url> <item1,item2>

$ nixbot rem <url>

$ nixbot nme <url> <name>

opml

$ nixbot exp

$ nixbot imp <filename>

PROGRAMMING

nixbot has it’s modules in the package, so edit a file in nixbot/modules/<name>.py and add the following for hello world

def hello(event):
    event.reply("hello world !!")

nixbot uses loading on demand of modules and has a tbl command to generate a table for this.

$ nixbot tbl > nixbot/modules/tbl.py

a md5sum can be added to verify the modules md5sums are matching.

$ nixbot md5

put this value in nixbot/modules/__init__.py and nixbot can execute the hello command now.

$ nixbot hello

hello world !!

Commands run in their own thread and the program borks on exit, output gets flushed on print so exceptions appear in the systemd logs. Modules can contain your own written python3 code, see the nixbot/modules directory for examples.

FILES

~/.nixbot

~/.local/bin/nixbot

~/.local/pipx/venvs/nixbot/*

AUTHOR

Bart Thate <[e-mail]>

COPYRIGHT

NIXBOT is Public Domain.