Merge branch 'master' into hashap-keytype-generic

Author: chuckyvt

.github/workflows/CI.yml

@@ -20,17 +20,25 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-12]
-        gcc_v: [10, 11, 12, 13] # Version of GFortran we want to use.
+        toolchain:
+          - {compiler: gcc, version: 10}
+          - {compiler: gcc, version: 11}
+          - {compiler: gcc, version: 12}
+          - {compiler: gcc, version: 13}
+          - {compiler: intel, version: '2024.1'}
+          - {compiler: intel-classic, version: '2021.9'}
         build: [cmake]
         include:
           - os: ubuntu-latest
-            gcc_v: 10
             build: cmake-inline
+            toolchain:
+              - {compiler: gcc, version: 10}
+        exclude:
+          - os: macos-12
+            toolchain: {compiler: intel, version: '2024.1'}
+          - os: macos-12
+            toolchain: {compiler: gcc, version: 13}
     env:
-      FC: gfortran-${{ matrix.gcc_v }}
-      CC: gcc-${{ matrix.gcc_v }}
-      CXX: g++-${{ matrix.gcc_v }}
-      GCC_V: ${{ matrix.gcc_v }}
       BUILD_DIR: ${{ matrix.build == 'cmake' && 'build' || '.' }}
 
     steps:
@@ -43,29 +51,19 @@ jobs:
         python-version: 3.x
 
     - name: Install fypp
-      run: pip install --upgrade fypp
+      run: pip install --upgrade fypp ninja
 
-    - name: Install GCC compilers Linux
-      if: contains( matrix.os, 'ubuntu')
-      run: |
-        sudo add-apt-repository ppa:ubuntu-toolchain-r/test
-        sudo apt-get update
-        sudo apt-get install -y gcc-${GCC_V} g++-${GCC_V} gfortran-${GCC_V}
-        sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-${GCC_V} 100 \
-        --slave /usr/bin/gfortran gfortran /usr/bin/gfortran-${GCC_V} \
-        --slave /usr/bin/g++ g++ /usr/bin/g++-${GCC_V} \
-        --slave /usr/bin/gcov gcov /usr/bin/gcov-${GCC_V}
-
-    - name: Install GCC compilers macOS
-      if: contains( matrix.os, 'macos')
-      run: |
-          brew install gcc@${GCC_V} || brew upgrade gcc@${GCC_V} || true
-          brew link gcc@${GCC_V}
+    - name: Setup Fortran compiler
+      uses: fortran-lang/setup-fortran@v1.6.1
+      id: setup-fortran
+      with:
+        compiler: ${{ matrix.toolchain.compiler }}
+        version: ${{ matrix.toolchain.version }}
 
     - name: Configure with CMake
       if: ${{ contains(matrix.build, 'cmake') }}
       run: >-
-        cmake -Wdev
+        cmake -Wdev -G Ninja
         -DCMAKE_BUILD_TYPE=Release
         -DCMAKE_MAXIMUM_RANK:String=4
         -DCMAKE_INSTALL_PREFIX=$PWD/_dist
@@ -91,157 +89,3 @@ jobs:
     - name: Install project
       if: ${{ contains(matrix.build, 'cmake') }}
       run: cmake --install ${{ env.BUILD_DIR }}
