Examples of Vector objects and Matrix objects

.github/workflows/CI.yml

@@ -47,7 +47,7 @@ jobs:
         test-suites:
           [
             # base test: fast first test
-            "testinstall",
+            "testinstall-bare",
 
             "teststandard",
 
@@ -141,7 +141,7 @@ jobs:
       TEST_SUITES: ${{ matrix.test-suites }}
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: "Set up Python"
         uses: actions/setup-python@v6
@@ -276,7 +276,7 @@ jobs:
       - name: "Gather coverage data"
         run: ${{ matrix.extra }} dev/ci-gather-coverage.sh
       - name: "Upload coverage data to Codecov"
-        uses: codecov/codecov-action@v6
+        uses: codecov/codecov-action@v7
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
 
@@ -288,7 +288,7 @@ jobs:
 
     steps:
       - name: "Send Codecov notifications"
-        uses: codecov/codecov-action@v6
+        uses: codecov/codecov-action@v7
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           run_command: send-notifications
@@ -341,7 +341,7 @@ jobs:
       - name: Install cross compile dependencies
         run: sudo apt-get install -q -y libgmp-dev:s390x libreadline-dev:s390x zlib1g-dev:s390x
 
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - run: ./autogen.sh
 
@@ -407,7 +407,7 @@ jobs:
     env:
       AUTOCONF_VERSION: 2.71
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: Download required GAP packages
         run: |

.github/workflows/gapjl.yml

@@ -44,7 +44,7 @@ jobs:
 
     steps:
       - name: Checkout GAP
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           path: 'GAPROOT'
       - name: "Set up Julia"
@@ -56,7 +56,7 @@ jobs:
         run: |
           using Pkg
           if "${{ matrix.gapjl-version }}" == "latest-release"
-            Pkg.add("GAP")
+            Pkg.develop("GAP")
           else
             Pkg.add(;name="GAP", rev="${{ matrix.gapjl-version }}")
           end
@@ -67,17 +67,37 @@ jobs:
       - name: "Install dependencies (for macOS)"
         if: runner.os == 'macOS'
         run: |
-          brew install autoconf zlib # gmp pkg-config
+          # - autoconf, gmp, zlib are needed by GAP's build system
+          # - coreutils provides nproc
+          # - force use of Homebrew gcc to build GAP for proper stacktrace support
+          #   Homebrew installs versioned binaries such as gcc-14 and g++-14,
+          #   while later scripts expect unversioned gcc and g++ in PATH.
+          brew install autoconf gmp zlib gcc@14 coreutils
+
+          # ensure gcc and g++ are available under those names (on macOS,
+          # these names are aliases for clang / clang++ out of the box)
+          shimdir="${HOME}/bin"
+          mkdir -p "${shimdir}"
+          ln -sf "$(brew --prefix)/bin/gcc-14" "${shimdir}/gcc"
+          ln -sf "$(brew --prefix)/bin/g++-14" "${shimdir}/g++"
+          echo "${shimdir}" >> "${GITHUB_PATH}"
       - name: "Build GAP"
         run: |
           mv GAPROOT /tmp/GAPROOT
           cd /tmp/GAPROOT
+          patchdir=$GAPJLPATH/.github/workflows/GAP_patches/master
+          if [ -d $patchdir ]; then
+            for f in $patchdir/*.patch; do
+              echo "Applying patch ${f}"
+              patch -p1 -d . < ${f}
+            done
+          fi
           ./autogen.sh
           ./configure --enable-Werror
           make -j`nproc`
       - name: "Override bundled GAP"
         run: |
-          julia --proj=override $GAPJLPATH/etc/setup_override_dir.jl /tmp/GAPROOT /tmp/gap_jll_override --enable-Werror
+          julia --project=$GAPJLPATH $GAPJLPATH/etc/setup_override_dir.jl /tmp/GAPROOT /tmp/gap_jll_override --enable-Werror
       - name: "Run tests"
         run: |
-          julia --proj=override $GAPJLPATH/etc/run_with_override.jl /tmp/gap_jll_override --depwarn=error -e "using Pkg; Pkg.test(\"GAP\")"
+          julia --project=$GAPJLPATH $GAPJLPATH/etc/run_with_override.jl /tmp/gap_jll_override --depwarn=error -e "using Pkg; Pkg.test(\"GAP\")"

.github/workflows/lint.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-slim
     steps:
       - name: "Check out the repository"
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: "Set up Python"
         uses: actions/setup-python@v6
         with:

.github/workflows/package-distro-trigger.yml

@@ -0,0 +1,193 @@
+#
+# This workflow lets GAP collaborators request a full PackageDistro test run
+# from a GAP pull request comment.
+#
+# Usage:
+#   1. Open a pull request on gap-system/gap.
+#   2. Comment exactly:
+#        @gap-package-distribution-bot test
+#   3. The workflow checks that the commenter has at least triage permission,
+#      creates or updates a marker comment on the PR, and dispatches the
+#      PackageDistro `test-gap-pr.yml` workflow.
+#   4. PackageDistro tests the current PR head against all packages and updates
+#      the same marker comment with the result.
+#
+# The GAP comments and the dispatch to PackageDistro use GitHub App tokens:
+# configure `APP_CLIENT_ID` as an organization or repository variable (or
+# secret) and `APP_PRIVATE_KEY` as a secret available to this repository. The
+# app must be installed on both `gap-system/gap` and
+# `gap-system/PackageDistro`.
+#
+name: PackageDistro PR trigger
+
+on:
+  issue_comment:
+    types: [created]
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.issue.number }}
+  cancel-in-progress: false
+
+jobs:
+  dispatch-package-distro:
+    name: Dispatch PackageDistro test
+    if: ${{ github.event.issue.pull_request != null }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check command
+        id: command
+        env:
+          COMMENT_BODY: ${{ github.event.comment.body }}
+        run: |
+          expected='@gap-package-distribution-bot test'
+          if [[ "${COMMENT_BODY}" == "${expected}" ]]; then
+            echo "matches=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "matches=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - uses: actions/create-github-app-token@v3
+        id: gap-token
+        if: ${{ steps.command.outputs.matches == 'true' }}
+        with:
+          client-id: ${{ vars.APP_CLIENT_ID || secrets.APP_CLIENT_ID || secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+          owner: gap-system
+          repositories: gap
+
+      - name: Check commenter permission
+        id: permission
+        if: ${{ steps.command.outputs.matches == 'true' }}
+        env:
+          GH_TOKEN: ${{ steps.gap-token.outputs.token }}
+          REPO: ${{ github.repository }}
+          ACTOR: ${{ github.event.comment.user.login }}
+        run: |
+          api_url="https://api.github.com/repos/${REPO}/collaborators/${ACTOR}/permission"
+          http_code=$(
+            curl -sSL \
+              -H "Authorization: Bearer ${GH_TOKEN}" \
+              -H "Accept: application/vnd.github+json" \
+              -o permission.json \
+              -w '%{http_code}' \
+              "${api_url}"
+          )
+          if [[ "${http_code}" == "200" ]]; then
+            permission=$(jq -r '.permission // "none"' permission.json)
+          else
+            permission="none"
+          fi
+          echo "permission=${permission}" >> "$GITHUB_OUTPUT"
+          case "${permission}" in
+            admin|maintain|write|triage)
+              echo "authorized=true" >> "$GITHUB_OUTPUT"
+            ;;
+            *)
+              echo "authorized=false" >> "$GITHUB_OUTPUT"
+            ;;
+          esac
+
+      - name: Find prior bot comment
+        id: find-comment
+        if: ${{ steps.command.outputs.matches == 'true' }}
+        uses: peter-evans/find-comment@v4
+        with:
+          token: ${{ steps.gap-token.outputs.token }}
+          issue-number: ${{ github.event.issue.number }}
+          body-includes: "<!-- gap-package-distribution-bot:gap-pr-test -->"
+
+      - name: Reply to unauthorized request
+        if: >-
+          ${{
+            steps.command.outputs.matches == 'true' &&
+            steps.permission.outputs.authorized != 'true'
+          }}
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          token: ${{ steps.gap-token.outputs.token }}
+          comment-id: ${{ steps.find-comment.outputs.comment-id }}
+          issue-number: ${{ github.event.issue.number }}
+          edit-mode: replace
+          body: |
+            <!-- gap-package-distribution-bot:gap-pr-test -->
+            `@gap-package-distribution-bot test` may only be used by GAP collaborators with at least triage access.
+
+      - uses: actions/create-github-app-token@v3
+        id: pkgdistro-token
+        if: >-
+          ${{
+            steps.command.outputs.matches == 'true' &&
+            steps.permission.outputs.authorized == 'true'
+          }}
+        with:
+          client-id: ${{ vars.APP_CLIENT_ID || secrets.APP_CLIENT_ID || secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+          owner: gap-system
+          repositories: PackageDistro
+
+      - name: Acknowledge accepted request
+        id: acknowledge-request
+        if: >-
+          ${{
+            steps.command.outputs.matches == 'true' &&
+            steps.permission.outputs.authorized == 'true'
+          }}
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          token: ${{ steps.gap-token.outputs.token }}
+          comment-id: ${{ steps.find-comment.outputs.comment-id }}
+          issue-number: ${{ github.event.issue.number }}
+          edit-mode: replace
+          body: |
+            <!-- gap-package-distribution-bot:gap-pr-test -->
+            Accepted `@gap-package-distribution-bot test`.
+
+            PackageDistro was asked to run the full package test suite against the current head of this pull request. This comment will be updated with the result.
+
+      - name: Dispatch PackageDistro workflow
+        if: >-
+          ${{
+            steps.command.outputs.matches == 'true' &&
+            steps.permission.outputs.authorized == 'true'
+          }}
+        env:
+          GH_TOKEN: ${{ steps.pkgdistro-token.outputs.token }}
+          PR_URL: ${{ github.event.issue.html_url }}
+          COMMENT_ID: ${{ steps.acknowledge-request.outputs.comment-id }}
+          REQUESTER: ${{ github.event.comment.user.login }}
+          COMMAND: ${{ github.event.comment.body }}
+        run: |
+          comment_id_json=null
+          if [[ -n "${COMMENT_ID}" ]]; then
+            comment_id_json=${COMMENT_ID}
+          fi
+          jq -n \
+            --arg ref main \
+            --arg pr_url "${PR_URL}" \
+            --arg requester "${REQUESTER}" \
+            --arg command "${COMMAND}" \
+            --arg callback_repo "${GITHUB_REPOSITORY}" \
+            --arg callback_pr_number "${{ github.event.issue.number }}" \
+            --argjson callback_comment_id "${comment_id_json}" \
+            '({
+                "gap-pr-url": $pr_url,
+                "callback-repo": $callback_repo,
+                "callback-pr-number": $callback_pr_number,
+                requester: $requester,
+                command: $command
+              } + (if $callback_comment_id == null then {} else {"callback-comment-id": ($callback_comment_id | tostring)} end)) as $inputs
+            | {
+              ref: $ref,
+              inputs: $inputs
+            }' > payload.json
+          curl -fsSL \
+            -X POST \
+            -H "Authorization: Bearer ${GH_TOKEN}" \
+            -H "Accept: application/vnd.github+json" \
+            https://api.github.com/repos/gap-system/PackageDistro/actions/workflows/test-gap-pr.yml/dispatches \
+            -d @payload.json

.github/workflows/release.yml

@@ -35,7 +35,7 @@ jobs:
     name: "Validate release scripts"
     runs-on: ubuntu-slim
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: "Set up Python"
         uses: actions/setup-python@v6
@@ -56,8 +56,8 @@ jobs:
       #- name: "Validate types"
       #  run: python -m mypy --disallow-untyped-calls --disallow-untyped-defs dev/releases/*.py
 
-      #- name: "Run tests"
-      #  run: python -m pytest tools/tests/dev/releases*.py -vv
+      - name: "Run tests"
+        run: cd dev/releases && python -m pytest
 
   unix:
     name: "Create Unix archives and data"
@@ -72,7 +72,7 @@ jobs:
       # requires fetching the entire history. Therefore, we might as well do
       # that here when checking out the repo, which is what setting fetch-depth
       # to 0 accomplishes here.
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -94,7 +94,7 @@ jobs:
 
       - name: "Install autoconf 2.72"   # for compatibility with GCC 14 & clang versions
         run: |
-          wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.72.tar.xz
+          wget https://ftpmirror.gnu.org/gnu/autoconf/autoconf-2.72.tar.xz
           tar xvf autoconf-2.72.tar.xz
           cd autoconf-2.72
           ./configure
@@ -207,7 +207,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: "Clone the Windows installer maker scripts"
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           repository: gap-system/gap-windows
           ref: main

.github/workflows/update-gh-pages.yml

@@ -41,7 +41,7 @@ jobs:
           sudo apt-get update
           sudo apt-get install --no-install-recommends "${packages[@]}"
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Configure GAP
         run: |
           ./autogen.sh && ./configure

.gitignore

@@ -31,6 +31,17 @@
 /libgap*.dll*
 /libgap*.so*
 
+# emscripten / wasm build outputs (etc/emscripten/build.sh and friends)
+/native-build/
+/extern/emscripten/
+/web-example/
+/packages.tar.gz
+/gap.html
+/gap.js
+/gap.wasm
+/gap.worker.js
+/gap-fs.json
+
 /bin/gap*.sh
 /bin/*-*/
 # Compiling the `xgap` package creates the file `xgap.sh`