frogml-core 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

frogml_core/__init__.py

@@ -0,0 +1,25 @@
+"""Top-level package for frogml."""
+
+__author__ = "jfrog"
+__version__ = "0.0.2"
+
+from frogml_core.inner.di_configuration import wire_dependencies
+from frogml_core.model.model_version_tracking import (  # noqa: F401,E501
+    log_metric,
+    log_param,
+)
+from frogml_core.model_loggers.artifact_logger import (  # noqa: F401,E501
+    load_file,
+    log_file,
+)
+from frogml_core.model_loggers.data_logger import load_data, log_data  # noqa: F401
+from frogml_core.model_loggers.model_logger import (  # noqa: F401,E501
+    load_model,
+    log_model,
+)
+
+from .frogml_client.client import FrogMLClient  # noqa: F401
+from .model.decorators.api import api_decorator as api  # noqa: F401
+from .model.decorators.timer import frogml_timer  # noqa: F401
+
+_container = wire_dependencies()

frogml_core/automations/__init__.py

@@ -0,0 +1,70 @@
+from frogml_core.automations.automations import (
+    Action,
+    Automation,
+    AutomationAudit,
+    CustomWebhook,
+    Metric,
+    MetricBasedTrigger,
+    NoneTrigger,
+    Notification,
+    ScheduledTrigger,
+    SlackNotification,
+    SqlMetric,
+    ThresholdDirection,
+    Trigger,
+)
+from frogml_core.automations.batch_execution_action import (
+    BatchExecution,
+    BatchJobDataSpecifications,
+    BatchJobExecutionSpecifications,
+)
+from frogml_core.automations.build_and_deploy_action import (
+    AggregationType,
+    AutoScaleQuerySpec,
+    AutoScaleTrigger,
+    AutoScalingConfig,
+    AutoScalingPrometheusTrigger,
+    BuildMetric,
+    BuildSpecifications,
+    ClientResources,
+    CpuResources,
+    DeploymentCondition,
+    DeploymentSpecifications,
+    FrogmlBuildDeploy,
+    GpuResources,
+    MetricType,
+    Resources,
+)
+
+__all__ = [
+    "Action",
+    "AggregationType",
+    "Automation",
+    "AutomationAudit",
+    "AutoScaleQuerySpec",
+    "AutoScaleTrigger",
+    "AutoScalingConfig",
+    "AutoScalingPrometheusTrigger",
+    "BuildMetric",
+    "BuildSpecifications",
+    "CpuResources",
+    "CustomWebhook",
+    "DeploymentCondition",
+    "DeploymentSpecifications",
+    "GpuResources",
+    "Metric",
+    "MetricBasedTrigger",
+    "MetricType",
+    "NoneTrigger",
+    "Notification",
+    "FrogmlBuildDeploy",
+    "Resources",
+    "ScheduledTrigger",
+    "SlackNotification",
+    "SqlMetric",
+    "ThresholdDirection",
+    "Trigger",
+    "BatchExecution",
+    "BatchJobDataSpecifications",
+    "BatchJobExecutionSpecifications",
+]

frogml_core/automations/automation_executions.py

