Skip to main content

Reporting and data retrieval for Open edX

Project description

Travis Codecov

Reporting and data retrieval app for Open edX.

Notice and Development Status

October 9, 2018

Figures is now avaible on PyPI for open beta testing!

Overview

Figures is a reporting and data retrieval app. It plugs into the edx-platform LMS app server. Its goal is to provide site-wide and cross-course analytics that compliment Open edX’s traditional course-centric analytics.

To evolve Figures to meet community needs, we are keeping in mind as principles the following features, which Jill Vogel outlined in her lightweight analytics post on ed Xchange:

  • Real time (or near real time) updates

  • Lightweight deployment

  • Flexible reporting

  • Simpler contributions

Please refer to the Figures design document for more details on goals and architecture.

Requirements

  • Python (2.7)

  • Django (1.8)

  • Open edX (Ginkgo)

Installation

Devstack

Go here for instructions to install and run Figures in devstack.

Production

go here for instructions to install Figures in production.

Project Architecture

Front-end

The Figures user interface is a JavaScript Single Page Application (SPA) built with React and uses the create-react-app build scaffolding generator.

Back-end

The Figures back-end is a reusable Django app. It contains a set of REST API endpoints that serve a dual purpose of providing data to the front-end and to remote clients.

Testing

TODO: Improve the testing instructions

The unit tests should be able to run on any OS that supports Python 2.7.x

Clone the repo:

git@github.com:appsembler/figures.git

Go to the project directory:

cd figures

Create a virtualenv for Python 2.7.x.

Install required Python packages:

pip install -r devsite/requirements.txt

From the figures repository root directory:

py.test

If all goes well, the Figures unit tests will all complete succesfully

Future

  • Open edX “Hawthorn” will provide a plug-in architecture. This will hopefully simplify Figures installation even more

  • Backport to Ficus

  • Downloadable report files

  • Plugin architecture to extend Figures for custom data sources

How to Contribute

TODO: Add details here or separate CONTRIBUTING file to the root of the repo

Reporting Security Issues

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

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

Figures-0.1.2.tar.gz (3.2 MB view hashes)

Uploaded Source

Built Distribution

Figures-0.1.2-py2.py3-none-any.whl (2.8 MB view hashes)

Uploaded Python 2 Python 3

Supported by

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