Forge Home

irssi

Install and configure irssi chat client

7,393 downloads

4,173 latest version

5.0 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.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

  • 0.1.3 (latest)
  • 0.1.2
  • 0.1.1
  • 0.1.0 (deleted)
released May 24th 2019
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • ,

Start using this module

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

Add this module to your Puppetfile:

mod 'brwyatt-irssi', '0.1.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add brwyatt-irssi
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install brwyatt-irssi --version 0.1.3

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

Documentation

brwyatt/irssi — version 0.1.3 May 24th 2019

irssi

Build Status

GitHub license GitHub issues GitHub forks GitHub stars

Puppet Forge Puppet Forge - downloads Puppet Forge - scores

Table of Contents

  1. Description
  2. Setup - The basics of getting started with irssi
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module
  7. Contributors - List of those who've helped to make the module better

Description

This module provides simple classes and types for installing the irssi chat client on a system, and setting up user configuration and scripts.

Setup

What irssi affects

This module installs the irssi package and may optionally be used to manage one or more user configuration directories.

Setup Requirements

Currently, this module only supports Ubuntu (tested on Ubuntu 14.04), but will likely work on otehr Debian-based distributions.

Beginning with irssi

To install this modual, call:

puppet module install brwyatt-irssi

Usage

To install irssi on agent, simply include it into your manifests.

include ::irssi

Reference

Classes

irssi

Installs and realizes user configuration for irssi by including irssi::install and irssi::configure.

irssi::configure

Realizes user configuration for irssi.

Realizes all irssi::user_config and irssi::user_script resources.

irssi::install

Installs the irssi package with the default system package provider.

Default values for class parameters are derived from Hiera data files in irssi/data/

Parameters:

  • package_ensure: Package ensure value (defaults to "latest")
  • package_name: Name of the package (defaults to "irssi" on Debian)

Defined Types

irssi::user_config

Manages an irssi config directory and config file.

Parameters:

  • owner: (required) System owner of the files and directories
  • config_dir: (namevar) Path of the config directory to manage
  • networks: Hash of networks and their configurations TODO: Describe structure
  • real_name: Default real name of the user
  • user_name: Default user name of the user
  • nick_name: Default nick name of the user
  • windows: Array of pre-defined windows and their settings TODO: Describe structure
  • purge_scripts: Whether the scripts directory should have unmanaged scripts purged (default: false)

irssi::user_script

Manages scripts installed in a config directory.

Parameters:

  • config_dir: (required) Config directory this script should be installed to
  • owner: (required) System owner of the script
  • source: Source for the file (required unless content defined)
  • content: Content of the file (required unless source defined)
  • user_config: (optional) Name of the irssi::user_config if named differently than the default config_dir
  • autorun: Controls whether the script should be enabled to auto-load on irssi start. (default: false)
  • script_name: (namevar) The filename for the script file

Limitations

Currently, this module is only tested against Ubuntu 16.04. It will likely work on other Debian-based distributions, and may or may not work on RedHat-based distributions, but makes no claims regarding such.

Development

Feel free to file issues in the GitHub issue tracker for the repository, or submit Pull Requests.

I may not have much time to work on (or test) this myself, so help to expand current functionality (especially to make it work for more people) is greatly appreciated and encouraged.

Contributors

The list of contributors can be found at: https://github.com/brwyatt/puppet-irssi/graphs/contributors.