Abstract Class to Setup a python virtual environment and pip install required packages. Derive this class for creating installer for the respective tool. More...

#include <QmitkSetupVirtualEnvUtil.h>

Inheritance diagram for QmitkSetupVirtualEnvUtil:

[legend]

Public Types
using	CallbackType = void()(itk::Object , const itk::EventObject &, void *)

Public Member Functions
	QmitkSetupVirtualEnvUtil (const QString &baseDir)

	QmitkSetupVirtualEnvUtil ()

virtual bool	SetupVirtualEnv (const QString &venvName)=0
	Implement the method in child class to setup the virtual environment. More...

virtual QString	GetVirtualEnvPath ()
	Get the Virtual Env Path object. Override this method in the respective tool installer class. More...

void	PipInstall (const std::string &library, const std::string &workingDir, CallbackType callback, const std::string &command="pip3")
	Function to Pip install a library package given the location of pip3 executable. Any callback function can be passed to process the output. More...

void	PipInstall (const std::string &library, CallbackType callback, const std::string &command="pip3")
	Overloaded function to Pip install a library function. More...

void	ExecutePython (const std::string &args, const std::string &pythonPath, CallbackType callback, const std::string &command="python")
	Function to execute any python code given a python path. Any callback function can be passed to process the output. More...

void	ExecutePython (const std::string &args, CallbackType callback, const std::string &command="python")
	Overloaded function to Execute Python code. Any callback function can be passed to process the output. More...

void	InstallPytorch (const std::string &workingDir, CallbackType callback)
	Installs pytorch using light-the-torch package, correctly identifying cuda version. Requires location of pip3 executable. Any callback function can be passed to process the output. More...

void	InstallPytorch ()
	Overloaded function to install pytorch using light-the-torch package, correctly identifying cuda version. More...

void	InstallPytorch (CallbackType callback)
	Overloaded function to install pytorch using light-the-torch package, correctly identifying cuda version. More...

QString &	GetBaseDir ()
	Get the Base Dir object. More...

QString &	GetSystemPythonPath ()
	Get the System Python Path object. More...

QString &	GetPythonPath ()
	Get the Python Path object. More...

QString &	GetPipPath ()
	Get the Pip Path object. More...

void	SetSystemPythonPath (const QString &path)
	Set the System Python Path object. More...

void	SetPythonPath (const QString &path)
	Set the Python Path object. More...

void	SetPipPath (const QString &path)
	Set the Pip Path object. More...

void	SetVirtualEnvPath (const QString &path)
	Set the Virtual Env Path object. More...

bool	IsPythonPath (const QString &pythonPath)
	Check if the path provide has python executable or not. More...

Static Public Member Functions
static bool	IsVenvInstalled (const QString &pythonPath)
	Checks if venv module is available for the python. More...

static QString	GetPipPackageVersion (const QString &pythonPath, const QString &packageName)
	Returns version of the pip installed package. More...

static void	PrintProcessEvent (itk::Object , const itk::EventObject &e, void )
	Function can be used as callback to simply print out all the process execution output parsed out from itk::EventObject. More...

static std::pair< QString, QString >	GetExactPythonPath (const QString &pyEnv)
	Get the exact Python path and version for any OS from the virtual environment path. More...

Detailed Description

Abstract Class to Setup a python virtual environment and pip install required packages. Derive this class for creating installer for the respective tool.

Definition at line 25 of file QmitkSetupVirtualEnvUtil.h.

Member Typedef Documentation

◆ CallbackType

using QmitkSetupVirtualEnvUtil::CallbackType = void (*)(itk::Object *, const itk::EventObject &, void *)

Definition at line 28 of file QmitkSetupVirtualEnvUtil.h.

Constructor & Destructor Documentation

◆ QmitkSetupVirtualEnvUtil() [1/2]

QmitkSetupVirtualEnvUtil::QmitkSetupVirtualEnvUtil ( const QString & baseDir )

◆ QmitkSetupVirtualEnvUtil() [2/2]

QmitkSetupVirtualEnvUtil::QmitkSetupVirtualEnvUtil ( )

Member Function Documentation

◆ ExecutePython() [1/2]

void QmitkSetupVirtualEnvUtil::ExecutePython	(	const std::string &	args,
		CallbackType	callback,
		const std::string &	command = `"python"`
	)

Overloaded function to Execute Python code. Any callback function can be passed to process the output.

Parameters

args
callback
command

◆ ExecutePython() [2/2]

void QmitkSetupVirtualEnvUtil::ExecutePython	(	const std::string &	args,
		const std::string &	pythonPath,
		CallbackType	callback,
		const std::string &	command = `"python"`
	)

Function to execute any python code given a python path. Any callback function can be passed to process the output.

Parameters

args
pythonPath
callback
command

◆ GetBaseDir()

QString& QmitkSetupVirtualEnvUtil::GetBaseDir ( )

Get the Base Dir object.

Returns: QString&

◆ GetExactPythonPath()

static std::pair<QString, QString> QmitkSetupVirtualEnvUtil::GetExactPythonPath ( const QString & pyEnv )

static

Get the exact Python path and version for any OS from the virtual environment path.

Returns: A pair of the exact python path and its Python version or empty, if an supported version of Python could not be found.

