questions 0.8.0

How the Code Looks

To get a feel for how Questions works, nothing better than looking at a simple example:

from questions import Form
from questions import TextQuestion
from questions import RadioGroupQuestion


class SimpleForm(Form):
    name = TextQuestion()
    email = TextQuestion(input_type="email", required="True")
    favorite_number = TextQuestion(title="What is your favorite number?",
        input_type="number")
    language = RadioGroupQuestion(title="Favorite Language",
        choices=["Python", "Other"])
    version = RadioGroupQuestion(title="Preferred Python Version",
        choices=["Python 2", "Python 3"],
        visible_if="{language} = 'Python'")

This is a fairly conventional way to define forms, so no surprises here, but look at the way the input_type parameter allows us to use different HTML5 text input methods. Pay special attention to the last line, where we use the visible_if parameter to only show the Python version question if the answer to the language question is “Python”. Defining “live” form behavior in this way is something that is usually out of scope for server side code, but Questions’ SurveyJS integration allows us to do it.

Full Working Multi-page Flask Application

Let’s show how easy things can be if your applications needs are simple. The following is a complete application using the popular Flask web framework:

from flask import Flask
from flask import redirect
from flask import request

from questions import Form
from questions import FormPage
from questions import TextQuestion
from questions import DropdownQuestion


class PageOne(Form):
    name = TextQuestion()
    email = TextQuestion(input_type="email", required="True")


class PageTwo(Form):
    country = DropdownQuestion(choices_by_url={"value_name": "name",
        "url": "https://restcountries.eu/rest/v2/all"})
    birthdate = TextQuestion(input_type="date")


class Profile(Form):
    page_one = FormPage(PageOne, title="Identification Information")
    page_two = FormPage(PageTwo, title="Additional Information")


app = Flask(__name__)

@app.route("/", methods=("GET",))
def form():
    form = Profile()
    return form.render_html()

@app.route("/", methods=("POST",))
def post():
    form_data = request.get_json()
    # Here, we would save to a database or something
    print(form_data)
    return redirect("/thanks")

@app.route("/thanks")
def thanks():
    return "Thanks for your information"

if __name__ == "__main__":
    app.run()

By default, Questions uses a CDN for fetching the Javascript resources, which is why all that is needed to run the above code is installing Flask and Questions. Of course, it is possible to install all the dependencies yourself and configure Questions to use your installation, but sometimes this is all that’s required to get a full working application.

Admittedly, our application doesn’t do much, but we get a working form that you can fill and submit in your browser. See how easy it is to get a multi-page form with navigation buttons. Also, notice how get_json is the only Flask request call we need to get the form data.

As the code shows, defining a multiple page form is very simple, and allows us to keep the form pages logically separated, and even using them independently or in combination with other forms with little additional work.

Finally, take a look at the choices_by_url parameter in the DropdownQuestion, which allows us to get the dropdown choices from separate, restful web services.

License and Documentation

• Free software: MIT license

• Documentation: https://questions.readthedocs.io.

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

0.5.0a0 (2020-10-01)

• First release on PyPI.

0.5.0a1 (2020-12-09)

• Fix bug that caused Questions to crash when two or more panels were used in one form.

• Add feature for creating Form subclasses from JSON data.

• Add screencast to README page.

• Update docs.

• Update dependencies to latest versions.

0.5.0a2 (2020-12-09)

• Fix bug with form parameters in from_json conversion.

0.5.0a3 (2020-12-10)

• Make sure jinja templates are included in manifest.

0.7.0a4 (2020-12-13)

• Update installation docs to mention typing-extensions requirement for Python < 3.8.

• Use correct default value for allow_clear in signature pad.

• Set type hints to allow localization arrays in visible text properties.

• Fix bug when generating classes from JSON with dynamic panels.

• Add string representation methods to main classes.

• Feature: add console script for generating code for classes created with from_json method.

0.7.1 (2022-09-18)

• Bug fix: do not add a default page when other pages are defined.

• Update js CDN and tests.

0.8.0 (2023-04-10)

• Bug fix: fix choices with translatable text (thanks @joan-qida).

• Bug fix: fix read the docs build.

• Update SurveyJS version.

• Use current SurveyJS supported themes.

• Include newer Python versions in tests.

• Add documentation for i18n.

• Various dependency updates.