sapiopycommons 2025.9.5a726__py3-none-any.whl → 2025.9.5rc727__py3-none-any.whl

sapiopycommons/callbacks/callback_util.py

@@ -1765,8 +1765,11 @@ class CallbackUtil:
             blank_result_handling = BlankResultHandling.REPEAT
         def not_blank_func(r: list[DataRecord]) -> bool:
             return bool(r)
-        return self.__send_dialog_blank_results(request, self.callback.show_input_selection_dialog, not_blank_func,
-                                                blank_result_handling, repeat_message, cancel_message)
+        response: list[DataRecord] = self.__send_dialog_blank_results(request,
+                                                                      self.callback.show_input_selection_dialog,
+                                                                      not_blank_func, blank_result_handling,
+                                                                      repeat_message, cancel_message)
+        return self.rec_handler.wrap_models(response, wrapper_type)
 
     # FR-47690: Deprecated the require_authentication parameter.
     # noinspection PyUnusedLocal
@@ -1812,7 +1815,8 @@ class CallbackUtil:
         return response
 
     def request_file(self, title: str, exts: Iterable[str] | None = None,
-                     show_image_editor: bool = False, show_camera_button: bool = False) -> tuple[str, bytes]:
+                     show_image_editor: bool = False, show_camera_button: bool = False,
+                     *, enforce_file_extensions: bool = True) -> tuple[str, bytes]:
         """
         Request a single file from the user.
 
@@ -1822,6 +1826,8 @@ class CallbackUtil:
         :param show_image_editor: Whether the user will see an image editor when image is uploaded in this file prompt.
         :param show_camera_button: Whether the user will be able to use camera to take a picture as an upload request,
             rather than selecting an existing file.
+        :param enforce_file_extensions: If true, then the file extensions provided in the exts parameter will be
+            enforced. If false, then the user may upload any file type.
         :return: The file name and bytes of the uploaded file.
         """
         # If no extensions were provided, use an empty list for the extensions instead.
@@ -1841,11 +1847,12 @@ class CallbackUtil:
             file_path: str = self.__send_dialog(request, self.callback.show_file_dialog, data_sink=do_consume)
 
         # Verify that each of the file given matches the expected extension(s).
-        self.__verify_file(file_path, sink.data, exts)
+        self.__verify_file(file_path, sink.data, exts if enforce_file_extensions else None)
         return file_path, sink.data
 
     def request_files(self, title: str, exts: Iterable[str] | None = None,
-                      show_image_editor: bool = False, show_camera_button: bool = False) -> dict[str, bytes]:
+                      show_image_editor: bool = False, show_camera_button: bool = False,
+                      *, enforce_file_extensions: bool = True) -> dict[str, bytes]:
         """
         Request multiple files from the user.
 
@@ -1855,6 +1862,8 @@ class CallbackUtil:
         :param show_image_editor: Whether the user will see an image editor when image is uploaded in this file prompt.
         :param show_camera_button: Whether the user will be able to use camera to take a picture as an upload request,
             rather than selecting an existing file.
+        :param enforce_file_extensions: If true, then the file extensions provided in the exts parameter will be
+            enforced. If false, then the user may upload any file type.
         :return: A dictionary of file name to file bytes for each file the user uploaded.
         """
         # If no extensions were provided, use an empty list for the extensions instead.
@@ -1870,7 +1879,7 @@ class CallbackUtil:
         for file_path in file_paths:
             sink = InMemoryRecordDataSink(self.user)
             sink.consume_client_callback_file_path_data(file_path)
-            self.__verify_file(file_path, sink.data, exts)
+            self.__verify_file(file_path, sink.data, exts if enforce_file_extensions else None)
             ret_dict.update({file_path: sink.data})
 
         return ret_dict
