benchling-sdk 1.18.1__py3-none-any.whl → 1.19.0__py3-none-any.whl

benchling_sdk/services/v2/stable/dna_alignments_service.py

@@ -16,8 +16,8 @@ from benchling_sdk.helpers.logging_helpers import log_deprecation
 from benchling_sdk.helpers.pagination_helpers import NextToken, PageIterator
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import none_as_unset, optional_array_query_param
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     DnaAlignment,
     DnaAlignmentsPaginatedList,
     DnaAlignmentSummary,
@@ -126,7 +126,9 @@ class DnaAlignmentsService(BaseService):
         return PageIterator(api_call, results_extractor)
 
     @api_method
-    def create_template_alignment(self, template_alignment: DnaTemplateAlignmentCreate) -> AsyncTaskLink:
+    def create_template_alignment(
+        self, template_alignment: DnaTemplateAlignmentCreate
+    ) -> TaskHelper[DnaAlignment]:
         """
         Create a template DNA alignment (Deprecated).
 
@@ -141,10 +143,12 @@ class DnaAlignmentsService(BaseService):
         response = create_dna_template_alignment.sync_detailed(
             client=self.client, json_body=template_alignment
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, DnaAlignment)
 
     @api_method
-    def create_consensus_alignment(self, consensus_alignment: DnaConsensusAlignmentCreate) -> AsyncTaskLink:
+    def create_consensus_alignment(
+        self, consensus_alignment: DnaConsensusAlignmentCreate
+    ) -> TaskHelper[DnaAlignment]:
         """
         Create a consensus DNA alignment (Deprecated).
 
@@ -159,7 +163,7 @@ class DnaAlignmentsService(BaseService):
         response = create_dna_consensus_alignment.sync_detailed(
             client=self.client, json_body=consensus_alignment
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, DnaAlignment)
 
     @api_method
     def delete_alignment(self, dna_alignment_id: str) -> None:

benchling_sdk/services/v2/stable/dna_oligo_service.py

@@ -24,8 +24,10 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateDnaOligosAsyncTaskResponse,
+    BulkUpdateDnaOligosAsyncTaskResponse,
     DnaOligo,
     DnaOligoBulkUpdate,
     DnaOligoCreate,
@@ -227,7 +229,9 @@ class DnaOligoService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def bulk_create(self, dna_oligos: Iterable[DnaOligoCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, dna_oligos: Iterable[DnaOligoCreate]
+    ) -> TaskHelper[BulkCreateDnaOligosAsyncTaskResponse]:
         """
         Bulk create DNA Oligos.
 
@@ -235,10 +239,12 @@ class DnaOligoService(BaseService):
         """
         body = DnaOligosBulkCreateRequest(list(dna_oligos))
         response = bulk_create_dna_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateDnaOligosAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, dna_oligos: Iterable[DnaOligoBulkUpdate]) -> AsyncTaskLink:
+    def bulk_update(
+        self, dna_oligos: Iterable[DnaOligoBulkUpdate]
+    ) -> TaskHelper[BulkUpdateDnaOligosAsyncTaskResponse]:
         """
         Bulk update DNA oligos.
 
@@ -246,7 +252,7 @@ class DnaOligoService(BaseService):
         """
         body = DnaOligosBulkUpdateRequest(list(dna_oligos))
         response = bulk_update_dna_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateDnaOligosAsyncTaskResponse)
 
     @api_method
     def upsert(self, entity_registry_id: str, dna_oligo: OligoUpsertRequest) -> DnaOligo:
