Version information
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
Add this module to your Puppetfile:
mod 'brwyatt-irssi', '0.1.3'
Learn more about managing modules with a PuppetfileDocumentation
irssi
Table of Contents
- Description
- Setup - The basics of getting started with irssi
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
- 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 directoriesconfig_dir
: (namevar) Path of the config directory to managenetworks
: Hash of networks and their configurations TODO: Describe structurereal_name
: Default real name of the useruser_name
: Default user name of the usernick_name
: Default nick name of the userwindows
: Array of pre-defined windows and their settings TODO: Describe structurepurge_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 toowner
: (required) System owner of the scriptsource
: Source for the file (required unlesscontent
defined)content
: Content of the file (required unlesssource
defined)user_config
: (optional) Name of theirssi::user_config
if named differently than the defaultconfig_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.
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning
0.1.3 - 2019-05-24
Added
- PDK Update
- Add Forge credentials for deployment from Travis CI
0.1.2 - 2018-07-02
Maintenance release
Added
- Add dependency for package resource on Exec[apt_update], if it is defined
- PDK update
0.1.1 - 2018-01-05
Re-release
Fixed
- Incorrect repo diff links
- Increment version to correct premature publication to Forge
0.1.0 - 2018-01-05
Initial release
Added
- Install irssi
- Manage basic config file
- Manage scripts