Skip to content

Latest commit

 

History

History
99 lines (73 loc) · 3.21 KB

README.md

File metadata and controls

99 lines (73 loc) · 3.21 KB

Puppet Mode

License GPL 3 travis

Puppet Mode lets you edit Puppet 3 manifests with GNU Emacs 24.

Puppet Mode is a major mode for GNU Emacs 24 which adds support for the Puppet language. Puppet is a system provisioning and configuration tool by Puppetlabs Inc. This mode supports Puppet 3 and later. Puppet 2 is not explicitly supported anymore, but should mostly work.

This mode needs GNU Emacs 24. It will not work with GNU Emacs 23 and below, or with other flavors of Emacs (e.g. XEmacs).

Features

  1. Syntax highlighting
  2. Indentation and alignment of expressions and statements
  3. Tag navigation (aka imenu)
  4. Manual validation and linting of manifests (see Flycheck for on-the-fly validation and linting)

Installation

From MELPA or MELPA Stable with M-x package-install RET puppet-mode.

In your Cask file:

(source melpa)

(depends-on "puppet-mode")

Usage

Just visit Puppet manifests. The major mode is enabled automatically for Puppet manifests with the extension .pp.

The following key bindings are available in Puppet Mode:

Key Command
C-M-a Move to the beginning of the current block
C-M-e Move to the end of the current block
C-c C-a Align parameters in the current block
C-c C-' Toggle string quoting between single and double
C-c C-; Blank the string at point
C-c C-j Jump to a class, define, variable or resource
C-c C-c Apply the current manifest in dry-run mode
C-c C-v Validate the syntax of the current manifest
C-c C-l Check the current manifest for semantic issues

Use M-x customize-group RET puppet to customize Puppet Mode.

Support

Feel free to ask question or make suggestions in our issue tracker.

Contribute

License

Puppet Mode 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 3 of the License, or (at your option) any later version.

Puppet Mode 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.

See COPYING for the complete license.