sapiopycommons 2025.4.15a484__py3-none-any.whl → 2025.4.16a485__py3-none-any.whl

sapiopycommons/eln/experiment_cache.py

@@ -63,7 +63,7 @@ class ExperimentCacheManager:
         self._predefined_fields = {}
 
     def get_experiment_template(self, name: str, active: bool = True, version: int | None = None,
-                                first_match: bool = False) -> ElnTemplate:
+                                first_match: bool = False, public: bool | None = True) -> ElnTemplate:
         """
         Get the experiment template with the given information.
 
@@ -71,6 +71,10 @@ class ExperimentCacheManager:
         :param active: Whether the template is marked as active.
         :param version: The version of the template to get. If None, the latest version will be returned.
         :param first_match: If true, returns the first match found. If false, raises an exception.
+        :param public: Whether the template is public. If true, only pubic templates will be queried. If false, only
+            private templates will be queried. If None, both public and private templates will be queried. Non-public
+            templates do not have a version number, so this will always fail if public is false and a version number is
+            provided.
         :return: The experiment template with the given information.
         """
         if not hasattr(self, "_templates"):
@@ -78,11 +82,11 @@ class ExperimentCacheManager:
             query.active_templates_only = False
             query.latest_version_only = False
             self._templates = self.eln_man.get_template_experiment_list(query)
-        return self._find_template(self._templates, name, active, version, first_match)
+        return self._find_template(self._templates, name, active, version, first_match, public)
 
 
     def get_protocol_template(self, name: str, active: bool = True, version: int | None = None,
-                              first_match: bool = False) -> ProtocolTemplateInfo:
+                              first_match: bool = False, public: bool | None = True) -> ProtocolTemplateInfo:
         """
         Get the protocol template with the given information. Will throw an exception if multiple templates match
         the given information.
@@ -91,6 +95,10 @@ class ExperimentCacheManager:
         :param active: Whether the template is marked as active.
         :param version: The version of the template to get. If None, the latest version will be returned.
         :param first_match: If true, returns the first match found. If false, raises an exception.
+        :param public: Whether the template is public. If true, only pubic templates will be queried. If false, only
+            private templates will be queried. If None, both public and private templates will be queried. Non-public
+            templates do not have a version number, so this will always fail if public is false and a version number is
+            provided.
         :return: The protocol template with the given information.
         """
         if not hasattr(self, "_protocols"):
@@ -98,11 +106,11 @@ class ExperimentCacheManager:
             query.active_templates_only = False
             query.latest_version_only = False
             self._protocols = self.eln_man.get_protocol_template_info_list(query)
-        return self._find_template(self._protocols, name, active, version, first_match)
+        return self._find_template(self._protocols, name, active, version, first_match, public)
 
     @staticmethod
     def _find_template(templates: list[ElnTemplate] | list[ProtocolTemplateInfo], name: str, active: bool,
-                       version: int, first_match: bool) -> ElnTemplate | ProtocolTemplateInfo:
+                       version: int, first_match: bool, public: bool | None) -> ElnTemplate | ProtocolTemplateInfo:
         """
         Find the experiment or protocol template with the given information.
         """
@@ -114,15 +122,22 @@ class ExperimentCacheManager:
                 continue
             if version is not None and template.template_version != version:
                 continue
+            if public is True and template.template_version is None:
+                continue
+            if public is False and template.template_version is not None:
+                continue
             matches.append(template)
         if not matches:
             raise SapioException(f"No template with the name \"{name}\"" +
                                  ("" if version is None else f" and the version {version}") +
                                  f" found.")
-        if not version:
-            return max(matches, key=lambda x: x.template_version)
+        # Only filter for the max version number if any of the matches actually have a version number.
+        versioned_matches = [x for x in matches if x.template_version is not None]
+        if version is None and versioned_matches:
+            return max(versioned_matches, key=lambda x: x.template_version)
         if len(matches) > 1 and not first_match:
-            raise SapioException(f"Multiple templates with the name \"{name}\" found.")
+            raise SapioException(f"Multiple templates with the name \"{name}\" found. Consider setting first_match to "
+                                 f"true, or restrict your search criteria further.")
         return matches[0]
 
     def get_predefined_field(self, field_name: str, data_type: ElnBaseDataType) -> AbstractVeloxFieldDefinition:

sapiopycommons/eln/step_creation.py

