Skip to main content

A django survey app, based on and compatible with

Project description

Django survey

A django survey app, based on and compatible with "django-survey". You will be able to migrate your data from an ancient version of django-survey, but it has been ported to python 3 and you can export results as CSV or PDF using your native language.

The latest version still compatible with python 2.7 is 1.2.1.

Build Status Coverage Status PyPI version


Getting started

Making a survey

Generating a pdf report from the survey's result

Contributing as a developper

Translating the project


Getting started

Add django-survey-and-report to your requirements and get it with pip.

echo 'django-survey-and-report' > requirements.txt
pip install -r requirements.txt

Add bootstrapform and survey in the INSTALLED_APPS in your settings :


Add an URL entry to your project’s, for example:

from django.conf import settings

if 'survey' in settings.INSTALLED_APPS:
    urlpatterns += [
        url(r'^survey/', include('survey.urls'))

Note: you can use whatever you wish as the URL prefix.

To uninstall django-survey-and-report, simply comment out or remove the 'survey' line in your INSTALLED_APPS.

If you want to use the pdf rendering with the Sankey's diagram generation you will have to install python-tk (for python 2.7) or python3-tk (for python 3.x).

Making a survey

Using the admin interface you can create surveys, add questions, give questions categories, and mark them as required or not. You can define choices for answers using comma separated words.

Creating of a question

The front-end survey view then automatically populates based on the questions that have been defined and published in the admin interface. We use bootstrap3 to render them.

Answering a survey

Submitted responses can be viewed via the admin backend, in an exported csv or in a pdf generated with latex.

Generating a pdf report from the survey's result

You can manage the way the report is created in a yaml file, globally, survey by survey, or question by question. In order to render pdf you will need to install texlive and python-tk or python3-tk for sankey's diagram.

The results are generated for the server only when needed, but you can force it as a developper with:

python exportresult -h

Following is an example of a configuration file. you can generate one with:

python generatetexconf -h

Basic example

    document_option: 11pt

Test survëy:
    document_class: report
  Lorem ipsum dolor sit amët, <strong> consectetur </strong> adipiscing elit.:
          type: polar
          text: pin
  Dolor sit amët, consectetur<strong>  adipiscing</strong>  elit.:
          type: cloud
          text: inside

The pdf is then generated using the very good pgf-pie library.

The generated pdf for the polar and pin options

The generated pdf for the cloud and inside options

Sankey diagram

If you installed python3-tk, you can also show the relation between two questions using a sankey diagram :

Lorem ipsum dolor sit amët, <strong> consectetur </strong> adipiscing elit.:
      type: sankey
      question: Dolor sit amët, consectetur<strong>  adipiscing</strong>  elit.

You get this as a result:

The generated pdf for the sankey example

Advanced example

You can also limit the answers shown by cardinality, filter them, group them together and choose the color for each answer or group of answers.

If you use this configuration for the previous question:

Test survëy:
  Dolor sit amët, consectetur<strong>  adipiscing</strong>  elit.:
      Sub Sub Section with radius=3 :
        color: {"Yës": "blue!50", "No": "red!50",
                "Whatever": "red!50!blue!50"}
        radius: 3
      Sub Sub Section with text=pin :
        group_together: {"Nah": ["No", "Whatever"], "K.": ["Yës"]}
        color: {"Nah": "blue!33!red!66", "K.": "blue!50"}
        text: pin
      radius: 1
      type: cloud
      text: inside

You get this as a result:

The generated pdf for the multiple charts example

Implementing a custom treatment

If you want to make your own treatment you can use your own class, for example.


Test survëy:
        Ipsum dolor sit amët, <strong> consectetur </strong>  adipiscing elit.:
                type: survey.tests.exporter.tex.CustomQuestion2TexChild

Code in survey.tests.exporter.tex.CustomQuestion2TexChild:

from survey.exporter.tex.question2tex_chart import Question2TexChart

class CustomQuestion2TexChild(Question2TexChart):

    def get_results(self):
        self.type = "polar"
        return """        2/There were no answer at all,
        3/But we have a custom treatment to show some,
        2/You can make minor changes too !"""


The generated pdf for the custom example

For a full example of a configuration file look at example_conf.yaml in doc, you can also generate your configuration file with python generatetexconf -h, it will create the default skeleton for every survey and question.

Contributing as a developper

Development environement

You may want to use a virtualenv :

  python3 -m venv .env/
  source .env/bin/activate

In order to get started, install the dev requirements, create the database, create a superuser, load the test dump, then launch the server :

  pip install -r requirements_dev.txt
  python migrate
  python createsuperuser
  python loaddata survey/tests/testdump.json
  python runserver


  python test survey

  xdg-open htmlcov/index.html

Sorting imports

    isort -rc survey

Lint :

  pylint survey

Translating the project

Django survey's is available in multiple language. Your contribution would be very appreciated if you know a language that is not yet available.

Language available

  • <input type="checkbox" checked="" disabled="" /> French thanks to Pierre Sassoulas (@Pierre-Sassoulas)
  • <input type="checkbox" checked="" disabled="" /> English
  • <input type="checkbox" checked="" disabled="" /> Japanese thanks to Nobukuni Suzue (@nsuzue)

As a developper

If your language already exists and you're a developper :

  python makemessages --no-obsolete --no-wrap
  python runserver
  # Access http://localhost:8000/rosetta

If your language is not yet available in rosetta, this stack overflow question should work even for language not handled by django.

As a translator

If you're not a developper, open an issue on github and ask for a .po file in your language. I will generate it for you, so you can edit it with an online editor. I will then integrate it to the project and credit you here.


Based on jessykate's django-survey, and contribution by jibaku, joshualoving, and ijasperyang in forks of jessykate's project.

We use anazalea's pySankey for sankey's diagram during reporting.

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-survey-and-report, version 1.3.1
Filename, size File type Python version Upload date Hashes
Filename, size django-survey-and-report-1.3.1.tar.gz (293.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page