olcf · AcerP-py · May 19, 2026 · May 19, 2026 · May 19, 2026 · May 19, 2026
diff --git a/.docs/role_documentation_generator b/.docs/role_documentation_generator
@@ -40,52 +40,53 @@ if __name__ == "__main__":
                     roles_rst.append("")
 
                     # options
-                    roles_rst.extend(["`Variables`", "^^^^^^^^^^^", ""])
-                    for option in specs["argument_specs"]["main"]["options"]:
-                        roles_rst.extend([
-                            ".. _{}_variable:".format(option),
-                            "",
-                            "``{}``".format(option),
-                            '"' * (len(option) + 4),
-                            "",
-                            ":Type: **{}**".format(
-                                specs["argument_specs"]["main"]["options"][option]["type"]
-                            ),
-                            "",
-                            ":Required: **{}**".format(
-                                json_dumps(
-                                    specs["argument_specs"]["main"]["options"][option]["required"]
-                                )
-                            ),
-                            "",
-                        ])
-                        if "choices" in specs["argument_specs"]["main"]["options"][option]:
+                    if "options" in specs["argument_specs"]["main"]:
+                        roles_rst.extend(["`Variables`", "^^^^^^^^^^^", ""])
+                        for option in specs["argument_specs"]["main"]["options"]:
                             roles_rst.extend([
-                                ":Allowed Values: ``{}``".format(
-                                    json_dumps(specs["argument_specs"]["main"]["options"][option]["choices"])
-                                )
-                            ])
-                        if (not specs["argument_specs"]["main"]["options"][option]["required"] and
-                                "default" in  specs["argument_specs"]["main"]["options"][option]):
-                            roles_rst.extend([
-                                ":Default: ``{}``".format(
+                                ".. _{}_variable:".format(option),
+                                "",
+                                "``{}``".format(option),
+                                '"' * (len(option) + 4),
+                                "",
+                                ":Type: **{}**".format(
+                                    specs["argument_specs"]["main"]["options"][option]["type"]
+                                ),
+                                "",
+                                ":Required: **{}**".format(
                                     json_dumps(
-                                        specs["argument_specs"]["main"]["options"][option]["default"]
+                                        specs["argument_specs"]["main"]["options"][option]["required"]
                                     )
                                 ),
                                 "",
                             ])
-                        roles_rst.extend([
-                            ":Description: {}".format(
-                                specs["argument_specs"]["main"]["options"][option]["description"]
-                            ),
-                            "",
-                        ])
-                        if "raw" in specs["argument_specs"]["main"]["options"][option]:
+                            if "choices" in specs["argument_specs"]["main"]["options"][option]:
+                                roles_rst.extend([
+                                    ":Allowed Values: ``{}``".format(
+                                        json_dumps(specs["argument_specs"]["main"]["options"][option]["choices"])
+                                    )
+                                ])
+                            if (not specs["argument_specs"]["main"]["options"][option]["required"] and
+                                    "default" in  specs["argument_specs"]["main"]["options"][option]):
+                                roles_rst.extend([
+                                    ":Default: ``{}``".format(
+                                        json_dumps(
+                                            specs["argument_specs"]["main"]["options"][option]["default"]
+                                        )
+                                    ),
+                                    "",
+                                ])
                             roles_rst.extend([
-                                specs["argument_specs"]["main"]["options"][option]["raw"],
+                                ":Description: {}".format(
+                                    specs["argument_specs"]["main"]["options"][option]["description"]
+                                ),
                                 "",
                             ])
+                            if "raw" in specs["argument_specs"]["main"]["options"][option]:
+                                roles_rst.extend([
+                                    specs["argument_specs"]["main"]["options"][option]["raw"],
+                                    "",
+                                ])
 
     print("--- writing out documentation for NSP roles ---")
     out_dir = Path(__file__).parent.joinpath("source/reference")

diff --git a/.docs/source/starting/setup.rst b/.docs/source/starting/setup.rst
@@ -377,7 +377,7 @@ We will name our spack environments according to the following schema ``core<yea
 .. code-block:: jinja
     :caption: ``moria/spack/environments/concretizer.yaml.j2``
 
-    {{ ansible_managed | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
+    {{ NSP_template_header | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
 
     concretizer:
       reuse: false
@@ -391,7 +391,7 @@ We will name our spack environments according to the following schema ``core<yea
 .. code-block:: jinja
     :caption: ``moria/spack/environments/config.yaml.j2``
 
-    {{ ansible_managed | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
+    {{ NSP_template_header | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
 
     config:
       install_tree:
@@ -447,7 +447,7 @@ We will name our spack environments according to the following schema ``core<yea
 .. code-block:: jinja
     :caption: ``moria/spack/environments/modules.yaml.j2``
 
-    {{ ansible_managed | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
+    {{ NSP_template_header | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
 
     modules:
       prefix_inspections:
@@ -508,7 +508,7 @@ We will name our spack environments according to the following schema ``core<yea
 .. code-block:: jinja
     :caption: ``moria/spack/environments/packages.yaml.j2``
 
-    {{ ansible_managed | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
+    {{ NSP_template_header | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
 
     packages:
       all:
@@ -552,7 +552,7 @@ We will name our spack environments according to the following schema ``core<yea
 .. code-block:: jinja
     :caption: ``moria/spack/environments/core25.02/spack.yaml.j2``
 
-    {{ ansible_managed | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
+    {{ NSP_template_header | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
 
     # OLCF {{ NSP_system_name }} {{ _SPACK_environment_name }} Spack Environment
 
@@ -593,7 +593,7 @@ We will name our spack environments according to the following schema ``core<yea
 .. code-block:: jinja
     :caption: ``moria/spack/environments/sw25.02/spack.yaml.j2``
 
-    {{ ansible_managed | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
+    {{ NSP_template_header | comment(beginning="##", end="##", decoration="#", prefix_count=0, postfix_count=0) }}
 
     # OLCF {{ NSP_system_name }} {{ _SPACK_environment_name }} Spack Environment
 
@@ -728,7 +728,7 @@ environment that we installed.
 .. code-block:: jinja
     :caption: ``moria/files/Core/25.02.lua``
 
-    {{ ansible_managed | comment(beginning="--[[", end="]]--", decoration="", prefix_count=0, postfix_count=0) }}
+    {{ NSP_template_header | comment(beginning="--[[", end="]]--", decoration="", prefix_count=0, postfix_count=0) }}
 
     help("Add path for Core 25.02 modules to MODULEPATH")
 

diff --git a/.gitignore b/.gitignore
@@ -1,5 +1,6 @@
 # IDE files
 .idea
+.vscode
 
 # build files
 .docs/build

diff --git a/ansible.cfg b/ansible.cfg
@@ -1,11 +1,3 @@
 [defaults]
 roles_path = ./roles
 display_skipped_hosts = no
-ansible_managed = | WARNING! This file is managed by Ansible.
-    | Do NOT make manual changes to this file.
-    | Please email {{{{ NSP_help_email }}}} to request a change.
-
-    | Info:
-    |   Role: {{{{ ansible_role_name }}}}
-    |   {{{{ "{{}} Template: {{}}".format(NSP_site_name, template_path.replace(playbook_dir, "").lstrip("/")) if playbook_dir in template_path else "NSP Template: {{}}".format(template_path) }}}}
-    |   User: {{{{ ansible_user_id }}}}
diff --git a/aocc/templates/module.lua.j2 b/aocc/templates/module.lua.j2
@@ -1,4 +1,4 @@
-{{ ansible_managed | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
+{{ NSP_template_header | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
 
 family("compiler")
 

diff --git a/codee/templates/module.lua.j2 b/codee/templates/module.lua.j2
@@ -1,4 +1,4 @@
-{{ ansible_managed | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
+{{ NSP_template_header | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
 
 whatis("Codee : A code modernization and optimization platform")
 whatis("Version : {{ NSP_CODEE_version }}")

diff --git a/cuda/templates/module.lua.j2 b/cuda/templates/module.lua.j2
@@ -1,4 +1,4 @@
-{{ ansible_managed | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
+{{ NSP_template_header | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
 
 family("gpu")
 

diff --git a/gcc/templates/module.lua.j2 b/gcc/templates/module.lua.j2
@@ -1,4 +1,4 @@
-{{ ansible_managed | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
+{{ NSP_template_header | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
 
 family("compiler")
 

diff --git a/init/defaults/main.yaml b/init/defaults/main.yaml
@@ -1 +0,0 @@
-NSP_INIT_wipe: false

diff --git a/init/meta/argument_specs.yaml b/init/meta/argument_specs.yaml
@@ -10,9 +10,8 @@ argument_specs:
 
              The ``init`` directory and accompanying files are completely optional. Without them, blank init scripts
              will be created.
-    options:
-      NSP_INIT_wipe:
-        type: bool
-        required: false
-        default: false
-        description: Wipe and recreate the init scripts on every run.
+      - |-
+          .. note::
+             The init role provides a bash/csh function called ``nsp_initialize_lmod`` that can be used to setup Lmod
+             from the default location. You may use them in your own ``profile.j2`` and ``cshrc.j2``
+             templates if desired.
diff --git a/init/tasks/main.yaml b/init/tasks/main.yaml
@@ -8,42 +8,13 @@
   tags:
     - init
 
-- name: Check profile Status
-  ansible.builtin.stat:
-    path: "{{ [NSP_install_root, 'init', 'profile'] | path_join }}"
-  register: profile_status
-  tags:
-    - init
-
 - name: Generate profile
   ansible.builtin.template:
     src: profile.j2
     dest: "{{ [NSP_install_root, 'init', 'profile'] | path_join }}"
     owner: "{{ NSP_user }}"
     group: "{{ NSP_group }}"
     mode: "{{ NSP_file_permissions }}"
-  when: NSP_INIT_wipe or not profile_status.stat.exists
-  tags:
-    - init
-
-- name: Add Contents to profile
-  ansible.builtin.blockinfile:
-    block: "{{ lookup('template', [playbook_dir, 'init/profile.j2'] | path_join) }}"
-    path: "{{ [NSP_install_root, 'init', 'profile'] | path_join }}"
-    marker: "# {mark} INIT MANAGED"
-    append_newline: true
-    prepend_newline: true
-    owner: "{{ NSP_user }}"
-    group: "{{ NSP_group }}"
-    mode: "{{ NSP_file_permissions }}"
-  when: "[playbook_dir, 'init/profile.j2'] | path_join is file"
-  tags:
-    - init
-
-- name: Check cshrc Status
-  ansible.builtin.stat:
-    path: "{{ [NSP_install_root, 'init', 'cshrc'] | path_join }}"
-  register: cshrc_status
   tags:
     - init
 
@@ -54,20 +25,5 @@
     owner: "{{ NSP_user }}"
     group: "{{ NSP_group }}"
     mode: "{{ NSP_file_permissions }}"
-  when: NSP_INIT_wipe or not cshrc_status.stat.exists
-  tags:
-    - init
-
-- name: Add Contents to cshrc
-  ansible.builtin.blockinfile:
-    block: "{{ lookup('template', [playbook_dir, 'init/cshrc.j2'] | path_join) }}"
-    path: "{{ [NSP_install_root, 'init', 'cshrc'] | path_join }}"
-    marker: "# {mark} INIT MANAGED"
-    append_newline: true
-    prepend_newline: true
-    owner: "{{ NSP_user }}"
-    group: "{{ NSP_group }}"
-    mode: "{{ NSP_file_permissions }}"
-  when: "[playbook_dir, 'init/cshrc.j2'] | path_join is file"
   tags:
     - init
diff --git a/init/templates/cshrc.j2 b/init/templates/cshrc.j2
@@ -1,2 +1,18 @@
 #!/usr/bin/env csh
-{{ ansible_managed | comment(beginning='##', end='##', decoration='#', prefix_count=0, postfix_count=0) }}
+{{ NSP_template_header | comment(beginning='##', end='##', decoration='#', prefix_count=0, postfix_count=0) }}
+
+########################################
+# NSP Helpers
+########################################
+
+nsp_initialize_lmod() {
+    if ( -f "{{ [NSP_install_root, 'lmod/etc/profile'] | path_join }}" ) then
+        source "{{ [NSP_install_root, 'lmod/etc/profile'] | path_join }}"
+    endif
+}
+
+########################################
+# User Content
+########################################
+
+{{ lookup('template', [playbook_dir, 'init/cshrc.j2'] | path_join, errors='ignore') | default('') }}
diff --git a/init/templates/profile.j2 b/init/templates/profile.j2
@@ -1,2 +1,18 @@
 #!/usr/bin/env bash
-{{ ansible_managed | comment(beginning='##', end='##', decoration='#', prefix_count=0, postfix_count=0) }}
+{{ NSP_template_header | comment(beginning='##', end='##', decoration='#', prefix_count=0, postfix_count=0) }}
+
+########################################
+# NSP Helpers
+########################################
+
+nsp_initialize_lmod() {
+    if [ -f {{ [NSP_install_root, 'lmod/etc/profile'] | path_join }} ]; then
+        source {{ [NSP_install_root, 'lmod/etc/profile'] | path_join }}
+    fi
+}
+
+########################################
+# User Content
+########################################
+
+{{ lookup('template', [playbook_dir, 'init/profile.j2'] | path_join, errors='ignore') | default('') }}
diff --git a/llvm/templates/module.lua.j2 b/llvm/templates/module.lua.j2
@@ -1,4 +1,4 @@
-{{ ansible_managed | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
+{{ NSP_template_header | comment(beginning='--[[', end=']]--', decoration='', prefix_count=0, postfix_count=0) }}
 {% set llvm_v_list = NSP_LLVM_version.split('.') %}
 
 family("compiler")

diff --git a/lmod/meta/main.yaml b/lmod/meta/main.yaml
@@ -1,3 +1,2 @@
 dependencies:
   - role: nsp
-  - role: init
diff --git a/lmod/tasks/external.yaml b/lmod/tasks/external.yaml