Library for writing IRC bots in OCaml, a collection of plugins, and a dramatic robotic actor.
The core library is called
Introduction to the Code
Let's assume calculon is loaded, via:
# #require "calculon";;
main entry point would look like this.
Calculon works by gathering a list of
plugins (see the module
Plugin), some configuration (see
and running the package in a loop using irc-client.
module C = Calculon let plugins : C.Plugin.t list = [ C.Plugin_social.plugin; C.Plugin_factoids.plugin; (* etc. *) ] let () = let conf = C.Config.of_argv () in C.Run_main.main conf plugins |> Lwt_main.run
A plugin contains a set of commands.
A command is is a rule that matches a IRC message with some regex, and decides
whether or not to fire with a reply. They are defined in the module
For instance, the following module will reply to messages
!hello by replying
"hello <sender>". This is a simple
command, as the function
Command.make_simple indicates: it returns a
string option to indicate whether or not to respond to any line starting with
!prefix. More elaborate commands are possible using
open Calculon let cmd_hello : Command.t = Command.make_simple ~descr:"hello world" ~cmd:"hello" ~prio:10 (fun (input_msg:Core.privmsg) _ -> let who = input_msg.Core.nick in Lwt.return (Some ("hello " ^ who)) ) let plugin_hello : Plugin.t = Plugin.of_cmd cmd_hello
Basic plugins are stateless, built from one or more commands with
Other plugins can be stateful (typically, they can have some persistent
state, or more "custom" schemes).
Plugin.stateful is used to make such plugins.
All the persistent state is stored in a single json file.
See for instance the existing plugins
to see how to use
>= "1.2" & < "3.0"
>= "1.4.1" & < "2.0.0"
>= "0.6.0" & < "0.7.0"