@@ -1887,16 +1896,17 @@ class CallbackUtil:
         """
         if file_path is None or len(file_path) == 0 or file_bytes is None or len(file_bytes) == 0:
             raise SapioUserErrorException("Empty file provided or file unable to be read.")
-        if allowed_extensions:
-            matches: bool = False
-            for ext in allowed_extensions:
-                # FR-47690: Changed to a case-insensitive match.
-                if file_path.casefold().endswith("." + ext.lstrip(".").casefold()):
-                    matches = True
-                    break
-            if matches is False:
-                raise SapioUserErrorException("Unsupported file type. Expecting the following extension(s): "
-                                              + (",".join(allowed_extensions)))
+        if not allowed_extensions:
+            return
+        matches: bool = False
+        for ext in allowed_extensions:
+            # FR-47690: Changed to a case-insensitive match.
+            if file_path.casefold().endswith("." + ext.lstrip(".").casefold()):
+                matches = True
+                break
+        if not matches:
+            raise SapioUserErrorException("Unsupported file type. Expecting the following extension(s): "
+                                          + (",".join(allowed_extensions)))
 
     def write_file(self, file_name: str, file_data: str | bytes) -> None:
         """

sapiopycommons/eln/experiment_handler.py

@@ -206,12 +206,11 @@ class ExperimentHandler:
         else:
             user = context
             context = None
-        if context is not None and context.eln_experiment is not None and experiment is None:
-            experiment = context.eln_experiment
         # FR-46495 - Allow the init function of ExperimentHandler to take in an ElnExperiment that is separate from the
         # context.
         # CR-37038 - Allow other experiment object types to be provided. Convert them all down to ElnExperiment.
-        if (context is None or context.eln_experiment is None) and experiment is not None:
+        # PR-47793 - Fix cases where both a SapioWebhookContext and an experiment parameter are provided.
+        if experiment is not None:
             eln_manager = DataMgmtServer.get_eln_manager(user)
             # If this object is already an ElnExperiment, do nothing.
             if isinstance(experiment, ElnExperiment):
@@ -227,13 +226,19 @@ class ExperimentHandler:
                     raise SapioException(f"No experiment with notebook ID {notebook_id} located in the system.")
             # If this object is a record, assume it is an experiment record that we can query the system with.
             else:
-                record_id: int = AliasUtil.to_record_ids([experiment])[0]
+                record_id: int = AliasUtil.to_record_id(experiment)
                 experiment: ElnExperiment = eln_manager.get_eln_experiment_by_record_id(record_id)
                 if not experiment:
                     raise SapioException(f"No experiment with record ID {record_id} located in the system.")
+        elif context is not None and context.eln_experiment is not None:
+            experiment = context.eln_experiment
+
         if experiment is None:
             raise SapioException("Cannot initialize ExperimentHandler. No ELN Experiment found in the provided "
                                  "parameters.")
+        elif not isinstance(experiment, ElnExperiment):
+            raise SapioException("Cannot initialize ExperimentHandler. The experiment variable is not an "
+                                 "ElnExperiment!")
 
         return user, context, experiment
 
