spack.modules package

Submodules

spack.modules.common module

Here we consolidate the logic for creating an abstract description of the information that module systems need.

This information maps a single spec to:

  • a unique module filename

  • the module file content

and is divided among four classes:

  • a configuration class that provides a convenient interface to query details about the configuration for the spec under consideration.

  • a layout class that provides the information associated with module file names and directories

  • a context class that provides the dictionary used by the template engine to generate the module file

  • a writer that collects and uses the information above to either write or remove the module file

Each of the four classes needs to be sub-classed when implementing a new module type.

class spack.modules.common.BaseConfiguration(spec, module_set_name)[source]

Bases: object

Manipulates the information needed to generate a module file to make querying easier. It needs to be sub-classed for specific module types.

property blacklisted

Returns True if the module has been blacklisted, False otherwise.

property context
default_projections = {'all': '{name}-{version}-{compiler.name}-{compiler.version}'}
property defaults

Returns the specs configured as defaults or [].

property env

List of environment modifications that should be done in the module.

property environment_blacklist

List of variables that should be left unmodified.

property hash

Hash tag for the module or None

property literals_to_load

List of literal modules to be loaded.

property projections

Projection from specs to module names

property specs_to_load

List of specs that should be loaded in the module file.

property specs_to_prereq

List of specs that should be prerequisite of the module file.

property suffixes

List of suffixes that should be appended to the module file name.

property template

Returns the name of the template to use for the module file or None if not specified in the configuration.

property verbose

Returns True if the module file needs to be verbose, False otherwise

class spack.modules.common.BaseContext(configuration)[source]

Bases: spack.tengine.Context

Provides the base context needed for template rendering.

This class needs to be sub-classed for specific module types. The following attributes need to be implemented:

  • fields

property autoload

List of modules that needs to be loaded automatically.

property category
property configure_options
context_properties = ['spec', 'timestamp', 'category', 'short_description', 'long_description', 'configure_options', 'environment_modifications', 'autoload', 'verbose']
property environment_modifications

List of environment modifications to be processed.

property long_description
property short_description
property spec
property timestamp
property verbose

Verbosity level.

class spack.modules.common.BaseFileLayout(configuration)[source]

Bases: object

Provides information on the layout of module files. Needs to be sub-classed for specific module types.

dirname()[source]

Root folder for module files of this type.

extension = None

This needs to be redefined

property filename

Name of the module file for the current spec.

property spec

Spec under consideration

property use_name

Returns the ‘use’ name of the module i.e. the name you have to type to console to use it. This implementation fits the needs of most non-hierarchical layouts.

class spack.modules.common.BaseModuleFileWriter(spec, module_set_name)[source]

Bases: object

remove()[source]

Deletes the module file.

update_module_defaults()[source]
write(overwrite=False)[source]

Writes the module file.

Parameters

overwrite (bool) – if True it is fine to overwrite an already existing file. If False the operation is skipped an we print a warning to the user.

exception spack.modules.common.DefaultTemplateNotDefined[source]

Bases: AttributeError, spack.modules.common.ModulesError

Raised if the attribute ‘default_template’ has not been specified in the derived classes.

class spack.modules.common.ModuleIndexEntry(path, use_name)

Bases: tuple

property path

Alias for field number 0

property use_name

Alias for field number 1

exception spack.modules.common.ModuleNotFoundError(message, long_message=None)[source]

Bases: spack.modules.common.ModulesError

Raised when a module cannot be found for a spec

exception spack.modules.common.ModulesError(message, long_message=None)[source]

Bases: spack.error.SpackError

Base error for modules.

exception spack.modules.common.ModulesTemplateNotFoundError(message, long_message=None)[source]

Bases: spack.modules.common.ModulesError, RuntimeError

Raised if the template for a module file was not found.

class spack.modules.common.UpstreamModuleIndex(local_db, module_indices)[source]

Bases: object

This is responsible for taking the individual module indices of all upstream Spack installations and locating the module for a given spec based on which upstream install it is located in.

upstream_module(spec, module_type)[source]
spack.modules.common.configuration(module_set_name)[source]
spack.modules.common.dependencies(spec, request='all')[source]

