artifact

Artifact implementation for negotiation card.

NegotiationCard

Bases: Artifact

The negotiation card contains information produced at MLTE negotiation points.

Source code in mlte/negotiation/artifact.py

class NegotiationCard(Artifact):
    """The negotiation card contains information produced at MLTE negotiation points."""

    type = ArtifactType.NEGOTIATION_CARD
    """Class attribute indicating type."""

    def __init__(
        self,
        identifier: Optional[str] = None,
        system: SystemDescriptor = SystemDescriptor(),
        data: List[DataDescriptor] = [],
        model: ModelDescriptor = ModelDescriptor(),
        quality_scenarios: List[QASDescriptor] = [],
    ) -> None:
        super().__init__(identifier)

        self.system = system
        """A descriptor for the system into which the model is integrated."""

        self.data = data
        """A collection of descriptors for relevant datasets."""

        self.model = model
        """A descriptor for the model."""

        self.quality_scenarios = quality_scenarios
        """A list of quality attribute scenarios."""

        self.level = ArtifactLevel.MODEL
        """Indicate that this type of artifact will exist at the model level."""

        # Add ids to QAS as needed.
        qas.add_qas_ids(self.identifier, self.quality_scenarios)

    # ----------------------------------------------------------------------------------
    # Serialization methods.
    # ----------------------------------------------------------------------------------
    # Overriden.
    def to_model(self) -> ArtifactModel:
        """Convert a negotation card artifact to its corresponding model."""
        return ArtifactModel(
            header=self.build_artifact_header(),
            body=NegotiationCardModel(
                system=self.system,
                data=self.data,
                model=self.model,
                system_requirements=self.quality_scenarios,
            ),
        )

    # Overriden.
    @classmethod
    def from_model(cls, model: BaseModel) -> NegotiationCard:
        """Convert a negotiation card model to its corresponding artifact."""
        assert isinstance(
            model, ArtifactModel
        ), "Can't create object from non-ArtifactModel model."
        assert (
            model.header.type == ArtifactType.NEGOTIATION_CARD
        ), "Type should be NegotiationCard."
        body = typing.cast(NegotiationCardModel, model.body)
        return NegotiationCard(
            identifier=model.header.identifier,
            system=body.system,
            data=body.data,
            model=body.model,
            quality_scenarios=body.system_requirements,
        )

    # Overriden.
    @classmethod
    def load(cls, identifier: Optional[str] = None) -> NegotiationCard:
        """
        Load a NegotiationCard from the configured global session.
        :param identifier: The identifier for the artifact. If None,
        the default id is used.
        """
        card = super().load(identifier)
        return typing.cast(NegotiationCard, card)

    # Overriden.
    def pre_save_hook(self, context: Context, store: ArtifactStore) -> None:
        """
        Override Artifact.pre_save_hook(). Ensures that QAS that done have ids are assigned them.
        :param context: The context in which to save the artifact
        :param store: The store in which to save the artifact
        :raises RuntimeError: On broken invariant
        """
        # Add ids to QAS as needed.
        qas.add_qas_ids(self.identifier, self.quality_scenarios)

    # ----------------------------------------------------------------------------------
    # Helper methods.
    # ----------------------------------------------------------------------------------

    # Overriden.
    def __eq__(self, other: object) -> bool:
        if not isinstance(other, NegotiationCard):
            return False
        return self._equal(other)

    def print_quality_scenarios(self):
        """Prints the scenarios in a user-friendly way."""
        for scenario in self.quality_scenarios:
            print(scenario)

data = data instance-attribute

A collection of descriptors for relevant datasets.

level = ArtifactLevel.MODEL instance-attribute

Indicate that this type of artifact will exist at the model level.

model = model instance-attribute

A descriptor for the model.

quality_scenarios = quality_scenarios instance-attribute

A list of quality attribute scenarios.

system = system instance-attribute

A descriptor for the system into which the model is integrated.

type = ArtifactType.NEGOTIATION_CARD class-attribute instance-attribute

Class attribute indicating type.

from_model(model) classmethod

Convert a negotiation card model to its corresponding artifact.

Source code in mlte/negotiation/artifact.py

@classmethod
def from_model(cls, model: BaseModel) -> NegotiationCard:
    """Convert a negotiation card model to its corresponding artifact."""
    assert isinstance(
        model, ArtifactModel
    ), "Can't create object from non-ArtifactModel model."
    assert (
        model.header.type == ArtifactType.NEGOTIATION_CARD
    ), "Type should be NegotiationCard."
    body = typing.cast(NegotiationCardModel, model.body)
    return NegotiationCard(
        identifier=model.header.identifier,
        system=body.system,
        data=body.data,
        model=body.model,
        quality_scenarios=body.system_requirements,
    )

load(identifier=None) classmethod

Load a NegotiationCard from the configured global session.

Parameters:

Name	Type	Description	Default
identifier	Optional[str]	The identifier for the artifact. If None, the default id is used.	None

Source code in mlte/negotiation/artifact.py

@classmethod
def load(cls, identifier: Optional[str] = None) -> NegotiationCard:
    """
    Load a NegotiationCard from the configured global session.
    :param identifier: The identifier for the artifact. If None,
    the default id is used.
    """
    card = super().load(identifier)
    return typing.cast(NegotiationCard, card)

pre_save_hook(context, store)

Override Artifact.pre_save_hook(). Ensures that QAS that done have ids are assigned them.

Parameters:

Name	Type	Description	Default
context	Context	The context in which to save the artifact	required
store	ArtifactStore	The store in which to save the artifact	required

Raises:

Type	Description
RuntimeError	On broken invariant

Source code in mlte/negotiation/artifact.py

def pre_save_hook(self, context: Context, store: ArtifactStore) -> None:
    """
    Override Artifact.pre_save_hook(). Ensures that QAS that done have ids are assigned them.
    :param context: The context in which to save the artifact
    :param store: The store in which to save the artifact
    :raises RuntimeError: On broken invariant
    """
    # Add ids to QAS as needed.
    qas.add_qas_ids(self.identifier, self.quality_scenarios)

print_quality_scenarios()

Prints the scenarios in a user-friendly way.

Source code in mlte/negotiation/artifact.py

def print_quality_scenarios(self):
    """Prints the scenarios in a user-friendly way."""
    for scenario in self.quality_scenarios:
        print(scenario)

to_model()

Convert a negotation card artifact to its corresponding model.

Source code in mlte/negotiation/artifact.py

def to_model(self) -> ArtifactModel:
    """Convert a negotation card artifact to its corresponding model."""
    return ArtifactModel(
        header=self.build_artifact_header(),
        body=NegotiationCardModel(
            system=self.system,
            data=self.data,
            model=self.model,
            system_requirements=self.quality_scenarios,
        ),
    )