Forge Home

lita

Installs and configures lita

9,767 downloads

9,462 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.1.1 (latest)
  • 0.1.0
released Apr 10th 2015
This version is compatible with:
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'evenup-lita', '0.1.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add evenup-lita
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install evenup-lita --version 0.1.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download
Tags: jira, lita

Documentation

evenup/lita — version 0.1.1 Apr 10th 2015

Puppet Forge Build Status

Table of Contents

  1. Overview
  2. Module Description
  3. Setup
  4. Usage
  5. Reference
  6. Limitations
  7. Development
  8. Changelog/Contributors

Overview

A Puppet module that installs and configures Lita bots

Module Description

Lita is a Chatbot written in ruby supporting various chat services and handlers. This puppet module will configure a system for Lita and configure one or multiple bots.

Setup

What lita affects

  • (optional) Manage bundler and packages required to build lita gems
  • Lita bots and associated services

Beginning with lita

Installation of the lita module:

  puppet module install evenup-lita

Usage

Insallation and creation of 'test bot' using the irc adapter

      class { 'lita':
        bundler_binpath => '/usr/bin'
      }

      lita::bot { 'test bot':
        adapter        => ':irc',
        adapter_config => { 'server' => 'irc.freenode.net', 'channels' => ['#litabot'] }
      }

Reference

Public methods

Class: lita

Main class for setting bot global defaults and global configuration

#####base_path

String. Path Lita bots should be installed in

Default: /opt/lita

#####manage_bundler

Boolean. Should the bundler gem be managed by this module

Default: false

#####bundler_package

String. Name of the package to install if managing the bundler gem

Default: bundler

#####bundler_provider

String. Provider used to install the bundler gem if managed by this module

Default: gem

#####bundler_binpath

String. Path to the bundler binary

Default: /bin

#####extra_packages

String/Array of Strings. If needed, a list of packages to manage with this module to support gem building for bots

#####version

String. Default version of lita to use for bots

Default: latest

#####adapter

String. Default adapter to use for bots

Default: :shell

#####adapter_config

Hash. Default adapter configuration to use for bots

Default: {}

Format: {'key' => 'value'}

#####bot_name

String. Default name to use for bots

Default: lita

#####gems

Array of Strings. Default gems to use for bots

Default: []

#####mention_name

String. Default mention name to use for bots

Default: lita

#####plugins

String. Default plugins to use for bots

Default: []

#####plugin_config

Hash. Default plugin configuration to use for bots

Default: []

Format: { 'plugin_name' => { 'key' => 'value' } }

#####admins

Array of Strings. Default list of admins to use for bots

Default: []

#####locale

String. Default localeto use for bots

Default: en

#####log_level

String. Default log_level to use for bots

Default: :info

#####http_host

String. Default host to listen for HTTP requests on for bots

Default: '0.0.0.0'

#####http_port

Integer. Default port to listen for HTTP requests on for bots

Default: 8080

#####redis_host

String. Default redis host to use for bots

Default: '127.0.0.1'

#####redis_port

Integer. Default redis port to use for bots

Default: 6379

Define: lita::bot

Configures individual lita bots.

#####version

String. Version of lita to use

Default: latest

#####adapter

String. Adapter to be used by this bot

Default: :shell

#####adapter_config

Hash. Adapter configuration for this bot

Default: {}

Format: {'key' => 'value'}

#####bot_name

String. Name to be used by the bot

Default: lita

#####gems

Array of Strings. Gems needed for this bot

Default: []

#####mention_name

String. Mention name for this bot

Default: lita

#####plugins

String. Plugins to be used by this bot

Default: []

#####plugin_config

Hash. Plugin configuration to be used by this bot

Default: []

Format: { 'plugin_name' => { 'key' => 'value' } }

#####admins

Array of Strings. Admin names of this bot

Default: []

#####locale

String. Locale to be used by this bot

Default: en

#####log_level

String. Log_level for this bot

Default: :info

#####http_host

String. Address to open listening port on for this bot

Default: '0.0.0.0'

#####http_port

Integer. Port to listen on for this bot

Default: 8080

#####redis_host

String. Redis host to use for this bot

Default: '127.0.0.1'

#####redis_port

Integer. Port to connect to redis on

Default: 6379

Private classes

  • lita::params: Default lita configuration

Limitations

  • Only tested on RHEL/CentOS 7

Development

Improvements and bug fixes are greatly appreciated. See the contributing guide for information on adding and validating tests for PRs.

Changelog / Contributors

Changelog

Contributors