@@ -1425,7 +1430,9 @@ class ExperimentHandler:
         :return: The map of options for the input step.
         """
         step: ElnEntryStep = self.get_step(step)
-        if step not in self._step_options:
+        # PR-47796: Fix the get_step_options function making a webservice query every time it is called instead of
+        # properly checking its cache of entry options.
+        if step.get_id() not in self._step_options:
             self._step_options.update(ExperimentReportUtil.get_experiment_entry_options(self.user,
                                                                                         self.get_all_steps()))
         return self._step_options[step.get_id()]

sapiopycommons/files/assay_plate_reader.py

@@ -0,0 +1,93 @@
+import base64
+import dataclasses
+from typing import Any
+
+from databind.core.dataclasses import dataclass
+from databind.json import loads
+from sapiopylib.rest.utils.singletons import SapioContextManager
+
+
+@dataclasses.dataclass
+class ProcessAssayPlateRequest:
+    """
+    A request to process the results of assay plate reader with a configuration set in Sapio.
+
+    Attributes:
+        num_rows (int): The number of rows in the plate.
+        num_columns (int): The number of columns in the plate.
+        plate_ids_in_context (list[str]): List of plate IDs that are in context for this request.
+        filename (str): The name of the file containing the assay data.
+        file_data (bytes): The binary content of the file.
+        plate_reader_config_name (str): The name of the plate reader configuration to use.
+    """
+    num_rows: int
+    num_columns: int
+    plate_ids_in_context: list[str] | None
+    filename: str
+    file_data: bytes
+    plate_reader_config_name: str
+
+    def to_json(self) -> dict[str, Any]:
+        return {
+            "numRows": self.num_rows,
+            "numCols": self.num_columns,
+            "plateIdsInContext": self.plate_ids_in_context,
+            "fileName": self.filename,
+            "fileDataBase64": base64.b64encode(self.file_data).decode('utf-8'),
+            "plateReaderName": self.plate_reader_config_name
+        }
+
+
+@dataclass
+class AssayPlateResultIdent:
+    plateId: str
+    channelIdOrBlock: str
+    kineticAssaySeconds: float | None
+
+
+@dataclass
+class AssayResultDatum:
+    """
+    Describes the data received from an assay plate reader.
+    Most of the time, the data is a single value, but sometimes it can be multiple values, especially for kinetic data.
+    """
+    DEFAULT_PROPERTY_NAME: str = "read"
+    rowPosition: str
+    columnPosition: str
+    valueByPropertyName: dict[str, float]
+    textValueByPropertyName: dict[str, str]
+
+
+@dataclass
+class AssayPlateResult:
+    """
+    Assay plate load result for a single plate in a file. A file can have more than one of this result if it has multiple plate of data in a single file.
+    """
+    resultIdent: AssayPlateResultIdent
+    numRows: int
+    numColumns: int
+    resultDatum: list[AssayResultDatum]
+
+
+@dataclass
+class AssayFileLoadResult:
+    """
+    The entire top-level file loading result for an assay plate reader file.
+    """
+    filename: str
+    plateResultList: list[AssayPlateResult]
+
+
+class AssayPlateReader(SapioContextManager):
+    """
+    This class contains services for Sapio Assay Plate Reader.
+    """
+
+    def process_plate_reader_data(self, request: ProcessAssayPlateRequest) -> AssayFileLoadResult:
+        """
+        Processes the assay plate reader data using provided request into a structured result using configuration defined in Sapio.
+        """
+        payload = request.to_json()
+        response = self.user.plugin_post("assayplatereader/process", payload=payload)
+        self.user.raise_for_status(response)
+        return loads(response.text, AssayFileLoadResult)

sapiopycommons/files/file_text_converter.py

@@ -0,0 +1,207 @@
+import io
+import os
+import tempfile
+from enum import Enum, auto
+
+class FileType(Enum):
+    """Supported file types for conversion."""
+    TXT = auto()
+    MD = auto()
+    CSV = auto()
+    DOC = auto()
+    DOCX = auto()
+    XLS = auto()
+    XLSX = auto()
+    PPT = auto()
+    PPTX = auto()
+    PDF = auto()
+    UNKNOWN = auto()
+
+
+class FileToTextConverter:
+    """
+    A class for converting various file types to raw text.
+    """
+    @staticmethod
+    def mime_type_to_enum(mime_type: str) -> FileType:
+        """
+        Converts a MIME type to a FileType enum.
+
+        :param mime_type: The MIME type string to convert.
+        :return: The corresponding FileType enum, or UNKNOWN if not recognized.
+        """
+        if not mime_type or not mime_type.strip():
+            return FileType.UNKNOWN
+
+        mime_map = {
+            "text/plain": FileType.TXT,
+            "text/markdown": FileType.MD,
+            "text/csv": FileType.CSV,
+            "application/msword": FileType.DOC,
+            "application/vnd.openxmlformats-officedocument.wordprocessingml.document": FileType.DOCX,
+            "application/vnd.ms-excel": FileType.XLS,
+            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": FileType.XLSX,
+            "application/vnd.ms-powerpoint": FileType.PPT,
+            "application/vnd.openxmlformats-officedocument.presentationml.presentation": FileType.PPTX,
+            "application/pdf": FileType.PDF,
+        }
+        return mime_map.get(mime_type, FileType.UNKNOWN)
+
+    @staticmethod
+    def file_extension_to_enum(file_path: str) -> FileType:
+        """
+        Converts a file path or extension to a FileType enum.
+
+        :param file_path: The file path or extension to convert.
+        :return: The corresponding FileType enum, or UNKNOWN if not recognized.
+        """
+        if not file_path or not file_path.strip():
+            return FileType.UNKNOWN
+
+        # Extract the file extension, removing the leading dot and making it lowercase
+        file_extension = os.path.splitext(file_path)[1].lstrip('.').lower()
+
+        ext_map = {
+            "txt": FileType.TXT,
+            "md": FileType.MD,
+            "csv": FileType.CSV,
+            "doc": FileType.DOC,
+            "docx": FileType.DOCX,
+            "xls": FileType.XLS,
+            "xlsx": FileType.XLSX,
+            "ppt": FileType.PPT,
+            "pptx": FileType.PPTX,
+            "pdf": FileType.PDF,
+        }
+        return ext_map.get(file_extension, FileType.UNKNOWN)
+
+    @classmethod
+    def parse_file(cls, file_type: FileType, file_bytes: bytes) -> str | None:
+        """
+        Parses file bytes based on the FileType and returns the text content.
+
+        :param file_type: The type of the file to parse.
+        :param file_bytes: The raw bytes of the file to parse.
+        :return: The text content of the file, or None if the file type is not supported or parsing fails.
+        """
+        if file_type is None or file_bytes is None:
+            return None
+        if not file_bytes:
+            return ""
+
+        # Dispatch to the correct parser method
+        parser_map = {
+            FileType.TXT: cls._parse_plain_text,
+            FileType.MD: cls._parse_plain_text,
+            FileType.CSV: cls._parse_plain_text,
+            FileType.DOC: cls._parse_doc,
+            FileType.DOCX: cls._parse_docx,
+            FileType.XLS: cls._parse_xls,
+            FileType.XLSX: cls._parse_xlsx,
+            FileType.PPT: cls._parse_ppt,
+            FileType.PPTX: cls._parse_pptx,
+            FileType.PDF: cls._parse_pdf,
+        }
+
+        parser_func = parser_map.get(file_type)
+
+        if parser_func:
+            return parser_func(file_bytes)
+
+        return None
+
+    @staticmethod
+    def _parse_plain_text(file_bytes: bytes) -> str:
+        return file_bytes.decode('utf-8')
+
+    @staticmethod
+    def _run_textract(file_bytes: bytes, extension: str) -> str:
+        """
+        Helper to run textract on in-memory bytes by writing to a temp file.
+        Note: textract may require external system dependencies.
+        """
+        import textract
+        with tempfile.NamedTemporaryFile(suffix=f".{extension}", delete=True) as temp_file:
+            temp_file.write(file_bytes)
+            temp_file.flush()  # Ensure all bytes are written to disk
+            text = textract.process(temp_file.name).decode('utf-8')
+        return text
+
+    @classmethod
+    def _parse_doc(cls, file_bytes: bytes) -> str:
+        return cls._run_textract(file_bytes, 'doc')
+
+    @staticmethod
+    def _parse_docx(file_bytes: bytes) -> str:
+        import docx
+        with io.BytesIO(file_bytes) as stream:
+            document = docx.Document(stream)
+            return "\n".join(para.text for para in document.paragraphs if para.text.strip())
+
+    @staticmethod
+    def _parse_xls(file_bytes: bytes) -> str:
+        import xlrd
+        workbook = xlrd.open_workbook(file_contents=file_bytes)
+        text_parts = []
+        for sheet in workbook.sheets():
+            text_parts.append(f"Sheet: {sheet.name}\n")
+            for row_idx in range(sheet.nrows):
+                row_cells = []
+                for col_idx in range(sheet.ncols):
+                    cell_text = str(sheet.cell_value(row_idx, col_idx))
+                    if cell_text.strip():
+                        row_cells.append(cell_text + "\t")
+                if row_cells:
+                    text_parts.append("".join(row_cells))
+                text_parts.append("\n")
+            text_parts.append("\n")
+        return "".join(text_parts)
+
+    @staticmethod
+    def _parse_xlsx(file_bytes: bytes) -> str:
+        import openpyxl
+        with io.BytesIO(file_bytes) as stream:
+            workbook = openpyxl.load_workbook(stream, read_only=True)
+            text_parts = []
+            for sheet in workbook.worksheets:
+                text_parts.append(f"Sheet: {sheet.title}\n")
+                for row in sheet.iter_rows():
+                    row_cells = []
+                    for cell in row:
+                        cell_text = str(cell.value) if cell.value is not None else ""
+                        if cell_text.strip():
+                            row_cells.append(cell_text + "\t")
+                    if row_cells:
+                        text_parts.append("".join(row_cells))
+                    text_parts.append("\n")
+                text_parts.append("\n")
+            return "".join(text_parts)
+
+    @classmethod
+    def _parse_ppt(cls, file_bytes: bytes) -> str:
+        return cls._run_textract(file_bytes, 'ppt')
+
+    @staticmethod
+    def _parse_pptx(file_bytes: bytes) -> str:
+        import pptx
+        with io.BytesIO(file_bytes) as stream:
+            presentation = pptx.Presentation(stream)
+            text_parts = []
+            for slide in presentation.slides:
+                for shape in slide.shapes:
+                    if shape.has_text_frame:
+                        text = shape.text_frame.text
+                        if text and text.strip():
+                            text_parts.append(text)
+            return "\n".join(text_parts)
+
+    @staticmethod
+    def _parse_pdf(file_bytes: bytes) -> str:
+        """Parses a PDF file's bytes and extracts text using PyMuPDF."""
+        import pymupdf
+        text_parts = []
+        with io.BytesIO(file_bytes) as stream:
+            with pymupdf.open(stream=stream) as doc:
+                for page in doc:
+                    text_parts.append(page.get_text())
+        return "\n".join(text_parts)