@@ -263,7 +269,7 @@ class DnaOligoService(BaseService):
     @api_method
     def bulk_upsert(
         self, body: DnaOligosBulkUpsertRequest, returning: Optional[Iterable[str]] = None
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[BulkUpdateDnaOligosAsyncTaskResponse]:
         """
         Bulk create or update DNA Oligos.
 
@@ -273,4 +279,4 @@ class DnaOligoService(BaseService):
         response = bulk_upsert_dna_oligos.sync_detailed(
             client=self.client, json_body=body, returning=none_as_unset(returning_string)
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateDnaOligosAsyncTaskResponse)

benchling_sdk/services/v2/stable/dna_sequence_service.py

@@ -34,10 +34,12 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import EmptyTaskResponse, TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     AutoAnnotateDnaSequences,
     AutofillSequences,
+    BulkCreateDnaSequencesAsyncTaskResponse,
+    BulkUpdateDnaSequencesAsyncTaskResponse,
     DnaSequence,
     DnaSequenceBulkCreate,
     DnaSequenceBulkUpdate,
@@ -53,6 +55,7 @@ from benchling_sdk.models import (
     DnaSequenceUpdate,
     DnaSequenceUpsertRequest,
     EntityArchiveReason,
+    FindMatchingRegionsDnaAsyncTaskResponse,
     ListDNASequencesSort,
     MatchBasesRequest,
     OptimizeCodons,
@@ -267,7 +270,9 @@ class DnaSequenceService(BaseService):
         return dna_sequences_results.dna_sequences
 
     @api_method
-    def bulk_create(self, dna_sequences: Iterable[DnaSequenceBulkCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, dna_sequences: Iterable[DnaSequenceBulkCreate]
+    ) -> TaskHelper[BulkCreateDnaSequencesAsyncTaskResponse]:
         """
         Bulk create DNA sequences.
 
@@ -275,10 +280,12 @@ class DnaSequenceService(BaseService):
         """
         body = DnaSequencesBulkCreateRequest(list(dna_sequences))
         response = bulk_create_dna_sequences.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateDnaSequencesAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, dna_sequences: Iterable[DnaSequenceBulkUpdate]) -> AsyncTaskLink:
+    def bulk_update(
+        self, dna_sequences: Iterable[DnaSequenceBulkUpdate]
+    ) -> TaskHelper[BulkUpdateDnaSequencesAsyncTaskResponse]:
         """
         Bulk update DNA sequences.
 
@@ -286,10 +293,10 @@ class DnaSequenceService(BaseService):
         """
         body = DnaSequencesBulkUpdateRequest(list(dna_sequences))
         response = bulk_update_dna_sequences.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateDnaSequencesAsyncTaskResponse)
 
     @api_method
-    def autofill_parts(self, dna_sequence_ids: Iterable[str]) -> AsyncTaskLink:
+    def autofill_parts(self, dna_sequence_ids: Iterable[str]) -> TaskHelper[EmptyTaskResponse]:
         """
         Autofill DNA sequence parts.
 
@@ -297,10 +304,10 @@ class DnaSequenceService(BaseService):
         """
         body = AutofillSequences(dna_sequence_ids=list(dna_sequence_ids))
         response = autofill_dna_sequence_parts.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
-    def autofill_transcriptions(self, dna_sequence_ids: Iterable[str]) -> AsyncTaskLink:
+    def autofill_transcriptions(self, dna_sequence_ids: Iterable[str]) -> TaskHelper[EmptyTaskResponse]:
         """
         Autofill DNA sequence transcriptions.
 
@@ -308,10 +315,10 @@ class DnaSequenceService(BaseService):
         """
         body = AutofillSequences(dna_sequence_ids=list(dna_sequence_ids))
         response = autofill_dna_sequence_transcriptions.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
-    def autofill_translations(self, dna_sequence_ids: Iterable[str]) -> AsyncTaskLink:
+    def autofill_translations(self, dna_sequence_ids: Iterable[str]) -> TaskHelper[EmptyTaskResponse]:
         """
         Autofill DNA sequence translations.
 
@@ -319,17 +326,17 @@ class DnaSequenceService(BaseService):
         """
         body = AutofillSequences(dna_sequence_ids=list(dna_sequence_ids))
         response = autofill_dna_sequence_translations.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
-    def auto_annotate(self, auto_annotate: AutoAnnotateDnaSequences) -> AsyncTaskLink:
+    def auto_annotate(self, auto_annotate: AutoAnnotateDnaSequences) -> TaskHelper[EmptyTaskResponse]:
         """
         Auto-annotate DNA sequences with matching features from specified Feature Libraries.
 
         See https://benchling.com/api/reference#/DNA%20Sequences/autoAnnotateDnaSequences
         """
         response = auto_annotate_dna_sequences.sync_detailed(client=self.client, json_body=auto_annotate)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
     def upsert(self, entity_registry_id: str, dna_sequence: DnaSequenceUpsertRequest) -> DnaSequence:
@@ -346,7 +353,7 @@ class DnaSequenceService(BaseService):
     @api_method
     def bulk_upsert(
         self, body: DnaSequencesBulkUpsertRequest, returning: Optional[Iterable[str]] = None
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[BulkUpdateDnaSequencesAsyncTaskResponse]:
         """
         Bulk create or update DNA sequences.
 
@@ -356,7 +363,7 @@ class DnaSequenceService(BaseService):
         response = bulk_upsert_dna_sequences.sync_detailed(
             client=self.client, json_body=body, returning=none_as_unset(returning_string)
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateDnaSequencesAsyncTaskResponse)
 
     @api_method
     def match_bases(self, match_bases_request: MatchBasesRequest) -> DnaSequencesPaginatedList:
@@ -390,7 +397,9 @@ class DnaSequenceService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def find_matching_regions(self, find_matching_region: DnaSequencesFindMatchingRegion) -> AsyncTaskLink:
+    def find_matching_regions(
+        self, find_matching_region: DnaSequencesFindMatchingRegion
+    ) -> TaskHelper[FindMatchingRegionsDnaAsyncTaskResponse]:
         """
         Find matching regions for DNA sequences.
 
@@ -399,14 +408,14 @@ class DnaSequenceService(BaseService):
         response = find_matching_regions_dna_sequences.sync_detailed(
             client=self.client, json_body=find_matching_region
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, FindMatchingRegionsDnaAsyncTaskResponse)
 
     @api_method
-    def optimize_codons(self, optimize_request: OptimizeCodons) -> AsyncTaskLink:
+    def optimize_codons(self, optimize_request: OptimizeCodons) -> TaskHelper[EmptyTaskResponse]:
         """
         Create codon-optimized DNA sequences.
 
         See https://benchling.com/api/reference#/DNA%20Sequences/optimizeCodons
         """
         response = optimize_codons.sync_detailed(client=self.client, json_body=optimize_request)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)

benchling_sdk/services/v2/stable/export_service.py

@@ -1,8 +1,8 @@
 from benchling_api_client.v2.stable.api.exports import export_item
 
 from benchling_sdk.helpers.decorators import api_method
-from benchling_sdk.helpers.response_helpers import model_from_detailed
-from benchling_sdk.models import AsyncTaskLink, ExportItemRequest
+from benchling_sdk.helpers.task_helpers import TaskHelper
+from benchling_sdk.models import ExportItemRequest, ExportsAsyncTaskResponse
 from benchling_sdk.services.v2.base_service import BaseService
 
 
@@ -16,7 +16,7 @@ class ExportService(BaseService):
     """
 
     @api_method
-    def export(self, export_request: ExportItemRequest) -> AsyncTaskLink:
+    def export(self, export_request: ExportItemRequest) -> TaskHelper[ExportsAsyncTaskResponse]:
         """
         Export a Notebook Entry.
 
@@ -27,4 +27,4 @@ class ExportService(BaseService):
         See https://benchling.com/api/reference#/Exports/exportItem
         """
         response = export_item.sync_detailed(client=self.client, json_body=export_request)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, ExportsAsyncTaskResponse)

