fix #665 parfeval with background thread pool)

* parallel module template
* allow to assign in handle array
* allows overload struct(handle) and fieldnames(handle) if available
* do not allow to concate handle with different category
* handle display header
* fetchOutputs
* changelog 0.6.6
* 0.6.6.x family
* backgroundPool, fetchOutputs, parfeval help files
* codacy warnings
* CodeQL warning

Author: Nelson-numerical-software

CHANGELOG.md

@@ -4,10 +4,16 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
-## 0.6.X (UNRELEASED)
+## 0.6.6 (UNRELEASED)
 
 ### Added
 
+- Parallel functions (part 1):
+
+  - `parfeval`: Run function on parallel background thread pool worker.
+  - `backgroundPool`: Environment for running code in the background.
+  - `fetchOutputs`: Retrieve results from function running in the background.
+
 - [#666](http://github.com/Nelson-numerical-software/nelson/issues/666): `ls` function: List folder contents.
 
 - [#655](http://github.com/Nelson-numerical-software/nelson/issues/655): help viewer embedded (available on all platforms).
@@ -20,6 +26,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 - [#668](http://github.com/Nelson-numerical-software/nelson/issues/668): `maxNumCompThreads` detects numbers of physical cores on Windows.
 
+- matrix of handles supported.
+
 ### Fixed
 
 - [#659](http://github.com/Nelson-numerical-software/nelson/issues/659): qhelpgenerator on macOs after brew Qt6.3.0 update.

CMakeLists.txt

@@ -22,7 +22,7 @@ project(Nelson)
 # ==============================================================================
 set(Nelson_VERSION_MAJOR_DEFAULT 0)
 set(Nelson_VERSION_MINOR_DEFAULT 6)
-set(Nelson_VERSION_MAINTENANCE_DEFAULT 5)
+set(Nelson_VERSION_MAINTENANCE_DEFAULT 6)
 set(Nelson_VERSION_BUILD_DEFAULT 0)
 # ==============================================================================
 if(NOT DEFINED CMAKE_INSTALL_PREFIX)

NelSon.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 16.0.29728.190
+# Visual Studio Version 17
+VisualStudioVersion = 17.1.32421.90
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NelSon-gui", "modules\main\nelson_gui\NelSon-gui.vcxproj", "{F34BD496-D9B3-4C25-A9E9-C91EB3E35C12}"
 	ProjectSection(ProjectDependencies) = postProject
@@ -75,6 +75,7 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NelSon-cli", "modules\main\
 		{34B4A66D-9703-400E-9F00-B595F8C72808} = {34B4A66D-9703-400E-9F00-B595F8C72808}
 		{221D076E-3B43-42CC-8EE7-159424BE4CF2} = {221D076E-3B43-42CC-8EE7-159424BE4CF2}
 		{EA091C71-85C9-417A-B5AA-211455D6FC79} = {EA091C71-85C9-417A-B5AA-211455D6FC79}
+		{8620B873-E578-4F09-A46C-00539356604E} = {8620B873-E578-4F09-A46C-00539356604E}
 		{D8992275-39D6-486D-AEA8-445E49B419E8} = {D8992275-39D6-486D-AEA8-445E49B419E8}
 		{EF054E75-90E8-46B3-AA42-F1C424F0DC3C} = {EF054E75-90E8-46B3-AA42-F1C424F0DC3C}
 		{A510477A-3415-4E46-8C98-8579823ADF91} = {A510477A-3415-4E46-8C98-8579823ADF91}
@@ -124,6 +125,7 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NelSon-cli", "modules\main\
 		{59D86CCC-61D2-4BB7-80C0-E0CCB668AA7F} = {59D86CCC-61D2-4BB7-80C0-E0CCB668AA7F}
 		{AC0F66CE-C661-4D56-8FE7-8D0AE72E5BF9} = {AC0F66CE-C661-4D56-8FE7-8D0AE72E5BF9}
 		{78B885D2-1630-42DE-9829-E791D77BB175} = {78B885D2-1630-42DE-9829-E791D77BB175}
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA} = {B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}
 		{5E1776D7-EDDC-4AA7-A085-BAEFA057D5EB} = {5E1776D7-EDDC-4AA7-A085-BAEFA057D5EB}
 		{F6495DD9-6FF5-485B-9393-767327A4DD79} = {F6495DD9-6FF5-485B-9393-767327A4DD79}
 		{3389E1DA-B13E-46E0-A6BF-67E7D207ABAB} = {3389E1DA-B13E-46E0-A6BF-67E7D207ABAB}
@@ -451,6 +453,10 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "nlsDisplay_format", "module
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "nlsDisplay_format_builtin", "modules\display_format\builtin\c\nlsDisplay_format_builtin.vcxproj", "{C2034CB9-7ACD-4B87-9F89-DDFE0FDECC62}"
 EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "nlsParallel", "modules\parallel\src\c\nlsParallel.vcxproj", "{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "nlsParallel_builtin", "modules\parallel\builtin\c\nlsParallel_builtin.vcxproj", "{8620B873-E578-4F09-A46C-00539356604E}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Win32 = Debug|Win32
@@ -1559,6 +1565,22 @@ Global
 		{C2034CB9-7ACD-4B87-9F89-DDFE0FDECC62}.Release|Win32.Build.0 = Release|Win32
 		{C2034CB9-7ACD-4B87-9F89-DDFE0FDECC62}.Release|x64.ActiveCfg = Release|x64
 		{C2034CB9-7ACD-4B87-9F89-DDFE0FDECC62}.Release|x64.Build.0 = Release|x64
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}.Debug|Win32.ActiveCfg = Debug|Win32
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}.Debug|Win32.Build.0 = Debug|Win32
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}.Debug|x64.ActiveCfg = Debug|x64
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}.Debug|x64.Build.0 = Debug|x64
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}.Release|Win32.ActiveCfg = Release|Win32
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}.Release|Win32.Build.0 = Release|Win32
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}.Release|x64.ActiveCfg = Release|x64
+		{B472F9D3-B1A1-44AE-8C50-4CCE4520E2AA}.Release|x64.Build.0 = Release|x64
+		{8620B873-E578-4F09-A46C-00539356604E}.Debug|Win32.ActiveCfg = Debug|Win32
+		{8620B873-E578-4F09-A46C-00539356604E}.Debug|Win32.Build.0 = Debug|Win32
+		{8620B873-E578-4F09-A46C-00539356604E}.Debug|x64.ActiveCfg = Debug|x64
+		{8620B873-E578-4F09-A46C-00539356604E}.Debug|x64.Build.0 = Debug|x64
+		{8620B873-E578-4F09-A46C-00539356604E}.Release|Win32.ActiveCfg = Release|Win32
+		{8620B873-E578-4F09-A46C-00539356604E}.Release|Win32.Build.0 = Release|Win32
+		{8620B873-E578-4F09-A46C-00539356604E}.Release|x64.ActiveCfg = Release|x64
+		{8620B873-E578-4F09-A46C-00539356604E}.Release|x64.Build.0 = Release|x64
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

