Reference test platforms¶
About requirements¶
The requirements.txt
mentioned in the following sections is a text file which
contains the list of all the Python packages required for building up the projet
environment. It is used by the pip
command to install all the dependencies.
The requirements.txt
file is generated automatically by the
toml-to-requirements
tool. It is based on the pyproject.toml
file
which is the reference file for the project dependencies.
Warning
Please note that the generation is not systematic and the requirements.txt
file may not be up-to-date.
To update the requirements.txt
file, you need to install the
toml-to-requirements
and execute the following command:
toml-to-req --toml-file .\pyproject.toml --include-optional
Microsoft Windows 10¶
First, install the latest version of Python 3.10 from the WinPython project.
Note
At the time of writing, the latest version is 3.10.11.1 which can be download from here.
Then install all the requirements using the following command from the WinPython command prompt:
pip install -r requirements.txt
That’s it, you can now run the tests using the following command:
pytest
If you want to rely on Visual Studio Code for editing and take advantage of the project settings and tasks, you will need to set the following environment variable:
set PPSTACK_PYTHONEXE=C:\WPy64-31110\python-3.11.1.amd64\python.exe
CentOS Stream 8.8¶
Note
The following instructions have been tested on CentOS Stream which is the
reference platform for the project. However, they should work on
any other Linux distribution relying on the yum
package manager.
As for the other distributions, you may need to adapt the instructions
to your specific environment (e.g. use apt-get
instead of yum
).
First, install the prerequisites:
sudo yum install groupinstall "Development Tools" -y
sudo yum install openssl-devel.i686 libffi-devel.i686 bzip2-devel.i686 sqlite-devel -y
Check that gcc
is installed and available in the PATH
environment variable:
gcc --version
Install OpenSSL 1.1.1:
wget https://www.openssl.org/source/openssl-1.1.1v.tar.gz
tar -xvf openssl-1.1.1v.tar.gz
cd openssl-1.1.1v
./config --prefix=/usr --openssldir=/etc/ssl --libdir=lib no-shared zlib-dynamic
make
sudo make install
openssl version
which openssl
cd ..
Install Python 3.10.13 (the latest 3.10 version at the time of writing):
wget https://www.python.org/ftp/python/3.10.13/Python-3.10.13.tgz
tar -xvf Python-3.10.13.tgz
cd Python-3.10.13
./configure --enable-optimizations --with-openssl=/usr --enable-loadable-sqlite-extensions
sudo make altinstall
cd ..
Eventually add the /usr/local/bin
directory to the PATH
environment variable
if Python has warned you about it:
sudo echo 'pathmunge /usr/local/bin' > /etc/profile.d/py310.sh
chmod +x /etc/profile.d/py310.sh
. /etc/profile # or logout and login again (reload the environment variables)
echo $PATH # check that /usr/local/bin is in the PATH
Create a virtual environment and install the requirements:
python3.10 -m venv guidata-venv
source guidata-venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
That’s it, you can now run the tests using the following command:
pytest