qualtrutils 0.1.5

Description:

qualtrutils 0.1.5

QualtrUtils - A package to create questions from templates with Qualtrics (v3) API






This package allows the creation of questions based on an existing template (i.e., a question created with the Qualtrics interface. The operations that this package supports are:

Creating block
Copying an existing question
Replacing keywords
Changing multiple choice answers
Changing the initial position of the slider
Changing a question JS code

Installation
Using PIP:
pip install qualtrutils

Using CONDA:
conda install -c emanuele-albini qualtrutils

For developers
To use the package in editable mode use instead the following.
git clone https://github.com/emanuele-albini/qualtrutils.git
pip install --editable qualtrutils

Configuration (optional)
Global configuration is in ~\.qualtrutils\qualtrics.toml. Example:
API_URL = "https://yourdatacenter.qualtrics.com/API/v3/"
API_TOKEN = "your_token"
LIBRARY_ID = "UR_XXXXXXXXXXXXX"
SURVEY_ID = "SV_XXXXXXXXXXXXX"

The configuration saved in ~\.qualtrutils\qualtrics.toml will be used as default in QualtricsSurvey constructor.
This configuration it's optional, the settigs can be directly passed to QualtricsSurvey at runtime.
Usage example
from qualtrutils import QualtricsSurvey

survey = QualtricsSurvey()

# Get a question from an existing survey
question = survey.get_question_by_name('QuestionName', 'MyNewQuestion')

# The following will replace (using regex) all the occurences
# of 'SOMETHING' in the question text and multiples choice answers (if any)
# with 'SOMETHING_ELSE'
question.text_sub('SOMETHING', 'SOMETHING_ELSE')

# The following will set the multiple choice answers
question.set_choices(['First Answer', 'Second Answer', 'Third Answer'])

# The flowwing will set the Javascript code of the question
question.set_js('var hello = 1;')

# Add this new question to the survey in a block called 'Block A'
# If the block does not exists it will be created
survey.create_question(question, 'Block A')

Documentation
See here for the complete documentation with all the functionalities.