appveyor.yml

@@ -1,4 +1,4 @@
-version: 0.6.5.{build}
+version: 0.6.6.{build}
 image: Visual Studio 2022
 
 environment:

modules/CMakeLists.txt

@@ -79,7 +79,8 @@ list(
   ipc
   statistics
   validators
-  polynomial_functions)
+  polynomial_functions
+  parallel)
 list(APPEND moduleslist main)
 # ==============================================================================
 if (NOT LGPL21_ONLY)

modules/api_nelson/src/c/resources.rc

@@ -48,8 +48,8 @@ END
 //
 
 VS_VERSION_INFO VERSIONINFO
- FILEVERSION 0,6,5,0
- PRODUCTVERSION 0,6,5,0
+ FILEVERSION 0,6,6,0
+ PRODUCTVERSION 0,6,6,0
  FILEFLAGSMASK 0x17L
 #ifdef _DEBUG
  FILEFLAGS 0x1L
@@ -68,8 +68,8 @@ BEGIN
             VALUE "InternalName", "api_nelson"
             VALUE "OriginalFilename", "libnlsapi_nelson.dll"
             VALUE "ProductName", "Nelson (api_nelson)"
-            VALUE "ProductVersion", "0,6,5,0"
-            VALUE "FileVersion", "0,6,5,0"
+            VALUE "ProductVersion", "0,6,6,0"
+            VALUE "FileVersion", "0,6,6,0"
             VALUE "LegalCopyright", "Nelson Copyright (C) 2016-present"
             VALUE "Comments", "All rights reserved."
             VALUE "CompanyName", "Allan CORNET"

