This git repository contains the source for the RaumZeitChef IRC bot.

script/ircbot-chef

A simple script to run the IRC bot, providing --version.

lib/RaumZeitLabor/IRC/Chef.pm

The bot source code.

WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP

Currently rewriting architecture/plugin system to enable modular testing. In the meantime please run ./script/ircbot-chef and set --channel and set --nick to something appropiate.

WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP

The preferred way to deploy code on infra.rzl (where this bot traditionally runs on) is by installing a Debian package. This has many advantages:

1. When we need to re-install for some reason, the package has the correct dependencies, so installation is easy.

2. If Debian ships a new version of perl, the script will survive that easily.

3. A simple dpkg -l | grep -i raumzeit is enough to find all RaumZeitLabor-related packages and their version. The precise location of initscripts, configuration and source code can be displayed by dpkg -L raumzeitchef-ircbot.

To create a Debian package, ensure you have dpkg-dev installed, then run as root to ensure the Modules are installed globally:

sudo dpkg-buildpackage -uc -us

Now you have a package called raumzeitchef-ircbot_$VERSION_all.deb which you can deploy on infra.rzl.

If you introduce new dependencies, bump the version or change the description, you have to update the Debian packaging. First, install the packaging tools we are going to use:

apt-get install dh-make-perl

Then, run the following commands:

perl Makefile.PL
make manifest
export DEBFULLNAME='Your Name' DEBEMAIL='[email protected]'
dh-make-perl refresh
debchange --nmu

Inspect the changes to debian/ and commit them.

For more information about Debian packaging, see:

• http://wiki.ubuntu.com/PackagingGuide/Complete

For online documentation about the Perl modules which are used:

• http://search.cpan.org/perldoc?AnyEvent::IRC::Client
• http://search.cpan.org/perldoc?Audio::MPD