@@ -0,0 +1,99 @@
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+
+from google.protobuf.timestamp_pb2 import Timestamp
+
+from frogml_proto.qwak.automation.v1.automation_execution_pb2 import (
+    AutomationExecutionMessage,
+    ExecutionRunDetailsMessage,
+    ExecutionStatusMessage,
+)
+
+
+class ExecutionStatus(Enum):
+    UNDEFINED = 0
+    RUNNING = 1
+    SUCCESSFUL = 2
+    FAILED = 3
+
+
+execution_status_to_proto_map = {
+    ExecutionStatus.UNDEFINED: ExecutionStatusMessage.UNDEFINED,
+    ExecutionStatus.RUNNING: ExecutionStatusMessage.RUNNING,
+    ExecutionStatus.FAILED: ExecutionStatusMessage.FAILED,
+    ExecutionStatus.SUCCESSFUL: ExecutionStatusMessage.SUCCESSFUL,
+}
+
+proto_status_to_execution_status_map = {
+    v: k for k, v in execution_status_to_proto_map.items()
+}
+
+
+@dataclass
+class ExecutionRunDetails:
+    start_time: datetime = field(default=None)
+    end_time: datetime = field(default=None)
+    error_details: str = field(default="")
+    status: ExecutionStatus = field(default=ExecutionStatus.UNDEFINED)
+    task: str = field(default="")
+    finish_cause: str = field(default="")
+
+    def to_proto(self):
+        start_time_timestamp = None
+        end_time_timestamp = None
+        if self.start_time:
+            start_time_timestamp = Timestamp()
+            start_time_timestamp.FromDatetime(self.start_time)
+
+        if self.end_time:
+            end_time_timestamp = Timestamp()
+            end_time_timestamp.FromDatetime(self.end_time)
+
+        return ExecutionRunDetailsMessage(
+            start_time=start_time_timestamp,
+            end_time=end_time_timestamp,
+            error_details=self.error_details,
+            status=execution_status_to_proto_map.get(self.status),
+            task=self.task,
+            finish_cause=self.finish_cause,
+        )
+
+    @staticmethod
+    def from_proto(message: ExecutionRunDetailsMessage):
+        return ExecutionRunDetails(
+            start_time=(
+                datetime.fromtimestamp(
+                    message.start_time.seconds + message.start_time.nanos / 1e9
+                )
+                if message.start_time
+                else None
+            ),
+            end_time=(
+                datetime.fromtimestamp(
+                    message.end_time.seconds + message.end_time.nanos / 1e9
+                )
+                if message.end_time
+                else None
+            ),
+            status=proto_status_to_execution_status_map.get(message.status),
+            task=message.task,
+            error_details=message.error_details,
+            finish_cause=message.finish_cause,
+        )
+
+
+@dataclass
+class AutomationExecution:
+    execution_id: str = field(default="")
+    run_details: ExecutionRunDetails = field(default_factory=ExecutionRunDetails)
+
+    @staticmethod
+    def from_proto(message: AutomationExecutionMessage):
+        return AutomationExecution(
+            execution_id=message.execution_id,
+            run_details=ExecutionRunDetails.from_proto(message.run_details),
+        )
+
+    def __str__(self):
+        return f"Id: {self.execution_id}\nDetails:\nStart Time:\t{self.run_details.start_time}\nEnd Time:\t{self.run_details.end_time}\nStatus:\t{self.run_details.status.name}\n"

frogml_core/automations/automations.py