modules/assert_functions/builtin/c/resources.rc

@@ -48,8 +48,8 @@ END
 //
 
 VS_VERSION_INFO VERSIONINFO
- FILEVERSION 0,6,5,0
- PRODUCTVERSION 0,6,5,0
+ FILEVERSION 0,6,6,0
+ PRODUCTVERSION 0,6,6,0
  FILEFLAGSMASK 0x17L
 #ifdef _DEBUG
  FILEFLAGS 0x1L
@@ -68,8 +68,8 @@ BEGIN
             VALUE "InternalName", "assert_functions_builtin"
             VALUE "OriginalFilename", "libnlsassert_functions_builtin.dll"
             VALUE "ProductName", "Nelson (assert_functions_builtin)"
-            VALUE "ProductVersion", "0,6,5,0"
-            VALUE "FileVersion", "0,6,5,0"
+            VALUE "ProductVersion", "0,6,6,0"
+            VALUE "FileVersion", "0,6,6,0"
             VALUE "LegalCopyright", "Nelson Copyright (C) 2016-present"
             VALUE "Comments", "All rights reserved."
             VALUE "CompanyName", "Allan CORNET"

modules/assert_functions/src/c/resources.rc

@@ -48,8 +48,8 @@ END
 //
 
 VS_VERSION_INFO VERSIONINFO
- FILEVERSION 0,6,5,0
- PRODUCTVERSION 0,6,5,0
+ FILEVERSION 0,6,6,0
+ PRODUCTVERSION 0,6,6,0
  FILEFLAGSMASK 0x17L
 #ifdef _DEBUG
  FILEFLAGS 0x1L
@@ -68,8 +68,8 @@ BEGIN
             VALUE "InternalName", "assert_functions"
             VALUE "OriginalFilename", "libnlsassert_functions.dll"
             VALUE "ProductName", "Nelson (assert_functions)"
-            VALUE "ProductVersion", "0,6,5,0"
-            VALUE "FileVersion", "0,6,5,0"
+            VALUE "ProductVersion", "0,6,6,0"
+            VALUE "FileVersion", "0,6,6,0"
             VALUE "LegalCopyright", "Nelson Copyright (C) 2016-present"
             VALUE "Comments", "All rights reserved."
             VALUE "CompanyName", "Allan CORNET"

modules/audio/builtin/c/resources.rc

@@ -48,8 +48,8 @@ END
 //
 
 VS_VERSION_INFO VERSIONINFO
- FILEVERSION 0,6,5,0
- PRODUCTVERSION 0,6,5,0
+ FILEVERSION 0,6,6,0
+ PRODUCTVERSION 0,6,6,0
  FILEFLAGSMASK 0x17L
 #ifdef _DEBUG
  FILEFLAGS 0x1L
@@ -68,8 +68,8 @@ BEGIN
             VALUE "InternalName", "audio_builtin"
             VALUE "OriginalFilename", "libnlsaudio_builtin.dll"
             VALUE "ProductName", "Nelson (audio_builtin)"
-            VALUE "ProductVersion", "0,6,5,0"
-            VALUE "FileVersion", "0,6,5,0"
+            VALUE "ProductVersion", "0,6,6,0"
+            VALUE "FileVersion", "0,6,6,0"
             VALUE "LegalCopyright", "Nelson Copyright (C) 2016-present"
             VALUE "Comments", "All rights reserved."
             VALUE "CompanyName", "Allan CORNET"

modules/audio/builtin/cpp/audioplayer_getBuiltin.cpp

@@ -30,7 +30,7 @@ Nelson::AudioGateway::audioplayer_getBuiltin(int nLhs, const ArrayOfVector& argI
     auto* objPlayer = (AudioplayerObject*)param1.getContentAsHandleScalar();
     ArrayOf res;
     if (!objPlayer->get(propertyName, res)) {
-        Error(ERROR_WRONG_ARGUMENT_2_VALUE);
+        Error(ERROR_WRONG_ARGUMENT_2_VALUE + L" " + propertyName);
     }
     retval << res;
     return retval;