Merge pull request #308 from GraphBLAS/v1.2

LAGraph v1.2, ready for a beta release.  It has one more minor change I'd like to make before releasing a stable v1.2.  The github CI uses SuiteSparse:GraphBLAS 9.0.0 and 10.0.5.  I'm about to release 10.1.0 (it's already posted as 10.1.0-beta.1).  I would like to revise the CI to use 9.0.0 and 10.1.0.

Author: DrTimothyAldenDavis

.github/workflows/build-arch-emu.yaml

@@ -0,0 +1,87 @@
+name: arch-emu
+
+# this is done on workflow_dispatch only since it takes a very long time
+on:
+  workflow_dispatch:
+
+jobs:
+
+  alpine:
+    # Run armv7 on aarch64 runners
+    runs-on: ${{ matrix.arch == 'armv7' && 'ubuntu-24.04-arm' || 'ubuntu-latest' }}
+
+    defaults:
+      run:
+        # Use emulated shell as default
+        shell: alpine.sh {0}
+
+    strategy:
+      matrix:
+        config:
+          # FIXME: switch to 10.1.0 when it is released:
+         - {grb_version: 10.0.5}
+        # For available CPU architectures, see:
+        # https://github.com/marketplace/actions/setup-alpine-linux-environment
+        arch: [riscv64]
+        include:
+          - arch: riscv64
+            ccache-max: 28M
+
+    name: alpine (${{ matrix.arch }})
+
+    steps:
+      - name: get CPU information (host)
+        shell: bash
+        run: lscpu
+
+      - name: checkout repository
+        uses: actions/checkout@v4
+        # shell: bash
+
+      - name: install dependencies
+        uses: jirutka/setup-alpine@v1
+        # shell: bash
+        with:
+          arch: ${{ matrix.arch }}
+          apk-tools-url: ${{ matrix.arch == 'armv7'
+              && 'https://gitlab.alpinelinux.org/api/v4/projects/5/packages/generic/v2.14.7/aarch64/apk.static#!sha256!27a975638ddc95a411c9f17c63383e335da9edf6bb7de2281d950c291a11f878'
+              || 'https://gitlab.alpinelinux.org/api/v4/projects/5/packages/generic/v2.14.7/x86_64/apk.static#!sha256!bdd044e0fd6cc388c5e571e1093efa5f35f7767cc5aa338b0a2576a429009a62' }}
+          packages: >
+            build-base
+            ccache
+            cmake
+            lscpu
+            libtool
+            git
+            sudo
+
+      - name: disable QEMU emulation
+        if: matrix.arch == 'armv7'
+        shell: bash
+        run: sudo update-binfmts --disable qemu-arm
+
+      - name: get CPU information (emulated)
+        run: lscpu
+
+      - name: build GraphBLAS
+        run: |
+          echo "gcc --version"
+          gcc --version
+          echo "gcc -dumpmachine"
+          gcc -dumpmachine
+          git clone https://github.com/DrTimothyAldenDavis/GraphBLAS.git
+          cd GraphBLAS
+          # FIXME: switch to 10.1.0 when it is released:
+          # git checkout tags/v${{ matrix.config.grb_version }}
+          git checkout dev2
+          make compact
+          sudo make install
+          cd ..
+
+      - name: build and test LAGraph
+        run: |
+          cd build
+          cmake ..
+          JOBS=2 make
+          ctest . --verbose
+

.github/workflows/build.yml

@@ -8,20 +8,29 @@ on:
   pull_request:
 
 jobs:
+
   linux:
+
     runs-on: ubuntu-22.04
+
     strategy:
       matrix:
         config:
         # if there are multiple items in this list, only use should
         # deployit=true for just one of them.
-         - {grb_version: 9.3.1, deployit: true}
+        # FIXME: use GraphBLAS v10.1.0 once it's released
+         - {grb_version: 9.0.0, deployit: false}
+         - {grb_version: 10.0.5, deployit: true}
+
     steps:
+
     - name: Checkout
       uses: actions/[email protected]
+
     - name: Install tools for build
       run: |
         sudo apt install -y lcov
+
     - name: Build GraphBLAS
       run: |
         git clone https://github.com/DrTimothyAldenDavis/GraphBLAS.git
@@ -30,40 +39,51 @@ jobs:
         make compact
         sudo make install
         cd ..
+
     - name: Build project
       run: |
-        export GRAPHBLAS_INCLUDE_DIR=`pwd`/GraphBLAS/include/suitesparse
-        export GRAPHBLAS_LIBRARY=`pwd`/GraphBLAS/lib/libgraphblas.so
         cd build
-        cmake .. -DCOVERAGE=1 -DGRAPHBLAS_INCLUDE_DIR=${GRAPHBLAS_INCLUDE_DIR} -DGRAPHBLAS_LIBRARY=${GRAPHBLAS_LIBRARY}
+        cmake .. -DCOVERAGE=1
         JOBS=2 make
         make test_coverage
+
     - name: Deploy
       uses: JamesIves/[email protected]
       if: matrix.config.deployit && github.event_name == 'push' && github.ref == 'refs/heads/stable'
       with:
         branch: gh-pages
         folder: build/test_coverage/
         single-commit: true
+
     - name: Save output
       uses: actions/[email protected]
+      if: matrix.config.deployit
       with:
         name: test_coverage
         path: build/test_coverage/
+
   macos:
+
     runs-on: macos-14
+
     strategy:
       matrix:
         config:
-         - {grb_version: 9.3.1}
+        # FIXME: use GraphBLAS v10.1.0 once it's released
+         - {grb_version: 9.0.0}
+         - {grb_version: 10.0.5}
+
     steps:
+
     - name: Checkout
       uses: actions/[email protected]
+
     - name: Install dependencies
       run: |
         brew tap-new libomp/cask
         brew extract --version=14.0.6 libomp libomp/cask
         brew install [email protected]
+
     - name: Build GraphBLAS
       run: |
         git clone https://github.com/DrTimothyAldenDavis/GraphBLAS.git
@@ -72,13 +92,13 @@ jobs:
         make compact
         sudo make install
         cd ..
+
     - name: Build project
       run: |
-        export GRAPHBLAS_INCLUDE_DIR=`pwd`/GraphBLAS/include/suitesparse
-        export GRAPHBLAS_LIBRARY=`pwd`/GraphBLAS/lib/libgraphblas.dylib
         # adding an extra line to the CMakeLists.txt file to locate the libomp instance installed by brew
         echo 'include_directories("/usr/local/opt/libomp/include")' | cat - CMakeLists.txt
         cd build
-        CC=gcc cmake .. -DGRAPHBLAS_INCLUDE_DIR=${GRAPHBLAS_INCLUDE_DIR} -DGRAPHBLAS_LIBRARY=${GRAPHBLAS_LIBRARY}
+        cmake ..
         JOBS=2 make
-        make test
+        ctest .
+

.gitignore

@@ -41,6 +41,8 @@ gmon.out
 cmake-build-debug*
 CMakeFiles*
 *~
+data/comments*.txt
+data/comments*.mtx
 
 */build/*
 **/.venv/*

.readthedocs.yaml

@@ -2,11 +2,6 @@
 
 version: 2
 
-build:
-  os: ubuntu-22.04
-  tools:
-    python: "3.12"
-
 formats:
   - pdf