dynamic-kobo

Replace / update and redeploy KoBo forms.

Developed by Karla Peña Ramírez, packaged by Jacopo Margutti.

Requirements

1. Python >= 3.7
2. Firefox
3. Geckodriver

Set up

1. Download and install Firefox
2. Download the geckodriver binary for your platform (here)
3. Install dynamic-kobo from PyPI

pip install dynamic-kobo

Usage

Usage: replace-redeploy [OPTIONS]

  replace KoBo form with a new one and redeploy

Options:
  --config            path to configuration file (.env)
  --headless          run headless (no GUI)
  --koboserver TEXT   URL of KoBo server
  --username TEXT     username
  --password TEXT     password
  --formid TEXT       form (asset) ID
  --newform TEXT      absolute path to new form (.xlsx)
  --geckodriver TEXT  absolute path to geckodriver binary
  --help              show this message and exit

N.B. all options can be stored in a .env file, the script will load them automatically as environment variables. Example:

GECKODRIVER=C:\geckodriver\geckodriver.exe
KOBO_SERVER=https://kobo.humanitarianresponse.info/
USERNAME=...
PASSWORD=...
FORM_ID=ai3sdfC1GnERTW72rwwSFq
NEW_FORM='C:\forms\new-form.xlsx'