mlrun 1.6.0rc35__py3-none-any.whl → 1.7.0rc2__py3-none-any.whl

mlrun/model_monitoring/stores/sql_model_endpoint_store.py

@@ -80,7 +80,7 @@ class SQLModelEndpointStore(ModelEndpointStore):
             self.ModelEndpointsTable.__table__  # pyright: ignore[reportGeneralTypeIssues]
         )
 
-    def write_model_endpoint(self, endpoint: typing.Dict[str, typing.Any]):
+    def write_model_endpoint(self, endpoint: dict[str, typing.Any]):
         """
         Create a new endpoint record in the SQL table. This method also creates the model endpoints table within the
         SQL database if not exist.
@@ -105,7 +105,7 @@ class SQLModelEndpointStore(ModelEndpointStore):
             )
 
     def update_model_endpoint(
-        self, endpoint_id: str, attributes: typing.Dict[str, typing.Any]
+        self, endpoint_id: str, attributes: dict[str, typing.Any]
     ):
         """
         Update a model endpoint record with a given attributes.
@@ -145,7 +145,7 @@ class SQLModelEndpointStore(ModelEndpointStore):
     def get_model_endpoint(
         self,
         endpoint_id: str,
-    ) -> typing.Dict[str, typing.Any]:
+    ) -> dict[str, typing.Any]:
         """
         Get a single model endpoint record.
 
@@ -175,10 +175,10 @@ class SQLModelEndpointStore(ModelEndpointStore):
         self,
         model: str = None,
         function: str = None,
-        labels: typing.List[str] = None,
+        labels: list[str] = None,
         top_level: bool = None,
-        uids: typing.List = None,
-    ) -> typing.List[typing.Dict[str, typing.Any]]:
+        uids: list = None,
+    ) -> list[dict[str, typing.Any]]:
         """
         Returns a list of model endpoint dictionaries, supports filtering by model, function, labels or top level.
         By default, when no filters are applied, all available model endpoints for the given project will
@@ -262,7 +262,7 @@ class SQLModelEndpointStore(ModelEndpointStore):
         query: db.orm.query.Query,
         model_endpoints_table: db.Table,
         key_filter: str,
-        filtered_values: typing.List,
+        filtered_values: list,
         combined=True,
     ) -> db.orm.query.Query:
         """Filtering the SQL query object according to the provided filters.
@@ -300,7 +300,7 @@ class SQLModelEndpointStore(ModelEndpointStore):
     @staticmethod
     def _validate_labels(
         endpoint_dict: dict,
-        labels: typing.List,
+        labels: list,
     ) -> bool:
         """Validate that the model endpoint dictionary has the provided labels. There are 2 possible cases:
         1 - Labels were provided as a list of key-values pairs (e.g. ['label_1=value_1', 'label_2=value_2']): Validate
@@ -334,9 +334,7 @@ class SQLModelEndpointStore(ModelEndpointStore):
 
         return True
 
-    def delete_model_endpoints_resources(
-        self, endpoints: typing.List[typing.Dict[str, typing.Any]]
-    ):
+    def delete_model_endpoints_resources(self, endpoints: list[dict[str, typing.Any]]):
         """
         Delete all model endpoints resources in both SQL and the time series DB.
 
@@ -352,11 +350,11 @@ class SQLModelEndpointStore(ModelEndpointStore):
     def get_endpoint_real_time_metrics(
         self,
         endpoint_id: str,
-        metrics: typing.List[str],
+        metrics: list[str],
         start: str = "now-1h",
         end: str = "now",
         access_key: str = None,
-    ) -> typing.Dict[str, typing.List[typing.Tuple[str, float]]]:
+    ) -> dict[str, list[tuple[str, float]]]:
         """
         Getting metrics from the time series DB. There are pre-defined metrics for model endpoints such as
         `predictions_per_second` and `latency_avg_5m` but also custom metrics defined by the user.

mlrun/model_monitoring/stream_processing.py

@@ -49,7 +49,7 @@ class EventStreamProcessor:
         parquet_batching_timeout_secs: int,
         parquet_target: str,
         sample_window: int = 10,
-        aggregate_windows: typing.Optional[typing.List[str]] = None,
+        aggregate_windows: typing.Optional[list[str]] = None,
         aggregate_period: str = "30s",
         model_monitoring_access_key: str = None,
     ):