-
-  intel-build-llvm:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest]
-        fc: [ifx]
-        cc: [icx]
-        cxx: [icpx]
-    env:
-      FC: ${{ matrix.fc }}
-      CC: ${{ matrix.cc }}
-      CXX: ${{ matrix.cxx }}
-
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-
-    - name: Set up Python 3.x
-      uses: actions/setup-python@v5
-      with:
-        python-version: 3.x
-
-    - name: Add Intel repository (Linux)
-      if: contains(matrix.os, 'ubuntu')
-      run: |
-        wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB \ | gpg --dearmor | sudo tee /usr/share/keyrings/oneapi-archive-keyring.gpg > /dev/null
-        echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
-        sudo apt-get update
-
-    - name: Install Intel oneAPI compiler (Linux)
-      if: contains(matrix.os, 'ubuntu')
-      run: |
-        sudo apt-get install intel-oneapi-compiler-fortran
-        sudo apt-get install intel-oneapi-compiler-dpcpp-cpp
-
-    - name: Setup Intel oneAPI environment
-      run: |
-        source /opt/intel/oneapi/setvars.sh
-        printenv >> $GITHUB_ENV
-
-    - name: Install fypp
-      run: pip install --upgrade fypp
-
-    - name: Configure with CMake
-      run: >-
-         cmake -Wdev
-         -DCMAKE_BUILD_TYPE=Release
-         -DCMAKE_MAXIMUM_RANK:String=4
-         -DCMAKE_INSTALL_PREFIX=$PWD/_dist
-         -S . -B build
-
-    - name: Build and compile
-      run: cmake --build build
-
-    - name: catch build fail
-      run: cmake --build build --verbose --parallel 1
-      if: failure()
-
-    - name: test
-      run: ctest --parallel --output-on-failure --no-tests=error
-      working-directory: build
-
-    - name: Install project
-      run: cmake --install build
-
-  intel-build-classic:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [macos-12]
-        fc: [ifort]
-        cc: [icc]
-        cxx: [icpc]
-    env:
-      MACOS_HPCKIT_URL: >-
-        https://registrationcenter-download.intel.com/akdlm/IRC_NAS/a99cb1c5-5af6-4824-9811-ae172d24e594/m_HPCKit_p_2023.1.0.44543.dmg
-      MACOS_FORTRAN_COMPONENTS: all
-      FC: ${{ matrix.fc }}
-      CC: ${{ matrix.cc }}
-      CXX: ${{ matrix.cxx }}
-
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-
-    - name: Set up Python 3.x
-      uses: actions/setup-python@v5
-      with:
-        python-version: 3.x
-
-    - name: Prepare for cache restore (OSX)
-      if: contains(matrix.os, 'macos')
-      run: |
-        sudo mkdir -p /opt/intel
-        sudo chown $USER /opt/intel
-
-    - name: Cache Intel install (OSX)
-      if: contains(matrix.os, 'macos')
-      id: cache-install
-      uses: actions/cache@v2
-      with:
-        path: /opt/intel/oneapi
-        key: install-${{ env.MACOS_HPCKIT_URL }}-${{ env.MACOS_FORTRAN_COMPONENTS }}
-
-    - name: Install Intel oneAPI compiler (OSX)
-      if: contains(matrix.os, 'macos') && steps.cache-install.outputs.cache-hit != 'true'
-      run: |
-        curl --output webimage.dmg --url "$URL" --retry 5 --retry-delay 5
-        hdiutil attach webimage.dmg
-        if [ -z "$COMPONENTS" ]; then
-          sudo /Volumes/"$(basename "$URL" .dmg)"/bootstrapper.app/Contents/MacOS/bootstrapper -s --action install --eula=accept --continue-with-optional-error=yes --log-dir=.
-          installer_exit_code=$?
-        else
-          sudo /Volumes/"$(basename "$URL" .dmg)"/bootstrapper.app/Contents/MacOS/bootstrapper -s --action install --components="$COMPONENTS" --eula=accept --continue-with-optional-error=yes --log-dir=.
-          installer_exit_code=$?
-        fi
-        hdiutil detach /Volumes/"$(basename "$URL" .dmg)" -quiet
-        exit $installer_exit_code
-      env:
-        URL: ${{ env.MACOS_HPCKIT_URL }}
-        COMPONENTS: ${{ env.MACOS_FORTRAN_COMPONENTS }}
-
-    - name: Setup Intel oneAPI environment
-      run: |
-        source /opt/intel/oneapi/setvars.sh
-        printenv >> $GITHUB_ENV
-
-    - name: Install fypp
-      run: pip install --upgrade fypp
-
-    - name: Configure with CMake
-      run: >-
-         cmake -Wdev
-         -DCMAKE_BUILD_TYPE=Release
-         -DCMAKE_MAXIMUM_RANK:String=4
-         -DCMAKE_INSTALL_PREFIX=$PWD/_dist
-         -S . -B build
-
-    - name: Build and compile
-      run: cmake --build build
-
-    - name: catch build fail
-      run: cmake --build build --verbose --parallel 1
-      if: failure()
-
-    - name: test
-      run: ctest --parallel --output-on-failure --no-tests=error
-      working-directory: build
-
-    - name: Install project
-      run: cmake --install build

.github/workflows/fpm-deployment.yml

@@ -35,9 +35,12 @@ jobs:
         with:
           fpm-version: 'v0.10.0'
 
-      - run: |
+      - run: | # Just for deployment: create stdlib-fpm folder
           python config/fypp_deployment.py --deploy_stdlib_fpm
-          fpm test --profile release
+
+      - 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'
 
     # Update and deploy the f90 files generated by github-ci to the `stdlib-fpm` branch.
       - name: Deploy 🚀

CHANGELOG.md

