Developers Notes

Packaging (not applicable to version 4.0)

Windows

Prerequisites

• python3 latest version (not Microsoft Store version)
• include python executable in PATH system
• NSIS - Nullsoft Scriptable Installer for making a self-extract installer

Packaging

1. Clone or unzip the code in a Windows machine folder.
2. Create a virtual enviroment

python -m venv <name of virutalenv>

4. activate the virtualenv
5. install wheel package, the requirements.txt (remove the pytest and weasyprint from it) and pyinstaller

pip install wheel
pip install -r requirements.txt
pip install pyinstaller

6. update paths (inluded_files and pathex) in added_files list .spec file
7. run pyinstaller

pyinstaller qctoolgui_windows.spec

8. Zip the dist\MipDataQualityControlTool folder
9. use the NSIS to create a self-extract installer

MacOS

Prerequisites

1. install homebrew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

2. Download and install the latest python3 version from the official python.org website. There are some issues with tkinter with the python versions installed through the apple store. Also, don't install python through homebrew.
3. Install cairo, Pango and GDK-PixBuf using Homebrew:

brew install cairo pango gdk-pixbuf libffi

Packaging

1. Clone or unzip the code in a Windows machine folder.
2. Create a virtual enviroment

python3 -m venv <name of virutalenv>

4. activate the virtualenv
5. install wheel package, the requirements.txt (remove the pytest and weasyprint from it) and pyinstaller

pip3 install wheel
pip3 install -r requirements.txt
pip3 install pyinstaller

6. update paths (inluded_files and pathex) in added_files list .spec file
7. run pyinstaller

pyinstaller qctoolgui_macos.spec

Ubuntu

• Docker client
• dh-virtualenv

the instructions in dh-virtualenv cookbook

https://sourceforge.net/projects/vcxsrv/