Metadata-Version: 2.0
Name: edx-completion
Version: 0.0.9
Summary: A library for tracking completion of blocks by learners in edX courses.
Home-page: https://github.com/edx/completion
Author: edX
Author-email: oscm@edx.org
License: AGPL 3.0
Description-Content-Type: UNKNOWN
Keywords: Django edx
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: backports.functools-lru-cache (==1.4)
Requires-Dist: djangorestframework (==3.6.3)
Requires-Dist: snowballstemmer (==1.2.1)
Requires-Dist: pyparsing (==2.2.0)
Requires-Dist: caniusepython3 (==6.0.0)
Requires-Dist: tqdm (==4.19.5)
Requires-Dist: path.py (>=8.2.1)
Requires-Dist: pytz (==2016.7)
Requires-Dist: pip-tools (==1.11.0)
Requires-Dist: pyyaml (==3.12)
Requires-Dist: six (==1.11.0)
Requires-Dist: pygments (==2.2.0)
Requires-Dist: jinja2 (==2.10)
Requires-Dist: XBlock (==1.1.1)
Requires-Dist: distlib (==0.2.6)
Requires-Dist: twine (==1.9.1)
Requires-Dist: diff-cover (==1.0.2)
Requires-Dist: pycodestyle (==2.3.1)
Requires-Dist: wheel (==0.30.0)
Requires-Dist: isort (==4.2.15)
Requires-Dist: urllib3 (==1.22)
Requires-Dist: jinja2-pluralize (==0.3.0)
Requires-Dist: virtualenv (==15.1.0)
Requires-Dist: tox (==2.9.1)
Requires-Dist: pluggy (==0.6.0)
Requires-Dist: inflect (==0.2.5)
Requires-Dist: django-model-utils (==3.0.0)
Requires-Dist: pydocstyle (==2.1.1)
Requires-Dist: requests (==2.18.4)
Requires-Dist: markupsafe (==1.0)
Requires-Dist: packaging (==16.8)
Requires-Dist: requests-toolbelt (==0.8.0)
Requires-Dist: configparser (==3.5.0)
Requires-Dist: Django (<2.0,>=1.8)
Requires-Dist: chardet (==3.0.4)
Requires-Dist: tox-battery (==0.2)
Requires-Dist: argparse (==1.4.0)
Requires-Dist: certifi (==2018.1.18)
Requires-Dist: idna (==2.6)
Requires-Dist: edx-opaque-keys[django] (==0.4.2)
Requires-Dist: polib (==1.1.0)
Requires-Dist: first (==2.0.1)
Requires-Dist: click (==6.7)
Requires-Dist: py (==1.5.2)
Requires-Dist: pkginfo (==1.4.1)
Requires-Dist: futures (==3.2.0); python_version == "2.7"

completion
=============================

|pypi-badge| |travis-badge| |codecov-badge| |doc-badge| |pyversions-badge|
|license-badge|

A library for tracking completion of blocks by learners in edX courses.

Overview
________

This repository provides a Django model `BlockCompletion` that is intended to be plugged into ``edx-platform``.  It
provides various handlers and services for the recording of completion data.  It also provides a DRF API for submitting
completion data in batches.

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 <https://github.com/edx/edx-platform/blob/master/CONTRIBUTING.rst>`_ 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 <https://github.com/edx/completion/blob/master/.github/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 <https://github.com/edx/completion/blob/master/.github/ISSUE_TEMPLATE.md>`_

Reporting Security Issues
-------------------------

Please do not report security issues in public. Please email security@edx.org.

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.

.. _list of resources: https://open.edx.org/getting-help


.. |pypi-badge| image:: https://img.shields.io/pypi/v/completion.svg
    :target: https://pypi.python.org/pypi/completion/
    :alt: PyPI

.. |travis-badge| image:: https://travis-ci.org/edx/completion.svg?branch=master
    :target: https://travis-ci.org/edx/completion
    :alt: Travis

.. |codecov-badge| image:: http://codecov.io/github/edx/completion/coverage.svg?branch=master
    :target: http://codecov.io/github/edx/completion?branch=master
    :alt: Codecov

.. |doc-badge| image:: https://readthedocs.org/projects/completion/badge/?version=latest
    :target: http://completion.readthedocs.io/en/latest/
    :alt: Documentation

.. |pyversions-badge| image:: https://img.shields.io/pypi/pyversions/completion.svg
    :target: https://pypi.python.org/pypi/completion/
    :alt: Supported Python versions

.. |license-badge| image:: https://img.shields.io/github/license/edx/completion.svg
    :target: https://github.com/edx/completion/blob/master/LICENSE.txt
    :alt: License


Change Log
----------

..
   All enhancements and patches to completion will be documented
   in this file.  It adheres to the structure of http://keepachangelog.com/ ,
   but in reStructuredText instead of Markdown (for ease of incorporation into
   Sphinx documentation and the PyPI description).

   This project adheres to Semantic Versioning (http://semver.org/).

.. There should always be an "Unreleased" section for changes pending release.

Unreleased
~~~~~~~~~~
* Add query method for all completions by course

[0.0.9] - 2018-02-27
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Added "utilities.py", which houses methods for working with BlockCompletion
  data.

[0.0.8] - 2018-03-01
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Add model method for superlative “last completed block” - for site awareness 
  include every last completed block by course, for later sorting in business 
  layer.

[0.0.7] - 2018-02-15
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Add settings and service method for determining completion-by-viewing delay.

  [0.0.6] - 2018-02-13
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Add the additional completion logic into the service and models from edx-platform

[0.0.2] - 2018-01-31
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Fix up edx-lint requirements shenanigans.


[0.0.1] - 2018-01-31
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Initial release