sapiopycommons/flowcyto/flow_cyto.py

@@ -4,38 +4,16 @@ from weakref import WeakValueDictionary
 
 from databind.json import dumps
 from sapiopylib.rest.User import SapioUser
+from sapiopylib.rest.utils.singletons import SapioContextManager
 
 from sapiopycommons.flowcyto.flowcyto_data import FlowJoWorkspaceInputJson, UploadFCSInputJson, \
     ComputeFlowStatisticsInputJson
 
 
-class FlowCytoManager:
+class FlowCytoManager(SapioContextManager):
     """
     This manager includes flow cytometry analysis tools that would require FlowCyto license to use.
     """
-    _user: SapioUser
-
-    __instances: WeakValueDictionary[SapioUser, FlowCytoManager] = WeakValueDictionary()
-    __initialized: bool
-
-    def __new__(cls, user: SapioUser):
-        """
-        Observes singleton pattern per record model manager object.
-
-        :param user: The user that will make the webservice request to the application.
-        """
-        obj = cls.__instances.get(user)
-        if not obj:
-            obj = object.__new__(cls)
-            obj.__initialized = False
-            cls.__instances[user] = obj
-        return obj
-
-    def __init__(self, user: SapioUser):
-        if self.__initialized:
-            return
-        self._user = user
-        self.__initialized = True
 
     def create_flowjo_workspace(self, workspace_input: FlowJoWorkspaceInputJson) -> int:
         """

sapiopycommons/general/accession_service.py

@@ -5,6 +5,7 @@ from typing import Any
 from weakref import WeakValueDictionary
 
 from sapiopylib.rest.User import SapioUser
+from sapiopylib.rest.utils.singletons import SapioContextManager
 
 _STR_JAVA_TYPE = "java.lang.String"
 _INT_JAVA_TYPE = "java.lang.Integer"
@@ -274,37 +275,10 @@ class AccessionServiceDescriptor:
         }
 
 
-class AccessionService:
+class AccessionService(SapioContextManager):
     """
     Provides Sapio Foundations Accession Service functionalities.
     """
-    _user: SapioUser
-
-    __instances: WeakValueDictionary[SapioUser, AccessionService] = WeakValueDictionary()
-    __initialized: bool
-
-    @property
-    def user(self) -> SapioUser:
-        return self._user
-
-    def __new__(cls, user: SapioUser):
-        """
-        Observes singleton pattern per record model manager object.
-
-        :param user: The user that will make the webservice request to the application.
-        """
-        obj = cls.__instances.get(user)
-        if not obj:
-            obj = object.__new__(cls)
-            obj.__initialized = False
-            cls.__instances[user] = obj
-        return obj
-
-    def __init__(self, user: SapioUser):
-        if self.__initialized:
-            return
-        self._user = user
-        self.__initialized = True
 
     def accession_with_config(self, data_type_name: str, data_field_name: str, num_ids: int) -> list[str]:
         """