@@ -629,14 +629,14 @@ class ProcessEndpointEvent(mlrun.feature_store.steps.MapClass):
         self.project: str = project
 
         # First and last requests timestamps (value) of each endpoint (key)
-        self.first_request: typing.Dict[str, str] = dict()
-        self.last_request: typing.Dict[str, str] = dict()
+        self.first_request: dict[str, str] = dict()
+        self.last_request: dict[str, str] = dict()
 
         # Number of errors (value) per endpoint (key)
-        self.error_count: typing.Dict[str, int] = collections.defaultdict(int)
+        self.error_count: dict[str, int] = collections.defaultdict(int)
 
         # Set of endpoints in the current events
-        self.endpoints: typing.Set[str] = set()
+        self.endpoints: set[str] = set()
 
     def do(self, full_event):
         event = full_event.body
@@ -745,18 +745,12 @@ class ProcessEndpointEvent(mlrun.feature_store.steps.MapClass):
         # in list of events. This list will be used as the body for the storey event.
         events = []
         for i, (feature, prediction) in enumerate(zip(features, predictions)):
-            # Validate that inputs are based on numeric values
-            if not self.is_valid(
-                endpoint_id,
-                self.is_list_of_numerics,
-                feature,
-                ["request", "inputs", f"[{i}]"],
-            ):
-                return None
-
             if not isinstance(prediction, list):
                 prediction = [prediction]
 
+            if not isinstance(feature, list):
+                feature = [feature]
+
             events.append(
                 {
                     EventFieldType.FUNCTION_URI: function_uri,
@@ -803,18 +797,6 @@ class ProcessEndpointEvent(mlrun.feature_store.steps.MapClass):
                 f"{self.last_request[endpoint_id]} - write to TSDB will be rejected"
             )
 
-    @staticmethod
-    def is_list_of_numerics(
-        field: typing.List[typing.Union[int, float, dict, list]],
-        dict_path: typing.List[str],
-    ):
-        if all(isinstance(x, int) or isinstance(x, float) for x in field):
-            return True
-        logger.error(
-            f"List does not consist of only numeric values: {field} [Event -> {','.join(dict_path)}]"
-        )
-        return False
-
     def resume_state(self, endpoint_id):
         # Make sure process is resumable, if process fails for any reason, be able to pick things up close to where we
         # left them
@@ -849,7 +831,7 @@ class ProcessEndpointEvent(mlrun.feature_store.steps.MapClass):
         endpoint_id: str,
         validation_function,
         field: typing.Any,
-        dict_path: typing.List[str],
+        dict_path: list[str],
     ):
         if validation_function(field, dict_path):
             return True
@@ -857,7 +839,7 @@ class ProcessEndpointEvent(mlrun.feature_store.steps.MapClass):
         return False
 
 