benchling_sdk/services/v2/stable/feature_library_service.py

@@ -19,8 +19,9 @@ from benchling_sdk.helpers.decorators import api_method
 from benchling_sdk.helpers.pagination_helpers import NextToken, PageIterator
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import none_as_unset, optional_array_query_param
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateFeaturesAsyncTaskResponse,
     Feature,
     FeatureBulkCreate,
     FeatureCreate,
@@ -244,7 +245,9 @@ class FeatureLibraryService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def bulk_create_features(self, features: Iterable[FeatureBulkCreate]) -> AsyncTaskLink:
+    def bulk_create_features(
+        self, features: Iterable[FeatureBulkCreate]
+    ) -> TaskHelper[BulkCreateFeaturesAsyncTaskResponse]:
         """
         Bulk create features.
 
@@ -252,4 +255,4 @@ class FeatureLibraryService(BaseService):
         """
         body = FeaturesBulkCreateRequest(list(features))
         response = bulk_create_features.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateFeaturesAsyncTaskResponse)

benchling_sdk/services/v2/stable/lab_automation_service.py

@@ -21,8 +21,8 @@ from benchling_sdk.helpers.decorators import api_method
 from benchling_sdk.helpers.pagination_helpers import NextToken, PageIterator
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import none_as_unset
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     AutomationInputGenerator,
     AutomationInputGeneratorUpdate,
     AutomationOutputProcessor,