@@ -185,6 +185,7 @@ class GlobalDtTableStepCreation(StepCreation):
         self.layout_name = None
         self.extension_types = None
         self.table_columns = None
+        self.field_names = None
         self.show_key_fields = None
 
 

{sapiopycommons-2025.4.15a484.dist-info → sapiopycommons-2025.4.16a485.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: sapiopycommons
-Version: 2025.4.15a484
+Version: 2025.4.16a485
 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-2025.4.15a484.dist-info → sapiopycommons-2025.4.16a485.dist-info}/RECORD

@@ -15,13 +15,13 @@ sapiopycommons/datatype/attachment_util.py,sha256=N-nhsJ0oxa_Ft6Y6VWeNFYLzfuQqsj
 sapiopycommons/datatype/data_fields.py,sha256=pczUlEcE0TeHEDU0Gkvu7voacSLPXCB7l9UbI1Tb6V0,5656
 sapiopycommons/datatype/pseudo_data_types.py,sha256=lAJDnFuStrUP0mK5AuYlFvLerwjEB-ABd6Z4qlCrwJA,40637
 sapiopycommons/eln/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sapiopycommons/eln/experiment_cache.py,sha256=kiYZBZEAuQpv-rFviv8_6g7uvXdzH9BMUEprvAHT0Ds,8181
+sapiopycommons/eln/experiment_cache.py,sha256=Zv4IcsAl95ftO2ul3DRc_Hyno0AfC3OvFV7RYb72ITo,9560
 sapiopycommons/eln/experiment_handler.py,sha256=7vYRlYAW_xT5LcZ5nLqL9dxEHGRAPEuUxX8d8TElWV8,105742
 sapiopycommons/eln/experiment_report_util.py,sha256=NNNNPVD3_2ZAjoOqCMOnlnmPD0SCjDcgYi453ATSJBs,37027
 sapiopycommons/eln/experiment_step_factory.py,sha256=qw9UfLslVzB6dEIZPOZ85XHKpld81RhD4-csM6TgQNg,26099
 sapiopycommons/eln/experiment_tags.py,sha256=7-fpOiSqrjbXmWIJhEhaxMgLsVCPAtKqH8xRzpDVKoE,356
 sapiopycommons/eln/plate_designer.py,sha256=XFazSvhTbSy47t80-jc2tyx_-fQ_IUjKd18JQKEFcsY,13939
-sapiopycommons/eln/step_creation.py,sha256=d_2fEpGDMyas4nx2W_WviFaMsfw95epTT7sJoDuE94g,10139
+sapiopycommons/eln/step_creation.py,sha256=CFkGC-SxwAQpQlcs_obqLAVgmsNxKSGMqMtO_E6IVmw,10171
 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=vKbqxPexi15epr_-_qLrEfYoxNxB031mXN92iVtOMqE,9511
@@ -61,7 +61,7 @@ sapiopycommons/webhook/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 sapiopycommons/webhook/webhook_context.py,sha256=D793uLsb1691SalaPnBUk3rOSxn_hYLhdvkaIxjNXss,1909
 sapiopycommons/webhook/webhook_handlers.py,sha256=tUVNCw05CDGu1gFDm2g558hX_O203WVm_n__ojjoRRM,39841
 sapiopycommons/webhook/webservice_handlers.py,sha256=tyaYGG1-v_JJrJHZ6cy5mGCxX9z1foLw7pM4MDJlFxs,14297
-sapiopycommons-2025.4.15a484.dist-info/METADATA,sha256=qeCjsb8bTmQM3qISPoKn2kHnYVGRY5Kr_4OiLOzETZ8,3143
-sapiopycommons-2025.4.15a484.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-sapiopycommons-2025.4.15a484.dist-info/licenses/LICENSE,sha256=HyVuytGSiAUQ6ErWBHTqt1iSGHhLmlC8fO7jTCuR8dU,16725
-sapiopycommons-2025.4.15a484.dist-info/RECORD,,
+sapiopycommons-2025.4.16a485.dist-info/METADATA,sha256=0fBY9ysTmQxnwGRANJWN96fA5VtNSqBEtE81Uabzsdg,3143
+sapiopycommons-2025.4.16a485.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+sapiopycommons-2025.4.16a485.dist-info/licenses/LICENSE,sha256=HyVuytGSiAUQ6ErWBHTqt1iSGHhLmlC8fO7jTCuR8dU,16725
+sapiopycommons-2025.4.16a485.dist-info/RECORD,,