From 80714089d56e69eb2d4603a2bcc3bdd0adeb51a5 Mon Sep 17 00:00:00 2001 From: Kori Kuzma Date: Tue, 27 Oct 2026 14:27:41 -0400 Subject: [PATCH] feat: deprecate translator methods * `translate_to` and `translate_from` will be renamed in v3 close #623 --- src/ga4gh/vrs/extras/translator.py | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/src/ga4gh/vrs/extras/translator.py b/src/ga4gh/vrs/extras/translator.py index 4f5a8477..fcf3b2f0 100644 --- a/src/ga4gh/vrs/extras/translator.py +++ b/src/ga4gh/vrs/extras/translator.py @@ -80,9 +80,14 @@ def __init__( self.data_proxy = data_proxy self.identify = identify self.rle_seq_limit = rle_seq_limit - self.from_translators: dict[str, VariationFromStrProtocol] = {} - self.to_translators: dict[str, VariationToStrProtocol] = {} - + self.from_translators: dict[ + str, VariationFromStrProtocol + ] = {} # Will be renamed to ``to_vrs_translators`` in v3. + self.to_translators: dict[ + str, VariationToStrProtocol + ] = {} # Will be renamed to ``from_vrs_translators`` in v3. + + @deprecated("translate_from is deprecated and will be renamed to to_vrs in v3.") def translate_from( self, var: str, fmt: str | None = None, **kwargs ) -> models._VariationBase: @@ -136,6 +141,7 @@ def translate_from( msg = f"Unable to parse data as {', '.join(formats)}" raise ValueError(msg) + @deprecated("translate_to is deprecated and will be renamed to from_vrs in v3.") def translate_to(self, vo: models._VariationBase, fmt: str, **kwargs) -> list[str]: """Translate vrs object `vo` to named format `fmt`