Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Special testing note: If your python tests fail with UnicodeEncodeErrors that look like this: UnicodeEncodeError: 'ascii' codec can't encode character u'\xeb' in position 42: ordinal not in range(128), there's an easy fix. What's happening is that there are python tests (for the filesystem-based file upload backend) which will attempt to locate paths on the current box. One of these paths contains a weird unicode value that can cause problems. The fix is to ensure that your local system (the lms container) is using unicode. First, try export LC_ALL='en_US.UTF-8'. If that failed with /bin/bash: warning: setlocale: LC_ALL: cannot change locale (en_US.UTF-8), that just means your system doesn't have the required locale generated. Run sudo locale-gen en_US.UTF-8, then retry the initial command.

Working with submission dependencies

ORA code also depends on edx-submissions. As a result, anytime a new version of edx-submissions is released, ORA code must be updated as follows.

For devstack:

make lms-shell   # get into docker container
cd /edx/src/edx-ora2 # goto into ora2 folder
source edx-ora2/bin/activate # activate ora2 virtual environment
pip install -U edx-submissions # installs latest version of submissions from pypi
pip install -e /edx/src/edx-submissions # istalls local version of submissions

Available make commands

  • make javascript - makes the bundled JavaScript files for LMS and Studio

  • make quality - run the JSHint quality tests

  • make sass - recompiles sass, can be done while edx-platform is running, then refresh the browser to see the changes
  • make test - run all the tests
  • make test-acceptance - run the acceptance tests
  • make test-a11y - run the accessibility tests
  • make test-js - run the JavaScript tests
  • make test-js-debug - run the JavaScript tests in debug mode in Chrome
  • make test-python - run the Python tests
  • make test-sandbox - run all the sandbox tests (currently acceptance and a11y)