sapiopycommons 2024.8.20a306__py3-none-any.whl → 2024.8.26a309__py3-none-any.whl

sapiopycommons/callbacks/callback_util.py

@@ -900,7 +900,7 @@ class CallbackUtil:
         return response
 
     def request_file(self, title: str, exts: list[str] | None = None,
-                     show_image_editor: bool = False, show_camera_button: bool = False) -> (str, bytes):
+                     show_image_editor: bool = False, show_camera_button: bool = False) -> tuple[str, bytes]:
         """
         Request a single file from the user.
 
@@ -933,7 +933,7 @@ class CallbackUtil:
         return file_path, sink.data
 
     def request_files(self, title: str, exts: list[str] | None = None,
-                      show_image_editor: bool = False, show_camera_button: bool = False):
+                      show_image_editor: bool = False, show_camera_button: bool = False) -> dict[str, bytes]:
         """
         Request multiple files from the user.
 
@@ -964,7 +964,7 @@ class CallbackUtil:
         return ret_dict
 
     @staticmethod
-    def __verify_file(file_path: str, file_bytes: bytes, allowed_extensions: list[str]):
+    def __verify_file(file_path: str, file_bytes: bytes, allowed_extensions: list[str]) -> None:
         """
         Verify that the provided file was read (i.e. the file path and file bytes aren't None or empty) and that it
         has the correct file extension. Raises a user error exception if something about the file is incorrect.

sapiopycommons/eln/experiment_handler.py

@@ -330,11 +330,7 @@ class ExperimentHandler:
         :return: The data record for this experiment. None if it has no record.
         """
         if not hasattr(self, "_ExperimentHandler__exp_record"):
-            drm = DataMgmtServer.get_data_record_manager(self.user)
-            dt = self.__eln_exp.experiment_data_type_name
-            results = drm.query_data_records_by_id(dt, [self.__eln_exp.experiment_record_id]).result_list
-            # PR-46504: Set the exp_record to None if there are no results.
-            self.__exp_record = results[0] if results else None
+            self.__exp_record = self.__protocol.get_record()
         if self.__exp_record is None and exception_on_none:
             raise SapioException(f"Experiment record not found for experiment with ID {self.__exp_id}.")
         return self.__exp_record

sapiopycommons/files/file_bridge_handler.py

@@ -328,7 +328,7 @@ class Directory(FileBridgeObject):
         return {x: y for x, y in self.contents.items() if not y.is_file()}
 
 
-def split_path(file_path: str) -> (str, str):
+def split_path(file_path: str) -> tuple[str, str]:
     """
     :param file_path: A file path where directories are separated the "/" characters.
     :return: A tuple of two strings that splits the path on its last slash. The first string is the name of the

sapiopycommons/recordmodel/record_handler.py

@@ -92,7 +92,7 @@ class RecordHandler:
         return self.inst_man.add_existing_records_of_type(list(records), wrapper_type)
 
     def query_models(self, wrapper_type: type[WrappedType], field: FieldIdentifier, value_list: Iterable[FieldValue],
-                     page_limit: int | None = None) -> list[WrappedType]:
+                     page_limit: int | None = None, page_size: int | None = None) -> list[WrappedType]:
         """
         Shorthand for using the data record manager to query for a list of data records by field value
         and then converting the results into a list of record models.
@@ -100,14 +100,20 @@ class RecordHandler:
         :param wrapper_type: The record model wrapper to use.
         :param field: The field to query on.
         :param value_list: The values of the field to query on.
-        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages.
+        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages. This parameter
+            only functions if you set a page size or the platform enforces a page size.
+        :param page_size: The size of the pages to query. If None, the page size may be limited by the platform.
         :return: The record models for the queried records.
         """
-        return self.query_models_with_criteria(wrapper_type, field, value_list, None, page_limit)[0]
+        criteria: DataRecordPojoPageCriteria | None = None
+        if page_size is not None:
+            criteria = DataRecordPojoPageCriteria(page_size=page_size)
+        return self.query_models_with_criteria(wrapper_type, field, value_list, criteria, page_limit)[0]
 
     def query_and_map_models(self, wrapper_type: type[WrappedType], field: FieldIdentifier,
                              value_list: Iterable[FieldValue], page_limit: int | None = None,
-                             *, mapping_field: FieldIdentifier | None = None) -> dict[FieldValue, list[WrappedType]]:
+                             page_size: int | None = None, *, mapping_field: FieldIdentifier | None = None) \
+            -> dict[FieldValue, list[WrappedType]]:
         """
         Shorthand for using query_models to search for records given values on a specific field and then using
         map_by_field to turn the returned list into a dictionary mapping field values to records.
