Merge branch 'master' into subprocess

Author: perazz

.github/workflows/ci_windows.yml

@@ -13,8 +13,7 @@ jobs:
       fail-fast: false
       matrix:
         include: [
-          { msystem: MINGW64, arch: x86_64 },
-          { msystem: MINGW32, arch: i686   }
+          { msystem: MINGW64, arch: x86_64 }
         ]
     defaults:
       run:

.github/workflows/fpm-deployment.yml

@@ -38,6 +38,9 @@ jobs:
       - run: | # Just for deployment: create stdlib-fpm folder
           python config/fypp_deployment.py --deploy_stdlib_fpm
 
+      - run: | # Just for deployment: create stdlib-fpm-ilp64 folder
+          python config/fypp_deployment.py --deploy_stdlib_fpm --with_ilp64
+
       - run: | # Use fpm gnu ci to check xdp and qp 
           python config/fypp_deployment.py --with_xdp --with_qp
           fpm test --profile release --flag '-DWITH_XDP -DWITH_QP'
@@ -48,4 +51,12 @@ jobs:
         if: github.event_name != 'pull_request'
         with:
           BRANCH: stdlib-fpm
-          FOLDER: stdlib-fpm
+          FOLDER: stdlib-fpm
+
+    # Update and deploy the f90 files generated by github-ci to the `stdlib-fpm-ilp64` branch.
+      - name: Deploy with 64-bit integer support 🚀
+        uses: JamesIves/[email protected]
+        if: github.event_name != 'pull_request'
+        with:
+          BRANCH: stdlib-fpm-ilp64
+          FOLDER: stdlib-fpm-ilp64

CMakeLists.txt