-def is_not_none(field: typing.Any, dict_path: typing.List[str]):
+def is_not_none(field: typing.Any, dict_path: list[str]):
     if field is not None:
         return True
     logger.error(
@@ -946,7 +928,7 @@ class MapFeatureNames(mlrun.feature_store.steps.MapClass):
                 return self.label_columns[endpoint_id]
         return None
 
-    def do(self, event: typing.Dict):
+    def do(self, event: dict):
         endpoint_id = event[EventFieldType.ENDPOINT_ID]
 
         # Get feature names and label columns
@@ -1045,9 +1027,9 @@ class MapFeatureNames(mlrun.feature_store.steps.MapClass):
 
     @staticmethod
     def _map_dictionary_values(
-        event: typing.Dict,
-        named_iters: typing.List,
-        values_iters: typing.List,
+        event: dict,
+        named_iters: list,
+        values_iters: list,
         mapping_dictionary: str,
     ):
         """Adding name-value pairs to event dictionary based on two provided lists of names and values. These pairs
@@ -1082,7 +1064,7 @@ class UpdateEndpoint(mlrun.feature_store.steps.MapClass):
         self.project = project
         self.model_endpoint_store_target = model_endpoint_store_target
 
-    def do(self, event: typing.Dict):
+    def do(self, event: dict):
         update_endpoint_record(
             project=self.project,
             endpoint_id=event.pop(EventFieldType.ENDPOINT_ID),
@@ -1117,7 +1099,7 @@ class InferSchema(mlrun.feature_store.steps.MapClass):
         self.table = table
         self.keys = set()
 
-    def do(self, event: typing.Dict):
+    def do(self, event: dict):
         key_set = set(event.keys())
         if not key_set.issubset(self.keys):
             self.keys.update(key_set)

mlrun/model_monitoring/tracking_policy.py

@@ -96,12 +96,13 @@ class TrackingPolicy(mlrun.model.ModelObj):
                 )
         return new_obj
 
-    def to_dict(self, fields=None, exclude=None):
+    def to_dict(self, fields: list = None, exclude: list = None, strip: bool = False):
         struct = super().to_dict(
             fields,
             exclude=[
                 mlrun.common.schemas.model_monitoring.EventFieldType.DEFAULT_BATCH_INTERVALS
             ],
+            strip=strip,
         )
         if self.default_batch_intervals:
             struct[

mlrun/package/__init__.py

@@ -18,7 +18,7 @@
 import functools
 import inspect
 from collections import OrderedDict
-from typing import Callable, Dict, List, Type, Union
+from typing import Callable, Union
 
 from ..config import config
 from .context_handler import ContextHandler
@@ -40,9 +40,9 @@ from .utils import (
 
 
 def handler(
-    labels: Dict[str, str] = None,
-    outputs: List[Union[str, Dict[str, str]]] = None,
-    inputs: Union[bool, Dict[str, Union[str, Type]]] = True,
+    labels: dict[str, str] = None,
+    outputs: list[Union[str, dict[str, str]]] = None,
+    inputs: Union[bool, dict[str, Union[str, type]]] = True,
 ):
     """
     MLRun's handler is a decorator to wrap a function and enable setting labels, parsing inputs (`mlrun.DataItem`) using
@@ -58,7 +58,7 @@ def handler(
                     * `str` - A string in the format of '{key}:{artifact_type}'. If a string was given without ':' it
                       will indicate the key, and the artifact type will be according to the returned value type's
                       default artifact type. The artifact types supported are listed in the relevant type packager.
-                    * `Dict[str, str]` - A dictionary of logging configuration. the key 'key' is mandatory for the
+                    * `dict[str, str]` - A dictionary of logging configuration. the key 'key' is mandatory for the
                       logged artifact key.
                     * None - Do not log the output.
 
@@ -73,7 +73,7 @@ def handler(
                    * True - Parse all found inputs to the assigned type hint in the function's signature. If there is no
                      type hint assigned, the value will remain an `mlrun.DataItem`.
                    * False - Do not parse inputs, leaving the inputs as `mlrun.DataItem`.
-                   * Dict[str, Union[Type, str]] - A dictionary with argument name as key and the expected type to parse
+                   * dict[str, Union[Type, str]] - A dictionary with argument name as key and the expected type to parse
                      the `mlrun.DataItem` to. The expected type can be a string as well, idicating the full module path.
 
                    Default: True - meaning inputs will be parsed from DataItem's as long as they are type hinted.

mlrun/package/context_handler.py

@@ -15,7 +15,7 @@
 import inspect
 import os
 from collections import OrderedDict
-from typing import Dict, List, Union
+from typing import Union
 
 from mlrun.datastore import DataItem
 from mlrun.errors import MLRunInvalidArgumentError
@@ -181,7 +181,7 @@ class ContextHandler:
     def log_outputs(
         self,
         outputs: list,
-        log_hints: List[Union[Dict[str, str], str, None]],
+        log_hints: list[Union[dict[str, str], str, None]],
     ):
         """
         Log the given outputs as artifacts (or results) with the stored context. Errors raised during the packing will
@@ -229,7 +229,7 @@ class ContextHandler:
         # Clear packagers outputs:
         self._packagers_manager.clear_packagers_outputs()
 
-    def set_labels(self, labels: Dict[str, str]):
+    def set_labels(self, labels: dict[str, str]):
         """
         Set the given labels with the stored context.
 
@@ -239,7 +239,7 @@ class ContextHandler:
             self._context.set_label(key=key, value=value)
 
     def _collect_packagers(
-        self, packagers: List[str], is_mandatory: bool, is_custom_packagers: bool
+        self, packagers: list[str], is_mandatory: bool, is_custom_packagers: bool
     ):
         """
         Collect packagers with the stored manager. The collection can ignore errors raised by setting the mandatory flag
@@ -310,7 +310,7 @@ class ContextHandler:
     def _validate_objects_to_log_hints_length(
         self,
         outputs: list,
-        log_hints: List[Union[Dict[str, str], str, None]],
+        log_hints: list[Union[dict[str, str], str, None]],
     ):
         """
         Validate the outputs and log hints are the same length. If they are not, warnings will be printed on what will

mlrun/package/packager.py

@@ -14,7 +14,7 @@
 #
 from abc import ABC, abstractmethod
 from pathlib import Path
-from typing import Any, List, Tuple, Type, Union
+from typing import Any, Union
 
 from mlrun.artifacts import Artifact
 from mlrun.datastore import DataItem
@@ -93,7 +93,7 @@ class Packager(ABC):
     """
 
     #: The type of object this packager can pack and unpack.
-    PACKABLE_OBJECT_TYPE: Type = ...
+    PACKABLE_OBJECT_TYPE: type = ...
 
     #: The priority of this packager in the packagers collection of the manager (lower is better).
     PRIORITY: int = ...
@@ -104,7 +104,7 @@ class Packager(ABC):
         self._priority = Packager.PRIORITY
 
         # List of all paths to be deleted by the manager of this packager after logging the packages:
-        self._future_clearing_path_list: List[str] = []
+        self._future_clearing_path_list: list[str] = []
 
     @abstractmethod
     def get_default_packing_artifact_type(self, obj: Any) -> str:
@@ -132,7 +132,7 @@ class Packager(ABC):
         pass
 
     @abstractmethod
-    def get_supported_artifact_types(self) -> List[str]:
+    def get_supported_artifact_types(self) -> list[str]:
         """
         Get all the supported artifact types on this packager.
 
@@ -147,7 +147,7 @@ class Packager(ABC):
         key: str = None,
         artifact_type: str = None,
         configurations: dict = None,
-    ) -> Union[Tuple[Artifact, dict], dict]:
+    ) -> Union[tuple[Artifact, dict], dict]:
         """
         Pack an object as the given artifact type using the provided configurations.
 
@@ -212,7 +212,7 @@ class Packager(ABC):
         return True
 
     def is_unpackable(
-        self, data_item: DataItem, type_hint: Type, artifact_type: str = None
+        self, data_item: DataItem, type_hint: type, artifact_type: str = None
     ) -> bool:
         """
         Check if this packager can unpack an input according to the user-given type hint and the provided artifact type.
@@ -269,7 +269,7 @@ class Packager(ABC):
         self._priority = priority
 
     @property
-    def future_clearing_path_list(self) -> List[str]:
+    def future_clearing_path_list(self) -> list[str]:
         """
         Get the packager's future clearing path list.
 

mlrun/package/packagers/default_packager.py

@@ -15,7 +15,7 @@
 import inspect
 from abc import ABCMeta
 from types import MethodType
-from typing import Any, List, Tuple, Type, Union
+from typing import Any, Union
 
 import docstring_parser
 
@@ -51,7 +51,7 @@ class _DefaultPackagerMeta(ABCMeta):
         return super().__new__(mcls, name, bases, namespace, **kwargs)
 
     @property
-    def __doc__(cls: Type["DefaultPackager"]) -> str:
+    def __doc__(cls: type["DefaultPackager"]) -> str:
         """
         Override the `__doc__` attribute of a `DefaultPackager` to be a property in order to auto-summarize the
         packager's class docstring. The summary is concatenated after the original class doc string.
@@ -273,7 +273,7 @@ class DefaultPackager(Packager, metaclass=_DefaultPackagerMeta):
     """
 
     #: The type of object this packager can pack and unpack.
-    PACKABLE_OBJECT_TYPE: Type = ...
+    PACKABLE_OBJECT_TYPE: type = ...
 
     #: A flag for indicating whether to also pack all subclasses of the `PACKABLE_OBJECT_TYPE`.
     PACK_SUBCLASSES = False
@@ -306,7 +306,7 @@ class DefaultPackager(Packager, metaclass=_DefaultPackagerMeta):
         """
         return self.DEFAULT_UNPACKING_ARTIFACT_TYPE
 
-    def get_supported_artifact_types(self) -> List[str]:
+    def get_supported_artifact_types(self) -> list[str]:
         """
         Get all the supported artifact types on this packager.
 
@@ -326,7 +326,7 @@ class DefaultPackager(Packager, metaclass=_DefaultPackagerMeta):
         key: str = None,
         artifact_type: str = None,
         configurations: dict = None,
-    ) -> Union[Tuple[Artifact, dict], dict]:
+    ) -> Union[tuple[Artifact, dict], dict]:
         """
         Pack an object as the given artifact type using the provided configurations.
 
@@ -442,7 +442,7 @@ class DefaultPackager(Packager, metaclass=_DefaultPackagerMeta):
         obj: Any,
         key: str,
         pickle_module_name: str = DEFAULT_PICKLE_MODULE,
-    ) -> Tuple[Artifact, dict]:
+    ) -> tuple[Artifact, dict]:
         """
         Pack a python object, pickling it into a pkl file and store it in an artifact.
 

mlrun/package/packagers/numpy_packagers.py

@@ -16,7 +16,7 @@ import os
 import pathlib
 import tempfile
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Tuple, Union
+from typing import Any, Union
 
 import numpy as np
 import pandas as pd
@@ -29,7 +29,7 @@ from ..utils import ArtifactType, SupportedFormat
 from .default_packager import DefaultPackager
 
 # Type for collection of numpy arrays (list / dict of arrays):
-NumPyArrayCollectionType = Union[List[np.ndarray], Dict[str, np.ndarray]]
+NumPyArrayCollectionType = Union[list[np.ndarray], dict[str, np.ndarray]]
 
 
 class _Formatter(ABC):
@@ -194,7 +194,7 @@ class _NPZFormatter(_Formatter):
             save_function(file_path, **obj)
 
     @classmethod
-    def load(cls, file_path: str, **load_kwargs: dict) -> Dict[str, np.ndarray]:
+    def load(cls, file_path: str, **load_kwargs: dict) -> dict[str, np.ndarray]:
         """
         Load the arrays from the given 'npz' file path.
 
