Skip to main content

an app that aggregates block level completion data for different block types for Open edX.

Project description

PyPI Travis Codecov Documentation Supported Python versions License

openedx-completion-aggregator is a Django app that aggregates block level completion data for different block types for Open edX.

Overview

openedx-completion-aggregator uses the pluggable django app pattern to ease installation. To use in edx-platform, do the following:

  1. Install the app into your virtualenv.

    ..code_block:

    $ pip install openedx-completion-aggregator
    
  2. [Optional] You may override the set of registered aggregator block types in your lms.env.json file:

    ...
    "COMPLETION_AGGREGATOR_BLOCK_TYPES": {
        "course",
        "chapter",
        "subsection",
        "vertical"
    },
    ...
    
  3. By default, completion is aggregated with each created or updated BlockCompletion. If this creates too much database activity for your installation, set the following in your lms.env.json file:

    ...
    "COMPLETION_AGGREGATOR_ASYNC_AGGREGATION": true,
    ...
    

    Then configure up a pair of cron jobs to run ./manage.py run_aggregator_service and ./manage.py run_aggregator_cleanup as often as desired.

Note that if operating on a Hawthorne-or-later release of edx-platform, you may override the settings in EDXAPP_ENV_EXTRA instead.

Documentation

The full documentation is at https://openedx-completion-aggregator.readthedocs.org.

License

The code in this repository is licensed under the AGPL 3.0 unless otherwise noted.

Please see LICENSE.txt for details.

How To Contribute

Contributions are very welcome.

Please read How To Contribute for details.

Even though they were written with edx-platform in mind, the guidelines should be followed for Open edX code in general.

PR description template should be automatically applied if you are sending PR from github interface; otherwise you can find it it at PULL_REQUEST_TEMPLATE.md

Issue report template should be automatically applied if you are sending it from github UI as well; otherwise you can find it at ISSUE_TEMPLATE.md

Reporting Security Issues

Please do not report security issues in public. Please email help@opencraft.com.

Getting Help

Have a question about this repository, or about Open edX in general? Please refer to this list of resources if you need any assistance.

Change Log

Unreleased

[1.0.0] - 2018-01-04

  • First release on PyPI.
  • On-demand asynchronous aggregation of xblock completion.
  • Provides an API to retrieve aggregations for one or many users, for one or many courses.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for openedx-completion-aggregator, version 1.5.10
Filename, size File type Python version Upload date Hashes
Filename, size openedx_completion_aggregator-1.5.10-py2.py3-none-any.whl (59.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size openedx-completion-aggregator-1.5.10.tar.gz (44.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page