@@ -101,7 +101,7 @@ class LabAutomationService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def generate_input(self, input_generator_id: str) -> AsyncTaskLink:
+    def generate_input(self, input_generator_id: str) -> TaskHelper[AutomationInputGenerator]:
         """
         Generate input with an Automation Input Generator.
 
@@ -110,10 +110,10 @@ class LabAutomationService(BaseService):
         response = generate_input_with_automation_input_generator.sync_detailed(
             client=self.client, input_generator_id=input_generator_id
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, AutomationInputGenerator)
 
     @api_method
-    def process_output(self, output_processor_id: str) -> AsyncTaskLink:
+    def process_output(self, output_processor_id: str) -> TaskHelper[AutomationOutputProcessor]:
         """
         Process output with an Automation Output Processor.
 
@@ -122,7 +122,7 @@ class LabAutomationService(BaseService):
         response = process_output_with_automation_output_processor.sync_detailed(
             client=self.client, output_processor_id=output_processor_id
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, AutomationOutputProcessor)
 
     @api_method
     def _automation_output_processors_page(

benchling_sdk/services/v2/stable/nucleotide_alignments_service.py

@@ -15,8 +15,8 @@ from benchling_sdk.helpers.decorators import api_method
 from benchling_sdk.helpers.pagination_helpers import NextToken, PageIterator
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import none_as_unset, optional_array_query_param
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     ListNucleotideAlignmentsSort,
     NucleotideAlignment,
     NucleotideAlignmentsPaginatedList,
@@ -118,7 +118,7 @@ class NucleotideAlignmentsService(BaseService):
     @api_method
     def create_template_alignment(
         self, template_alignment: NucleotideTemplateAlignmentCreate
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[NucleotideAlignment]:
         """
         Create a template Nucleotide alignment.
 
@@ -127,12 +127,12 @@ class NucleotideAlignmentsService(BaseService):
         response = create_template_nucleotide_alignment.sync_detailed(
             client=self.client, json_body=template_alignment
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, NucleotideAlignment)
 
     @api_method
     def create_consensus_alignment(
         self, consensus_alignment: NucleotideConsensusAlignmentCreate
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[NucleotideAlignment]:
         """
         Create a consensus Nucleotide alignment.
 
@@ -141,7 +141,7 @@ class NucleotideAlignmentsService(BaseService):
         response = create_consensus_nucleotide_alignment.sync_detailed(
             client=self.client, json_body=consensus_alignment
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, NucleotideAlignment)
 
     @api_method
     def delete_alignment(self, alignment_id: str) -> None:

benchling_sdk/services/v2/stable/oligo_service.py

@@ -23,8 +23,9 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateDnaOligosAsyncTaskResponse,
     DnaOligo,
     EntityArchiveReason,
     ListOligosSort,
@@ -269,7 +270,7 @@ class OligoService(BaseService):
         return oligos_results.oligos
 
     @api_method
-    def bulk_create(self, oligos: Iterable[OligoCreate]) -> AsyncTaskLink:
+    def bulk_create(self, oligos: Iterable[OligoCreate]) -> TaskHelper[BulkCreateDnaOligosAsyncTaskResponse]:
         """
         Bulk create DNA Oligos (Deprecated).
 
@@ -282,4 +283,4 @@ class OligoService(BaseService):
         log_deprecation("oligos.bulk_create", "dna_oligos.bulk_create or rna_oligos.bulk_create")
         body = OligosBulkCreateRequest(list(oligos))
         response = bulk_create_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateDnaOligosAsyncTaskResponse)

benchling_sdk/services/v2/stable/registry_service.py

@@ -13,9 +13,9 @@ from benchling_sdk.helpers.decorators import api_method
 from benchling_sdk.helpers.logging_helpers import check_for_csv_bug_fix
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import array_query_param
+from benchling_sdk.helpers.task_helpers import EmptyTaskResponse, TaskHelper
 from benchling_sdk.models import (
     AaSequenceWithEntityType,
-    AsyncTaskLink,
     CustomEntityWithEntityType,
     DnaOligoWithEntityType,
     DnaSequenceWithEntityType,
@@ -54,7 +54,7 @@ class RegistryService(BaseService):
         registry_id: str,
         entity_ids: Iterable[str],
         naming_strategy: NamingStrategy = NamingStrategy.NEW_IDS,
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[EmptyTaskResponse]:
         """
         Register entities.
 
@@ -70,7 +70,7 @@ class RegistryService(BaseService):
         response = register_entities.sync_detailed(
             client=self.client, registry_id=registry_id, json_body=registration_body
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
     def unregister(

benchling_sdk/services/v2/stable/rna_oligo_service.py

@@ -24,8 +24,10 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateRnaOligosAsyncTaskResponse,
+    BulkUpdateRnaOligosAsyncTaskResponse,
     EntityArchiveReason,
     ListRNAOligosSort,
     OligoUpsertRequest,
@@ -236,7 +238,9 @@ class RnaOligoService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def bulk_create(self, rna_oligos: Iterable[RnaOligoCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, rna_oligos: Iterable[RnaOligoCreate]
+    ) -> TaskHelper[BulkCreateRnaOligosAsyncTaskResponse]:
         """
         Bulk create RNA Oligos.
 
@@ -244,10 +248,12 @@ class RnaOligoService(BaseService):
         """
         body = RnaOligosBulkCreateRequest(list(rna_oligos))
         response = bulk_create_rna_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateRnaOligosAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, rna_oligos: Iterable[RnaOligoBulkUpdate]) -> AsyncTaskLink:
+    def bulk_update(
+        self, rna_oligos: Iterable[RnaOligoBulkUpdate]
+    ) -> TaskHelper[BulkUpdateRnaOligosAsyncTaskResponse]:
         """
         Bulk update RNA oligos.
 
@@ -255,7 +261,7 @@ class RnaOligoService(BaseService):
         """
         body = RnaOligosBulkUpdateRequest(list(rna_oligos))
         response = bulk_update_rna_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateRnaOligosAsyncTaskResponse)
 
     @api_method
     def upsert(self, entity_registry_id: str, rna_oligo: OligoUpsertRequest) -> RnaOligo:
@@ -272,7 +278,7 @@ class RnaOligoService(BaseService):
     @api_method
     def bulk_upsert(
         self, body: RnaOligosBulkUpsertRequest, returning: Optional[Iterable[str]] = None
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[BulkUpdateRnaOligosAsyncTaskResponse]:
         """
         Bulk create or update RNA Oligos.
 
@@ -282,4 +288,4 @@ class RnaOligoService(BaseService):
         response = bulk_upsert_rna_oligos.sync_detailed(
             client=self.client, json_body=body, returning=none_as_unset(returning_string)
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateRnaOligosAsyncTaskResponse)

benchling_sdk/services/v2/stable/rna_sequence_service.py

@@ -28,9 +28,11 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import EmptyTaskResponse, TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     AutoAnnotateRnaSequences,
+    BulkCreateRnaSequencesAsyncTaskResponse,
+    BulkUpdateRnaSequencesAsyncTaskResponse,
     EntityArchiveReason,
     ListRNASequencesSort,
     MatchBasesRequest,
@@ -267,7 +269,9 @@ class RnaSequenceService(BaseService):
         return rna_sequences_results.rna_sequences
 
     @api_method
-    def bulk_create(self, rna_sequences: Iterable[RnaSequenceBulkCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, rna_sequences: Iterable[RnaSequenceBulkCreate]
+    ) -> TaskHelper[BulkCreateRnaSequencesAsyncTaskResponse]:
         """
         Bulk create RNA sequences.
 
@@ -275,10 +279,12 @@ class RnaSequenceService(BaseService):
         """
         body = RnaSequencesBulkCreateRequest(list(rna_sequences))
         response = bulk_create_rna_sequences.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateRnaSequencesAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, rna_sequences: Iterable[RnaSequenceBulkUpdate]) -> AsyncTaskLink:
+    def bulk_update(
+        self, rna_sequences: Iterable[RnaSequenceBulkUpdate]
+    ) -> TaskHelper[BulkUpdateRnaSequencesAsyncTaskResponse]:
         """
         Bulk update RNA sequences.
 
@@ -286,10 +292,10 @@ class RnaSequenceService(BaseService):
         """
         body = RnaSequencesBulkUpdateRequest(list(rna_sequences))
         response = bulk_update_rna_sequences.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateRnaSequencesAsyncTaskResponse)
 
     @api_method
-    def autofill_parts(self, rna_sequence_ids: Iterable[str]) -> AsyncTaskLink:
+    def autofill_parts(self, rna_sequence_ids: Iterable[str]) -> TaskHelper[EmptyTaskResponse]:
         """
         Autofill RNA sequence parts.
 
@@ -297,10 +303,10 @@ class RnaSequenceService(BaseService):
         """
         body = AutofillRnaSequences(rna_sequence_ids=list(rna_sequence_ids))
         response = autofill_rna_sequence_parts.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
-    def autofill_translations(self, rna_sequence_ids: Iterable[str]) -> AsyncTaskLink:
+    def autofill_translations(self, rna_sequence_ids: Iterable[str]) -> TaskHelper[EmptyTaskResponse]:
         """
         Autofill RNA sequence translations.
 
@@ -308,17 +314,17 @@ class RnaSequenceService(BaseService):
         """
         body = AutofillRnaSequences(rna_sequence_ids=list(rna_sequence_ids))
         response = autofill_rna_sequence_translations.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
-    def auto_annotate(self, auto_annotate: AutoAnnotateRnaSequences) -> AsyncTaskLink:
+    def auto_annotate(self, auto_annotate: AutoAnnotateRnaSequences) -> TaskHelper[EmptyTaskResponse]:
         """
         Auto-annotate RNA sequences with matching features from specified Feature Libraries.
 
         See https://benchling.com/api/reference#/RNA%20Sequences/autoAnnotateRnaSequences
         """
         response = auto_annotate_rna_sequences.sync_detailed(client=self.client, json_body=auto_annotate)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
     def match_bases(self, match_bases_request: MatchBasesRequest) -> RnaSequencesPaginatedList:

benchling_sdk/services/v2/stable/task_service.py

@@ -32,6 +32,10 @@ class TaskService(BaseService):
     You can access a task for up to 30 minutes after its completion, after which its data will no longer be
     available.
 
+    Note that as of SDK version 1.19.0, most endpoint methods that create long-running tasks now return
+    a :py:class:`benchling_sdk.helpers.task_helpers.TaskHelper`, which allows you to get the task result
+    more conveniently as a specific model type.
+
     See https://benchling.com/api/reference#/Tasks
     """
 

{benchling_sdk-1.18.1.dist-info → benchling_sdk-1.19.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: benchling-sdk
-Version: 1.18.1
+Version: 1.19.0
 Summary: SDK for interacting with the Benchling Platform.
 License: Apache-2.0
 Author: Benchling Support
@@ -17,7 +17,7 @@ Provides-Extra: python-jose
 Requires-Dist: PyYAML (>=6.0,<7.0)
 Requires-Dist: attrs (>=20.1.0)
 Requires-Dist: backoff (>=1.10.0,<3)
-Requires-Dist: benchling-api-client (==2.0.336)
+Requires-Dist: benchling-api-client (==2.0.338)
 Requires-Dist: certifi (>=2022.12.7)
 Requires-Dist: cryptography (>=42.0.0) ; extra == "cryptography"
 Requires-Dist: dataclasses-json (>=0.5.2,<0.6.0)