KGB.CONF(5p) | User Contributed Perl Documentation | KGB.CONF(5p) |
kgb.conf -- KGB bot configuration file
kgb.conf is the main configuration file of the KGB bot. Its location is in /etc/kgb-bot/ unless changed with the --conf command line option. See kgb-bot(1).
The file format is YAML. Elaborate example configuration is at the end of this document.
A map with the following possible keys:
For making KGB bot listen on all addresses, set the value to 0.0.0.0.
Directory to store PID file to. Defaults to /var/run/kgb-bot/.
Path to file with additional configuration. May be a path to a directory, in which case all files in it ending with ".conf" are loaded, in alphabetical order.
Minimum version of the protocol that will be supported by the server. Defaults to 1. Protocol version 0 has no authentication.
When messages are sent to IRC, there is certain rate limitting, which may prevent the message to be sent right away. In this case messages are enqueued, and this parameter configures the size of the queue. When the queue is full client requests are rejected.
A map with keys project names and values maps with project details:
A map with keys network names and values map of network configuration, containing the following items:
Defaults to 6697 when use_ssl is true and 6667 otherwise.
A list of channels. Each element is a map and represents the channel's configuration:
A list of strings to be used as replies when the bot is addressed on IRC.
If set to a true value, polygen(1) will be used to generate replies when the bot is addressed on IRC.
Enables logging of additional diagnostic information.
A list of IRC masks, used to determine if a given IRC nick is bot administrator. Note that currently these nicks have no additional power.
A map of colors to be used when painting commit messages. The following keys are recognized:
Depending on the action performed to the path, additional coloring is made:
A map for enabling GitLab webook support. Possible keys:
The name of a WWW::Shorten module to use for URL-shortening. The leading "WWW::Shorten::" part must be omitted.
Default: none
Example: Debli
# vim: filetype=yaml --- soap: server_addr: 127.0.0.1 server_port: 9999 service_name: KGB queue_limit: 150 log_file: "/var/log/kgb-bot.log" include: "/etc/kgb-bot/kgb.conf.d" repositories: # just a name to identify it foo: # needs to be the same on the client password: supersecret # private repositories aren't announced to broadcast channels # private: yes # Some witty answer for people that talk to the bot #smart_answers: # - "I won't speak with you!" # - "Do not disturb!" # - "Leave me alone, I am buzy!" # Admins are allowed some special !commands (currently only !version) #admins: # - some!irc@mask # - some!other@host networks: freenode: nick: KGB ircname: KGB bot username: kgb password: ~ nickserv_password: ~ server: irc.freenode.net port: 6667 channels: # a broadcast channel - name: '#commits' network: freenode broadcast: yes # a channel, tied to one or several repositories - name: '#foo' network: freenode repos: - foo # Can also be set per-channel #smart_answers: # - "I'm in ur channel, watching ur commits!" # - "I am not listening" # - "Shut up! I am buzy watching you." pid_dir: /var/run/kgb-bot # anything less is rejected min_protocol_ver: 1 # default colors: colors: repository: bold revision: bold author: green branch: brown module: purple path: teal addition: green modification: teal deletion: "bold red" replacement: reverse prop_change: underline web: silver # you can combine them like "bold red" (ouch!) # available colors: black, navy, green, red, brown, purple, orange, yellow, # lime, teal, aqua, blue, fuchsia, gray, silver, white # available modifiers: bold underline reverse webhook: enabled: 1 allowed_networks: - 127.0.0.1 short_url_service: Debli
Copyright (C) 2012, 2013 Damyan Ivanov
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
2020-11-03 | perl v5.30.3 |