Returns the list of dependent specs for a given spec, according to the request passed as parameter.

Parameters
  • spec – spec to be analyzed

  • request – either ‘none’, ‘direct’ or ‘all’

Returns

list of dependencies

The return list will be empty if request is ‘none’, will contain the direct dependencies if request is ‘direct’, or the entire DAG if request is ‘all’.

spack.modules.common.disable_modules()[source]

Disable the generation of modulefiles within the context manager.

spack.modules.common.generate_module_index(root, modules, overwrite=False)[source]
spack.modules.common.get_module(module_type, spec, get_full_path, module_set_name='default', required=True)[source]

Retrieve the module file for a given spec and module type.

Retrieve the module file for the given spec if it is available. If the module is not available, this will raise an exception unless the module is blacklisted or if the spec is installed upstream.

Parameters
  • module_type – the type of module we want to retrieve (e.g. lmod)

  • spec – refers to the installed package that we want to retrieve a module for

  • required – if the module is required but blacklisted, this function will print a debug message. If a module is missing but not blacklisted, then an exception is raised (regardless of whether it is required)

  • get_full_path – if True, this returns the full path to the module. Otherwise, this returns the module name.

  • module_set_name – the named module configuration set from modules.yaml for which to retrieve the module.

Returns

The module name or path. May return None if the module is not available.

spack.modules.common.merge_config_rules(configuration, spec)[source]

Parses the module specific part of a configuration and returns a dictionary containing the actions to be performed on the spec passed as an argument.

Parameters
  • configuration – module specific configuration (e.g. entries under the top-level ‘tcl’ key)

  • spec – spec for which we need to generate a module file

Returns

actions to be taken on the spec passed as an argument

Return type

dict

spack.modules.common.read_module_index(root)[source]
spack.modules.common.read_module_indices()[source]
spack.modules.common.root_path(name, module_set_name)[source]

Returns the root folder for module file installation.

Parameters
  • name – name of the module system to be used (e.g. ‘tcl’)

  • module_set_name – name of the set of module configs to use

Returns

root folder for module file installation

spack.modules.common.update_dictionary_extending_lists(target, update)[source]

Updates a dictionary, but extends lists instead of overriding them.

Parameters
  • target – dictionary to be updated

  • update – update to be applied

spack.modules.lmod module

exception spack.modules.lmod.CoreCompilersNotFoundError(message, long_message=None)[source]

Bases: spack.error.SpackError, KeyError

Error raised if the key ‘core_compilers’ has not been specified in the configuration file.

class spack.modules.lmod.LmodConfiguration(spec, module_set_name)[source]

Bases: spack.modules.common.BaseConfiguration

Configuration class for lmod module files.

property available

Returns a dictionary of the services that are currently available.

property core_compilers

Returns the list of “Core” compilers

Raises

CoreCompilersNotFoundError – if the key was not specified in the configuration file or the sequence is empty

property core_specs

Returns the list of “Core” specs

default_projections = {'all': '{name}/{version}'}
property hierarchy_tokens

Returns the list of tokens that are part of the modulefile hierarchy. ‘compiler’ is always present.

property missing

Returns the list of tokens that are not available.

property provides

Returns a dictionary mapping all the services provided by this spec to the spec itself.

property requires

Returns a dictionary mapping all the requirements of this spec to the actual provider. ‘compiler’ is always present among the requirements.

class spack.modules.lmod.LmodContext(configuration)[source]

Bases: spack.modules.common.BaseContext

Context class for lmod module files.

property conditionally_unlocked_paths

Returns the list of paths that are unlocked conditionally. Each item in the list is a tuple with the structure (condition, path).

context_properties = ['has_modulepath_modifications', 'has_conditional_modifications', 'name_part', 'version_part', 'provides', 'missing', 'unlocked_paths', 'conditionally_unlocked_paths', 'spec', 'timestamp', 'category', 'short_description', 'long_description', 'configure_options', 'environment_modifications', 'autoload', 'verbose']
property has_conditional_modifications

True if this module modifies MODULEPATH conditionally to the presence of other services in the environment, False otherwise.

property has_modulepath_modifications

True if this module modifies MODULEPATH, False otherwise.

property missing

Returns a list of missing services.

property name_part

