ol-openedx-course-translations 0.1.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

ol_openedx_course_translations/views.py

@@ -0,0 +1,73 @@
+"""
+API Views for ol_openedx_course_translations App
+"""
+
+import logging
+
+from opaque_keys import InvalidKeyError
+from opaque_keys.edx.keys import CourseKey
+from openedx.core.djangoapps.content.course_overviews.models import CourseOverview
+from rest_framework import status
+from rest_framework.permissions import IsAuthenticated
+from rest_framework.response import Response
+from rest_framework.views import APIView
+
+log = logging.getLogger(__name__)
+
+
+class CourseLanguageView(APIView):
+    """
+    API View to retrieve the language of a specified course.
+
+    Sample Request:
+        GET /course-translations/api/course_language/{course_key}/
+
+    Sample Response:
+        200 OK
+        {
+            "language": "en"
+        }
+
+    Error Responses:
+        400 Bad Request
+        {
+            "error": "Invalid course_key."
+        }
+        404 Not Found
+        {
+            "error": "Course not found."
+        }
+        400 Bad Request
+        {
+            "error": "An unexpected error occurred."
+        }
+    """
+
+    permission_classes = [IsAuthenticated]
+
+    def get(self, request, course_key_string):  # noqa: ARG002
+        """
+        Retrieve the language of the specified course.
+        """
+        try:
+            course_key = CourseKey.from_string(course_key_string)
+            course = CourseOverview.get_from_id(course_key)
+        except InvalidKeyError:
+            log.info("Invalid course key %s", course_key_string)
+            return Response(
+                {"error": "Invalid course_key."},
+                status=status.HTTP_400_BAD_REQUEST,
+            )
+        except CourseOverview.DoesNotExist:
+            log.info("Course not found for key %s", course_key_string)
+            return Response(
+                {"error": "Course not found."},
+                status=status.HTTP_404_NOT_FOUND,
+            )
+        except Exception:
+            log.exception("Unexpected error retrieving course %s", course_key_string)
+            return Response(
+                {"error": "An unexpected error occurred."},
+                status=status.HTTP_400_BAD_REQUEST,
+            )
+        return Response({"language": course.language})

ol_openedx_course_translations-0.3.0.dist-info/METADATA