@@ -1,3 +1,53 @@
+# Version 0.6.1
+
+Full release notes available at [v0.6.1] tag.
+
+[v0.6.1]: https://github.com/fortran-lang/stdlib/releases/tag/v0.6.1
+
+Changes to existing scripts and modules
+  - changes in module `stdlib_linalg_lapack`
+    - Renamed variable for compiler compliance
+      [#812](https://github.com/fortran-lang/stdlib/pull/812)
+  - change of the format in some example programs
+    [#813](https://github.com/fortran-lang/stdlib/pull/813)
+
+
+# Version 0.6.0
+
+Full release notes available at [v0.6.0] tag.
+
+[v0.6.0]: https://github.com/fortran-lang/stdlib/releases/tag/v0.6.0
+
+
+- new script `fypp_deployment.py` to support `fpm` in combination with `fypp`
+  files
+  [#802](https://github.com/fortran-lang/stdlib/pull/802)
+
+
+Changes to existing scripts and modules
+  - change in module `stdlib_hashmap_wrappers`
+    - addition of `int32` hashmap key type
+      [#778](https://github.com/fortran-lang/stdlib/pull/778)
+  - changes in module `stdlib_linalg`
+    - addition of the procedure `det` to compute determinants
+      [#798](https://github.com/fortran-lang/stdlib/pull/798)
+    - addition of the procedures `lstsq` and `lstsq_space`
+      [#801](https://github.com/fortran-lang/stdlib/pull/801)
+      [#809](https://github.com/fortran-lang/stdlib/pull/809)
+    - addition of the procedures `solve` and `solve_lu`
+      [#806](https://github.com/fortran-lang/stdlib/pull/806)
+  - change in module `stdlib_linalg_blas`
+    - addition of the documentation for `rotm` and `rotmg`
+      [#795](https://github.com/fortran-lang/stdlib/pull/795)
+  - use of macOS 12 in macOS CI
+    [#807](https://github.com/fortran-lang/stdlib/pull/807)
+
+
+Changes to existing documentation
+  - Improvement of the documentation `linalg`
+    [#797](https://github.com/fortran-lang/stdlib/pull/797)
+
+
 # Version 0.5.0
 
 Full release notes available at [v0.5.0] tag.

VERSION

@@ -1 +1 @@
-0.5.0
+0.6.1

doc/specs/index.md

@@ -14,6 +14,7 @@ This is an index/directory of the specifications (specs) for each new module/fea
  - [ansi](./stdlib_ansi.html) - Terminal color and style escape sequences
  - [array](./stdlib_array.html) - Procedures for index manipulation and array handling
  - [ascii](./stdlib_ascii.html) - Procedures for handling ASCII characters
+ - [constants](./stdlib_constants.html) - Constants
  - [bitsets](./stdlib_bitsets.html) - Bitset data types and procedures
  - [error](./stdlib_error.html) - Catching and handling errors
  - [hash](./stdlib_hash_procedures.html) - Hashing integer

doc/specs/stdlib_constants.md

@@ -0,0 +1,78 @@
+---
+title: constants
+---
+
+[TOC]
+
+## Introduction
+
+
+The [[stdlib_constants]] module provides mathematical constants and the most common physical constants.
+
+**Warning**: The names of the most common physical constants are kept short as they are inside a dedicated module. 
+Nonetheless, in case of overlapping names, they can always be renamed as following:
+
+```fortran
+use stdlib_constants, only: clight => c
+```
+
+## Codata
+
+The [[stdlib_codata(module)]] module defines all codata (physical) constants as derived 
+type. The module is automatically generated with a simple 
+[parser written in Python](https://github.com/MilanSkocic/codata/)
+The latest codata constants were released in 2022 by the [NIST](http://physics.nist.gov/constants)
+All values for the codata constants are provided as double precision reals. 
+The names are quite long and can be aliased with shorter names.
+
+The derived type [[stdlib_codata_type(module):codata_constant_type(type)]] defines:
+
+* 4 members:
+
+    * `name` (string)
+    * `value` (double precision real)
+    * `uncertainty` (double precision real)
+    * `unit` (string)
+
+* 2 type-bound procedures:
+
+    * `print`: to print the values of the constant members;
+    * `to_real`: to get the value or the uncertainty to the desired precision.
+
+A module level interface [[stdlib_codata_type(module):to_real(interface)]] is 
+available for getting the constant value or uncertainty of a constant. 
+
+## `to_real` - Get the constant value or its uncertainty.
+
+### Status
+
+Experimental
+
+### Description
+
+Convert a [[stdlib_codata_type(module):codata_constant_type(type)]] to a `real` (at least `sp`, or `dp`) scalar. 
+**Warning**: Some constants cannot be converted to single precision `sp` reals due to the value of the exponents.
+
+### Syntax
+
+`r = ` [[stdlib_codata_type(module):to_real(interface)]] `(c, mold [, uncertainty])`
+
+### Arguments
+
+`c`: argument has `intent(in) ` and shall be of type [[stdlib_codata_type(module):codata_constant_type(type)]].
+
+`mold`: argument has `intent(in)` and shall be of `real` type. 
+**Note**: The type of the `mold` argument defines the type of the result.
+
+`uncertainty` (optional): argument has `intent(in)` and shall be of `logical` type. 
+It specifies if the uncertainty needs to be returned instead of the value. Default to `.false.`.
+
+### Return value
+
+Returns a scalar of `real` type which is either the value or the uncertainty of a codata constant.
+
+## Example
+
+```fortran
+{!example/constants/example_constants.f90!}
+```