Merge branch 'develop' into add-betaprime-mean

Signed-off-by: Neeraj Pathak <[email protected]>

Author: Neerajpathak07

.editorconfig

@@ -86,7 +86,6 @@ indent_style = tab
 [*.{f,f.txt}]
 indent_style = space
 indent_size = 2
-insert_final_newline = false
 
 # Set properties for shell files:
 [*.{sh,sh.txt}]

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -117,5 +117,5 @@ body:
       options:
         - label: Read and understood the [Code of Conduct](https://github.com/stdlib-js/stdlib/blob/develop/CODE_OF_CONDUCT.md).
           required: true
-        - label:  Searched for existing issues and pull requests.
+        - label: Searched for existing issues and pull requests.
           required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -18,10 +18,10 @@
 
 contact_links:
   - name: 👩‍🏫 Frequently Asked Questions
-    url:  https://github.com/stdlib-js/stdlib/blob/develop/FAQ.md
+    url: https://github.com/stdlib-js/stdlib/blob/develop/FAQ.md
     about: Consult the FAQ in case we have already answered your question there.
   - name: 💬 Question
-    url:  https://gitter.im/stdlib-js/stdlib
+    url: https://gitter.im/stdlib-js/stdlib
     about: Got a (non-bug related) question we haven't already answered? Ask us on Gitter! 🤗
   - name: 👏 Support Us
     url: https://github.com/stdlib-js/stdlib/blob/develop/docs/support_the_project.md

.github/labeler.yml

@@ -35,3 +35,7 @@ REPL:
 Statistics:
 - changed-files:
   - any-glob-to-all-files: '**/stats/**/*'
+
+Tools:
+- changed-files:
+  - any-glob-to-all-files: '**/_tools/**/*'

.github/workflows/check_licenses.yml

@@ -128,7 +128,7 @@ jobs:
       # Upload the log file:
       - name: 'Upload log file'
         # Pin action to full length commit SHA
-        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        uses: actions/upload-artifact@6f51ac03b9356f520e9adb1b1b7802705f340c2b # v4.5.0
         if: always()
         with:
           # Define a name for the uploaded artifact:

.github/workflows/do_not_merge.yml

@@ -43,8 +43,7 @@ jobs:
 
     # Define job permissions:
     permissions:
-      contents: read
-      pull-requests: write
+      pull-requests: read
 
     # Define the type of virtual host machine:
     runs-on: ubuntu-latest

.github/workflows/first_time_greeting.yml

@@ -24,8 +24,8 @@ on: [pull_request_target, issues]
 
 # Global permissions:
 permissions:
-  # Allow read-only access to the repository contents:
-  contents: read
+  # Do not give the workflow any permissions:
+  contents: none
 
 # Workflow jobs:
 jobs:
@@ -47,7 +47,7 @@ jobs:
         # Pin action to full length commit SHA
         uses: actions/first-interaction@34f15e814fe48ac9312ccf29db4e74fa767cbab7 # v1.3.0
         with:
-          repo-token: ${{ secrets.CHATBOT_GITHUB_TOKEN }}
+          repo-token: ${{ secrets.STDLIB_BOT_FGPAT_PR_WRITE }}
           issue-message: |
             :wave: Hi there! :wave:
 

.github/workflows/good_first_issue.yml

@@ -56,7 +56,7 @@ jobs:
           GH_REPO: ${{ github.repository }}
           NUMBER: ${{ github.event.issue.number }}
           BODY: |
-            # :rotating_light: Important: PLEASE READ :rotating_light:
+            # :wave: Important: PLEASE READ :wave:
 
             This issue has been labeled as a **good first issue** and is available for anyone to work on.
 

.github/workflows/label_commands.yml

@@ -0,0 +1,242 @@
+#/
+# @license Apache-2.0
+#
+# Copyright (c) 2024 The Stdlib Authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#/
+
+# Workflow name:
+name: label_commands
+
+# Workflow triggers:
+on:
+  pull_request_target:
+    types:
+      - labeled
+
+# Workflow jobs:
+jobs:
+
+  # Define a job for removing the label and adding in-progress label:
+  manage_labels:
+
+    # Define a display name:
+    name: 'Manage labels'
+
+    # Define the type of virtual host machine:
+    runs-on: ubuntu-latest
+
+    # Define the conditions under which the job should run:
+    if: |
+      github.event.label.name == 'bot: Merge' ||
+      github.event.label.name == 'bot: Rebase' ||
+      github.event.label.name == 'bot: Check Files' ||
+      github.event.label.name == 'bot: Lint Autofix' ||
+      github.event.label.name == 'bot: Update Copyright Years'
+
+    # Define the job's steps:
+    steps:
+
+      - name: 'Remove label'
+        # Pin action to full length commit SHA
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          github-token: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+          script: |
+            try {
+              await github.rest.issues.removeLabel({
+                'owner': context.repo.owner,
+                'repo': context.repo.repo,
+                'issue_number': context.issue.number,
+                'name': '${{ github.event.label.name }}'
+              })
+            } catch ( error ) {
+              console.log( 'Error removing label: %s', error.message );
+            }
+
+      - name: 'Add in-progress label'
+        # Pin action to full length commit SHA
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          github-token: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+          script: |
+            github.rest.issues.addLabels({
+              'owner': context.repo.owner,
+              'repo': context.repo.repo,
+              'issue_number': context.issue.number,
+              'labels': ['bot: In Progress']
+            })
+
+      # Add initial reaction to comment with slash command:
+      - name: 'Add initial reaction'
+        run: |
+          curl -X POST \
+            -H "Accept: application/vnd.github.v3+json" \
+            -H "Authorization: Bearer ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}" \
+            "https://api.github.com/repos/${{ github.repository }}/issues/${{ github.event.pull_request.number }}/reactions" \
+            -d '{"content":"eyes"}'
+
+  # Define a job for checking for required files:
+  check_files:
+
+    # Define a display name:
+    name: 'Check for required files'
+
+    # Ensure initial reaction job has completed before running this job:
+    needs: [ manage_labels ]
+
+    # Define the conditions under which the job should run:
+    if: |
+      github.event.label.name == 'bot: Check Files'
+
+    # Run reusable workflow:
+    uses: ./.github/workflows/check_required_files.yml
+    with:
+      pull_request_number: ${{ github.event.pull_request.number }}
+      user: ${{ github.event.sender.login }}
+    secrets:
+      STDLIB_BOT_GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+
+  # Define a job for updating copyright header years:
+  update_copyright_years:
+
+    # Define a display name:
+    name: 'Update copyright header years'
+
+    # Ensure initial reaction job has completed before running this job:
+    needs: [ manage_labels ]
+
+    # Define the conditions under which the job should run:
+    if: |
+      github.event.label.name == 'bot: Update Copyright Years'
+
+    # Run reusable workflow:
+    uses: ./.github/workflows/update_pr_copyright_years.yml
+    with:
+      pull_request_number: ${{ github.event.pull_request.number }}
+    secrets:
+      REPO_GITHUB_TOKEN: ${{ secrets.REPO_GITHUB_TOKEN }}
+      STDLIB_BOT_GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+      STDLIB_BOT_GPG_PRIVATE_KEY: ${{ secrets.STDLIB_BOT_GPG_PRIVATE_KEY }}
+      STDLIB_BOT_GPG_PASSPHRASE: ${{ secrets.STDLIB_BOT_GPG_PASSPHRASE }}
+
+  # Define a job for auto-fixing lint errors:
+  fix_lint_errors:
+
+    # Define a display name:
+    name: 'Auto-fix lint errors'
+
+    # Ensure initial reaction job has completed before running this job:
+    needs: [ manage_labels ]
+
+    # Define the conditions under which the job should run:
+    if: |
+      github.event.label.name == 'bot: Lint Autofix'
+
+    # Run reusable workflow:
+    uses: ./.github/workflows/lint_autofix.yml
+    with:
+      pull_request_number: ${{ github.event.pull_request.number }}
+    secrets:
+      REPO_GITHUB_TOKEN: ${{ secrets.REPO_GITHUB_TOKEN }}
+      STDLIB_BOT_GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+      STDLIB_BOT_GPG_PRIVATE_KEY: ${{ secrets.STDLIB_BOT_GPG_PRIVATE_KEY }}
+      STDLIB_BOT_GPG_PASSPHRASE: ${{ secrets.STDLIB_BOT_GPG_PASSPHRASE }}
+
+  # Define a job for merging develop branch:
+  merge_develop:
+
+    # Define a display name:
+    name: 'Merge changes from develop branch into this PR'
+
+    # Ensure initial reaction job has completed before running this job:
+    needs: [ manage_labels ]
+
+    # Define the conditions under which the job should run:
+    if: |
+      github.event.label.name == 'bot: Merge'
+
+    # Run reusable workflow:
+    uses: ./.github/workflows/pr_merge_develop.yml
+    with:
+      pull_request_number: ${{ github.event.pull_request.number }}
+    secrets:
+      REPO_GITHUB_TOKEN: ${{ secrets.REPO_GITHUB_TOKEN }}
+      STDLIB_BOT_GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+      STDLIB_BOT_GPG_PRIVATE_KEY: ${{ secrets.STDLIB_BOT_GPG_PRIVATE_KEY }}
+      STDLIB_BOT_GPG_PASSPHRASE: ${{ secrets.STDLIB_BOT_GPG_PASSPHRASE }}
+
+  # Define a job for rebasing on develop branch:
+  rebase_develop:
+
+    # Define a display name:
+    name: 'Rebase this PR on top of develop branch'
+
+    # Ensure initial reaction job has completed before running this job:
+    needs: [ manage_labels ]
+
+    # Define the conditions under which the job should run:
+    if: |
+      github.event.label.name == 'bot: Rebase'
+
+    # Run reusable workflow:
+    uses: ./.github/workflows/pr_rebase_develop.yml
+    with:
+      pull_request_number: ${{ github.event.pull_request.number }}
+    secrets:
+      REPO_GITHUB_TOKEN: ${{ secrets.REPO_GITHUB_TOKEN }}
+      STDLIB_BOT_GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+      STDLIB_BOT_GPG_PRIVATE_KEY: ${{ secrets.STDLIB_BOT_GPG_PRIVATE_KEY }}
+      STDLIB_BOT_GPG_PASSPHRASE: ${{ secrets.STDLIB_BOT_GPG_PASSPHRASE }}
+
+  # Define a job for removing the in-progress label:
+  remove_progress_label:
+
+    # Define a display name:
+    name: 'Remove in-progress label'
+
+    # Define the type of virtual host machine:
+    runs-on: ubuntu-latest
+
+    # Ensure all previous jobs have completed before running this job:
+    needs: [ manage_labels, check_files, update_copyright_years, fix_lint_errors, merge_develop, rebase_develop ]
+
+    # Define the conditions under which the job should run:
+    if: |
+      github.event.label.name == 'bot: Merge' ||
+      github.event.label.name == 'bot: Rebase' ||
+      github.event.label.name == 'bot: Check Files' ||
+      github.event.label.name == 'bot: Lint Autofix' ||
+      github.event.label.name == 'bot: Update Copyright Years'
+
+    # Define the job's steps:
+    steps:
+      - name: Remove in-progress label
+        # Run the step regardless of the outcome of previous steps:
+        if: always()
+        # Pin action to full length commit SHA
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          github-token: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+          script: |
+            try {
+              await github.rest.issues.removeLabel({
+                'owner': context.repo.owner,
+                'repo': context.repo.repo,
+                'issue_number': context.issue.number,
+                'name': 'bot: In Progress'
+              })
+            } catch ( error ) {
+              console.log( 'Error removing label: %s', error.message );
+            }