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.

Source Distribution

openedx-completion-aggregator-1.4.tar.gz (43.1 kB view details)

Uploaded Source

Built Distribution

openedx_completion_aggregator-1.4-py2.py3-none-any.whl (43.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file openedx-completion-aggregator-1.4.tar.gz.

File metadata

  • Download URL: openedx-completion-aggregator-1.4.tar.gz
  • Upload date:
  • Size: 43.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.5.6

File hashes

Hashes for openedx-completion-aggregator-1.4.tar.gz
Algorithm Hash digest
SHA256 67daf625b63cbc2d655df1d19dbcc6d5ce87feda61decfe80127c10d9d9bc0bc
MD5 96ed4d4a5d0e036c973697d677e0c0fb
BLAKE2b-256 6d3ed86fe36c1c7759345b25a4b5cba42a001c0907ea5f1bde5add1a59969536

See more details on using hashes here.

File details

Details for the file openedx_completion_aggregator-1.4-py2.py3-none-any.whl.

File metadata

  • Download URL: openedx_completion_aggregator-1.4-py2.py3-none-any.whl
  • Upload date:
  • Size: 43.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.5.6

File hashes

Hashes for openedx_completion_aggregator-1.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 0196a4ada11a7c9727a6d09d94a9958cc2f4a8425f140e7fc1d3b848b20ec9f5
MD5 2ea5638ded2d53d95d34171f8a091792
BLAKE2b-256 c32ae1f17418b277ca362eef8d8d56d18a0c973a337af69b3e603fb96b15d345

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page