Skip to main content

A flexible prompt and user responses data schema utilizing the generic content types

Project description

https://badge.fury.io/py/django-prompt-responses.svg https://travis-ci.org/graup/django-prompt-responses.svg?branch=master https://codecov.io/gh/graup/django-prompt-responses/branch/master/graph/badge.svg

A flexible prompt and user responses data schema utilizing Django’s content types framework.

This app was born during a university research project. The main use case is data collection. It lets you create numerous kinds of “prompts” (questions or tasks) and record user responses. Prompts can be populated with any kind of database object.

This supports these kind of prompts:

  • How do you feel today on a 1-5 scale? (Simple likert question)
  • How do you like {object} on a 1-10 scale? (Object-based likert question)
  • Which word do you associate with {object}? (Object-based open-ended question)
  • How related do you think is {object} to these other objects? (Tagging task)

Ratings and tags are simply integer values, their meaning can be defined by your application (e.g. 1 to 5 scales, or -1 = no, +1 = yes, and so on).

Documentation

The full documentation is at https://django-prompt-responses.readthedocs.io.

Quickstart

Install prompt_responses:

pip install django-prompt-responses

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    ...
    'prompt_responses',
    'sortedm2m',  # for the ability to change the order of Prompts in the Django admin
    ...
)

Create Prompts, e.g. through the integrated admin views.

Deliver a prompt to the user:

prompt = Prompt.objects.get(id=1)
instance = prompt.get_instance()

"""
Use these variables to display the UI:
prompt.type
str(instance)
instance.object
instance.response_objects
"""

Save a user response:

prompt = Prompt.objects.get(id=1)
prompt.create_response(
    user=user,
    prompt_object=instance.object,
    rating=5
)

Analyze data:

prompt = Prompt.objects.get(id=1)
# Mean rating for all responses
rating = prompt.get_mean_rating()
# Mean ratings for all objects
matrix = prompt.get_mean_tag_rating_matrix()
# Mean ratings for one object
ratings = list(prompt.get_mean_tag_ratings(instance.object))

Use the included viewsets in your Django Rest Framework API:

from rest_framework import routers
from prompt_responses.viewsets import PromptViewSet

router = routers.DefaultRouter()
router.register(r'prompts', PromptViewSet)

urlpatterns = [
    url(r'^api/', include(router.urls))
]

This offers api/prompts/, api/prompts/<id>/, api/prompts/<id>/instantiate/, api/prompts/<id>/create-response/ (POST) endpoints.

Features

  • Prompt types
    • Likert scale ratings
    • Open-ended free text
    • Tagging
  • Populate prompts with objects in order to
    • let users rate objects from one set
    • let users rate (tag) relations between two sets of objects
  • Analytics convenience functions
  • (Coming soon) Plugable object sampling algorithms
  • Support for Django Rest Framework

Running Tests

Credits

Tools used in rendering this package:

History

0.1.0 (2017-11-07)

  • First release on PyPI.

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 django-prompt-responses, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size django_prompt_responses-0.1.1-py2.py3-none-any.whl (21.0 kB) File type Wheel Python version 2.7 Upload date Hashes View hashes
Filename, size django-prompt-responses-0.1.1.tar.gz (17.1 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