Activate Python virtual environment on Windows during configuration

.gitignore

@@ -16,3 +16,6 @@ _deps
 # Editor directories
 .idea/
 .vs/
+
+# Python Virtual Environment
+.venv/

tools/configure-environment.bat

@@ -1,9 +1,18 @@
 @setlocal enabledelayedexpansion
 
 @set script_dir=%~dp0
+@set venv_path=%script_dir%\..\.venv
+
+:: Assign user-specified Python Virtual Environment
+@if not "%~1"=="" set venv_path=%~f1
+
+:: Activate Python Virtual Environment
+python -m venv %venv_path%
+@call %venv_path%\Scripts\activate.bat
 
 :: Install Python packages
-@pip install --upgrade -r "%script_dir%\..\requirements.txt"
+python -m pip install --upgrade pip
+pip install --upgrade -r "%script_dir%\..\requirements.txt"
 
 :: Configure default Conan profile
 @conan profile detect -e
@@ -19,4 +28,7 @@
     conan config install "%script_dir%\conan\profiles\!profile_name!" -tf profiles
 )
 
+:: Deactivate Python Virtual Environment
+@call %venv_path%\Scripts\deactivate.bat
+
 @pause

tools/lib/run-cmake-configure.bat

@@ -5,7 +5,8 @@
     -DCMAKE_PREFIX_PATH="%qt_base%/%qt_version%/%qt_arch%" ^
     -DCMAKE_PROJECT_TOP_LEVEL_INCLUDES="%script_dir%\..\..\external\cmake-conan\conan_provider.cmake" ^
     -DCONAN_HOST_PROFILE=%conan_profile% ^
-    -DCONAN_BUILD_PROFILE=%conan_profile%
+    -DCONAN_BUILD_PROFILE=%conan_profile% ^
+    -DSCWX_VENV_PATH=%venv_path%
 
 @if defined build_type (
     set cmake_args=%cmake_args% ^

tools/lib/setup-common.bat

@@ -3,7 +3,15 @@
 :: Import common paths
 @call %script_dir%\common-paths.bat
 
+:: Activate Python Virtual Environment
+@if defined venv_path (
+    echo Activating Python Virtual Environment: %venv_path%
+    python -m venv %venv_path%
+    call %venv_path%\Scripts\activate.bat
+)
+
 :: Install Python packages
+python -m pip install --upgrade pip
 pip install --upgrade -r "%script_dir%\..\..\requirements.txt"
 
 @if defined build_type (
@@ -24,3 +32,6 @@ pip install --upgrade -r "%script_dir%\..\..\requirements.txt"
 
 :: Run CMake Configure
 @call %script_dir%\run-cmake-configure.bat
+
+:: Deactivate Python Virtual Environment
+@call %venv_path%\Scripts\deactivate.bat

tools/setup-debug-msvc2022.bat

@@ -6,9 +6,19 @@
 @set generator=Visual Studio 17 2022
 @set qt_base=C:/Qt
 @set qt_arch=msvc2022_64
+@set venv_path=%script_dir%\..\.venv
 
 :: Assign user-specified build directory
-@if not "%~1"=="" set build_dir=%~1
+@if not "%~1"=="" set build_dir=%~f1
+
+:: Assign user-specified Python Virtual Environment
+@if not "%~2"=="" (
+    if /i "%~2"=="none" (
+        set venv_path=
+    ) else (
+        set venv_path=%~f2
+    )
+)
 
 :: Perform common setup
 @call %script_dir%\lib\setup-common.bat

tools/setup-debug-ninja.bat

@@ -6,9 +6,19 @@
 @set generator=Ninja
 @set qt_base=C:/Qt
 @set qt_arch=msvc2022_64
+@set venv_path=%script_dir%\..\.venv
 
 :: Assign user-specified build directory
-@if not "%~1"=="" set build_dir=%~1
+@if not "%~1"=="" set build_dir=%~f1
+
+:: Assign user-specified Python Virtual Environment
+@if not "%~2"=="" (
+    if /i "%~2"=="none" (
+        set venv_path=
+    ) else (
+        set venv_path=%~f2
+    )
+)
 
 :: Perform common setup
 @call %script_dir%\lib\setup-common.bat

tools/setup-multi-msvc2022.bat

@@ -5,9 +5,19 @@
 @set generator=Visual Studio 17 2022
 @set qt_base=C:/Qt
 @set qt_arch=msvc2022_64
+@set venv_path=%script_dir%\..\.venv
 
 :: Assign user-specified build directory
-@if not "%~1"=="" set build_dir=%~1
+@if not "%~1"=="" set build_dir=%~f1
+
+:: Assign user-specified Python Virtual Environment
+@if not "%~2"=="" (
+    if /i "%~2"=="none" (
+        set venv_path=
+    ) else (
+        set venv_path=%~f2
+    )
+)
 
 :: Perform common setup
 @call %script_dir%\lib\setup-common.bat

tools/setup-multi-ninja.bat

@@ -5,9 +5,19 @@
 @set generator=Ninja Multi-Config
 @set qt_base=C:/Qt
 @set qt_arch=msvc2022_64
+@set venv_path=%script_dir%\..\.venv
 
 :: Assign user-specified build directory
-@if not "%~1"=="" set build_dir=%~1
+@if not "%~1"=="" set build_dir=%~f1
+
+:: Assign user-specified Python Virtual Environment
+@if not "%~2"=="" (
+    if /i "%~2"=="none" (
+        set venv_path=
+    ) else (
+        set venv_path=%~f2
+    )
+)
 
 :: Perform common setup
 @call %script_dir%\lib\setup-common.bat

tools/setup-release-msvc2022.bat

@@ -6,9 +6,19 @@
 @set generator=Visual Studio 17 2022
 @set qt_base=C:/Qt
 @set qt_arch=msvc2022_64
+@set venv_path=%script_dir%\..\.venv
 
 :: Assign user-specified build directory
-@if not "%~1"=="" set build_dir=%~1
+@if not "%~1"=="" set build_dir=%~f1
+
+:: Assign user-specified Python Virtual Environment
+@if not "%~2"=="" (
+    if /i "%~2"=="none" (
+        set venv_path=
+    ) else (
+        set venv_path=%~f2
+    )
+)
 
 :: Perform common setup
 @call %script_dir%\lib\setup-common.bat

tools/setup-release-ninja.bat

@@ -6,9 +6,19 @@
 @set generator=Ninja
 @set qt_base=C:/Qt
 @set qt_arch=msvc2022_64
+@set venv_path=%script_dir%\..\.venv
 
 :: Assign user-specified build directory
-@if not "%~1"=="" set build_dir=%~1
+@if not "%~1"=="" set build_dir=%~f1
+
+:: Assign user-specified Python Virtual Environment
+@if not "%~2"=="" (
+    if /i "%~2"=="none" (
+        set venv_path=
+    ) else (
+        set venv_path=%~f2
+    )
+)
 
 :: Perform common setup
 @call %script_dir%\lib\setup-common.bat