Functional Tests

Creating a pibox-installer image is a long and complex process with many many steps of configuration.

This document helps one ensure the whole process created a correct image with the expected behavior and features.

Most tests can be done through the online demo but not all of them. Also, testing on real hardware is a lot faster.

From now on, we'll assume the image was created with project name mybox.

Image size

• Size in bytes (ls -l) should be a multiple of 1,000 not 1,024.
• Size in bytes should be slightly less than the advertised size.
• Example: 127000000000 for a 128G SD card (118.28 GiB)

General

• WiFi network name mybox is present
• WiFi network is open (depends)
• WiFi network is protected and work with defined password (depends)
• Navigating to http://kiwix.org should redirect to http://mybox.hotspot
• Navigating to https://facebook.com should display an error and offer to open the Network Authentication Page or redirect to http://mybox.hotspot (depending on browser).

Ideascube

• Available at http://mybox.hotspot/.
• Favicon is visible and is the one configured (depends).
• Top-left logo is the one configured (depends).
• Custom CSS file has been applied (depends).
• Ideascube does not offer to create an admin account.
• Login to ideascube works with defined username and password (depends).
• Login to ideascube works with admin/admin (depends).
• Lists all the configured contents:
• Khanacademy pointing to http://khanacademy.mybox.hotspot/ (depends).
• Aflatoun pointing to http://aflatoun.mybox.hotspot/ (depends).
• Wikifundi fr pointing to http://fr.wikifundi.mybox.hotspot/ (depends).
• Wikifundi en pointing to http://en.wikifundi.mybox.hotspot/ (depends).
• Edupi pointing to http://edupi-one.hotspot/ (depends).
• Every ZIMs (one card per ZIM) pointing to http://kiwix.mybox.hotspot/zim-id/ (depends).

KhanAcademy

• Available at http://khanacademy.mybox.hotspot/.

• Can login with defined username and password or admin/admin (depends).

• Select language from bottom-left.

• Videos are present and playing (sample).

• Databases on /data/kalite/database/content_khan_en.sqlite, /data/kalite/database/content_khan_fr.sqlite and /data/kalite/database/data.sqlite.

• Files (video) stored on /data/kalite/content/.

Aflatoun

• Available at http://aflatoun.mybox.hotspot/.
• Can login with defined username and password or admin/admin (depends).
• Select language from bottom-left.
• PDF are present and opening (sample fr).
• Videos are present and playing (sample fr).
• Audios are present and playing (sample fr).

Notes:

• Databases on /data/aflatoun/database/content_khan_en.sqlite, /data/aflatoun/database/content_khan_fr.sqlite and /data/aflatoun/database/data.sqlite.
• Files (video, audio, pdf) stored on /data/aflatoun/content/.

Wikifundi

• Available at http://fr.wikifundi.mybox.hotspot/ (depends).
• Available at http://fr.wikifundi.mybox.hotspot/ (depends).
• Can not make edits anonymously.
• Can create a User Account.
• Can Create a page.
• Can edit a page in visual editor and save it.
• Modifications are visible in the Modifications récentes.
• Can Upload a file Téléverser (between 2MiB and 5MiB)
• Can display Wikifundi files: Fichier:Welcome2WP_French_WEB.pdf
• Can reuse an uploaded image.

Notes:

• Database on /data/wikifundi/fr.africapack.kiwix.org/mw_fr_africapack.sqlite and /data/wikifundi/en.africapack.kiwix.org/mw_en_africapack.sqlite.
• Files stored on /data/wikifundi/fr.africapack.kiwix.org/w/images/.

EduPi

• Available at http://edupi.mybox.hotspot/.
• Can login at http://edupi.mybox.hotspot/custom/ with defined username and password or admin/admin (depends).
• Can create folders.
• Can upload files to folders.
• Folders browsable from UI.
• Images, PDF and Files viewable and downloadable from UI.
• Search can find uploaded files.

Notes:

• sys-info displays available space on / partition while the content is actually on /data/edupi so its information is irrelevant.
• Database on /data/edupi/database/db.sqlite3.
• Files stored on /data/edupi/media.

ZIM Files

• Kiwix index available at http://kiwix.mybox.hotspot/.
• Kiwix index shows proper meta data (name, description, size, icon).
• ZIM file available at http://kiwix.mybox.hotspot/zim-id/.
• ZIM file works properly.
• Title Autocomplete in search bar works properly.
• Full text search works properly (depends on ZIM).
• Images display properly (depends on ZIM).
• Videos display properly (depends on ZIM).

Notes:

• Files stored on /data/ideascube/kiwix/.