@@ -115,17 +121,20 @@ class RecordHandler:
         :param wrapper_type: The record model wrapper to use.
         :param field: The field to query and map on.
         :param value_list: The values of the field to query on.
-        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages.
+        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages. This parameter
+            only functions if you set a page size or the platform enforces a page size.
+        :param page_size: The size of the pages to query. If None, the page size may be limited by the platform.
         :param mapping_field: If provided, use this field to map against instead of the field that was queried on.
         :return: The record models for the queried records mapped by field values to the records with that value.
         """
         if mapping_field is None:
             mapping_field = field
-        return self.map_by_field(self.query_models(wrapper_type, field, value_list, page_limit), mapping_field)
+        return self.map_by_field(self.query_models(wrapper_type, field, value_list, page_limit, page_size),
+                                 mapping_field)
 
     def query_and_unique_map_models(self, wrapper_type: type[WrappedType], field: FieldIdentifier,
                                     value_list: Iterable[FieldValue], page_limit: int | None = None,
-                                    *, mapping_field: FieldIdentifier | None = None) \
+                                    page_size: int | None = None, *, mapping_field: FieldIdentifier | None = None) \
             -> dict[FieldValue, WrappedType]:
         """
         Shorthand for using query_models to search for records given values on a specific field and then using
@@ -135,13 +144,16 @@ class RecordHandler:
         :param wrapper_type: The record model wrapper to use.
         :param field: The field to query and map on.
         :param value_list: The values of the field to query on.
-        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages.
+        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages. This parameter
+            only functions if you set a page size or the platform enforces a page size.
+        :param page_size: The size of the pages to query. If None, the page size may be limited by the platform.
         :param mapping_field: If provided, use this field to map against instead of the field that was queried on.
         :return: The record models for the queried records mapped by field values to the record with that value.
         """
         if mapping_field is None:
             mapping_field = field
-        return self.map_by_unique_field(self.query_models(wrapper_type, field, value_list, page_limit), mapping_field)
+        return self.map_by_unique_field(self.query_models(wrapper_type, field, value_list, page_limit, page_size),
+                                        mapping_field)
 
     def query_models_with_criteria(self, wrapper_type: type[WrappedType], field: FieldIdentifier,
                                    value_list: Iterable[FieldValue],
@@ -157,7 +169,8 @@ class RecordHandler:
         :param value_list: The values of the field to query on.
         :param paging_criteria: The paging criteria to start the query with.
         :param page_limit: The maximum number of pages to query from the starting criteria. If None, exhausts all
-            possible pages.
+            possible pages. This parameter only functions if you set a page size in the paging criteria or the platform
+            enforces a page size.
         :return: The record models for the queried records and the final paging criteria.
         """
         dt: str = wrapper_type.get_wrapper_data_type_name()
@@ -167,17 +180,22 @@ class RecordHandler:
         return self.wrap_models(pager.get_all_at_once(), wrapper_type), pager.next_page_criteria
 
     def query_models_by_id(self, wrapper_type: type[WrappedType], ids: Iterable[int],
-                           page_limit: int | None = None) -> list[WrappedType]:
+                           page_limit: int | None = None, page_size: int | None = None) -> list[WrappedType]:
         """
         Shorthand for using the data record manager to query for a list of data records by record ID
         and then converting the results into a list of record models.
 
         :param wrapper_type: The record model wrapper to use.
         :param ids: The list of record IDs to query.
-        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages.
+        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages. This parameter
+            only functions if you set a page size or the platform enforces a page size.
+        :param page_size: The size of the pages to query. If None, the page size may be limited by the platform.
         :return: The record models for the queried records.
         """