@@ -62,6 +62,7 @@ list(
   "-DWITH_CBOOL=$<BOOL:${WITH_CBOOL}>"
   "-DWITH_QP=$<BOOL:${WITH_QP}>"
   "-DWITH_XDP=$<BOOL:${WITH_XDP}>"
+  "-DWITH_ILP64=$<BOOL:${WITH_ILP64}>"
   "-DPROJECT_VERSION_MAJOR=${PROJECT_VERSION_MAJOR}"
   "-DPROJECT_VERSION_MINOR=${PROJECT_VERSION_MINOR}"
   "-DPROJECT_VERSION_PATCH=${PROJECT_VERSION_PATCH}"

README.md

@@ -90,15 +90,15 @@ Name | Version | Platform | Architecture
 GCC Fortran | 10, 11, 12, 13 | Ubuntu 22.04.2 LTS | x86_64
 GCC Fortran | 10, 11, 12, 13 | macOS 12.6.3 (21G419) | x86_64
 GCC Fortran (MSYS) | 13 | Windows Server 2022 (10.0.20348 Build 1547) | x86_64
-GCC Fortran (MinGW) | 13 | Windows Server 2022 (10.0.20348 Build 1547) | x86_64, i686
+GCC Fortran (MinGW) | 13 | Windows Server 2022 (10.0.20348 Build 1547) | x86_64
 Intel oneAPI LLVM | 2024.0 | Ubuntu 22.04.2 LTS | x86_64
 Intel oneAPI classic | 2023.1 | macOS 12.6.3 (21G419) | x86_64
 
 The following combinations are known to work, but they are not tested in the CI:
 
 Name | Version | Platform | Architecture
 --- | --- | --- | ---
-GCC Fortran (MinGW) | 9.3.0, 10.2.0, 11.2.0 | Windows 10 | x86_64, i686
+GCC Fortran (MinGW) | 9.3.0, 10.2.0, 11.2.0 | Windows 10 | x86_64
 
 We try to test as many available compilers and platforms as possible.
 A list of tested compilers which are currently not working and the respective issue are listed below.
@@ -345,6 +345,34 @@ as well as a specification document or ["spec"](https://stdlib.fortran-lang.org/
 Some discussions and prototypes of proposed APIs along with a list of popular open source Fortran projects are available on the
 [wiki](https://github.com/fortran-lang/stdlib/wiki).
 
+## BLAS and LAPACK
+
+`stdlib` ships full versions of BLAS and LAPACK, for all `real` and `complex` kinds, through generalized interface modules `stdlib_linalg_blas` and `stdlib_linalg_lapack`.
+The 32- and 64-bit implementations may be replaced by external optimized libraries if available, which may allow for faster code.
+When linking against external BLAS/LAPACK libraries, the user should define macros `STDLIB_EXTERNAL_BLAS` and `STDLIB_EXTERNAL_LAPACK`, 
+to ensure that the external library version is used instead of the internal implementation. 
+
+- In case of a CMake build, the necessary configuration can be added by ensuring both macros are defined:
+  ```
+  add_compile_definitions(STDLIB_EXTERNAL_BLAS STDLIB_EXTERNAL_LAPACK)
+  ```
+- In case of an `fpm` build, the stdlib dependency should be set as follows:
+  ```toml
+  [dependencies]
+  stdlib = { git="https://github.com/fortran-lang/stdlib", branch="stdlib-fpm", preprocess.cpp.macros=["STDLIB_EXTERNAL_BLAS", "STDLIB_EXTERNAL_LAPACK"] }
+  ```
+
+Support for 64-bit integer size interfaces of all BLAS and LAPACK procedures may also be enabled 
+by setting the CMake flag `-DWITH_ILP64=True`. The 64-bit integer version is always built in addition to 
+the 32-bit integer version, that is always available. Additional macros `STDLIB_EXTERNAL_BLAS_I64` and `STDLIB_EXTERNAL_LAPACK_I64`  
+may be defined to link against an external 64-bit integer library, such as Intel MKL. 
+
+- In case of an `fpm` build, 64-bit integer linear algebra support is given via branch `stdlib-fpm-ilp64`:
+  ```toml
+  [dependencies]
+  stdlib = { git="https://github.com/fortran-lang/stdlib", branch="stdlib-fpm-ilp64", preprocess.cpp.macros=["STDLIB_EXTERNAL_BLAS_I64", "STDLIB_EXTERNAL_LAPACK"] }
+  ```
+
 ## Contributing
 
 * [Guidelines](CONTRIBUTING.md)

config/CMakeLists.txt

@@ -39,6 +39,11 @@ if (NOT DEFINED WITH_XDP)
   )
   set(WITH_XDP ${WITH_XDP} PARENT_SCOPE)
 endif()
+# Check if WITH_ILP64 is defined; if not, set it to FALSE
+if (NOT DEFINED WITH_ILP64)
+  set(WITH_ILP64 FALSE)
+  set(WITH_ILP64 ${WITH_ILP64} PARENT_SCOPE)
+endif()
 
 # Export a pkg-config file
 configure_file(

config/fypp_deployment.py

@@ -42,6 +42,8 @@ def pre_process_fypp(args):
         kwd.append("-DWITH_QP=True")
     if args.with_xdp:
         kwd.append("-DWITH_XDP=True")
+    if args.with_ilp64:
+        kwd.append("-DWITH_ILP64=True")
 
     optparser = fypp.get_option_parser()
     options, leftover = optparser.parse_args(args=kwd)
@@ -78,32 +80,38 @@ def process_f(file):
     return
 
 
-def deploy_stdlib_fpm():
+def deploy_stdlib_fpm(with_ilp64):
     """create the stdlib-fpm folder for backwards compatibility (to be deprecated)
     """
     import shutil
     prune=(
         "test_hash_functions.f90",
         "f18estop.f90",
     )
-    if not os.path.exists('stdlib-fpm'+os.sep+'src'):
-        os.makedirs('stdlib-fpm'+os.sep+'src')
-    if not os.path.exists('stdlib-fpm'+os.sep+'test'):
-        os.makedirs('stdlib-fpm'+os.sep+'test')
-    if not os.path.exists('stdlib-fpm'+os.sep+'example'):
-        os.makedirs('stdlib-fpm'+os.sep+'example')
+    
+    if with_ilp64:
+        base_folder = 'stdlib-fpm-ilp64'
+    else:
+        base_folder = 'stdlib-fpm'        
+
+    if not os.path.exists(base_folder+os.sep+'src'):
+        os.makedirs(base_folder+os.sep+'src')
+    if not os.path.exists(base_folder+os.sep+'test'):
+        os.makedirs(base_folder+os.sep+'test')
+    if not os.path.exists(base_folder+os.sep+'example'):
+        os.makedirs(base_folder+os.sep+'example')
 
     def recursive_copy(folder):
         for root, _, files in os.walk(folder):
             for file in files:
                 if file not in prune:
                     if file.endswith((".f90", ".F90", ".dat", ".npy", ".c")):
-                        shutil.copy2(os.path.join(root, file), 'stdlib-fpm'+os.sep+folder+os.sep+file)
+                        shutil.copy2(os.path.join(root, file), base_folder+os.sep+folder+os.sep+file)
     recursive_copy('src')
     recursive_copy('test')
     recursive_copy('example')
     for file in ['.gitignore','fpm.toml','LICENSE','VERSION']:
-        shutil.copy2(file, 'stdlib-fpm'+os.sep+file)
+        shutil.copy2(file, base_folder+os.sep+file)
     return
 
 def fpm_build(args,unknown):
@@ -140,8 +148,9 @@ def fpm_build(args,unknown):
     parser.add_argument("--maxrank",type=int, default=4, help="Set the maximum allowed rank for arrays")
     parser.add_argument("--with_qp",action='store_true', help="Include WITH_QP in the command")
     parser.add_argument("--with_xdp",action='store_true', help="Include WITH_XDP in the command")
+    parser.add_argument("--with_ilp64",action='store_true', help="Include WITH_ILP64 to build 64-bit integer BLAS/LAPACK")
     parser.add_argument("--lnumbering",action='store_true', help="Add line numbering in preprocessed files")
-    parser.add_argument("--deploy_stdlib_fpm",action='store_true', help="create the stdlib-fpm folder")
+    parser.add_argument("--deploy_stdlib_fpm",action='store_true', help="create the stdlib-fpm folder")    
     # external libraries arguments
     parser.add_argument("--build", action='store_true', help="Build the project")
 
@@ -158,7 +167,7 @@ def fpm_build(args,unknown):
     # pre process the meta programming fypp files
     pre_process_fypp(args)
     if args.deploy_stdlib_fpm:
-        deploy_stdlib_fpm()
+        deploy_stdlib_fpm(args.with_ilp64)
     #==========================================
     # build using fpm
     if args.build:

config/template.cmake

@@ -3,6 +3,7 @@
 set("@PROJECT_NAME@_WITH_CBOOL" @WITH_CBOOL@)
 set("@PROJECT_NAME@_WITH_QP" @WITH_QP@)
 set("@PROJECT_NAME@_WITH_XDP" @WITH_XDP@)
+set("@PROJECT_NAME@_WITH_ILP64" @WITH_ILP64@)
 
 if(NOT TARGET "@PROJECT_NAME@::@PROJECT_NAME@")
   include("${CMAKE_CURRENT_LIST_DIR}/@[email protected]")