feat: add get_taxonomy_by_export_id method

openedx_tagging/core/tagging/api.py

@@ -67,6 +67,14 @@ def get_taxonomy(taxonomy_id: int) -> Taxonomy | None:
     return taxonomy.cast() if taxonomy else None
 
 
+def get_taxonomy_by_export_id(taxonomy_export_id: str) -> Taxonomy | None:
+    """
+    Returns a Taxonomy cast to the appropriate subclass which has the given export ID.
+    """
+    taxonomy = Taxonomy.objects.filter(export_id=taxonomy_export_id).first()
+    return taxonomy.cast() if taxonomy else None
+
+
 def get_taxonomies(enabled=True) -> QuerySet[Taxonomy]:
     """
     Returns a queryset containing the enabled taxonomies, sorted by name.

openedx_tagging/core/tagging/models/base.py

@@ -241,7 +241,7 @@ class Taxonomy(models.Model):
             "Indicates whether this taxonomy should be visible to object authors."
         ),
     )
-    # External ID that should only be used on import/export.
+    # Export ID that should only be used on import/export.
     # NOT use for any other purposes, you can use the numeric ID of the model instead;
     # this id is editable.
     export_id = models.CharField(