Packaging#

Packaging into an executable#

The project takes advantage of PyInstaller to package the application into an executable.

The output binary and all embedded dependencies is located into a subfolder named: dist/GeotribuToolbelt_{version}_{operating-system}_Python{python-version}.

Windows#

Comply with Windows development requirements before to run.

# Generates MS Version Info
python .\builder\version_info_templater.py

# Generates MS Executable
python -O .\builder\pyinstaller_build_windows.py

To run it, double-click on the executable file (*.exe).

Ubuntu#

Comply with Ubuntu development requirements before to run.

# Generates binary executable
python -O ./builder/pyinstaller_build_ubuntu.py

To run it, for example:

cd dist/
chmod u+x ./GeotribuToolbelt_*
./GeotribuToolbelt_0-19-1_Ubuntu22-04_64bit_Python3-10-6

Docker#

Note

Image is meant to be used, not to develop. So, it does not contain side code: docs, tests, etc.
If you need that, edit the .dockerignore file.

Requirements#

  • Docker >= 20.10

Build#

docker build --pull --rm -f "Dockerfile" -t qdt:latest "."

Run within the container#

Enter into the container and run commands interactively::

> docker run --rm -it qdt:latest
root@55c5de0191ee:/user/app# qdt --version
0.23.1

Run QDT directly from the container:

> docker run --rm qdt:latest qdt --version
0.23.1