sapiopycommons/multimodal/multimodal.py

@@ -7,35 +7,13 @@ from weakref import WeakValueDictionary
 from databind.json import dumps, loads
 from sapiopylib.rest.User import SapioUser
 from sapiopylib.rest.pojo.DataRecord import DataRecord
+from sapiopylib.rest.utils.singletons import SapioContextManager
 
 from sapiopycommons.general.exceptions import SapioException
 from sapiopycommons.multimodal.multimodal_data import *
 
 
-class MultiModalManager:
-    _user: SapioUser
-
-    __instances: WeakValueDictionary[SapioUser, MultiModalManager] = WeakValueDictionary()
-    __initialized: bool
-
-    def __new__(cls, user: SapioUser):
-        """
-        Observes singleton pattern per record model manager object.
-
-        :param user: The user that will make the webservice request to the application.
-        """
-        obj = cls.__instances.get(user)
-        if not obj:
-            obj = object.__new__(cls)
-            obj.__initialized = False
-            cls.__instances[user] = obj
-        return obj
-
-    def __init__(self, user:SapioUser):
-        if self.__initialized:
-            return
-        self._user = user
-        self.__initialized = True
+class MultiModalManager(SapioContextManager):
 
     def load_image_data(self, request: ImageDataRequestPojo) -> list[str]:
         """

sapiopycommons/recordmodel/record_handler.py

@@ -100,6 +100,10 @@ class RecordHandler:
             PyRecordModel instead of a WrappedRecordModel.
         :return: The record model for the input.
         """