@@ -226,7 +226,7 @@ class NumPySupportedFormat(SupportedFormat[_Formatter]):
     }
 
     @classmethod
-    def get_single_array_formats(cls) -> List[str]:
+    def get_single_array_formats(cls) -> list[str]:
         """
         Get the supported formats for saving one numpy array.
 
@@ -235,7 +235,7 @@ class NumPySupportedFormat(SupportedFormat[_Formatter]):
         return [cls.NPY, cls.TXT, cls.GZ, cls.CSV]
 
     @classmethod
-    def get_multi_array_formats(cls) -> List[str]:
+    def get_multi_array_formats(cls) -> list[str]:
         """
         Get the supported formats for saving a collection (multiple) numpy arrays - e.g. list of arrays or dictionary of
         arrays.
@@ -310,7 +310,7 @@ class NumPyNDArrayPackager(DefaultPackager):
         key: str,
         file_format: str = DEFAULT_NUMPY_ARRAY_FORMAT,
         **save_kwargs,
-    ) -> Tuple[Artifact, dict]:
+    ) -> tuple[Artifact, dict]:
         """
         Pack an array as a file by the given format.
 
@@ -342,7 +342,7 @@ class NumPyNDArrayPackager(DefaultPackager):
         obj: np.ndarray,
         key: str,
         file_format: str = "",
-    ) -> Tuple[Artifact, dict]:
+    ) -> tuple[Artifact, dict]:
         """
         Pack an array as a dataset.
 
