Source code for renku.core.workflow.value_resolution

# Copyright 2017-2023 - Swiss Data Science Center (SDSC)
# A partnership between École Polytechnique Fédérale de Lausanne (EPFL) and
# Eidgenössische Technische Hochschule Zürich (ETHZ).
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# See the License for the specific language governing permissions and
# limitations under the License.
"""Resolution of ``Workflow`` execution values precedence."""

import datetime
from abc import ABC, abstractmethod
from itertools import chain
from string import Formatter
from typing import Any, Dict, Iterable, Mapping, Optional, Set, Tuple, Union

from renku.core import errors
from renku.domain_model.workflow.composite_plan import CompositePlan
from renku.domain_model.workflow.parameter import CommandParameterBase, ParameterMapping
from renku.domain_model.workflow.plan import AbstractPlan, Plan

[docs]class TemplateVariableFormatter(Formatter): """Template variable formatter for `CommandParameterBase`.""" RESERVED_KEYS = ["iter_index"] def __init__(self): super().__init__()
[docs] def apply(self, param: str, parameters: Optional[Mapping[str, Any]] = None) -> str: """Renders the parameter template into its final value.""" if parameters is None: parameters = {} try: return super().vformat(param, args=[], kwargs=parameters) except KeyError as e: raise errors.ParameterError(f"Could not resolve the variable {str(e)}")
[docs] def get_value(self, key, args, kwargs): """Ignore some special keys when formatting the variable.""" if key in self.RESERVED_KEYS: return key return super().get_value(key, args, kwargs)
[docs] @staticmethod def to_map(parameters: Iterable[Union[CommandParameterBase, Tuple[str, str]]]) -> Mapping[str, str]: """Converts a list of `CommandParameterBase` into parameter name-value dictionary.""" return dict( map( lambda x: (, x.actual_value) if isinstance(x, CommandParameterBase) else (x[1], str(x[0])), parameters, ) )
[docs]class ValueResolver(ABC): """Value resolution class for an ``AbstractPlan``.""" def __init__(self, plan: AbstractPlan, values: Optional[Dict[str, Any]]): self._values = values self.missing_parameters: Set[str] = set() self._plan = plan self._template_engine = TemplateVariableFormatter()
[docs] @abstractmethod def apply(self) -> AbstractPlan: """Applies values and default_values to a potentially nested workflow. Returns: AbstractPlan: The ``AbstractPlan`` with the user provided values set. """ pass
[docs] @staticmethod def get(plan: AbstractPlan, values: Dict[str, Any]) -> "ValueResolver": """Factory method to obtain the specific ValueResolver for a workflow. Args: plan(AbstractPlan): a workflow. values(Dict[str, Any]): user defined dictionary of runtime values for the provided workflow. Returns: "ValueResolver": A ValueResolver object. """ return PlanValueResolver(plan, values) if isinstance(plan, Plan) else CompositePlanValueResolver(plan, values)
[docs]class PlanValueResolver(ValueResolver): """Value resolution class for a ``Plan``. Applies values and default_values to a workflow. """ def __init__(self, plan: Plan, values: Dict[str, Any]): super().__init__(plan, values)
[docs] def apply(self) -> AbstractPlan: """Applies values and default_values to a ``Plan``. Returns: A Plan with values applied. """ if self._values is None: return self._plan values_keys = set(self._values.keys()) for param in chain(self._plan.inputs, self._plan.parameters, self._plan.outputs): if in self._values: param.actual_value = self._values[] values_keys.discard( # NOTE: we need 2-pass the plan parameters as values can be overridden # that should be reflected in the params_map params_map = TemplateVariableFormatter.to_map(chain(self._plan.inputs, self._plan.parameters)) for param in chain(self._plan.inputs, self._plan.parameters, self._plan.outputs): if isinstance(param.actual_value, str): actual_value_set_before = getattr(param, "_v_actual_value_set", False) param.actual_value = self._template_engine.apply(param.actual_value, params_map) param._v_actual_value_set = actual_value_set_before self.missing_parameters = values_keys return self._plan
[docs]class CompositePlanValueResolver(ValueResolver): """Value resolution class for a ``CompositePlan``. Applies values and default_values to a nested workflow. Order of precedence is as follows (from lowest to highest): - Default value on a parameter - Default value on a mapping to the parameter - Value passed to a mapping to the parameter - Value passed to the parameter - Value propagated to a parameter from the source of a ParameterLink """ def __init__(self, plan: CompositePlan, values: Optional[Dict[str, Any]] = None): super().__init__(plan, values)
[docs] def apply(self) -> AbstractPlan: """Applies values and default_values to a ``CompositePlan``. Returns: A ``CompositePlan`` with values applied. """ if self._values: self._apply_parameters_values() for name, step in filter(lambda x: isinstance(x[1], dict), self._values.items()): child_workflow = next((w for w in self._plan.plans if == name), None) if not child_workflow: raise errors.ChildWorkflowNotFoundError(name, rv = ValueResolver.get(child_workflow, step) _ = rv.apply() self.missing_parameters.update({f"{name}.{mp}" for mp in rv.missing_parameters}) # apply defaults for mapping in self._plan.mappings: self._apply_parameter_defaults(mapping) apply_parameter_links(self._plan) return self._plan
def _apply_parameter_defaults(self, mapping: ParameterMapping) -> None: """Apply default values to a mapping and contained params if they're not set already. Args: mapping(ParameterMapping): The mapping to apply values to. """ if not mapping.actual_value_set and mapping.default_value: mapping.actual_value = mapping.default_value for mapped_to in mapping.mapped_parameters: if isinstance(mapped_to, ParameterMapping): self._apply_parameter_defaults(mapped_to) else: if not mapped_to.actual_value_set: mapped_to.actual_value = mapping.default_value def _apply_parameters_values(self) -> None: """Apply values to mappings of a CompositePlan.""" if self._values is None: return for k, v in filter(lambda x: not isinstance(x[1], dict), self._values.items()): mapping = next((m for m in self._plan.mappings if == k), None) if not mapping: self.missing_parameters.add(k) continue mapping.actual_value = v