Merge branch 'develop' of https://github.com/stdlib-js/stdlib into pr…

…/Pranavchiku/2558

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,23 +1,20 @@
-Resolves # .
+Resolves #{{TODO: add issue number}}.
 
 ## Description
 
 > What is the purpose of this pull request?
 
 This pull request:
 
-- a
-- b
-- c
+- {{TODO: add description describing what this pull request does}}
 
 ## Related Issues
 
 > Does this pull request have any related issues?
 
 This pull request:
 
-- resolves #
-- fixes #
+- resolves #{{TODO: add issue number}} 
 
 ## Questions
 

.github/labeler.yml

@@ -20,6 +20,10 @@ BLAS:
 - changed-files:
  - any-glob-to-all-files: '**/blas/**/*'
 
+LAPACK:
+- changed-files:
+ - any-glob-to-all-files: '**/lapack/**/*'
+
 Math:
 - changed-files:
  - any-glob-to-all-files: '**/math/**/*'

.github/workflows/autoclose.yml

@@ -0,0 +1,181 @@
+#/
+# @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: autoclose
+
+# Workflow triggers:
+on:
+ pull_request_target:
+ types:
+ - labeled
+
+# Workflow jobs:
+jobs:
+
+ # Define a job which closes a pull request if a contributor failed to setup EditorConfig:
+ editorconfig:
+
+ # Define job name:
+ name: 'Check for EditorConfig label'
+
+ # Only run this job if the pull request has a specific label:
+ if: "${{ github.event.label.name == 'autoclose: EditorConfig' }}"
+
+ # Define job permissions:
+ permissions:
+ contents: read
+ pull-requests: write
+
+ # Define the type of virtual host machine:
+ runs-on: ubuntu-latest
+
+ # Define the sequence of job steps:
+ steps:
+
+ # Close the pull request:
+ - name: 'Close pull request'
+ run: gh pr close "$NUMBER" --comment "$BODY"
+ env:
+ GH_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+ GH_REPO: ${{ github.repository }}
+ NUMBER: ${{ github.event.pull_request.number }}
+ BODY: |
+ Thank you for working on this pull request. However, we cannot accept your contribution as this pull request does not follow our [contributing guidelines](https://github.com/stdlib-js/stdlib/blob/develop/CONTRIBUTING.md).
+
+ Per the guidelines outlined in our [development guide](https://github.com/stdlib-js/stdlib/blob/develop/docs/development.md), you should download and setup [EditorConfig](http://editorconfig.org/) to ensure that files are automatically configured to use expected indentation and line endings.
+
+ If you would prefer to avoid manual setup, you could also consider using a pre-configured [development container](https://github.com/stdlib-js/stdlib/tree/develop/.devcontainer) for use locally or in GitHub Codespaces.
+
+ Thank you again for your interest in stdlib, and we look forward to reviewing your future contriubtions.
+
+ # Define a job which closes a pull request if a contributor failed to follow contributing guidelines:
+ contributor_guidelines:
+
+ # Define job name:
+ name: 'Check for contributor guidelines label'
+
+ # Only run this job if the pull request has a specific label:
+ if: "${{ github.event.label.name == 'autoclose: Contributor Guidelines' }}"
+
+ # Define job permissions:
+ permissions:
+ contents: read
+ pull-requests: write
+
+ # Define the type of virtual host machine:
+ runs-on: ubuntu-latest
+
+ # Define the sequence of job steps:
+ steps:
+
+ # Close the pull request:
+ - name: 'Close pull request'
+ run: gh pr close "$NUMBER" --comment "$BODY"
+ env:
+ GH_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+ GH_REPO: ${{ github.repository }}
+ NUMBER: ${{ github.event.pull_request.number }}
+ BODY: |
+ Thank you for working on this pull request. However, we cannot accept your contribution as this pull request does not follow our [contributing guidelines](https://github.com/stdlib-js/stdlib/blob/develop/CONTRIBUTING.md).
+
+ Per the guidelines outlined in our [development guide](https://github.com/stdlib-js/stdlib/blob/develop/docs/development.md), you should have setup your local development environment such that automated development processes for linting, license verification, and unit testing can run prior to authoring commits and pushing changes. We encourage you to refer to that guide **before** continuing to work on this pull request.
+
+ If you would prefer to avoid manual setup, you could also consider using a pre-configured [development container](https://github.com/stdlib-js/stdlib/tree/develop/.devcontainer) for use locally or in GitHub Codespaces.
+
+ Thank you again for your interest in stdlib, and we look forward to reviewing your future contriubtions.
+
+ # Define a job which closes a pull request if a contributor failed to follow project conventions:
+ project_conventions:
+
+ # Define job name:
+ name: 'Check for project conventions label'
+
+ # Only run this job if the pull request has a specific label:
+ if: "${{ github.event.label.name == 'autoclose: Project Conventions' }}"
+
+ # Define job permissions:
+ permissions:
+ contents: read
+ pull-requests: write
+
+ # Define the type of virtual host machine:
+ runs-on: ubuntu-latest
+
+ # Define the sequence of job steps:
+ steps:
+
+ # Close the pull request:
+ - name: 'Close pull request'
+ run: gh pr close "$NUMBER" --comment "$BODY"
+ env:
+ GH_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+ GH_REPO: ${{ github.repository }}
+ NUMBER: ${{ github.event.pull_request.number }}
+ BODY: |
+ Thank you for working on this pull request. However, we cannot accept your contribution as this pull request does not follow project conventions.
+
+ We place a high value on consistency throughout the stdlib codebase, and this pull request was found to significantly deviate from stdlib conventions. We encourage you to closely examine other packages in stdlib and attempt to emulate the practices and conventions found therein.
+
+ - If you are attempting to contribute a new package, sometimes the best approach is to simply copy the contents of an existing package and then modify the minimum amount necessary to implement the feature (e.g., changing descriptions, parameter names, and implementation).
+ - If you are contributing tests, find a package implementing a similar feature and emulate the tests of that package.
+ - If you are updating documentation, examine several similar packages and emulate the content, style, and prose of those packages.
+
+ In short, the more effort you put in to ensure that your contribution looks and feels like stdlib—including variables names, bracket spacing, line breaks, etc—the more likely that your contribution will be reviewed and ultimately accepted. We encourage you to closely study the codebase **before** continuing to work on this pull request.
+
+ Thank you again for your interest in stdlib, and we look forward to reviewing your future contriubtions.
+
+ # Define a job which closes a pull request if a pull request is considered spam:
+ spam:
+
+ # Define job name:
+ name: 'Check for spam label'
+
+ # Only run this job if the pull request has a specific label:
+ if: "${{ github.event.label.name == 'autoclose: Spam' }}"
+
+ # Define job permissions:
+ permissions:
+ contents: read
+ pull-requests: write
+
+ # Define the type of virtual host machine:
+ runs-on: ubuntu-latest
+
+ # Define the sequence of job steps:
+ steps:
+
+ # Close the pull request:
+ - name: 'Close pull request'
+ run: gh pr close "$NUMBER" --comment "$BODY"
+ env:
+ GH_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+ GH_REPO: ${{ github.repository }}
+ NUMBER: ${{ github.event.pull_request.number }}
+ BODY: |
+ Thank you for working on this pull request. However, we cannot accept your contribution as this pull request does not meet the standards of this project.
+
+ Thank you again for your interest in stdlib, and we look forward to reviewing your future contriubtions.
+
+ # Lock pull request conversation:
+ - name: 'Lock conversation'
+ run: gh pr lock "$NUMBER" --reason spam
+ env:
+ GH_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+ GH_REPO: ${{ github.repository }}
+ NUMBER: ${{ github.event.pull_request.number }}

.github/workflows/check_contributing_guidelines_acceptance.yml

@@ -0,0 +1,93 @@
+#/
+# @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: check_contributing_guidelines_acceptance
+
+# Workflow triggers:
+on:
+ # Allow the workflow to be triggered by other workflows
+ workflow_call:
+ # Define the input parameters for the workflow:
+ inputs:
+ pull_request_number:
+ description: 'Pull request number'
+ required: true
+ type: number
+ user:
+ required: true
+ type: string
+ # Define the secrets accessible by the workflow:
+ secrets:
+ STDLIB_BOT_GITHUB_TOKEN:
+ description: 'stdlib-bot GitHub token to create pull request comments'
+ required: true
+
+ # Trigger on pull request events:
+ pull_request_target:
+ types:
+ - opened
+ - reopened
+
+# Global permissions:
+permissions:
+ # Allow read-only access to the repository contents:
+ contents: read
+
+ # Allow write access to pull requests:
+ pull-requests: write
+
+# Workflow jobs:
+jobs:
+
+ # Define a job for checking the contributing guidelines acceptance...
+ check_acknowledgment:
+
+ # Define a display name:
+ name: 'Check Contributing Guidelines Acceptance'
+
+ # Define the type of virtual host machine:
+ runs-on: ubuntu-latest
+
+ # Skip this job for PRs opened by automated bot accounts:
+ if: github.event.pull_request.user.login != 'stdlib-bot' && github.event.pull_request.user.login != 'dependabot[bot]'
+
+ # Define the sequence of job steps...
+ steps:
+ # Checkout the repository:
+ - name: 'Checkout repository'
+ # Pin action to full length commit SHA
+ uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
+ with:
+ # Specify whether to remove untracked files before checking out the repository:
+ clean: true
+
+ # Limit clone depth to the most recent commit:
+ fetch-depth: 1
+
+ # Specify whether to download Git-LFS files:
+ lfs: false
+ timeout-minutes: 10
+
+ # Check contributing guidelines acceptance:
+ - name: 'Check contributing guidelines acceptance'
+ env:
+ GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN }}
+ PR_NUMBER: ${{ github.event.pull_request.number || inputs.pull_request_number }}
+ run: |
+ . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_contributing_guidelines_acceptance" $PR_NUMBER

.github/workflows/check_licenses.yml

@@ -20,7 +20,7 @@
 name: check_licenses
 
 # Workflow triggers:
-on: [pull_request]
+on: [ pull_request ]
 
 # Global permissions:
 permissions:
@@ -81,7 +81,7 @@ jobs:
  # Install Node.js:
  - name: 'Install Node.js'
  # Pin action to full length commit SHA
- uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4.0.2
+ uses: actions/setup-node@1e60f620b9541d16bece96c5465dc8ee9832be0b # v4.0.3
  with:
  node-version: '20' # 'lts/*'
  timeout-minutes: 5
@@ -128,7 +128,7 @@ jobs:
  # Upload the log file:
  - name: 'Upload log file'
  # Pin action to full length commit SHA
- uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
+ uses: actions/upload-artifact@0b2256b8c012f0828dc542b3febcab082c67f72b # v4.3.4
  if: always()
  with:
  # Define a name for the uploaded artifact:

.github/workflows/check_required_files.yml

@@ -32,6 +32,7 @@ on:
  user:
  required: true
  type: string
+
  # Define the secrets accessible by the workflow:
  secrets:
  STDLIB_BOT_GITHUB_TOKEN:

.github/workflows/codeql.yml

@@ -121,7 +121,7 @@ jobs:
  # Install Node.js:
  - name: 'Install Node.js'
  # Pin action to full length commit SHA
- uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4.0.2
+ uses: actions/setup-node@1e60f620b9541d16bece96c5465dc8ee9832be0b # v4.0.3
  with:
  node-version: '20' # 'lts/*'
  timeout-minutes: 5