cinchize
Cinchize scope is to easily get a daemonized irc-bot up and running using plugins where there shouldn’t be any need to actually write code.
It should be noted that the program is currently considered to be in beta and may change both in how it’s accessed and how the config logs is formed.
Installation
gem install cinchize
Usage
Basic
cinchize --start network
The config file can either be in the current working directory or in /etc and should be called cinchize.yml. Use the flag -s to tell cinchize to look for the config file at /etc/cinchize.yml.
cinchize -s --start network
To daemonize, use -d
cinchize -d --start network
Network is the name you call the a server config in the servers part of the config file, i.e. “freenode”, “super_duper_amazing_network”, “quakenet” or similar.
–start, –restart, –stop and –status assumes that “cinchize.yml” is located in the current working directory unless -s is used, then we assume that it’s located in “/etc/cinchize.yml” as stated above.
Config-file
All config options to each server object is optional, except for the channels and plugins. All valid config options for a Cinch bot should work.
options:
log_output: true
dir_mode: normal
dir: "/path/to/pid/dir"
servers:
freenode:
server: irc.freenode.net
port: 6667
nick: CinchizeBot
channels:
- "#cinchbots"
plugins:
-
class: "Cinch::Plugins::SomePlugin"
options:
option: value
-
class: "Cinch::Plugins::AnotherPlugin"
Options explained
dir: the save path, absolute or relative to either /var/run or to the current working directory
dir_mode: “system” to work from /var/run and “normal”, to work from current working directory or from an absolute path
log_output: writes STDERR and STDOUT to a logfile in the same dir as the pid-file
Copyright
Copyright © 2010 Victor Bergöö. See LICENSE for details.