◆ GetPipPackageVersion()

static QString QmitkSetupVirtualEnvUtil::GetPipPackageVersion	(	const QString &	pythonPath,
		const QString &	packageName
	)

static

Returns version of the pip installed package.

◆ GetPipPath()

QString& QmitkSetupVirtualEnvUtil::GetPipPath ( )

Get the Pip Path object.

Returns: QString&

◆ GetPythonPath()

QString& QmitkSetupVirtualEnvUtil::GetPythonPath ( )

Get the Python Path object.

Returns: QString&

◆ GetSystemPythonPath()

QString& QmitkSetupVirtualEnvUtil::GetSystemPythonPath ( )

Get the System Python Path object.

Returns: QString&

◆ GetVirtualEnvPath()

virtual QString QmitkSetupVirtualEnvUtil::GetVirtualEnvPath ( )

virtual

Get the Virtual Env Path object. Override this method in the respective tool installer class.

Returns: QString

Reimplemented in QmitkSAMInstaller, and QmitkTotalSegmentatorToolInstaller.

◆ InstallPytorch() [1/3]

void QmitkSetupVirtualEnvUtil::InstallPytorch ( )

Overloaded function to install pytorch using light-the-torch package, correctly identifying cuda version.

◆ InstallPytorch() [2/3]

void QmitkSetupVirtualEnvUtil::InstallPytorch ( CallbackType callback )

Overloaded function to install pytorch using light-the-torch package, correctly identifying cuda version.

◆ InstallPytorch() [3/3]

void QmitkSetupVirtualEnvUtil::InstallPytorch	(	const std::string &	workingDir,
		CallbackType	callback
	)

Installs pytorch using light-the-torch package, correctly identifying cuda version. Requires location of pip3 executable. Any callback function can be passed to process the output.

Parameters

workingDir
callback

◆ IsPythonPath()

bool QmitkSetupVirtualEnvUtil::IsPythonPath ( const QString & pythonPath )

Check if the path provide has python executable or not.

Parameters

pythonPath

Returns: true; false

◆ IsVenvInstalled()

static bool QmitkSetupVirtualEnvUtil::IsVenvInstalled ( const QString & pythonPath )

static

Checks if venv module is available for the python.

◆ PipInstall() [1/2]

void QmitkSetupVirtualEnvUtil::PipInstall	(	const std::string &	library,
		CallbackType	callback,
		const std::string &	command = `"pip3"`
	)

Overloaded function to Pip install a library function.

Parameters

library
callback
command

◆ PipInstall() [2/2]

void QmitkSetupVirtualEnvUtil::PipInstall	(	const std::string &	library,
		const std::string &	workingDir,
		CallbackType	callback,
		const std::string &	command = `"pip3"`
	)

Function to Pip install a library package given the location of pip3 executable. Any callback function can be passed to process the output.

Parameters

library
workingDir
callback
command

◆ PrintProcessEvent()

static void QmitkSetupVirtualEnvUtil::PrintProcessEvent	(	itk::Object *	,
		const itk::EventObject &	e,
		void *
	)

static

Function can be used as callback to simply print out all the process execution output parsed out from itk::EventObject.

◆ SetPipPath()

void QmitkSetupVirtualEnvUtil::SetPipPath ( const QString & path )

Set the Pip Path object.

Parameters

path

◆ SetPythonPath()

void QmitkSetupVirtualEnvUtil::SetPythonPath ( const QString & path )

Set the Python Path object.

Parameters

path

◆ SetSystemPythonPath()

void QmitkSetupVirtualEnvUtil::SetSystemPythonPath ( const QString & path )

Set the System Python Path object.

Parameters

path

◆ SetupVirtualEnv()

virtual bool QmitkSetupVirtualEnvUtil::SetupVirtualEnv ( const QString & venvName )

pure virtual

Implement the method in child class to setup the virtual environment.

Implemented in QmitkSAMInstaller, and QmitkTotalSegmentatorToolInstaller.

◆ SetVirtualEnvPath()

void QmitkSetupVirtualEnvUtil::SetVirtualEnvPath ( const QString & path )

Set the Virtual Env Path object.

Parameters

path

The documentation for this class was generated from the following file:

QmitkSetupVirtualEnvUtil.h

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ CallbackType

Constructor & Destructor Documentation

◆ QmitkSetupVirtualEnvUtil() [1/2]

◆ QmitkSetupVirtualEnvUtil() [2/2]

Member Function Documentation

◆ ExecutePython() [1/2]

◆ ExecutePython() [2/2]

◆ GetBaseDir()

◆ GetExactPythonPath()

◆ GetPipPackageVersion()

◆ GetPipPath()

◆ GetPythonPath()

◆ GetSystemPythonPath()

◆ GetVirtualEnvPath()

◆ InstallPytorch() [1/3]

◆ InstallPytorch() [2/3]

◆ InstallPytorch() [3/3]

◆ IsPythonPath()

◆ IsVenvInstalled()

◆ PipInstall() [1/2]

◆ PipInstall() [2/2]

◆ PrintProcessEvent()

◆ SetPipPath()

◆ SetPythonPath()

◆ SetSystemPythonPath()

◆ SetupVirtualEnv()

◆ SetVirtualEnvPath()