-        return self.query_models_by_id_with_criteria(wrapper_type, ids, None, page_limit)[0]
+        criteria: DataRecordPojoPageCriteria | None = None
+        if page_size is not None:
+            criteria = DataRecordPojoPageCriteria(page_size=page_size)
+        return self.query_models_by_id_with_criteria(wrapper_type, ids, criteria, page_limit)[0]
 
     def query_models_by_id_with_criteria(self, wrapper_type: type[WrappedType], ids: Iterable[int],
                                          paging_criteria: DataRecordPojoPageCriteria | None = None,
@@ -191,7 +209,8 @@ class RecordHandler:
         :param ids: The list of record IDs to query.
         :param paging_criteria: The paging criteria to start the query with.
         :param page_limit: The maximum number of pages to query from the starting criteria. If None, exhausts all
-            possible pages.
+            possible pages. This parameter only functions if you set a page size in the paging criteria or the platform
+            enforces a page size.
         :return: The record models for the queried records and the final paging criteria.
         """
         dt: str = wrapper_type.get_wrapper_data_type_name()
@@ -200,28 +219,37 @@ class RecordHandler:
         return self.wrap_models(pager.get_all_at_once(), wrapper_type), pager.next_page_criteria
 
     def query_models_by_id_and_map(self, wrapper_type: type[WrappedType], ids: Iterable[int],
-                                   page_limit: int | None = None) -> dict[int, WrappedType]:
+                                   page_limit: int | None = None, page_size: int | None = None) \
+            -> dict[int, WrappedType]:
         """
         Shorthand for using the data record manager to query for a list of data records by record ID
         and then converting the results into a dictionary of record ID to the record model for that ID.
 
         :param wrapper_type: The record model wrapper to use.
         :param ids: The list of record IDs to query.
-        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages.
+        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages. This parameter
+            only functions if you set a page size or the platform enforces a page size.
+        :param page_size: The size of the pages to query. If None, the page size may be limited by the platform.
         :return: The record models for the queried records mapped in a dictionary by their record ID.
         """
-        return {x.record_id: x for x in self.query_models_by_id(wrapper_type, ids, page_limit)}
+        return {x.record_id: x for x in self.query_models_by_id(wrapper_type, ids, page_limit, page_size)}
 
-    def query_all_models(self, wrapper_type: type[WrappedType], page_limit: int | None = None) -> list[WrappedType]:
+    def query_all_models(self, wrapper_type: type[WrappedType], page_limit: int | None = None,
+                         page_size: int | None = None) -> list[WrappedType]:
         """
         Shorthand for using the data record manager to query for all data records of a given type
         and then converting the results into a list of record models.
 
         :param wrapper_type: The record model wrapper to use.
-        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages.
+        :param page_limit: The maximum number of pages to query. If None, exhausts all possible pages. This parameter
+            only functions if you set a page size or the platform enforces a page size.
+        :param page_size: The size of the pages to query. If None, the page size may be limited by the platform.
         :return: The record models for the queried records.
         """
-        return self.query_all_models_with_criteria(wrapper_type, None, page_limit)[0]
+        criteria: DataRecordPojoPageCriteria | None = None
+        if page_size is not None:
+            criteria = DataRecordPojoPageCriteria(page_size=page_size)
+        return self.query_all_models_with_criteria(wrapper_type, criteria, page_limit)[0]
 
     def query_all_models_with_criteria(self, wrapper_type: type[WrappedType],
                                        paging_criteria: DataRecordPojoPageCriteria | None = None,
@@ -234,7 +262,8 @@ class RecordHandler:
         :param wrapper_type: The record model wrapper to use.
         :param paging_criteria: The paging criteria to start the query with.
         :param page_limit: The maximum number of pages to query from the starting criteria. If None, exhausts all
-            possible pages.
+            possible pages. This parameter only functions if you set a page size in the paging criteria or the platform
+            enforces a page size.
         :return: The record models for the queried records and the final paging criteria.
         """
         dt: str = wrapper_type.get_wrapper_data_type_name()

{sapiopycommons-2024.8.20a306.dist-info → sapiopycommons-2024.8.26a309.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: sapiopycommons
-Version: 2024.8.20a306
+Version: 2024.8.26a309
 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>

{sapiopycommons-2024.8.20a306.dist-info → sapiopycommons-2024.8.26a309.dist-info}/RECORD

@@ -1,6 +1,6 @@
 sapiopycommons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sapiopycommons/callbacks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sapiopycommons/callbacks/callback_util.py,sha256=P0a4O1mIAzxS5drl7nGeXBHazPnOGUGlYmlNA9BGZSs,63421
+sapiopycommons/callbacks/callback_util.py,sha256=UmjRehMkg44LZB-qgOefQogJEcho2xKtHlICegCHe4I,63454
 sapiopycommons/chem/IndigoMolecules.py,sha256=QqFDi9CKERj6sn_ZwVcS2xZq4imlkaTeCrpq1iNcEJA,1992
 sapiopycommons/chem/Molecules.py,sha256=t80IsQBPJ9mwE8ZxnWomAGrZDhdsOuPvLaTPb_N6jGU,8639
 sapiopycommons/chem/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -11,13 +11,13 @@ sapiopycommons/customreport/term_builder.py,sha256=oVsr7iFPnug2TrZUCcAMhyps-b62k
 sapiopycommons/datatype/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sapiopycommons/datatype/attachment_util.py,sha256=_l2swuP8noIGAl4bwzBUEhr6YlN_OVZl3-gi1XqFHYA,3364
 sapiopycommons/eln/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sapiopycommons/eln/experiment_handler.py,sha256=2HlSQ4m_ITYo7gGObZPjJrWpI4cMllx5S7x_RgTfhRc,66994
+sapiopycommons/eln/experiment_handler.py,sha256=NoHBthxuXqxdmIj57KEYNqC_t2mArbOkIbcemJkw08U,66683
 sapiopycommons/eln/experiment_report_util.py,sha256=B55hXbTGndCEI19LiqhjvO46_chujZUK0qDTWHjzfcU,6398
 sapiopycommons/eln/plate_designer.py,sha256=FYJfhhNq8hdfuXgDYOYHy6g0m2zNwQXZWF_MTPzElDg,7184
 sapiopycommons/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sapiopycommons/files/complex_data_loader.py,sha256=T39veNhvYl6j_uZjIIJ8Mk5Aa7otR5RB-g8XlAdkksA,1421
 sapiopycommons/files/file_bridge.py,sha256=WwCVegk0OGA8eqho8chsOsLlqg1nXctO75zfh-rHF-g,5950
-sapiopycommons/files/file_bridge_handler.py,sha256=rGs9wJIYgMszdxZvzIYK0_doqWDCkZjnhO1pIJP8GOk,14258
+sapiopycommons/files/file_bridge_handler.py,sha256=bt2IfIsxJ4lcJYo_NHvCQ17ZV6C4fSAEa8Zcgixh7B4,14263
 sapiopycommons/files/file_data_handler.py,sha256=SCsjODMJIPEBSsahzXUeOM7CfSCmYwPPoGAM6aOfelo,36743
 sapiopycommons/files/file_util.py,sha256=ZrgoGwHHfPdL5KHkGwlrEHJqGpttmZzRkGQCXdLjra8,28284
 sapiopycommons/files/file_validator.py,sha256=4OvY98ueJWPJdpndwnKv2nqVvLP9S2W7Il_dM0Y0ojo,28709
@@ -37,14 +37,14 @@ sapiopycommons/multimodal/multimodal_data.py,sha256=p_caXW0vrURkzDHHspUptEI7lVFp
 sapiopycommons/processtracking/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sapiopycommons/processtracking/endpoints.py,sha256=w5bziI2xC7450M95rCF8JpRwkoni1kEDibyAux9B12Q,10848
 sapiopycommons/recordmodel/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sapiopycommons/recordmodel/record_handler.py,sha256=6ZbdBdQoIU7OeXqWgbSJAlvQftrEQD01Il6L-EEXKMo,62234
+sapiopycommons/recordmodel/record_handler.py,sha256=Uxjrq6f_cWFbqi7KRLySdOvmQGtbIBrCNyStRewqzx8,64751
 sapiopycommons/rules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sapiopycommons/rules/eln_rule_handler.py,sha256=JYzDA_14D2nLnlqwbpIxVOrfKWzbOS27AYf4TQfGr4Q,10469
 sapiopycommons/rules/on_save_rule_handler.py,sha256=Rkqvph20RbNq6m-RF4fbvCP-YfD2CZYBM2iTr3nl0eY,10236
 sapiopycommons/webhook/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sapiopycommons/webhook/webhook_handlers.py,sha256=jwc4xu-wwl8haS5k1dENZ1UIYK9GQk74TAo3CGxMW9U,16583
 sapiopycommons/webhook/webservice_handlers.py,sha256=1J56zFI0pWl5MHoNTznvcZumITXgAHJMluj8-2BqYEw,3315
-sapiopycommons-2024.8.20a306.dist-info/METADATA,sha256=oYFijljm4qXY9m6UvTMucluva6UmLJrJWuj1B9O2-yQ,3176
-sapiopycommons-2024.8.20a306.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
-sapiopycommons-2024.8.20a306.dist-info/licenses/LICENSE,sha256=HyVuytGSiAUQ6ErWBHTqt1iSGHhLmlC8fO7jTCuR8dU,16725
-sapiopycommons-2024.8.20a306.dist-info/RECORD,,
+sapiopycommons-2024.8.26a309.dist-info/METADATA,sha256=QPKphJJa5mBvsnj9s2eKoRIZgoQnso66pq4bwnVQW4A,3176
+sapiopycommons-2024.8.26a309.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
+sapiopycommons-2024.8.26a309.dist-info/licenses/LICENSE,sha256=HyVuytGSiAUQ6ErWBHTqt1iSGHhLmlC8fO7jTCuR8dU,16725
+sapiopycommons-2024.8.26a309.dist-info/RECORD,,