Add translation_imported signal

.devcontainer/devcontainer.json

@@ -26,7 +26,12 @@
         "redhat.vscode-yaml",
         "tamasfe.even-better-toml",
         "the-compiler.python-tox"
-      ]
+      ],
+      "settings": {
+        "[python]": {
+          "editor.defaultFormatter": "charliermarsh.ruff"
+        }
+      }
     }
   }
 }

README.md

@@ -162,9 +162,14 @@ flowchart LR
 
 ```
 
+## Signals
 
+This app provides a single `wagtail_localize.signals.translation_imported`
+signal that is sent when translation are imported from Smartling.
 
-## Signals
+Signal kwargs:
 
-<!-- TODO -->
-- `translation_imported`
+- `sender`: The `wagtail_localize_smartling.models.Job` class
+- `instance`: The `Job` instance for which translation are being imported
+- `translation`: The `wagtail_localize.models.Translation` instance the translations are being imported to
+- `target_instance`: The model instance that `translation` is for (i.e. the instance returned by `translation.get_target_instance()`)

pyproject.toml

@@ -84,3 +84,49 @@ reportUnnecessaryTypeIgnoreComment = true
 # Make sure we're checking against the minimum supported Python version by
 # default. CI will check against all supported versions for us.
 pythonVersion = "3.8"
+
+
+[tool.ruff]
+extend-exclude = [
+    "LC_MESSAGES",
+    "locale",
+]
+
+[tool.ruff.lint]
+select = [
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "DJ",     # flake8-django
+    "E",      # pycodestyle errors
+    "F",      # pyflakes
+    "I",      # isort
+    "RUF100", # unused noqa
+    "S",      # flake8-bandit
+    "UP",     # pyupgrade
+    "W",      # warning
+]
+fixable = [
+    "C4",
+    "E",
+    "F",
+    "I",
+    "UP",
+]
+
+[tool.ruff.lint.isort]
+lines-after-imports = 2
+lines-between-types = 1
+
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "S101",    # asserts allowed in tests
+    "ARG",     # unused function args (pytest fixtures)
+    "FBT",     # booleans as positional arguments (@pytest.mark.parametrize)
+    "PLR2004", # magic value used in comparison
+    "S311",    # standard pseudo-random generators are not suitable for cryptographic purposes
+]
+
+
+[tool.ruff.format]
+docstring-code-format = true

src/wagtail_localize_smartling/signals.py

@@ -1,5 +1,4 @@
 from django.dispatch import Signal
 
 
-# TODO send this
 translation_imported = Signal()

src/wagtail_localize_smartling/sync.py

@@ -6,10 +6,12 @@
 
 from django.db import transaction
 from django.utils import timezone
+from wagtail_localize.models import Translation
 
 from . import utils
 from .api.client import client
 from .api.types import JobStatus
+from .signals import translation_imported
 
 
 if TYPE_CHECKING:
@@ -183,7 +185,7 @@ def _download_and_apply_translations(job: "Job") -> None:
                 )
 
             try:
-                translation = job.translations.get(
+                translation: Translation = job.translations.get(
                     target_locale__language_code=utils.format_wagtail_locale_id(
                         smartling_locale_id
                     )
@@ -197,4 +199,10 @@ def _download_and_apply_translations(job: "Job") -> None:
             with translations_zip.open(zipinfo) as f:
                 po_file = polib.pofile(f.read().decode("utf-8"))
                 translation.import_po(po_file)
+                translation_imported.send(
+                    sender=Job,
+                    instance=job,
+                    translation=translation,
+                    target_instance=translation.get_target_instance(),
+                )
                 logger.info("Imported translations for %s", translation)

tests/status/test_status_view.py

@@ -36,10 +36,7 @@ def test_everything_working(client, superuser, smartling_project):
     # Project metadata
     assert f"Project ID {smartling_project.project_id}" in text
     assert f"Project name {smartling_project.name}" in text
-    assert (
-        f"Source locale {smartling_project.source_locale_description}"
-        in text
-    )
+    assert f"Source locale {smartling_project.source_locale_description}" in text
 
     # Source locale
     assert "The source locale is compatible with Smartling" in text