Name of this provider.

property provides

Returns the dictionary of provided services.

property unlocked_paths

Returns the list of paths that are unlocked unconditionally.

property version_part

Version of this provider.

class spack.modules.lmod.LmodFileLayout(configuration)[source]

Bases: spack.modules.common.BaseFileLayout

File layout for lmod module files.

property arch_dirname

Returns the root folder for THIS architecture

property available_path_parts

List of path parts that are currently available. Needed to construct the file name.

extension = 'lua'

file extension of lua module files

property filename

Returns the filename for the current module file

token_to_path(name, value)[source]

Transforms a hierarchy token into the corresponding path part.

Parameters
  • name (str) – name of the service in the hierarchy

  • value – actual provider of the service

Returns

part of the path associated with the service

Return type

str

property unlocked_paths

Returns a dictionary mapping conditions to a list of unlocked paths.

The paths that are unconditionally unlocked are under the key ‘None’. The other keys represent the list of services you need loaded to unlock the corresponding paths.

class spack.modules.lmod.LmodModulefileWriter(spec, module_set_name)[source]

Bases: spack.modules.common.BaseModuleFileWriter

Writer class for lmod module files.

default_template = 'modules/modulefile.lua'
exception spack.modules.lmod.NonVirtualInHierarchyError(message, long_message=None)[source]

Bases: spack.error.SpackError, TypeError

Error raised if non-virtual specs are used as hierarchy tokens in the lmod section of ‘modules.yaml’.

spack.modules.lmod.configuration(module_set_name)[source]
spack.modules.lmod.guess_core_compilers(name, store=False)[source]

Guesses the list of core compilers installed in the system.

Parameters

store (bool) – if True writes the core compilers to the modules.yaml configuration file

Returns

List of core compilers, if found, or None

spack.modules.lmod.make_configuration(spec, module_set_name)[source]

Returns the lmod configuration for spec

spack.modules.lmod.make_context(spec, module_set_name)[source]

Returns the context information for spec

spack.modules.lmod.make_layout(spec, module_set_name)[source]

Returns the layout information for spec

spack.modules.tcl module

This module implements the classes necessary to generate TCL non-hierarchical modules.

class spack.modules.tcl.TclConfiguration(spec, module_set_name)[source]

Bases: spack.modules.common.BaseConfiguration

Configuration class for tcl module files.

property conflicts

Conflicts for this module file

class spack.modules.tcl.TclContext(configuration)[source]

Bases: spack.modules.common.BaseContext

Context class for tcl module files.

property conflicts

List of conflicts for the tcl module file.

context_properties = ['prerequisites', 'conflicts', 'spec', 'timestamp', 'category', 'short_description', 'long_description', 'configure_options', 'environment_modifications', 'autoload', 'verbose']
property prerequisites

List of modules that needs to be loaded automatically.

class spack.modules.tcl.TclFileLayout(configuration)[source]

Bases: spack.modules.common.BaseFileLayout

File layout for tcl module files.

class spack.modules.tcl.TclModulefileWriter(spec, module_set_name)[source]

Bases: spack.modules.common.BaseModuleFileWriter

Writer class for tcl module files.

default_template = 'modules/modulefile.tcl'
spack.modules.tcl.configuration(module_set_name)[source]
spack.modules.tcl.make_configuration(spec, module_set_name)[source]

Returns the tcl configuration for spec

spack.modules.tcl.make_context(spec, module_set_name)[source]

Returns the context information for spec

spack.modules.tcl.make_layout(spec, module_set_name)[source]

Returns the layout information for spec

Module contents

This package contains code for creating environment modules, which can include TCL non-hierarchical modules, LUA hierarchical modules, and others.

class spack.modules.LmodModulefileWriter(spec, module_set_name)[source]

Bases: spack.modules.common.BaseModuleFileWriter

Writer class for lmod module files.

default_template = 'modules/modulefile.lua'
class spack.modules.TclModulefileWriter(spec, module_set_name)[source]

Bases: spack.modules.common.BaseModuleFileWriter

Writer class for tcl module files.

default_template = 'modules/modulefile.tcl'
spack.modules.disable_modules()[source]

Disable the generation of modulefiles within the context manager.