feat: add integration tests

.github/workflows/integration-test.yaml

@@ -0,0 +1,52 @@
+name: Integration Test
+
+on: [pull_request]
+
+jobs:
+  edx-platform-integration-test:
+    name: Integration with Tutor
+    strategy:
+      matrix:
+        # Open edX Version: Sumac
+        tutor_version: ["<20.0.0"]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          path: mitx-grading-library
+
+      - name: Adjust permissions to execute Tutor commands
+        run: |
+          chmod 777 . -R
+        shell: bash
+
+      - name: Set Tutor environment variables
+        run: |
+          cat <<EOF >> "$GITHUB_ENV"
+          LMS_HOST=local.edly.io
+          CMS_HOST=studio.local.edly.io
+          TUTOR_ROOT=$(pwd)
+          EOF
+        shell: bash
+
+      - name: Install and prepare Tutor, Codejail and tests
+        run: |
+          pip install "tutor${{ matrix.tutor_version }}"
+          pip install git+https://github.com/edunext/tutor-contrib-codejail
+          tutor config save
+          tutor plugins enable codejail
+          tutor local do init --limit codejail
+          tutor mounts add cms:mitx-grading-library/integration_tests/integration_test.py:/openedx/edx-platform/integration_test.py
+          tutor local launch -I
+        shell: bash
+
+      - name: Import MITx Demo Course
+        run: |
+          tutor local do importdemocourse -r ${{ github.event.pull_request.head.repo.clone_url }} -d course -v ${{ github.event.pull_request.head.ref }}
+        shell: bash
+
+      - name: Run integration tests
+        run: |
+          tutor local run cms python3 integration_test.py
+        shell: bash

integration_tests/integration_test.py

@@ -0,0 +1,131 @@
+"""
+This script is used to test the integration of the mitx-graders library with the Open edX platform.
+Running a code that uses the functions provided by the library using the safe_exec function, and in the MIT course context,
+to be able to use the python_lib.zip that contains the library.
+"""
+
+import os
+import django
+import logging
+from xmodule.capa.safe_exec import safe_exec
+from xmodule.util.sandboxing import SandboxService
+from xmodule.contentstore.django import contentstore
+from opaque_keys.edx.keys import CourseKey
+
+# Set up Django environment
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "cms.envs.test")
+django.setup()
+
+log = logging.getLogger(__name__)
+
+# Define the code to be executed
+all_code = """
+from mitxgraders import *
+
+# Grading Classes
+
+## Single-input graders
+
+StringGrader(answers="cat")
+FormulaGrader(answers='0')
+NumericalGrader()
+MatrixGrader(
+    answers='x*A*B*u + z*C^3*v/(u*C*v)',
+    variables=['A', 'B', 'C', 'u', 'v', 'z', 'x'],
+    sample_from={
+        'A': RealMatrices(shape=[2, 3]),
+        'B': RealMatrices(shape=[3, 2]),
+        'C': RealMatrices(shape=[2, 2]),
+        'u': RealVectors(shape=[2]),
+        'v': RealVectors(shape=[2]),
+        'z': ComplexRectangle()
+    },
+    identity_dim=2
+)
+SingleListGrader(
+    answers=['cat', 'dog', 'unicorn'],
+    subgrader=StringGrader()
+)
+
+## Multi-input graders
+
+ListGrader(
+    answers=['cat', 'dog', 'unicorn'],
+    subgraders=StringGrader()
+)
+
+## Specialized graders
+
+IntegralGrader(
+    answers={
+        'lower': 'a',
+        'upper': 'b',
+        'integrand': 'x^2',
+        'integration_variable': 'x'
+    },
+    input_positions={
+        'integrand': 1,
+        'lower': 2,
+        'upper': 3
+    },
+    variables=['a', 'b']
+)
+
+IntervalGrader(answers=['(','1','2',']'])
+
+SumGrader(
+    answers={
+        'lower': 'a',
+        'upper': 'b',
+        'summand': 'x^2',
+        'summation_variable': 'x'
+    },
+    input_positions={
+        'summand': 1,
+        'lower': 2,
+        'upper': 3
+    },
+    variables=['a', 'b']
+)
+
+"""
+
+
+def execute_code(all_code, course_key_str):
+    """
+    Executes the provided code in a sandboxed environment with the specified course context.
+
+    Args:
+        all_code (str): The code to be executed.
+        course_key_str (str): The string representation of the course key.
+
+    Returns:
+        None
+    """
+    course_key = CourseKey.from_string(course_key_str)
+    sandbox_service = SandboxService(
+        course_id=course_key,
+        contentstore=contentstore)
+    zip_lib = sandbox_service.get_python_lib_zip()
+
+    extra_files = []
+    python_path = []
+
+    if zip_lib is not None:
+        extra_files.append(("python_lib.zip", zip_lib))
+        python_path.append("python_lib.zip")
+
+    safe_exec(
+        all_code,
+        globals_dict={},
+        python_path=python_path,
+        extra_files=extra_files,
+        slug="integration-test",
+        limit_overrides_context=course_key_str,
+        unsafely=False,
+    )
+
+
+if __name__ == "__main__":
+    course_key_str = "course-v1:MITx+grading-library+course"
+    execute_code(all_code, course_key_str)