@@ -0,0 +1,396 @@
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Dict
+
+from google.protobuf.timestamp_pb2 import Timestamp
+
+from frogml_proto.qwak.automation.v1.automation_pb2 import (
+    Automation as AutomationProto,
+)
+from frogml_proto.qwak.automation.v1.automation_pb2 import (
+    AutomationAudit as AutomationAuditProto,
+)
+from frogml_proto.qwak.automation.v1.automation_pb2 import (
+    AutomationSpec as AutomationSpecProto,
+)
+from frogml_proto.qwak.automation.v1.common_pb2 import Metric as MetricProto
+from frogml_proto.qwak.automation.v1.common_pb2 import SqlMetric as SqlMetricProto
+from frogml_proto.qwak.automation.v1.notification_pb2 import (
+    CustomWebhook as CustomWebhookProto,
+)
+from frogml_proto.qwak.automation.v1.notification_pb2 import (
+    HttpMethodType as HttpMethodTypeProto,
+)
+from frogml_proto.qwak.automation.v1.notification_pb2 import (
+    Notification as NotificationProto,
+)
+from frogml_proto.qwak.automation.v1.notification_pb2 import (
+    PostSlackNotification as PostSlackNotificationProto,
+)
+from frogml_proto.qwak.automation.v1.trigger_pb2 import (
+    MetricBasedTrigger as MetricBasedTriggerProto,
+)
+from frogml_proto.qwak.automation.v1.trigger_pb2 import NoneTrigger as NoneTriggerProto
+from frogml_proto.qwak.automation.v1.trigger_pb2 import (
+    OnBoardingTrigger as OnBoardingTriggerProto,
+)
+from frogml_proto.qwak.automation.v1.trigger_pb2 import (
+    ScheduledTrigger as ScheduledTriggerProto,
+)
+from frogml_proto.qwak.automation.v1.trigger_pb2 import Trigger as TriggerProto
+from frogml_core.automations.batch_execution_action import BatchExecution
+from frogml_core.automations.build_and_deploy_action import FrogmlBuildDeploy
+from frogml_core.automations.common import (
+    Action,
+    ThresholdDirection,
+    map_proto_threshold_to_direction,
+    map_threshold_direction_to_proto,
+)
+
+
+@dataclass
+class Trigger(ABC):
+    def to_proto(self):
+        # abstract method
+        pass
+
+    @staticmethod
+    @abstractmethod
+    def from_proto(message: TriggerProto):
+        # abstract method
+        pass
+
+
+@dataclass
+class Metric(ABC):
+    @abstractmethod
+    def to_proto(self):
+        # abstract method
+        pass
+
+    @staticmethod
+    @abstractmethod
+    def from_proto(message: MetricProto):
+        # abstract method
+        pass
+
+
+@dataclass
+class ScheduledTrigger(Trigger):
+    cron: str = field(default="")
+    interval: str = field(default="")
+
+    def to_proto(self):
+        return (
+            TriggerProto(
+                scheduled_trigger=ScheduledTriggerProto(interval=self.interval)
+            )
+            if self.interval
+            else TriggerProto(scheduled_trigger=ScheduledTriggerProto(cron=self.cron))
+        )
+
+    @staticmethod
+    def from_proto(message: TriggerProto):
+        return ScheduledTrigger(
+            cron=message.scheduled_trigger.cron,
+            interval=message.scheduled_trigger.interval,
+        )
+
+
+@dataclass
+class MetricBasedTrigger(Trigger):
+    name: str = field(default="")
+    metric: Metric = field(default="")
+    direction: ThresholdDirection = field(default=ThresholdDirection.ABOVE)
+    threshold: str = field(default="")
+    override_cron: str = field(default="")
+
+    def to_proto(self):
+        return TriggerProto(
+            metric_based_trigger=MetricBasedTriggerProto(
+                name=self.name,
+                threshold=self.threshold,
+                metric=self.metric.to_proto(),
+                threshold_direction=map_threshold_direction_to_proto(self.direction),
+                override_cron=self.override_cron,
+            )
+        )
+
+    @staticmethod
+    def from_proto(message: TriggerProto):
+        metric = map_metric_name_to_class(
+            message.metric_based_trigger.metric.WhichOneof("metric")
+        )
+        return MetricBasedTrigger(
+            name=message.metric_based_trigger.name,
+            metric=(
+                metric.from_proto(message.metric_based_trigger.metric)
+                if metric
+                else None
+            ),
+            threshold=message.metric_based_trigger.threshold,
+            direction=map_proto_threshold_to_direction(
+                message.metric_based_trigger.threshold_direction
+            ),
+            override_cron=message.metric_based_trigger.override_cron,
+        )
+
+
+@dataclass
+class NoneTrigger(Trigger):
+    def to_proto(self):
+        return TriggerProto(none_trigger=NoneTriggerProto())
+
+    @staticmethod
+    def from_proto(message: TriggerProto):
+        return NoneTrigger()
+
+
+@dataclass
+class OnBoardingTrigger(Trigger):
+    def to_proto(self):
+        return TriggerProto(on_boarding_trigger=OnBoardingTriggerProto())
+
+    @staticmethod
+    def from_proto(message: TriggerProto):
+        return OnBoardingTrigger()
+
+
+@dataclass
+class SqlMetric(Metric):
+    sql_query: str = field(default="")
+
+    def to_proto(self):
+        return MetricProto(sql_metric=SqlMetricProto(sql_query=self.sql_query))
+
+    @staticmethod
+    def from_proto(message: MetricProto):
+        return SqlMetric(sql_query=message.sql_metric.sql_query)
+
+
+@dataclass
+class Notification(ABC):
+    def to_proto(self):
+        # abstract method
+        pass
+
+    @staticmethod
+    @abstractmethod
+    def from_proto(message: TriggerProto):
+        # abstract method
+        pass
+
+
+@dataclass
+class SlackNotification(Notification):
+    webhook: str = field(default="")
+
+    def to_proto(self):
+        return NotificationProto(
+            post_slack_notification=PostSlackNotificationProto(
+                webhook=self.webhook,
+            )
+        )
+
+    @staticmethod
+    def from_proto(message: NotificationProto):
+        return SlackNotification(
+            webhook=message.post_slack_notification.webhook,
+        )
+
+    def __str__(self):
+        return f"Slack Notification:\n webhook:{self.webhook}\n"
+
+
+@dataclass
+class CustomWebhook(Notification):
+    url: str = field(default="")
+    http_method: str = field(default="GET")
+    headers: Dict[str, str] = field(default_factory=dict)
+    data: Dict[str, str] = field(default_factory=dict)
+
+    _HTTP_NAME_TO_STATUS_MAPPING = {
+        "GET": HttpMethodTypeProto.HTTP_METHOD_TYPE_GET,
+        "POST": HttpMethodTypeProto.HTTP_METHOD_TYPE_POST,
+        "PUT": HttpMethodTypeProto.HTTP_METHOD_TYPE_PUT,
+        "PATCH": HttpMethodTypeProto.HTTP_METHOD_TYPE_PATCH,
+        "DELETE": HttpMethodTypeProto.HTTP_METHOD_TYPE_DELETE,
+        "HEAD": HttpMethodTypeProto.HTTP_METHOD_TYPE_HEAD,
+    }
+
+    _HTTP_STATUS_TO_NAME_MAPPING = {
+        v: k for k, v in _HTTP_NAME_TO_STATUS_MAPPING.items()
+    }
+
+    def __post_init__(self):
+        if self.http_method.upper() not in self._HTTP_NAME_TO_STATUS_MAPPING.keys():
+            raise ValueError(
+                f"HTTP method {self.http_method} is not a valid method. Available options are "
+                f"{list(self._HTTP_NAME_TO_STATUS_MAPPING.keys())}"
+            )
+
+    def to_proto(self):
+        return NotificationProto(
+            custom_webhook=CustomWebhookProto(
+                url=self.url,
+                http_method=self._HTTP_NAME_TO_STATUS_MAPPING.get(
+                    self.http_method.upper()
+                ),
+                headers=self.headers,
+                data=self.data,
+            )
+        )
+
+    @staticmethod
+    def from_proto(message: NotificationProto):
+        return CustomWebhook(
+            url=message.custom_webhook.url,
+            data=message.custom_webhook.data,
+            headers=message.custom_webhook.headers,
+            http_method=CustomWebhook._HTTP_STATUS_TO_NAME_MAPPING.get(
+                message.custom_webhook.http_method
+            ),
+        )
+
+    def __str__(self):
+        return f"Custom webhook:\n url:{self.url}\n data:{self.data}\n headers:{self.headers}\n http method:{self.http_method}\n"
+
+
+@dataclass
+class AutomationAudit(ABC):
+    date: datetime = field(default=datetime.now())
+    user_id: str = field(default="")
+
+    def to_proto(self):
+        timestamp = Timestamp()
+        timestamp.FromDatetime(self.date)
+        return AutomationAuditProto(user_id=self.user_id, date=timestamp)
+
+    @staticmethod
+    def from_proto(message: AutomationAuditProto):
+        return AutomationAudit(
+            user_id=message.user_id,
+            date=datetime.fromtimestamp(
+                message.date.seconds + message.date.nanos / 1e9
+            ),
+        )
+
+
+@dataclass
+class Automation:
+    id: str = field(default="")
+    name: str = field(default="")
+    model_id: str = field(default="")
+    execute_immediately: bool = field(default=False)
+    trigger: Trigger = field(default_factory=Trigger)
+    action: Action = field(default_factory=Action)
+    description: str = field(default="")
+    environment: str = field(default="")
+    is_enabled: bool = field(default=True)
+    is_deleted: bool = field(default=False)
+    is_sdk_v1: bool = field(default=False)
+    create_audit: AutomationAudit = field(default_factory=AutomationAudit)
+    on_error: Notification = field(default=None)
+    on_success: Notification = field(default=None)
+
+    def to_proto(self):
+        return AutomationProto(
+            automation_id=self.id,
+            automation_spec=AutomationSpecProto(
+                automation_name=self.name,
+                is_enabled=self.is_enabled,
+                is_sdk_v1=self.is_sdk_v1,
+                execute_immediately=self.execute_immediately,
+                model_id=self.model_id,
+                action=self.action.to_proto(),
+                trigger=self.trigger.to_proto() if self.trigger is not None else None,
+                on_error=(
+                    self.on_error.to_proto() if self.on_error is not None else None
+                ),
+                on_success=(
+                    self.on_success.to_proto() if self.on_success is not None else None
+                ),
+            ),
+            qwak_environment_id=self.environment,
+            create_audit=self.create_audit.to_proto(),
+            is_deleted=self.is_deleted,
+        )
+
+    @staticmethod
+    def from_proto(message: AutomationProto):
+        action = map_action_name_to_class(
+            message.automation_spec.action.WhichOneof("action")
+        )
+        trigger = map_trigger_name_to_class(
+            message.automation_spec.trigger.WhichOneof("trigger")
+        )
+        on_error_notification = map_notification_name_to_class(
+            message.automation_spec.on_error.WhichOneof("notification")
+        )
+        on_success_notification = map_notification_name_to_class(
+            message.automation_spec.on_success.WhichOneof("notification")
+        )
+
+        return Automation(
+            id=message.automation_id,
+            name=message.automation_spec.automation_name,
+            description=message.automation_spec.automation_description,
+            execute_immediately=message.automation_spec.execute_immediately,
+            model_id=message.automation_spec.model_id,
+            is_enabled=message.automation_spec.is_enabled,
+            is_sdk_v1=message.automation_spec.is_sdk_v1,
+            is_deleted=message.is_deleted,
+            action=(
+                action.from_proto(message.automation_spec.action) if action else None
+            ),
+            trigger=(
+                trigger.from_proto(message.automation_spec.trigger) if trigger else None
+            ),
+            environment=message.qwak_environment_id,
+            create_audit=AutomationAudit.from_proto(message.create_audit),
+            on_error=(
+                on_error_notification.from_proto(message.automation_spec.on_error)
+                if on_error_notification
+                else None
+            ),
+            on_success=(
+                on_success_notification.from_proto(message.automation_spec.on_success)
+                if on_success_notification
+                else None
+            ),
+        )
+
+    def __str__(self):
+        on_error = f"\nOn Error: {self.on_error}" if self.on_error else ""
+        on_success = f"\nOn Success: {self.on_success}" if self.on_success else ""
+        return f"Id: {self.id}\tName: {self.name}\tModel: {self.model_id}\nDescription: {self.description}\nAction: {self.action}\nTrigger: {self.trigger}{on_error}{on_success}"
+
+
+def map_notification_name_to_class(notification_name: str):
+    mapping = {
+        "post_slack_notification": SlackNotification,
+        "custom_webhook": CustomWebhook,
+    }
+    return mapping.get(notification_name)
+
+
+def map_action_name_to_class(action_name: str):
+    mapping = {"build_deploy": FrogmlBuildDeploy, "batch_execution": BatchExecution}
+    return mapping.get(action_name)
+
+
+def map_trigger_name_to_class(trigger_name: str):
+    mapping = {
+        "scheduled_trigger": ScheduledTrigger,
+        "metric_based_trigger": MetricBasedTrigger,
+        "none_trigger": NoneTrigger,
+        "on_boarding_trigger": OnBoardingTrigger,
+    }
+
+    return mapping.get(trigger_name)
+
+
+def map_metric_name_to_class(metric_name: str):
+    mapping = {"sql_metric": SqlMetric}
+    return mapping.get(metric_name)