Forge Home

figlet

Puppet module to install figlet and allow for figlet access in other modules

106,843 downloads

106,041 latest version

2.8 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

  • 1.0.1 (latest)
  • 1.0.0
  • 0.1.1
  • 0.1.0
released Dec 26th 2014
This version is compatible with:
  • ArchLinux, CentOS, Debian, RedHat, Ubuntu

Start using this module

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

Add this module to your Puppetfile:

mod 'zanloy-figlet', '1.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add zanloy-figlet
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install zanloy-figlet --version 1.0.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

Documentation

zanloy/figlet — version 1.0.1 Dec 26th 2014

figlet

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with figlet
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

Overview

figlet is a program that makes large ascii text art from standard text input.

Module Description

This module allows you to use figlet text in other modules as well as create basic files with figlet text (eg: /etc/motd). An example of this is:

  __ _       _      _   
 / _(_) __ _| | ___| |_ 
| |_| |/ _` | |/ _ \ __|
|  _| | (_| | |  __/ |_ 
|_| |_|\__, |_|\___|\__|
       |___/ 

Setup

What figlet affects

The figlet module will need to have figlet application installed on the puppet master. This can be done by calling "include figlet::install" in the node definition for your puppet master. It does not need to be installed on agents to use the function.

Setup Requirements

  • figlet sets up a function and several facts so it will require that pluginsync is enabled.
  • To install figlet on RedHat based systems, you will also need the repoforge repository. If you plan to use the "include figlet::install" method of installation on a RedHat system, then you need to have the yguenane/repoforge module installed and setup. There is a direct dependency to Yumrepo['repoforge'] and will fail if this is not in the catalog.

Beginning with figlet

To install the figlet module, you can either install from the forge:

puppet module install zanloy/figlet

or install from github (execute in the modules directory):

git clone https://github.com/zanloy/puppet-figlet.git figlet

Usage

To install figlet on the puppet master (include only in puppet master's node definition)

include figlet::install

The figlet modules does not have any declarable classes on its own. It is designed to be used in other modules. A good example of this is to setup a figlet banner in your motd file:

file { '/etc/motd':
  content => figlet("$::hostname"),
}

Reference

The figlet module create one function and two facts.

figlet($string, $font, $width)

Facts (should only be relevant on the puppet master):

figlet_fonts (comma separated string of fonts installed on node)
figlet_fonts_array (array of fonts installed)

Limitations

This module has only been tested on the following distros:

  • Ubuntu 14.04
  • RHEL 6.5

Development

This module is pretty basic but if you have any improvements, then please add a new issue with tag [feature] or you are always welcome to add it yourself and send a pull request.