@@ -442,7 +442,7 @@ class _NumPyNDArrayCollectionPackager(DefaultPackager):
         key: str,
         file_format: str = DEFAULT_NUMPPY_ARRAY_COLLECTION_FORMAT,
         **save_kwargs,
-    ) -> Tuple[Artifact, dict]:
+    ) -> tuple[Artifact, dict]:
         """
         Pack an array collection as a file by the given format.
 
@@ -476,7 +476,7 @@ class _NumPyNDArrayCollectionPackager(DefaultPackager):
         data_item: DataItem,
         file_format: str = None,
         allow_pickle: bool = False,
-    ) -> Dict[str, np.ndarray]:
+    ) -> dict[str, np.ndarray]:
         """
         Unpack a numppy array collection from file.
 
@@ -545,7 +545,7 @@ class NumPyNDArrayDictPackager(_NumPyNDArrayCollectionPackager):
     ``dict[str, numpy.ndarray]`` packager.
     """
 
-    PACKABLE_OBJECT_TYPE = Dict[str, np.ndarray]
+    PACKABLE_OBJECT_TYPE = dict[str, np.ndarray]
 
     def is_packable(
         self, obj: Any, artifact_type: str = None, configurations: dict = None
@@ -583,7 +583,7 @@ class NumPyNDArrayDictPackager(_NumPyNDArrayCollectionPackager):
 
         return True
 
-    def pack_result(self, obj: Dict[str, np.ndarray], key: str) -> dict:
+    def pack_result(self, obj: dict[str, np.ndarray], key: str) -> dict:
         """
         Pack a dictionary of numpy arrays as a result.
 