@@ -0,0 +1,407 @@
+Metadata-Version: 2.4
+Name: ol-openedx-course-translations
+Version: 0.3.0
+Summary: An Open edX plugin to translate courses
+Author: MIT Office of Digital Learning
+License-Expression: BSD-3-Clause
+License-File: LICENSE.txt
+Keywords: Python,edx
+Requires-Python: >=3.11
+Requires-Dist: deepl>=1.25.0
+Requires-Dist: django>=4.0
+Requires-Dist: djangorestframework>=3.14.0
+Requires-Dist: gitpython>=3.1.40
+Requires-Dist: litellm>=1.0.0
+Requires-Dist: polib>=1.2.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: srt>=3.5.3
+Description-Content-Type: text/x-rst
+
+OL Open edX Course Translations
+===============================
+
+An Open edX plugin to manage course translations.
+
+Purpose
+*******
+
+Translate course content into multiple languages to enhance accessibility for a global audience.
+
+Setup
+=====
+
+For detailed installation instructions, please refer to the `plugin installation guide <../../docs#installation-guide>`_.
+
+Installation required in:
+
+* Studio (CMS)
+* LMS (for auto language selection feature)
+
+Configuration
+=============
+
+- Add the following configuration values to the config file in Open edX. For any release after Juniper, that config file is ``/edx/etc/lms.yml`` and ``/edx/etc/cms.yml``. If you're using ``private.py``, add these values to ``lms/envs/private.py`` and ``cms/envs/private.py``. These should be added to the top level. **Ask a fellow developer for these values.**
+
+  .. code-block:: python
+
+       # Enable auto language selection
+       ENABLE_AUTO_LANGUAGE_SELECTION: true
+
+       # Translation providers configuration
+       TRANSLATIONS_PROVIDERS: {
+           "default_provider": "mistral",  # Default provider to use
+           "deepl": {
+               "api_key": "<YOUR_DEEPL_API_KEY>",
+           },
+           "openai": {
+               "api_key": "<YOUR_OPENAI_API_KEY>",
+               "default_model": "gpt-5.2",
+           },
+           "gemini": {
+               "api_key": "<YOUR_GEMINI_API_KEY>",
+               "default_model": "gemini-3-pro-preview",
+           },
+           "mistral": {
+               "api_key": "<YOUR_MISTRAL_API_KEY>",
+               "default_model": "mistral-large-latest",
+           },
+       }
+       TRANSLATIONS_GITHUB_TOKEN: <YOUR_GITHUB_TOKEN>
+       TRANSLATIONS_REPO_PATH: ""
+       TRANSLATIONS_REPO_URL: "https://github.com/mitodl/mitxonline-translations.git"
+
+- For Tutor installations, these values can also be managed through a `custom Tutor plugin <https://docs.tutor.edly.io/tutorials/plugin.html#plugin-development-tutorial>`_.
+
+Translation Providers
+=====================
+
+The plugin supports multiple translation providers:
+
+- DeepL
+- OpenAI (GPT models)
+- Gemini (Google)
+- Mistral
+
+**Configuration**
+
+All providers are configured through the ``TRANSLATIONS_PROVIDERS`` dictionary in your settings:
+
+.. code-block:: python
+
+    TRANSLATIONS_PROVIDERS = {
+        "default_provider": "mistral",  # Optional: default provider for commands
+        "deepl": {
+            "api_key": "<YOUR_DEEPL_API_KEY>",
+        },
+        "openai": {
+            "api_key": "<YOUR_OPENAI_API_KEY>",
+            "default_model": "gpt-5.2",  # Optional: used when model not specified
+        },
+        "gemini": {
+            "api_key": "<YOUR_GEMINI_API_KEY>",
+            "default_model": "gemini-3-pro-preview",
+        },
+        "mistral": {
+            "api_key": "<YOUR_MISTRAL_API_KEY>",
+            "default_model": "mistral-large-latest",
+        },
+    }
+
+**Important Notes:**
+
+1. **DeepL Configuration**: DeepL must be configured in ``TRANSLATIONS_PROVIDERS['deepl']['api_key']``.
+
+2. **DeepL for Subtitle Repair**: DeepL is used as a fallback repair mechanism for subtitle translations when LLM providers fail validation. Even if you use LLM providers for primary translation, you should configure DeepL to enable automatic repair.
+
+3. **Default Models**: The ``default_model`` in each provider's configuration is used when you specify a provider without a model (e.g., ``openai`` instead of ``openai/gpt-5.2``).
+
+**Provider Selection**
+
+You can specify providers in three ways:
+
+1. **Provider only** (uses default model from settings):
+
+.. code-block:: bash
+
+    ./manage.py cms translate_course \
+        --target-language AR \
+        --course-dir /path/to/course.tar.gz \
+        --content-translation-provider openai \
+        --srt-translation-provider gemini
+
+2. **Provider with specific model**:
+
+.. code-block:: bash
+
+    ./manage.py cms translate_course \
+        --target-language AR \
+        --course-dir /path/to/course.tar.gz \
+        --content-translation-provider openai/gpt-5.2 \
+        --srt-translation-provider gemini/gemini-3-pro-preview
+
+3. **DeepL** (no model needed):
+
+.. code-block:: bash
+
+    ./manage.py cms translate_course \
+        --target-language AR \
+        --course-dir /path/to/course.tar.gz \
+        --content-translation-provider deepl \
+        --srt-translation-provider deepl
+
+**Note:** If you specify a provider without a model (e.g., ``openai`` instead of ``openai/gpt-5.2``), the system will use the ``default_model`` configured in ``TRANSLATIONS_PROVIDERS`` for that provider.
+
+Translating a Course
+====================
+1. Open the course in Studio.
+2. Go to Tools -> Export Course.
+3. Export the course as a .tar.gz file.
+4. Go to the CMS shell
+5. Run the management command to translate the course:
+
+   .. code-block:: bash
+
+        ./manage.py cms translate_course \
+            --source-language EN \
+            --target-language AR \
+            --course-dir /path/to/course.tar.gz \
+            --content-translation-provider openai \
+            --srt-translation-provider gemini \
+            --glossary-dir /path/to/glossary
+
+**Command Options:**
+
+- ``--source-language``: Source language code (default: EN)
+- ``--target-language``: Target language code (required)
+- ``--course-dir``: Path to exported course tar.gz file (required)
+- ``--content-translation-provider``: Translation provider for content (XML/HTML and text) (required).
+
+  Format:
+
+  - ``deepl`` - uses DeepL (no model needed)
+  - ``PROVIDER`` - uses provider with default model from settings (e.g., ``openai``, ``gemini``, ``mistral``)
+  - ``PROVIDER/MODEL`` - uses provider with specific model (e.g., ``openai/gpt-5.2``, ``gemini/gemini-3-pro-preview``, ``mistral/mistral-large-latest``)
+
+- ``--srt-translation-provider``: Translation provider for SRT subtitles (required). Same format as ``--content-translation-provider``
+- ``--glossary-dir``: Path to glossary directory (optional)
+
+**Examples:**
+
+.. code-block:: bash
+
+    # Use DeepL for both content and subtitles
+    ./manage.py cms translate_course \
+        --target-language AR \
+        --course-dir /path/to/course.tar.gz \
+        --content-translation-provider deepl \
+        --srt-translation-provider deepl
+
+    # Use OpenAI and Gemini with default models from settings
+    ./manage.py cms translate_course \
+        --target-language FR \
+        --course-dir /path/to/course.tar.gz \
+        --content-translation-provider openai \
+        --srt-translation-provider gemini
+
+    # Use OpenAI with specific model for content, Gemini with default for subtitles
+    ./manage.py cms translate_course \
+        --target-language FR \
+        --course-dir /path/to/course.tar.gz \
+        --content-translation-provider openai/gpt-5.2 \
+        --srt-translation-provider gemini
+
+    # Use Mistral with specific model and glossary
+    ./manage.py cms translate_course \
+        --target-language ES \
+        --course-dir /path/to/course.tar.gz \
+        --content-translation-provider mistral/mistral-large-latest \
+        --srt-translation-provider mistral/mistral-large-latest \
+        --glossary-dir /path/to/glossary
+
+**Glossary Support:**
+
+Create language-specific glossary files in the glossary directory:
+
+.. code-block:: bash
+
+    glossaries/machine_learning/
+    ├── ar.txt  # Arabic glossary
+    ├── fr.txt  # French glossary
+    └── es.txt  # Spanish glossary
+
+Format: One term per line as "source_term : translated_term"
+
+.. code-block:: text
+
+    # ES HINTS
+    ## TERM MAPPINGS
+    These are preferred terminology choices for this language. Use them whenever they sound natural; adapt freely if context requires.
+
+    - 'accuracy' : 'exactitud'
+    - 'activation function' : 'función de activación'
+    - 'artificial intelligence' : 'inteligencia artificial'
+    - 'AUC' : 'AUC'
+
+Subtitle Translation and Validation
+====================================
+
+The course translation system includes robust subtitle (SRT) translation with automatic validation and repair mechanisms to ensure high-quality translations with preserved timing information.
+
+**Translation Process**
+
+The subtitle translation follows a multi-stage process with built-in quality checks:
+
+1. **Initial Translation**: Subtitles are translated using your configured provider (DeepL or LLM)
+2. **Validation**: Timestamps, subtitle count, and content are validated to ensure integrity
+3. **Automatic Retry**: If validation fails, the system automatically retries translation (up to 1 additional attempt)
+4. **DeepL Repair Fallback**: If retries fail, the system automatically falls back to DeepL for repair
+
+**Why DeepL for Repair?**
+
+When subtitle translations fail validation (mismatched timestamps, incorrect subtitle counts, or blank translations), the system automatically uses **DeepL as a repair mechanism**, regardless of which provider was initially used. This design choice is based on extensive testing and production experience:
+
+- **Higher Reliability**: LLMs frequently fail to preserve subtitle structure and timestamps correctly, even with detailed prompting
+- **Consistent Formatting**: DeepL's specialized subtitle translation API maintains timing precision through XML tag handling
+- **Lower Failure Rate**: DeepL demonstrates significantly better success rates for subtitle translation compared to LLMs
+- **Timestamp Preservation**: DeepL's built-in XML tag handling ensures start and end times remain intact during translation
+
+
+**Validation Rules**
+
+The system validates subtitle translations against these criteria:
+
+- **Subtitle Count**: Translated file must have the same number of subtitle blocks as the original
+- **Index Matching**: Each subtitle block index must match the original (e.g., if original has blocks 1-100, translation must have blocks 1-100 in the same order)
+- **Timestamp Preservation**: Start and end times for each subtitle block must remain unchanged
+- **Content Validation**: Non-empty original subtitles must have non-empty translations (blank translations are flagged as errors)
+
+**Example Validation Process:**
+
+.. code-block:: text
+
+    1. Initial Translation (using OpenAI):
+       ✓ 150 subtitle blocks translated
+       ✗ Validation failed: 3 blocks have mismatched timestamps
+
+    2. Retry Attempt:
+       ✓ 150 subtitle blocks translated
+       ✗ Validation failed: 2 blocks still have issues
+
+    3. DeepL Repair:
+       ✓ 150 subtitle blocks retranslated using DeepL
+       ✓ Validation passed: All timestamps and content validated
+       ✅ Translation completed successfully
+
+**Failure Handling**
+
+If subtitle repair fails after all attempts (including DeepL fallback):
+
+- The translation task will fail with a ``ValueError``
+- The entire course translation will be aborted to prevent incomplete translations
+- The translated course directory will be automatically cleaned up
+- An error message will indicate which subtitle file caused the failure
+- No partial or corrupted translation files will be left behind
+
+Auto Language Selection
+=======================
+
+The plugin includes an auto language selection feature that automatically sets the user's language preference based on the course language. When enabled, users will see the static site content in the course's configured language.
+
+To enable auto language selection:
+
+1. Set ``ENABLE_AUTO_LANGUAGE_SELECTION`` to ``true`` in your settings.
+
+2. Set ``SHARED_COOKIE_DOMAIN`` to your domain (e.g., ``.local.openedx.io`` for local tutor setup) to allow cookies to be shared between LMS and CMS.
+
+**How it works:**
+
+- **LMS**: The ``CourseLanguageCookieMiddleware`` automatically detects course URLs and sets the language preference based on the course's configured language.
+- **CMS**: The ``CourseLanguageCookieResetMiddleware`` ensures Studio always uses English for the authoring interface.
+- **Admin areas**: Admin URLs (``/admin``, ``/sysadmin``, instructor dashboards) are forced to use English regardless of course language.
+
+MFE Integration
+===============
+
+To make auto language selection work with Micro-Frontends (MFEs), you need to use a custom Footer component that handles language detection and switching.
+
+**Setup:**
+
+1. Use the Footer component from `src/bridge/settings/openedx/mfe/slot_config/Footer.jsx <https://github.com/mitodl/ol-infrastructure/blob/main/src/bridge/settings/openedx/mfe/slot_config/Footer.jsx>`_ in the `ol-infrastructure <https://github.com/mitodl/ol-infrastructure>`_ repository.
+
+2. Enable auto language selection in each MFE by adding the following to their ``.env.development`` file:
+
+   .. code-block:: bash
+
+       ENABLE_AUTO_LANGUAGE_SELECTION="true"
+
+3. This custom Footer component:
+   - Detects the current course context in MFEs
+   - Automatically switches the MFE language based on the course's configured language
+   - Ensures consistent language experience across the platform
+
+4. Configure your MFE slot overrides to use this custom Footer component instead of the default one.
+
+**Note:** The custom Footer is required because MFEs run as separate applications and need their own mechanism to detect and respond to course language settings. The environment variable must be set in each MFE's configuration for the feature to work properly.
+
+Generating static content translations
+======================================
+
+This command synchronizes translation keys from edx-platform and MFE's, translates empty keys using LLM, and automatically creates a pull request in the translations repository.
+
+**What it does:**
+
+1. Syncs translation keys from edx-platform and MFE's to the translations repository
+2. Extracts empty translation keys that need translation
+3. Translates empty keys using the specified LLM provider and model
+4. Applies translations to JSON and PO files
+5. Commits changes to a new branch
+6. Creates a pull request with translation statistics
+
+**Usage:**
+
+1. Go to the CMS shell
+2. Run the management command:
+
+   .. code-block:: bash
+
+        ./manage.py cms sync_and_translate_language <LANGUAGE_CODE> [OPTIONS]
+
+**Required arguments:**
+
+- ``LANGUAGE_CODE``: Language code (e.g., ``el``, ``fr``, ``es_ES``)
+
+**Optional arguments:**
+
+- ``--iso-code``: ISO code for JSON files (default: same as language code)
+- ``--provider``: Translation provider (``openai``, ``gemini``, ``mistral``). Default is taken from ``TRANSLATIONS_PROVIDERS['default_provider']`` setting
+- ``--model``: LLM model name. If not specified, uses the ``default_model`` for the selected provider from ``TRANSLATIONS_PROVIDERS``. Examples: ``gpt-5.2``, ``gemini-3-pro-preview``, ``mistral-large-latest``
+- ``--repo-path``: Path to mitxonline-translations repository (can also be set via ``TRANSLATIONS_REPO_PATH`` setting or environment variable)
+- ``--repo-url``: GitHub repository URL (default: ``https://github.com/mitodl/mitxonline-translations.git``, can also be set via ``TRANSLATIONS_REPO_URL`` setting or environment variable)
+- ``--glossary``: Use glossary from plugin glossaries folder (looks for ``{plugin_dir}/glossaries/machine_learning/{lang_code}.txt``)
+- ``--batch-size``: Number of keys to translate per API request (default: 200, recommended: 200-300 for most models)
+- ``--mfe``: Filter by specific MFE(s). Use ``edx-platform`` for backend translations
+- ``--dry-run``: Run without committing or creating PR
+
+**Examples:**
+
+   .. code-block:: bash
+
+        # Use default provider (from TRANSLATIONS_PROVIDERS['default_provider']) with its default model
+        ./manage.py cms sync_and_translate_language el
+
+        # Use OpenAI provider with its default model (gpt-5.2)
+        ./manage.py cms sync_and_translate_language el --provider openai
+
+        # Use OpenAI provider with a specific model
+        ./manage.py cms sync_and_translate_language el --provider openai --model gpt-5.2
+
+        # Use Mistral provider with a specific model and glossary
+        ./manage.py cms sync_and_translate_language el --provider mistral --model mistral-large-latest --glossary --batch-size 250
+
+License
+*******
+
+The code in this repository is licensed under the AGPL 3.0 unless
+otherwise noted.
+
+Please see `LICENSE.txt <LICENSE.txt>`_ for details.

ol_openedx_course_translations-0.3.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+ol_openedx_course_translations/__init__.py,sha256=qddojx2E0sw3CdZ_iyjwt3iTN_oTPCo1iPtRMSEgyHA,50
+ol_openedx_course_translations/apps.py,sha256=F99ZzLzMIZB85uNEy2tIlvMM1JTf16XnTcpJY6FguIs,1013
+ol_openedx_course_translations/middleware.py,sha256=pdcygHc-UdKOoaWDvZJIDWCr9o1jNHqzefCQZl2aJmw,4556
+ol_openedx_course_translations/tasks.py,sha256=fxxd4mMV8HxtOY-y6kvM-oNjoif4iJE-V2aVyFua0OE,8071
+ol_openedx_course_translations/urls.py,sha256=wDlOrRTtV_YRXAA1lpIhjEEf_fNkyfZUtmVPMD1PEi8,385
+ol_openedx_course_translations/views.py,sha256=ESDmgSFAvyHKQE9s2hthyNgRZmMuLNWvfrGkR4isoec,2173
+ol_openedx_course_translations/glossaries/machine_learning/ar.txt,sha256=f8Ga8GV3qXFVvmlYx3JAfBC-HNIMW5FbLrqTR_jIwWM,9065
+ol_openedx_course_translations/glossaries/machine_learning/de.txt,sha256=dEQx_qeeMc5DMAwKM4liRuGor0ZJu0zxsseD3npJyeE,7865
+ol_openedx_course_translations/glossaries/machine_learning/el.txt,sha256=i8dtMpI0S1sYcjej-kvzdXCXnoAsjETiPx43kvVsOT8,67171
+ol_openedx_course_translations/glossaries/machine_learning/es.txt,sha256=mM5PAW6Jv7qd--saDJdVRwvPHnOe1RPnd3uUX_ckfOQ,7694
+ol_openedx_course_translations/glossaries/machine_learning/fr.txt,sha256=q3JEPWa-C6GeY2vZhB528vERmhgUTgYiRmRn1vSsJCI,7892
+ol_openedx_course_translations/glossaries/machine_learning/ja.txt,sha256=Xa83zxPdwfN05QB2H4NfzkFZyYsKoruoJ3e9D-ka2fY,8028
+ol_openedx_course_translations/glossaries/machine_learning/pt-br.txt,sha256=68_mu_IEZpC-jswmrpEDiq3R86IF0zMdJ6Km7kCiDM4,7507
+ol_openedx_course_translations/glossaries/machine_learning/ru.txt,sha256=d-p1UcxBy7cz0MJfB35sBQIOHV27PK9nIXpFfVEDGMU,11984
+ol_openedx_course_translations/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ol_openedx_course_translations/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ol_openedx_course_translations/management/commands/sync_and_translate_language.py,sha256=E2sLaXYBTI1qCYcocV022Q-06y9iIA1YTMN5rHsb078,70176
+ol_openedx_course_translations/management/commands/translate_course.py,sha256=L7wWlfiRq4swVaySV6kcCs0rRT0RIxkl_Qw4A628m_M,20486
+ol_openedx_course_translations/providers/__init__.py,sha256=ZTWIG9KsYXYElfr-QwMsId7l6Sh6MypDKCWTivk3PME,48
+ol_openedx_course_translations/providers/base.py,sha256=-1QV7w-6Wpwz4EMzCiOOuWOG2kDw4b2gZ1KSK6GFVLM,9264
+ol_openedx_course_translations/providers/deepl_provider.py,sha256=hPuLVEZLU3Dm6a9H-8ztpcX53K9gUA8e57jUzn_HsKU,10076
+ol_openedx_course_translations/providers/llm_providers.py,sha256=L3MwmQI2appwn8FTKzZhRfq_FNauP1ei0kenY-yBcgc,19369
+ol_openedx_course_translations/settings/cms.py,sha256=SzoTxVUlvlWvjQ58GCoVygHjoMNAH3InME7T9K6dTQ4,392
+ol_openedx_course_translations/settings/common.py,sha256=2UksaEnYLJFDdpzB7wTwgpoPkJ8X7z2wK9glHSCm88o,1733
+ol_openedx_course_translations/settings/lms.py,sha256=4u6BjqxWcWHpMgxlgF4lNs7H9pDgKTQrEtjdhOg7Qv0,365
+ol_openedx_course_translations/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ol_openedx_course_translations/utils/command_utils.py,sha256=GRSGIBKm6ZnRCnv5oVRzxhS6UFwvjmNeJkvCEpLCks0,6482
+ol_openedx_course_translations/utils/constants.py,sha256=D3ICk0OmMHFdERShJ9eq5MaTaXHLVaUcVO3ZIg_3umQ,8141
+ol_openedx_course_translations/utils/course_translations.py,sha256=jlGYsIj7PBJRrPVDZt3Q4-QbwJKhHswaZPZPeicFAjE,20647
+ol_openedx_course_translations/utils/translation_sync.py,sha256=IQL-auVk5GwSfUfyeGICUDhd1KPxZs_bthAzRYm9LSs,26739
+ol_openedx_course_translations-0.3.0.dist-info/METADATA,sha256=YVqZ0XOrw8_5P1eUB4S4U92MF7ilsy7SDX1xHWz0n5Y,16716
+ol_openedx_course_translations-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ol_openedx_course_translations-0.3.0.dist-info/entry_points.txt,sha256=FPeAXhaGYIZqafskkDD8xPiljXJ6djil27_kTuNP0BI,239
+ol_openedx_course_translations-0.3.0.dist-info/licenses/LICENSE.txt,sha256=iVk4rSDx0SwrA7AriwFblTY0vUxpuVib1oqJEEeejN0,1496
+ol_openedx_course_translations-0.3.0.dist-info/RECORD,,

ol_openedx_course_translations-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[cms.djangoapp]
+ol_openedx_course_translations = ol_openedx_course_translations.apps:OLOpenedXCourseTranslationsConfig
+
+[lms.djangoapp]
+ol_openedx_course_translations = ol_openedx_course_translations.apps:OLOpenedXCourseTranslationsConfig

ol_openedx_course_translations-0.1.0.dist-info/METADATA

@@ -1,63 +0,0 @@
-Metadata-Version: 2.4
-Name: ol-openedx-course-translations
-Version: 0.1.0
-Summary: An Open edX plugin to translate courses
-Author: MIT Office of Digital Learning
-License-Expression: BSD-3-Clause
-License-File: LICENSE.txt
-Keywords: Python,edx
-Requires-Python: >=3.11
-Requires-Dist: deepl>=1.25.0
-Requires-Dist: django>=4.0
-Requires-Dist: djangorestframework>=3.14.0
-Description-Content-Type: text/x-rst
-
-OL Open edX Course Translations
-===============================
-
-An Open edX plugin to manage course translations.
-
-Purpose
-*******
-
-Translate course content into multiple languages to enhance accessibility for a global audience.
-
-Setup
-=====
-
-For detailed installation instructions, please refer to the `plugin installation guide <../../docs#installation-guide>`_.
-
-Installation required in:
-
-* Studio (CMS)
-
-Configuration
-=============
-
-- Add the following configuration values to the config file in Open edX. For any release after Juniper, that config file is ``/edx/etc/lms.yml``. If you're using ``private.py``, add these values to ``lms/envs/private.py``. These should be added to the top level. **Ask a fellow developer for these values.**
-
-  .. code-block:: python
-
-       DEEPL_API_KEY: <YOUR_DEEPL_API_KEY_HERE>
-
-- For Tutor installations, these values can also be managed through a `custom Tutor plugin <https://docs.tutor.edly.io/tutorials/plugin.html#plugin-development-tutorial>`_.
-
-Usage
-====================
-1. Open the course in Studio.
-2. Go to Tools -> Export Course.
-3. Export the course as a .tar.gz file.
-4. Go to the CMS shell
-5. Run the management command to translate the course:
-
-   .. code-block:: bash
-
-        ./manage.py cms translate_course --source-language <SOURCE_LANGUAGE_CODE, defaults to `EN`> --translation-language <TRANSLATION_LANGUAGE_CODE i.e. AR> --course-dir <PATH_TO_EXPORTED_COURSE_TAR_GZ>
-
-License
-*******
-
-The code in this repository is licensed under the AGPL 3.0 unless
-otherwise noted.
-
-Please see `LICENSE.txt <LICENSE.txt>`_ for details.

ol_openedx_course_translations-0.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-ol_openedx_course_translations/__init__.py,sha256=qddojx2E0sw3CdZ_iyjwt3iTN_oTPCo1iPtRMSEgyHA,50
-ol_openedx_course_translations/apps.py,sha256=AUjqONJsiuip2qG4R_CmQ1IIXoFvdEt-_G64-YWtntU,637
-ol_openedx_course_translations/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ol_openedx_course_translations/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ol_openedx_course_translations/management/commands/translate_course.py,sha256=0H4jFC-9zbE3uMl325HW6kCXUnA4MgiS2X6Osg8xKB8,21781
-ol_openedx_course_translations/settings/common.py,sha256=lzxBIJ1K8upO8Zv6WESl42NUX0xnX5otd0eEa_ko_-c,1074
-ol_openedx_course_translations-0.1.0.dist-info/METADATA,sha256=s2ujGEgFhgJpWUoVxWWgNdmx1FKNSC66-Fc-vXV0G2A,1994
-ol_openedx_course_translations-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-ol_openedx_course_translations-0.1.0.dist-info/entry_points.txt,sha256=07_M_0RSXTPpCQcstKi9xP27jZY-pSwZeeMrGX0mEf8,119
-ol_openedx_course_translations-0.1.0.dist-info/licenses/LICENSE.txt,sha256=iVk4rSDx0SwrA7AriwFblTY0vUxpuVib1oqJEEeejN0,1496
-ol_openedx_course_translations-0.1.0.dist-info/RECORD,,

ol_openedx_course_translations-0.1.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[cms.djangoapp]
-ol_openedx_course_translations = ol_openedx_course_translations.apps:OLOpenedXCourseTranslationsConfig