spacemacs/layers/+tools/puppet
syl20bnr 1c4f685b13 core: refactor layer system
TL;DR Should get 20~25% speed improvement on startup, should get a big
improvement when using ivy or helm SPC h SPC. Users with layers.el files
in their layers must use `configuration-layer/declare-used-layer`
instead of `configuration-layer/declare-layer`

The implementation of the layer system made heavy use of `object-assoc`
and `object-assoc-list` functions which are not efficient. This PR
mainly replaces those object lists with hash maps in order to index the
objects by their name and achieve an O(1) access time.

The old object lists `configuration-layer--layers` and
`configuration-layer--packages` have been each by two variables each:
- `configuration-layer--indexed-layers` which is a hash-map of all the
layer objects and `configuration-layer--used-layers` which is a list of
all _used_ layers symbols,
- symmetrically `configuration-layer--indexed-packages` which is a
hash-map of all the package objects and
`configuration-layer--used-packages` which is a list of all _used_
packages symbols.

The hash map `configuration-layer--layer-paths` is gone, now we create
directly layer objects when discovering the layers and set the :dir
property. Note that previously the layer paths were the parent directory
of the layer, now :dir is the layer path.

The function `configuration-layer//make-layer` is now similar to its
counterpart `configuration-layer//make-package` in the sense that it
takes an optional `obj` to be able to override its properties.

The functions `configuration-layer/declare-layer` and
`configuration-layer/declare-layers` now takes an optional parameter
`usedp` in order to declare used or not used layers. For convenience
new functions have been added: `configuration-layer/declare-used-layer`
and `configuration-layer/declare-used-layers`, users _must_ update all
occurrences of `configuration-layer/declare-layer` by
`configuration-layer/declare-used-layers` in their `layers.el` files.

`helm-spacemacs-help` and `ivy-spacemacs-help` are updated to match the
changes in `core-configuration-layer.el`.

Rename some variables to make them more explicit:
`configuration-layer-no-layer` -> `configuration-layer-exclude-all-layers`
`configuration-layer-distribution` -> `configuration-layer-force-distribution`
2016-07-28 23:26:54 -04:00
..
img Replace +config-files category by +tools category 2016-06-09 23:56:09 -04:00
config.el Replace +config-files category by +tools category 2016-06-09 23:56:09 -04:00
layers.el core: refactor layer system 2016-07-28 23:26:54 -04:00
packages.el Replace +config-files category by +tools category 2016-06-09 23:56:09 -04:00
README.org Replace +config-files category by +tools category 2016-06-09 23:56:09 -04:00

Puppet layer

/TakeV/spacemacs/media/commit/1c4f685b13ab606f7ad71299547d22cf3eec6cc2/layers/+tools/puppet/img/puppet.png

Description

This layer aims at providing support for the Puppet DSL using puppet-mode.

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add puppet to the existing dotspacemacs-configuration-layers list in this file.

Key bindings

The following key bindings are available in Puppet Mode:

Key Binding Description
SPC m { Move to the beginning of the current block
SPC m } Move to the end of the current block
SPC m a Align parameters in the current block
SPC m ' Toggle string quoting between single and double
SPC m ; Blank the string at point
SPC m j Jump to a class, define, variable or resource
SPC m c Apply the current manifest in dry-run mode
SPC m v Validate the syntax of the current manifest
SPC m l Check the current manifest for semantic issues
SPC m $ Interpolate with ${} in double quoted strings

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