+        # PR-47792: Set the wrapper_type to None if a str was provided instead of a type[WrappedType]. The type hints
+        # say this shouldn't be done anyway, but using this as a safeguard against user error.
+        if isinstance(wrapper_type, str):
+            wrapper_type = None
         if wrapper_type is not None:
             self.__verify_data_type(record, wrapper_type)
             if isinstance(record, PyRecordModel):

sapiopycommons/rules/eln_rule_handler.py

@@ -184,4 +184,7 @@ class ElnRuleHandler:
             instead of a model wrapper, then the returned records will be PyRecordModels instead of WrappedRecordModels.
         """
         dt: str = AliasUtil.to_data_type_name(wrapper_type)
+        # PR-47792: Set the wrapper_type to None if a str was provided instead of a type[WrappedType].
+        if isinstance(wrapper_type, str):
+            wrapper_type = None
         return self._rec_handler.wrap_models(self.get_records(dt, entry), wrapper_type)

sapiopycommons/rules/on_save_rule_handler.py

@@ -180,4 +180,7 @@ class OnSaveRuleHandler:
             instead of a model wrapper, then the returned records will be PyRecordModels instead of WrappedRecordModels.
         """
         dt: str = AliasUtil.to_data_type_name(wrapper_type)
+        # PR-47792: Set the wrapper_type to None if a str was provided instead of a type[WrappedType].
+        if isinstance(wrapper_type, str):
+            wrapper_type = None
         return self._rec_handler.wrap_models(self.get_records(dt, record_id), wrapper_type)

sapiopycommons/webhook/webservice_handlers.py

@@ -140,7 +140,7 @@ class AbstractWebserviceHandler(AbstractWebhookHandler):
         # Get the login credentials from the headers.
         auth: str = headers.get("Authorization")
         if auth and auth.startswith("Basic "):
-            credentials: list[str] = b64decode(auth.split("Basic ")[1]).decode().split(":", 1)
+            credentials: list[str] = b64decode(auth.split("Basic ")[1]).decode().split(":")
             user = self.basic_auth(url, credentials[0], credentials[1])
         elif auth and auth.startswith("Bearer "):
             user = self.bearer_token_auth(url, auth.split("Bearer ")[1])

{sapiopycommons-2025.9.5a726.dist-info → sapiopycommons-2025.9.5rc727.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: sapiopycommons
-Version: 2025.9.5a726
+Version: 2025.9.5rc727
 Summary: Official Sapio Python API Utilities Package
 Project-URL: Homepage, https://github.com/sapiosciences
 Author-email: Jonathan Steck <jsteck@sapiosciences.com>, Yechen Qiao <yqiao@sapiosciences.com>
@@ -17,7 +17,7 @@ Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Requires-Dist: databind>=4.5
-Requires-Dist: sapiopylib>=2025.4.17.264
+Requires-Dist: sapiopylib>=2025.7.31a279
 Description-Content-Type: text/markdown