arkindex-base-worker 0.4.0__py3-none-any.whl → 0.4.0a2__py3-none-any.whl

tests/test_elements_worker/test_transcriptions.py

@@ -0,0 +1,2102 @@
+import json
+import re
+from uuid import UUID
+
+import pytest
+from apistar.exceptions import ErrorResponse
+from playhouse.shortcuts import model_to_dict
+
+from arkindex_worker.cache import CachedElement, CachedTranscription
+from arkindex_worker.models import Element
+from arkindex_worker.worker.transcription import TextOrientation
+
+from . import BASE_API_CALLS
+
+TRANSCRIPTIONS_SAMPLE = [
+    {
+        "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+        "confidence": 0.5,
+        "text": "The",
+    },
+    {
+        "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+        "confidence": 0.75,
+        "text": "first",
+        "element_confidence": 0.75,
+    },
+    {
+        "polygon": [[1000, 300], [1200, 300], [1200, 500], [1000, 500]],
+        "confidence": 0.9,
+        "text": "line",
+    },
+]
+
+
+def test_create_transcription_wrong_element(mock_elements_worker):
+    with pytest.raises(
+        AssertionError,
+        match="element shouldn't be null and should be an Element or CachedElement",
+    ):
+        mock_elements_worker.create_transcription(
+            element=None,
+            text="i am a line",
+            confidence=0.42,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="element shouldn't be null and should be an Element or CachedElement",
+    ):
+        mock_elements_worker.create_transcription(
+            element="not element type",
+            text="i am a line",
+            confidence=0.42,
+        )
+
+
+def test_create_transcription_wrong_text(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+
+    with pytest.raises(
+        AssertionError, match="text shouldn't be null and should be of type str"
+    ):
+        mock_elements_worker.create_transcription(
+            element=elt,
+            text=None,
+            confidence=0.42,
+        )
+
+    with pytest.raises(
+        AssertionError, match="text shouldn't be null and should be of type str"
+    ):
+        mock_elements_worker.create_transcription(
+            element=elt,
+            text=1234,
+            confidence=0.42,
+        )
+
+
+def test_create_transcription_wrong_confidence(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcription(
+            element=elt,
+            text="i am a line",
+            confidence=None,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcription(
+            element=elt,
+            text="i am a line",
+            confidence="wrong confidence",
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcription(
+            element=elt,
+            text="i am a line",
+            confidence=0,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcription(
+            element=elt,
+            text="i am a line",
+            confidence=2.00,
+        )
+
+
+def test_create_transcription_default_orientation(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcription/",
+        status=200,
+        json={
+            "id": "56785678-5678-5678-5678-567856785678",
+            "text": "Animula vagula blandula",
+            "confidence": 0.42,
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        },
+    )
+    mock_elements_worker.create_transcription(
+        element=elt,
+        text="Animula vagula blandula",
+        confidence=0.42,
+    )
+    assert json.loads(responses.calls[-1].request.body) == {
+        "text": "Animula vagula blandula",
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "confidence": 0.42,
+        "orientation": "horizontal-lr",
+    }
+
+
+def test_create_transcription_orientation(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcription/",
+        status=200,
+        json={
+            "id": "56785678-5678-5678-5678-567856785678",
+            "text": "Animula vagula blandula",
+            "confidence": 0.42,
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        },
+    )
+    mock_elements_worker.create_transcription(
+        element=elt,
+        text="Animula vagula blandula",
+        orientation=TextOrientation.VerticalLeftToRight,
+        confidence=0.42,
+    )
+    assert json.loads(responses.calls[-1].request.body) == {
+        "text": "Animula vagula blandula",
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "confidence": 0.42,
+        "orientation": "vertical-lr",
+    }
+
+
+def test_create_transcription_wrong_orientation(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    with pytest.raises(
+        AssertionError,
+        match="orientation shouldn't be null and should be of type TextOrientation",
+    ):
+        mock_elements_worker.create_transcription(
+            element=elt,
+            text="Animula vagula blandula",
+            confidence=0.26,
+            orientation="elliptical",
+        )
+
+
+def test_create_transcription_api_error(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcription/",
+        status=418,
+    )
+
+    with pytest.raises(ErrorResponse):
+        mock_elements_worker.create_transcription(
+            element=elt,
+            text="i am a line",
+            confidence=0.42,
+        )
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        ("POST", f"http://testserver/api/v1/element/{elt.id}/transcription/")
+    ]
+
+
+def test_create_transcription(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcription/",
+        status=200,
+        json={
+            "id": "56785678-5678-5678-5678-567856785678",
+            "text": "i am a line",
+            "confidence": 0.42,
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        },
+    )
+
+    mock_elements_worker.create_transcription(
+        element=elt,
+        text="i am a line",
+        confidence=0.42,
+    )
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        ("POST", f"http://testserver/api/v1/element/{elt.id}/transcription/"),
+    ]
+
+    assert json.loads(responses.calls[-1].request.body) == {
+        "text": "i am a line",
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "confidence": 0.42,
+        "orientation": "horizontal-lr",
+    }
+
+
+def test_create_transcription_with_cache(responses, mock_elements_worker_with_cache):
+    elt = CachedElement.create(id="12341234-1234-1234-1234-123412341234", type="thing")
+
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcription/",
+        status=200,
+        json={
+            "id": "56785678-5678-5678-5678-567856785678",
+            "text": "i am a line",
+            "confidence": 0.42,
+            "orientation": "horizontal-lr",
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        },
+    )
+
+    mock_elements_worker_with_cache.create_transcription(
+        element=elt,
+        text="i am a line",
+        confidence=0.42,
+    )
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        ("POST", f"http://testserver/api/v1/element/{elt.id}/transcription/"),
+    ]
+
+    assert json.loads(responses.calls[-1].request.body) == {
+        "text": "i am a line",
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "orientation": "horizontal-lr",
+        "confidence": 0.42,
+    }
+
+    # Check that created transcription was properly stored in SQLite cache
+    assert list(CachedTranscription.select()) == [
+        CachedTranscription(
+            id=UUID("56785678-5678-5678-5678-567856785678"),
+            element_id=UUID(elt.id),
+            text="i am a line",
+            confidence=0.42,
+            orientation=TextOrientation.HorizontalLeftToRight,
+            worker_version_id=None,
+            worker_run_id=UUID("56785678-5678-5678-5678-567856785678"),
+        )
+    ]
+
+
+def test_create_transcription_orientation_with_cache(
+    responses, mock_elements_worker_with_cache
+):
+    elt = CachedElement.create(id="12341234-1234-1234-1234-123412341234", type="thing")
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcription/",
+        status=200,
+        json={
+            "id": "56785678-5678-5678-5678-567856785678",
+            "text": "Animula vagula blandula",
+            "confidence": 0.42,
+            "orientation": "vertical-lr",
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        },
+    )
+    mock_elements_worker_with_cache.create_transcription(
+        element=elt,
+        text="Animula vagula blandula",
+        orientation=TextOrientation.VerticalLeftToRight,
+        confidence=0.42,
+    )
+    assert json.loads(responses.calls[-1].request.body) == {
+        "text": "Animula vagula blandula",
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "orientation": "vertical-lr",
+        "confidence": 0.42,
+    }
+    # Check that the text orientation was properly stored in SQLite cache
+    assert list(map(model_to_dict, CachedTranscription.select())) == [
+        {
+            "id": UUID("56785678-5678-5678-5678-567856785678"),
+            "element": {
+                "id": UUID("12341234-1234-1234-1234-123412341234"),
+                "parent_id": None,
+                "type": "thing",
+                "image": None,
+                "polygon": None,
+                "rotation_angle": 0,
+                "mirrored": False,
+                "initial": False,
+                "worker_version_id": None,
+                "worker_run_id": None,
+                "confidence": None,
+            },
+            "text": "Animula vagula blandula",
+            "confidence": 0.42,
+            "orientation": TextOrientation.VerticalLeftToRight.value,
+            "worker_version_id": None,
+            "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+        }
+    ]
+
+
+def test_create_transcriptions_wrong_transcriptions(mock_elements_worker):
+    with pytest.raises(
+        AssertionError,
+        match="transcriptions shouldn't be null and should be of type list",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=None,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="transcriptions shouldn't be null and should be of type list",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=1234,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: element_id shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "text": "word",
+                    "confidence": 0.5,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: element_id shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": None,
+                    "text": "word",
+                    "confidence": 0.5,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: element_id shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": 1234,
+                    "text": "word",
+                    "confidence": 0.5,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: text shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "confidence": 0.5,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: text shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": None,
+                    "confidence": 0.5,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: text shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": 1234,
+                    "confidence": 0.5,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "word",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "word",
+                    "confidence": None,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "word",
+                    "confidence": "a wrong confidence",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "word",
+                    "confidence": 0,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "word",
+                    "confidence": 2.00,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: orientation shouldn't be null and should be of type TextOrientation",
+    ):
+        mock_elements_worker.create_transcriptions(
+            transcriptions=[
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "confidence": 0.75,
+                },
+                {
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "word",
+                    "confidence": 0.28,
+                    "orientation": "wobble",
+                },
+            ],
+        )
+
+
+def test_create_transcriptions_api_error(responses, mock_elements_worker):
+    responses.add(
+        responses.POST,
+        "http://testserver/api/v1/transcription/bulk/",
+        status=418,
+    )
+    trans = [
+        {
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "text": "The",
+            "confidence": 0.75,
+        },
+        {
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "text": "word",
+            "confidence": 0.42,
+        },
+    ]
+
+    with pytest.raises(ErrorResponse):
+        mock_elements_worker.create_transcriptions(transcriptions=trans)
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [("POST", "http://testserver/api/v1/transcription/bulk/")]
+
+
+def test_create_transcriptions(responses, mock_elements_worker_with_cache):
+    CachedElement.create(id="11111111-1111-1111-1111-111111111111", type="thing")
+    trans = [
+        {
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "text": "The",
+            "confidence": 0.75,
+        },
+        {
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "text": "word",
+            "confidence": 0.42,
+        },
+    ]
+
+    responses.add(
+        responses.POST,
+        "http://testserver/api/v1/transcription/bulk/",
+        status=200,
+        json={
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+            "transcriptions": [
+                {
+                    "id": "00000000-0000-0000-0000-000000000000",
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "The",
+                    "orientation": "horizontal-lr",
+                    "confidence": 0.75,
+                },
+                {
+                    "id": "11111111-1111-1111-1111-111111111111",
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "word",
+                    "orientation": "horizontal-lr",
+                    "confidence": 0.42,
+                },
+            ],
+        },
+    )
+
+    mock_elements_worker_with_cache.create_transcriptions(
+        transcriptions=trans,
+    )
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        ("POST", "http://testserver/api/v1/transcription/bulk/"),
+    ]
+
+    assert json.loads(responses.calls[-1].request.body) == {
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "transcriptions": [
+            {
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "text": "The",
+                "confidence": 0.75,
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+            },
+            {
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "text": "word",
+                "confidence": 0.42,
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+            },
+        ],
+    }
+
+    # Check that created transcriptions were properly stored in SQLite cache
+    assert list(CachedTranscription.select()) == [
+        CachedTranscription(
+            id=UUID("00000000-0000-0000-0000-000000000000"),
+            element_id=UUID("11111111-1111-1111-1111-111111111111"),
+            text="The",
+            confidence=0.75,
+            orientation=TextOrientation.HorizontalLeftToRight,
+            worker_run_id=UUID("56785678-5678-5678-5678-567856785678"),
+        ),
+        CachedTranscription(
+            id=UUID("11111111-1111-1111-1111-111111111111"),
+            element_id=UUID("11111111-1111-1111-1111-111111111111"),
+            text="word",
+            confidence=0.42,
+            orientation=TextOrientation.HorizontalLeftToRight,
+            worker_run_id=UUID("56785678-5678-5678-5678-567856785678"),
+        ),
+    ]
+
+
+def test_create_transcriptions_orientation(responses, mock_elements_worker_with_cache):
+    CachedElement.create(id="11111111-1111-1111-1111-111111111111", type="thing")
+    trans = [
+        {
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "text": "Animula vagula blandula",
+            "confidence": 0.12,
+            "orientation": TextOrientation.HorizontalRightToLeft,
+        },
+        {
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "text": "Hospes comesque corporis",
+            "confidence": 0.21,
+            "orientation": TextOrientation.VerticalLeftToRight,
+        },
+    ]
+
+    responses.add(
+        responses.POST,
+        "http://testserver/api/v1/transcription/bulk/",
+        status=200,
+        json={
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+            "transcriptions": [
+                {
+                    "id": "00000000-0000-0000-0000-000000000000",
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "Animula vagula blandula",
+                    "orientation": "horizontal-rl",
+                    "confidence": 0.12,
+                },
+                {
+                    "id": "11111111-1111-1111-1111-111111111111",
+                    "element_id": "11111111-1111-1111-1111-111111111111",
+                    "text": "Hospes comesque corporis",
+                    "orientation": "vertical-lr",
+                    "confidence": 0.21,
+                },
+            ],
+        },
+    )
+
+    mock_elements_worker_with_cache.create_transcriptions(
+        transcriptions=trans,
+    )
+
+    assert json.loads(responses.calls[-1].request.body) == {
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "transcriptions": [
+            {
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "text": "Animula vagula blandula",
+                "confidence": 0.12,
+                "orientation": TextOrientation.HorizontalRightToLeft.value,
+            },
+            {
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "text": "Hospes comesque corporis",
+                "confidence": 0.21,
+                "orientation": TextOrientation.VerticalLeftToRight.value,
+            },
+        ],
+    }
+
+    # Check that oriented transcriptions were properly stored in SQLite cache
+    assert list(map(model_to_dict, CachedTranscription.select())) == [
+        {
+            "id": UUID("00000000-0000-0000-0000-000000000000"),
+            "element": {
+                "id": UUID("11111111-1111-1111-1111-111111111111"),
+                "parent_id": None,
+                "type": "thing",
+                "image": None,
+                "polygon": None,
+                "rotation_angle": 0,
+                "mirrored": False,
+                "initial": False,
+                "worker_version_id": None,
+                "worker_run_id": None,
+                "confidence": None,
+            },
+            "text": "Animula vagula blandula",
+            "confidence": 0.12,
+            "orientation": TextOrientation.HorizontalRightToLeft.value,
+            "worker_version_id": None,
+            "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+        },
+        {
+            "id": UUID("11111111-1111-1111-1111-111111111111"),
+            "element": {
+                "id": UUID("11111111-1111-1111-1111-111111111111"),
+                "parent_id": None,
+                "type": "thing",
+                "image": None,
+                "polygon": None,
+                "rotation_angle": 0,
+                "mirrored": False,
+                "initial": False,
+                "worker_version_id": None,
+                "worker_run_id": None,
+                "confidence": None,
+            },
+            "text": "Hospes comesque corporis",
+            "confidence": 0.21,
+            "orientation": TextOrientation.VerticalLeftToRight.value,
+            "worker_version_id": None,
+            "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+        },
+    ]
+
+
+def test_create_element_transcriptions_wrong_element(mock_elements_worker):
+    with pytest.raises(
+        AssertionError,
+        match="element shouldn't be null and should be an Element or CachedElement",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=None,
+            sub_element_type="page",
+            transcriptions=TRANSCRIPTIONS_SAMPLE,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="element shouldn't be null and should be an Element or CachedElement",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element="not element type",
+            sub_element_type="page",
+            transcriptions=TRANSCRIPTIONS_SAMPLE,
+        )
+
+
+def test_create_element_transcriptions_wrong_sub_element_type(mock_elements_worker):
+    elt = Element({"zone": None})
+
+    with pytest.raises(
+        AssertionError,
+        match="sub_element_type shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type=None,
+            transcriptions=TRANSCRIPTIONS_SAMPLE,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="sub_element_type shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type=1234,
+            transcriptions=TRANSCRIPTIONS_SAMPLE,
+        )
+
+
+def test_create_element_transcriptions_wrong_transcriptions(mock_elements_worker):
+    elt = Element({"zone": None})
+
+    with pytest.raises(
+        AssertionError,
+        match="transcriptions shouldn't be null and should be of type list",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=None,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="transcriptions shouldn't be null and should be of type list",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=1234,
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: text shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": 0.5,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: text shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": 0.5,
+                    "text": None,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: text shouldn't be null and should be of type str",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": 0.5,
+                    "text": 1234,
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "text": "word",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": None,
+                    "text": "word",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": "a wrong confidence",
+                    "text": "word",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": 0,
+                    "text": "word",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: confidence shouldn't be null and should be a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": 2.00,
+                    "text": "word",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: polygon shouldn't be null and should be of type list",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {"confidence": 0.5, "text": "word"},
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: polygon shouldn't be null and should be of type list",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {"polygon": None, "confidence": 0.5, "text": "word"},
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: polygon shouldn't be null and should be of type list",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {"polygon": "not a polygon", "confidence": 0.5, "text": "word"},
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: polygon should have at least three points",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {"polygon": [[1, 1], [2, 2]], "confidence": 0.5, "text": "word"},
+            ],
+        )
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: polygon points should be lists of two items",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[1, 1, 1], [2, 2, 1], [2, 1, 1], [1, 2, 1]],
+                    "confidence": 0.5,
+                    "text": "word",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: polygon points should be lists of two items",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {"polygon": [[1], [2], [2], [1]], "confidence": 0.5, "text": "word"},
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: polygon points should be lists of two numbers",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [["not a coord", 1], [2, 2], [2, 1], [1, 2]],
+                    "confidence": 0.5,
+                    "text": "word",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match="Transcription at index 1 in transcriptions: orientation shouldn't be null and should be of type TextOrientation",
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": 0.35,
+                    "text": "word",
+                    "orientation": "uptown",
+                },
+            ],
+        )
+
+    with pytest.raises(
+        AssertionError,
+        match=re.escape(
+            "Transcription at index 1 in transcriptions: element_confidence should be either null or a float in [0..1] range"
+        ),
+    ):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=[
+                {
+                    "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                    "confidence": 0.75,
+                    "text": "The",
+                },
+                {
+                    "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                    "confidence": 0.75,
+                    "text": "word",
+                    "element_confidence": "not a confidence",
+                },
+            ],
+        )
+
+
+def test_create_element_transcriptions_api_error(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcriptions/bulk/",
+        status=418,
+    )
+
+    with pytest.raises(ErrorResponse):
+        mock_elements_worker.create_element_transcriptions(
+            element=elt,
+            sub_element_type="page",
+            transcriptions=TRANSCRIPTIONS_SAMPLE,
+        )
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        ("POST", f"http://testserver/api/v1/element/{elt.id}/transcriptions/bulk/")
+    ]
+
+
+def test_create_element_transcriptions(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcriptions/bulk/",
+        status=200,
+        json=[
+            {
+                "id": "56785678-5678-5678-5678-567856785678",
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "created": True,
+            },
+            {
+                "id": "67896789-6789-6789-6789-678967896789",
+                "element_id": "22222222-2222-2222-2222-222222222222",
+                "created": False,
+            },
+            {
+                "id": "78907890-7890-7890-7890-789078907890",
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "created": True,
+            },
+        ],
+    )
+
+    annotations = mock_elements_worker.create_element_transcriptions(
+        element=elt,
+        sub_element_type="page",
+        transcriptions=TRANSCRIPTIONS_SAMPLE,
+    )
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        ("POST", f"http://testserver/api/v1/element/{elt.id}/transcriptions/bulk/"),
+    ]
+
+    assert json.loads(responses.calls[-1].request.body) == {
+        "element_type": "page",
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "transcriptions": [
+            {
+                "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                "confidence": 0.5,
+                "text": "The",
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+            },
+            {
+                "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                "confidence": 0.75,
+                "text": "first",
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+                "element_confidence": 0.75,
+            },
+            {
+                "polygon": [[1000, 300], [1200, 300], [1200, 500], [1000, 500]],
+                "confidence": 0.9,
+                "text": "line",
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+            },
+        ],
+        "return_elements": True,
+    }
+    assert annotations == [
+        {
+            "id": "56785678-5678-5678-5678-567856785678",
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "created": True,
+        },
+        {
+            "id": "67896789-6789-6789-6789-678967896789",
+            "element_id": "22222222-2222-2222-2222-222222222222",
+            "created": False,
+        },
+        {
+            "id": "78907890-7890-7890-7890-789078907890",
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "created": True,
+        },
+    ]
+
+
+def test_create_element_transcriptions_with_cache(
+    responses, mock_elements_worker_with_cache
+):
+    elt = CachedElement(id="12341234-1234-1234-1234-123412341234", type="thing")
+
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcriptions/bulk/",
+        status=200,
+        json=[
+            {
+                "id": "56785678-5678-5678-5678-567856785678",
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "created": True,
+            },
+            {
+                "id": "67896789-6789-6789-6789-678967896789",
+                "element_id": "22222222-2222-2222-2222-222222222222",
+                "created": False,
+            },
+            {
+                "id": "78907890-7890-7890-7890-789078907890",
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "created": True,
+            },
+        ],
+    )
+
+    annotations = mock_elements_worker_with_cache.create_element_transcriptions(
+        element=elt,
+        sub_element_type="page",
+        transcriptions=TRANSCRIPTIONS_SAMPLE,
+    )
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        ("POST", f"http://testserver/api/v1/element/{elt.id}/transcriptions/bulk/"),
+    ]
+
+    assert json.loads(responses.calls[-1].request.body) == {
+        "element_type": "page",
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "transcriptions": [
+            {
+                "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                "confidence": 0.5,
+                "text": "The",
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+            },
+            {
+                "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                "confidence": 0.75,
+                "text": "first",
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+                "element_confidence": 0.75,
+            },
+            {
+                "polygon": [[1000, 300], [1200, 300], [1200, 500], [1000, 500]],
+                "confidence": 0.9,
+                "text": "line",
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+            },
+        ],
+        "return_elements": True,
+    }
+    assert annotations == [
+        {
+            "id": "56785678-5678-5678-5678-567856785678",
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "created": True,
+        },
+        {
+            "id": "67896789-6789-6789-6789-678967896789",
+            "element_id": "22222222-2222-2222-2222-222222222222",
+            "created": False,
+        },
+        {
+            "id": "78907890-7890-7890-7890-789078907890",
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "created": True,
+        },
+    ]
+
+    # Check that created transcriptions and elements were properly stored in SQLite cache
+    assert list(CachedElement.select()) == [
+        CachedElement(
+            id=UUID("11111111-1111-1111-1111-111111111111"),
+            parent_id=UUID("12341234-1234-1234-1234-123412341234"),
+            type="page",
+            polygon="[[100, 150], [700, 150], [700, 200], [100, 200]]",
+            worker_run_id=UUID("56785678-5678-5678-5678-567856785678"),
+        ),
+        CachedElement(
+            id=UUID("22222222-2222-2222-2222-222222222222"),
+            parent_id=UUID("12341234-1234-1234-1234-123412341234"),
+            type="page",
+            polygon="[[0, 0], [2000, 0], [2000, 3000], [0, 3000]]",
+            worker_run_id=UUID("56785678-5678-5678-5678-567856785678"),
+            confidence=0.75,
+        ),
+    ]
+    assert list(CachedTranscription.select()) == [
+        CachedTranscription(
+            id=UUID("56785678-5678-5678-5678-567856785678"),
+            element_id=UUID("11111111-1111-1111-1111-111111111111"),
+            text="The",
+            confidence=0.5,
+            orientation=TextOrientation.HorizontalLeftToRight.value,
+            worker_run_id=UUID("56785678-5678-5678-5678-567856785678"),
+        ),
+        CachedTranscription(
+            id=UUID("67896789-6789-6789-6789-678967896789"),
+            element_id=UUID("22222222-2222-2222-2222-222222222222"),
+            text="first",
+            confidence=0.75,
+            orientation=TextOrientation.HorizontalLeftToRight.value,
+            worker_run_id=UUID("56785678-5678-5678-5678-567856785678"),
+        ),
+        CachedTranscription(
+            id=UUID("78907890-7890-7890-7890-789078907890"),
+            element_id=UUID("11111111-1111-1111-1111-111111111111"),
+            text="line",
+            confidence=0.9,
+            orientation=TextOrientation.HorizontalLeftToRight.value,
+            worker_run_id=UUID("56785678-5678-5678-5678-567856785678"),
+        ),
+    ]
+
+
+def test_create_transcriptions_orientation_with_cache(
+    responses, mock_elements_worker_with_cache
+):
+    elt = CachedElement(id="12341234-1234-1234-1234-123412341234", type="thing")
+
+    responses.add(
+        responses.POST,
+        f"http://testserver/api/v1/element/{elt.id}/transcriptions/bulk/",
+        status=200,
+        json=[
+            {
+                "id": "56785678-5678-5678-5678-567856785678",
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "created": True,
+            },
+            {
+                "id": "67896789-6789-6789-6789-678967896789",
+                "element_id": "22222222-2222-2222-2222-222222222222",
+                "created": False,
+            },
+            {
+                "id": "78907890-7890-7890-7890-789078907890",
+                "element_id": "11111111-1111-1111-1111-111111111111",
+                "created": True,
+            },
+        ],
+    )
+
+    oriented_transcriptions = [
+        {
+            "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+            "confidence": 0.5,
+            "text": "Animula vagula blandula",
+        },
+        {
+            "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+            "confidence": 0.75,
+            "text": "Hospes comesque corporis",
+            "orientation": TextOrientation.VerticalLeftToRight,
+        },
+        {
+            "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+            "confidence": 0.9,
+            "text": "Quae nunc abibis in loca",
+            "orientation": TextOrientation.HorizontalRightToLeft,
+        },
+    ]
+
+    annotations = mock_elements_worker_with_cache.create_element_transcriptions(
+        element=elt,
+        sub_element_type="page",
+        transcriptions=oriented_transcriptions,
+    )
+
+    assert json.loads(responses.calls[-1].request.body) == {
+        "element_type": "page",
+        "worker_run_id": "56785678-5678-5678-5678-567856785678",
+        "transcriptions": [
+            {
+                "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                "confidence": 0.5,
+                "text": "Animula vagula blandula",
+                "orientation": TextOrientation.HorizontalLeftToRight.value,
+            },
+            {
+                "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                "confidence": 0.75,
+                "text": "Hospes comesque corporis",
+                "orientation": TextOrientation.VerticalLeftToRight.value,
+            },
+            {
+                "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                "confidence": 0.9,
+                "text": "Quae nunc abibis in loca",
+                "orientation": TextOrientation.HorizontalRightToLeft.value,
+            },
+        ],
+        "return_elements": True,
+    }
+    assert annotations == [
+        {
+            "id": "56785678-5678-5678-5678-567856785678",
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "created": True,
+        },
+        {
+            "id": "67896789-6789-6789-6789-678967896789",
+            "element_id": "22222222-2222-2222-2222-222222222222",
+            "created": False,
+        },
+        {
+            "id": "78907890-7890-7890-7890-789078907890",
+            "element_id": "11111111-1111-1111-1111-111111111111",
+            "created": True,
+        },
+    ]
+
+    # Check that the text orientation was properly stored in SQLite cache
+    assert list(map(model_to_dict, CachedTranscription.select())) == [
+        {
+            "id": UUID("56785678-5678-5678-5678-567856785678"),
+            "element": {
+                "id": UUID("11111111-1111-1111-1111-111111111111"),
+                "parent_id": UUID(elt.id),
+                "type": "page",
+                "image": None,
+                "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                "rotation_angle": 0,
+                "mirrored": False,
+                "initial": False,
+                "worker_version_id": None,
+                "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+                "confidence": None,
+            },
+            "text": "Animula vagula blandula",
+            "confidence": 0.5,
+            "orientation": TextOrientation.HorizontalLeftToRight.value,
+            "worker_version_id": None,
+            "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+        },
+        {
+            "id": UUID("67896789-6789-6789-6789-678967896789"),
+            "element": {
+                "id": UUID("22222222-2222-2222-2222-222222222222"),
+                "parent_id": UUID(elt.id),
+                "type": "page",
+                "image": None,
+                "polygon": [[0, 0], [2000, 0], [2000, 3000], [0, 3000]],
+                "rotation_angle": 0,
+                "mirrored": False,
+                "initial": False,
+                "worker_version_id": None,
+                "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+                "confidence": None,
+            },
+            "text": "Hospes comesque corporis",
+            "confidence": 0.75,
+            "orientation": TextOrientation.VerticalLeftToRight.value,
+            "worker_version_id": None,
+            "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+        },
+        {
+            "id": UUID("78907890-7890-7890-7890-789078907890"),
+            "element": {
+                "id": UUID("11111111-1111-1111-1111-111111111111"),
+                "parent_id": UUID(elt.id),
+                "type": "page",
+                "image": None,
+                "polygon": [[100, 150], [700, 150], [700, 200], [100, 200]],
+                "rotation_angle": 0,
+                "mirrored": False,
+                "initial": False,
+                "worker_version_id": None,
+                "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+                "confidence": None,
+            },
+            "text": "Quae nunc abibis in loca",
+            "confidence": 0.9,
+            "orientation": TextOrientation.HorizontalRightToLeft.value,
+            "worker_version_id": None,
+            "worker_run_id": UUID("56785678-5678-5678-5678-567856785678"),
+        },
+    ]
+
+
+def test_list_transcriptions_wrong_element(mock_elements_worker):
+    with pytest.raises(
+        AssertionError,
+        match="element shouldn't be null and should be an Element or CachedElement",
+    ):
+        mock_elements_worker.list_transcriptions(element=None)
+
+    with pytest.raises(
+        AssertionError,
+        match="element shouldn't be null and should be an Element or CachedElement",
+    ):
+        mock_elements_worker.list_transcriptions(element="not element type")
+
+
+def test_list_transcriptions_wrong_element_type(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+
+    with pytest.raises(AssertionError, match="element_type should be of type str"):
+        mock_elements_worker.list_transcriptions(
+            element=elt,
+            element_type=1234,
+        )
+
+
+def test_list_transcriptions_wrong_recursive(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+
+    with pytest.raises(AssertionError, match="recursive should be of type bool"):
+        mock_elements_worker.list_transcriptions(
+            element=elt,
+            recursive="not bool",
+        )
+
+
+def test_list_transcriptions_wrong_worker_run(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+
+    with pytest.raises(
+        AssertionError, match="worker_run should be of type str or bool"
+    ):
+        mock_elements_worker.list_transcriptions(
+            element=elt,
+            worker_run=1234,
+        )
+
+
+def test_list_transcriptions_wrong_worker_version(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+
+    # WARNING: pytest.deprecated_call must be placed BEFORE pytest.raises, otherwise `match` argument won't be checked
+    with (
+        pytest.deprecated_call(
+            match="`worker_version` usage is deprecated. Consider using `worker_run` instead."
+        ),
+        pytest.raises(
+            AssertionError, match="worker_version should be of type str or bool"
+        ),
+    ):
+        mock_elements_worker.list_transcriptions(
+            element=elt,
+            worker_version=1234,
+        )
+
+
+def test_list_transcriptions_wrong_bool_worker_run(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+
+    with pytest.raises(
+        AssertionError, match="if of type bool, worker_run can only be set to False"
+    ):
+        mock_elements_worker.list_transcriptions(
+            element=elt,
+            worker_run=True,
+        )
+
+
+def test_list_transcriptions_wrong_bool_worker_version(mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+
+    # WARNING: pytest.deprecated_call must be placed BEFORE pytest.raises, otherwise `match` argument won't be checked
+    with (
+        pytest.deprecated_call(
+            match="`worker_version` usage is deprecated. Consider using `worker_run` instead."
+        ),
+        pytest.raises(
+            AssertionError,
+            match="if of type bool, worker_version can only be set to False",
+        ),
+    ):
+        mock_elements_worker.list_transcriptions(
+            element=elt,
+            worker_version=True,
+        )
+
+
+def test_list_transcriptions_api_error(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    responses.add(
+        responses.GET,
+        "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/",
+        status=418,
+    )
+
+    with pytest.raises(
+        Exception, match="Stopping pagination as data will be incomplete"
+    ):
+        next(mock_elements_worker.list_transcriptions(element=elt))
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 5
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        # We do 5 retries
+        (
+            "GET",
+            "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/",
+        ),
+        (
+            "GET",
+            "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/",
+        ),
+        (
+            "GET",
+            "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/",
+        ),
+        (
+            "GET",
+            "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/",
+        ),
+        (
+            "GET",
+            "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/",
+        ),
+    ]
+
+
+def test_list_transcriptions(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    trans = [
+        {
+            "id": "0000",
+            "text": "hey",
+            "confidence": 0.42,
+            "worker_version_id": "56785678-5678-5678-5678-567856785678",
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+            "element": None,
+        },
+        {
+            "id": "1111",
+            "text": "it's",
+            "confidence": 0.42,
+            "worker_version_id": "56785678-5678-5678-5678-567856785678",
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+            "element": None,
+        },
+        {
+            "id": "2222",
+            "text": "me",
+            "confidence": 0.42,
+            "worker_version_id": "56785678-5678-5678-5678-567856785678",
+            "worker_run_id": "56785678-5678-5678-5678-567856785678",
+            "element": None,
+        },
+    ]
+    responses.add(
+        responses.GET,
+        "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/",
+        status=200,
+        json={
+            "count": 3,
+            "next": None,
+            "results": trans,
+        },
+    )
+
+    for idx, transcription in enumerate(
+        mock_elements_worker.list_transcriptions(element=elt)
+    ):
+        assert transcription == trans[idx]
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        (
+            "GET",
+            "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/",
+        ),
+    ]
+
+
+def test_list_transcriptions_manual_worker_version(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    trans = [
+        {
+            "id": "0000",
+            "text": "hey",
+            "confidence": 0.42,
+            "worker_version_id": None,
+            "worker_run_id": None,
+            "element": None,
+        }
+    ]
+    responses.add(
+        responses.GET,
+        "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/?worker_version=False",
+        status=200,
+        json={
+            "count": 1,
+            "next": None,
+            "results": trans,
+        },
+    )
+
+    with pytest.deprecated_call(
+        match="`worker_version` usage is deprecated. Consider using `worker_run` instead."
+    ):
+        for idx, transcription in enumerate(
+            mock_elements_worker.list_transcriptions(element=elt, worker_version=False)
+        ):
+            assert transcription == trans[idx]
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        (
+            "GET",
+            "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/?worker_version=False",
+        ),
+    ]
+
+
+def test_list_transcriptions_manual_worker_run(responses, mock_elements_worker):
+    elt = Element({"id": "12341234-1234-1234-1234-123412341234"})
+    trans = [
+        {
+            "id": "0000",
+            "text": "hey",
+            "confidence": 0.42,
+            "worker_version_id": None,
+            "worker_run_id": None,
+            "element": None,
+        }
+    ]
+    responses.add(
+        responses.GET,
+        "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/?worker_run=False",
+        status=200,
+        json={
+            "count": 1,
+            "next": None,
+            "results": trans,
+        },
+    )
+
+    for idx, transcription in enumerate(
+        mock_elements_worker.list_transcriptions(element=elt, worker_run=False)
+    ):
+        assert transcription == trans[idx]
+
+    assert len(responses.calls) == len(BASE_API_CALLS) + 1
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS + [
+        (
+            "GET",
+            "http://testserver/api/v1/element/12341234-1234-1234-1234-123412341234/transcriptions/?worker_run=False",
+        ),
+    ]
+
+
+@pytest.mark.usefixtures("_mock_cached_transcriptions")
+@pytest.mark.parametrize(
+    ("filters", "expected_ids"),
+    [
+        # Filter on element should give first and sixth transcription
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+            },
+            (
+                "11111111-1111-1111-1111-111111111111",
+                "66666666-6666-6666-6666-666666666666",
+            ),
+        ),
+        # Filter on element and element_type should give first and sixth transcription
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+                "element_type": "page",
+            },
+            (
+                "11111111-1111-1111-1111-111111111111",
+                "66666666-6666-6666-6666-666666666666",
+            ),
+        ),
+        # Filter on element and worker run should give the first transcription
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+                "worker_run": "56785678-5678-5678-5678-567856785678",
+            },
+            ("11111111-1111-1111-1111-111111111111",),
+        ),
+        # Filter on element, manual worker run should give the sixth transcription
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+                "worker_run": False,
+            },
+            ("66666666-6666-6666-6666-666666666666",),
+        ),
+        # Filter recursively on element should give all transcriptions inserted
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+                "recursive": True,
+            },
+            (
+                "11111111-1111-1111-1111-111111111111",
+                "22222222-2222-2222-2222-222222222222",
+                "33333333-3333-3333-3333-333333333333",
+                "44444444-4444-4444-4444-444444444444",
+                "55555555-5555-5555-5555-555555555555",
+                "66666666-6666-6666-6666-666666666666",
+            ),
+        ),
+        # Filter recursively on element and element_type should give three transcriptions
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+                "element_type": "something_else",
+                "recursive": True,
+            },
+            (
+                "22222222-2222-2222-2222-222222222222",
+                "44444444-4444-4444-4444-444444444444",
+                "55555555-5555-5555-5555-555555555555",
+            ),
+        ),
+    ],
+)
+def test_list_transcriptions_with_cache(
+    responses, mock_elements_worker_with_cache, filters, expected_ids
+):
+    # Check we have 5 elements already present in database
+    assert CachedTranscription.select().count() == 6
+
+    # Query database through cache
+    transcriptions = mock_elements_worker_with_cache.list_transcriptions(**filters)
+    assert transcriptions.count() == len(expected_ids)
+    for transcription, expected_id in zip(
+        transcriptions.order_by(CachedTranscription.id), expected_ids, strict=True
+    ):
+        assert transcription.id == UUID(expected_id)
+
+    # Check the worker never hits the API for elements
+    assert len(responses.calls) == len(BASE_API_CALLS)
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS
+
+
+@pytest.mark.usefixtures("_mock_cached_transcriptions")
+@pytest.mark.parametrize(
+    ("filters", "expected_ids"),
+    [
+        # Filter on element and worker_version should give first transcription
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+                "worker_version": "56785678-5678-5678-5678-567856785678",
+            },
+            ("11111111-1111-1111-1111-111111111111",),
+        ),
+        # Filter recursively on element and worker_version should give four transcriptions
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+                "worker_version": "90129012-9012-9012-9012-901290129012",
+                "recursive": True,
+            },
+            (
+                "22222222-2222-2222-2222-222222222222",
+                "33333333-3333-3333-3333-333333333333",
+                "44444444-4444-4444-4444-444444444444",
+                "55555555-5555-5555-5555-555555555555",
+            ),
+        ),
+        # Filter on element with manually created transcription should give sixth transcription
+        (
+            {
+                "element": CachedElement(
+                    id="11111111-1111-1111-1111-111111111111", type="page"
+                ),
+                "worker_version": False,
+            },
+            ("66666666-6666-6666-6666-666666666666",),
+        ),
+    ],
+)
+def test_list_transcriptions_with_cache_deprecation(
+    responses, mock_elements_worker_with_cache, filters, expected_ids
+):
+    # Check we have 5 elements already present in database
+    assert CachedTranscription.select().count() == 6
+
+    with pytest.deprecated_call(
+        match="`worker_version` usage is deprecated. Consider using `worker_run` instead."
+    ):
+        # Query database through cache
+        transcriptions = mock_elements_worker_with_cache.list_transcriptions(**filters)
+    assert transcriptions.count() == len(expected_ids)
+    for transcription, expected_id in zip(
+        transcriptions.order_by(CachedTranscription.id), expected_ids, strict=True
+    ):
+        assert transcription.id == UUID(expected_id)
+
+    # Check the worker never hits the API for elements
+    assert len(responses.calls) == len(BASE_API_CALLS)
+    assert [
+        (call.request.method, call.request.url) for call in responses.calls
+    ] == BASE_API_CALLS