|Sami Lahtinen af661a1add||2 years ago|
|src||2 years ago|
|.gitignore||5 years ago|
|.gitlab-ci.yml||3 years ago|
|CONTRIBUTING.md||3 years ago|
|Cargo.toml||2 years ago|
|Dockerfile||3 years ago|
|LICENSE||4 years ago|
|README.md||4 years ago|
|botconfig-example.toml||5 years ago|
|plugins-example.toml||2 years ago|
GOLBot-Rust, GamingOnLinux IRC Bot Rust rewrite
What is it?
GOLBot-Rust is a rewrite of the older GOLBotV2 IRC bot, used on the gamingonlinux.com IRC channel. This marks the third major iteration of the GOLBot IRC bot.
GOLBot's tasks include posting links from an RSS feed to reading URLs for web page titles and allowing users to check when someone has been last seen and leaving each other messages.
Why a third iteration?
The previous version of GOLBot was hacked together by two people with little regard to maintainability. As such, the versions we ended up with were more akin to spaghetti than readable program code. This made making changes and improvements to the bot increasingly difficult.
GOLBot-Rust is a total rewrite of the codebase and aims to separate each part of the bot properly, making changes and additions significantly easier.
GOLBot-Rust uses two configuration files: botconfig.toml and plugins.toml.
The general structure of the botconfig.toml is as follows:
nick = "GOLBOTv3" serv = "chat.freenode.net" channel = "#golbottest" realname = "I have none" ident = "GOLBOT" password = "somepassword" # optional
An example file is provided in the repository.
In the botconfig.toml file you can define the nickname, server and channel, along with other identifying information used to connect the bot to the desired IRC server.
The plugins.toml file is used to store any plugin specific, largely optional, details. You can see an example file here, which defines an RSS feed for the RSS plugin to read and a nickname to ignore in the URL Reader plugin.
Extending the bot
The bot can be extended by writing plugins for it. I use the term "plugin" fairly loosely, however, since plugins cannot be loaded during runtime. Instead the plugins are compiled into the bot upon building. The plugin system is more of an abstraction layer that separates the internals of the IRC bot from the code that is run on top of the bot.
I recommend you read the sources at src/plugins/ to have an idea how a GOLBot plugin behaves. Better documentation about plugins will be written when I bother writing some.