feat(pkg): separate components, use requisites and add clean states

README.rst

@@ -48,22 +48,51 @@ Available states
 
 Meta-state (This is a state that includes other states)
 
-This installs the template package, and starts the associated template service.
+This installs the template package,
+manages the template configuration file and then
+starts the associated template service.
 
-``template.install``
+``template.package``
 --------------------
 
 This state will install the template package only.
 
 ``template.config``
 -------------------
 
-This state will configure the template service and has a depency on ``template.install``
+This state will configure the template service and has a dependency on ``template.install``
 via include list.
 
 ``template.service``
 --------------------
 
-This state will start the template service and has a depency on ``template.config``
+This state will start the template service and has a dependency on ``template.config``
+via include list.
+
+``template.clean``
+------------------
+
+Meta-state (This is a state that includes other states)
+
+this state will undo everything performed in the ``template`` meta-state in reverse order, i.e.
+stops the service,
+removes the configuration file and
+then uninstalls the package.
+
+``template.service.clean``
+--------------------------
+
+This state will stop the template service and disable it at boot time.
+
+``template.config.clean``
+-------------------------
+
+This state will remove the configuration of the template service and has a dependency on ``template.service.clean``
+via include list.
+
+``template.package.clean``
+--------------------------
+
+This state will remove the template package and has a depency on ``template.config.clean``
 via include list.
 

template/clean.sls

@@ -0,0 +1,7 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+include:
+  - .service.clean
+  - .config.clean
+  - .package.clean

template/config/clean.sls

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+{#- Get the `tplroot` from `tpldir` #}
+{%- set tplroot = tpldir.split('/')[0] %}
+{%- set sls_service_clean = tplroot ~ '.service.clean' %}
+{%- from tplroot ~ "/map.jinja" import template with context %}
+{%- from tplroot ~ "/macros.jinja" import files_switch with context %}
+
+include:
+  - {{ sls_service_clean }}
+
+template-config-clean-file-absent:
+  file.absent:
+    - name: {{ template.config }}
+    - require:
+      - sls: {{ sls_service_clean }}

template/config/file.sls

@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+{#- Get the `tplroot` from `tpldir` #}
+{%- set tplroot = tpldir.split('/')[0] %}
+{%- set sls_package_install = tplroot ~ '.package.install' %}
+{%- from tplroot ~ "/map.jinja" import template with context %}
+{%- from tplroot ~ "/macros.jinja" import files_switch with context %}
+
+include:
+  - {{ sls_package_install }}
+
+template-config-file-file-managed:
+  file.managed:
+    - name: {{ template.config }}
+    - source: {{ files_switch(
+                    salt['config.get'](
+                        tplroot ~ ':tofs:files:template-config',
+                        ['example.tmpl', 'example.tmpl.jinja']
+                    )
+              ) }}
+    - mode: 644
+    - user: root
+    - group: root
+    - template: jinja
+    - require:
+      - sls: {{ sls_package_install }}

template/config/init.sls

@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+include:
+  - .file

template/init.sls

@@ -2,6 +2,6 @@
 # vim: ft=sls
 
 include:
-  - template.install
-  - template.config
-  - template.service
+  - .package
+  - .config
+  - .service

template/map.jinja

@@ -1,13 +1,13 @@
 # -*- coding: utf-8 -*-
 # vim: ft=jinja
 
-{#- Get the `topdir` from `tpldir` #}
-{%- set topdir = tpldir.split('/')[0] %}
+{#- Get the `tplroot` from `tpldir` #}
+{%- set tplroot = tpldir.split('/')[0] %}
 {#- Start imports as #}
-{%- import_yaml topdir ~ "/defaults.yaml" or {} as default_settings %}
-{%- import_yaml topdir ~ "/osfamilymap.yaml" or {} as osfamilymap %}
-{%- import_yaml topdir ~ "/osmap.yaml" or {} as osmap %}
-{%- import_yaml topdir ~ "/osfingermap.yaml" or {} as osfingermap %}
+{%- import_yaml tplroot ~ "/defaults.yaml" or {} as default_settings %}
+{%- import_yaml tplroot ~ "/osfamilymap.yaml" or {} as osfamilymap %}
+{%- import_yaml tplroot ~ "/osmap.yaml" or {} as osmap %}
+{%- import_yaml tplroot ~ "/osfingermap.yaml" or {} as osfingermap %}
 
 {% set defaults = salt['grains.filter_by'](default_settings,
     default='template',

template/package/clean.sls

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+{#- Get the `tplroot` from `tpldir` #}
+{%- set tplroot = tpldir.split('/')[0] %}
+{%- set sls_config_clean = tplroot ~ '.config.clean' %}
+{%- from tplroot ~ "/map.jinja" import template with context %}
+
+include:
+  - {{ sls_config_clean }}
+
+template-package-clean-pkg-removed:
+  pkg.removed:
+    - name: {{ template.pkg }}
+    - require:
+      - sls: {{ sls_config_clean }}

template/package/init.sls

@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+include:
+  - .install

template/package/install.sls

@@ -0,0 +1,10 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+{#- Get the `tplroot` from `tpldir` #}
+{%- set tplroot = tpldir.split('/')[0] %}
+{%- from tplroot ~ "/map.jinja" import template with context %}
+
+template-package-install-pkg-installed:
+  pkg.installed:
+    - name: {{ template.pkg }}

template/service/clean.sls

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+{#- Get the `tplroot` from `tpldir` #}
+{%- set tplroot = tpldir.split('/')[0] %}
+{%- from tplroot ~ "/map.jinja" import template with context %}
+
+template-service-clean-service-dead:
+  service.dead:
+    - name: {{ template.service.name }}
+    - enable: False

template/service/init.sls

@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+include:
+  - .running

template/service/running.sls

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+# vim: ft=sls
+
+{#- Get the `tplroot` from `tpldir` #}
+{%- set tplroot = tpldir.split('/')[0] %}
+{%- set sls_config_file = tplroot ~ '.config.file' %}
+{%- from tplroot ~ "/map.jinja" import template with context %}
+
+include:
+  - {{ sls_config_file }}
+
+template-service-running-service-running:
+  service.running:
+    - name: {{ template.service.name }}
+    - enable: True
+    - require:
+      - sls: {{ sls_config_file }}