@@ -604,7 +604,7 @@ class NumPyNDArrayDictPackager(_NumPyNDArrayCollectionPackager):
         data_item: DataItem,
         file_format: str = None,
         allow_pickle: bool = False,
-    ) -> Dict[str, np.ndarray]:
+    ) -> dict[str, np.ndarray]:
         """
         Unpack a numppy array dictionary from file.
 
@@ -630,7 +630,7 @@ class NumPyNDArrayListPackager(_NumPyNDArrayCollectionPackager):
     ``list[numpy.ndarray]`` packager.
     """
 
-    PACKABLE_OBJECT_TYPE = List[np.ndarray]
+    PACKABLE_OBJECT_TYPE = list[np.ndarray]
 
     def is_packable(
         self, obj: Any, artifact_type: str = None, configurations: dict = None
@@ -665,7 +665,7 @@ class NumPyNDArrayListPackager(_NumPyNDArrayCollectionPackager):
 
         return True
 
-    def pack_result(self, obj: List[np.ndarray], key: str) -> dict:
+    def pack_result(self, obj: list[np.ndarray], key: str) -> dict:
         """
         Pack a list of numpy arrays as a result.
 
@@ -681,7 +681,7 @@ class NumPyNDArrayListPackager(_NumPyNDArrayCollectionPackager):
         data_item: DataItem,
         file_format: str = None,
         allow_pickle: bool = False,
-    ) -> List[np.ndarray]:
+    ) -> list[np.ndarray]:
         """
         Unpack a numppy array list from file.
 

mlrun/package/packagers/pandas_packagers.py

@@ -17,7 +17,7 @@ import os
 import pathlib
 import tempfile
 from abc import ABC, abstractmethod
-from typing import Any, List, Tuple, Union
+from typing import Any, Union
 
 import pandas as pd
 
@@ -70,7 +70,7 @@ class _Formatter(ABC):
         pass
 
     @staticmethod
-    def _flatten_dataframe(dataframe: pd.DataFrame) -> Tuple[pd.DataFrame, dict]:
+    def _flatten_dataframe(dataframe: pd.DataFrame) -> tuple[pd.DataFrame, dict]:
         """
         Flatten the dataframe: moving all indexes to be columns at the start (from column 0) and lowering the columns
         levels to 1, renaming them from tuples. All columns and index info is stored so it can be unflatten later on.
@@ -733,7 +733,7 @@ class PandasDataFramePackager(DefaultPackager):
         file_format: str = None,
         flatten: bool = True,
         **to_kwargs,
-    ) -> Tuple[Artifact, dict]:
+    ) -> tuple[Artifact, dict]:
         """
         Pack a dataframe as a file by the given format.
 
@@ -857,7 +857,7 @@ class PandasSeriesPackager(PandasDataFramePackager):
     PACKABLE_OBJECT_TYPE = pd.Series
     DEFAULT_PACKING_ARTIFACT_TYPE = ArtifactType.FILE
 
-    def get_supported_artifact_types(self) -> List[str]:
+    def get_supported_artifact_types(self) -> list[str]:
         """
         Get all the supported artifact types on this packager. It will be the same as `PandasDataFramePackager` but
         without the 'dataset' artifact type support.
@@ -886,7 +886,7 @@ class PandasSeriesPackager(PandasDataFramePackager):
         file_format: str = None,
         flatten: bool = True,
         **to_kwargs,
-    ) -> Tuple[Artifact, dict]:
+    ) -> tuple[Artifact, dict]:
         """
         Pack a series as a file by the given format.