Auto-generated commit

Author: stdlib-bot

.github/.keepalive

@@ -1 +1 @@
-2023-02-01T02:14:11.839Z
+2023-03-01T06:26:25.124Z

.github/workflows/productionize.yml

@@ -34,6 +34,12 @@ on:
         type: boolean
         default: true
 
+  # Run workflow upon completion of `publish` workflow run:
+  workflow_run:
+    workflows: ["publish"]
+    types: [completed]
+
+
 # Concurrency group to prevent multiple concurrent executions:
 concurrency:
   group: productionize
@@ -94,10 +100,11 @@ jobs:
       # Change `@stdlib/string-format` to `@stdlib/error-tools-fmtprodmsg` in package.json if the former is a dependency, otherwise insert it as a dependency:
       - name: 'Update dependencies in package.json'
         run: |
+          PKG_VERSION=$(npm view @stdlib/error-tools-fmtprodmsg version)
           if grep -q '"@stdlib/string-format"' package.json; then
-            sed -i "s/\"@stdlib\/string-format\"/\"@stdlib\/error-tools-fmtprodmsg\"/g" package.json
+            sed -i "s/\"@stdlib\/string-format\": \"^.*\"/\"@stdlib\/error-tools-fmtprodmsg\": \"^$PKG_VERSION\"/g" package.json
           else
-            node -e "var pkg = require( './package.json' ); pkg.dependencies[ '@stdlib/error-tools-fmtprodmsg' ] = '^0.0.x'; require( 'fs' ).writeFileSync( 'package.json', JSON.stringify( pkg, null, 2 ) );"
+            node -e "var pkg = require( './package.json' ); pkg.dependencies[ '@stdlib/error-tools-fmtprodmsg' ] = '^$PKG_VERSION'; require( 'fs' ).writeFileSync( 'package.json', JSON.stringify( pkg, null, 2 ) );"
           fi
 
       # Configure git:

.github/workflows/publish.yml

@@ -21,9 +21,23 @@ name: publish
 
 # Workflow triggers:
 on:
-  # Run workflow when a new tag is pushed to the repository:
-  push:
-    tags: v[0-9]+.[0-9]+.[0-9]+
+  # Allow the workflow to be manually run:
+  workflow_dispatch:
+    # Workflow inputs:
+    inputs:
+      version:
+        description: 'Version Increment'
+        type: choice
+        default: 'none'
+        options:
+          - 'none'
+          - 'major'
+          - 'minor'
+          - 'patch'
+          - 'premajor'
+          - 'preminor'
+          - 'prepatch'
+          - 'prerelease'
 
 # Workflow jobs:
 jobs:
@@ -32,14 +46,15 @@ jobs:
   publish:
 
     # Define display name:
-    name: 'Publish to npm'
+    name: 'Publish package to npm'
 
     # Define the type of virtual host machine on which to run the job:
     runs-on: ubuntu-latest
 
     # Define environment variables:
     env:
       SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
 
     # Define the sequence of job steps...
     steps:
@@ -55,6 +70,85 @@ jobs:
           node-version: 16
         timeout-minutes: 5
 
+      # Configure git:
+      - name: 'Configure git'
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "stdlib-bot"
+
+      # Increment package version (if requested):
+      - name: 'Increment package version (if requested)'
+        if: ${{ github.event.inputs.version != 'none' }}
+        run: |
+          # Save NPM_TOKEN to user's .npmrc:
+          echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
+
+          # Increment package version:
+          npm version ${{ github.event.inputs.version }} --no-git-tag-version
+
+          # Define variable for new version:
+          NEW_VERSION=$(node -p "require('./package.json').version")
+
+          # Replace branch in README.md link definitions for badges with the new version:
+          find . -type f -name '*.md' -print0 | xargs -0 sed -Ei "s/branch([=:])[^ ]+/branch\1v${NEW_VERSION}/g"
+
+          # Create a new commit and tag:
+          git add package.json README.md
+          git commit -m "Release v${NEW_VERSION}"
+          git tag -a "v${NEW_VERSION}" -m "Release v${NEW_VERSION}"
+
+          # Push changes to GitHub:
+          SLUG=${{ github.repository }}
+          git push "https://$GITHUB_ACTOR:[email protected]/$SLUG.git" --follow-tags
+
+      # Remove CLI:
+      - name: 'Remove CLI'
+        if: ${{ github.ref == 'refs/heads/main' }}
+        run: |
+          # Exit if the package does not have a CLI:
+          if ! grep -q '"bin":' package.json; then
+            exit 0
+          fi
+          rm -rf ./bin/cli
+          rm test/test.cli.js
+          rm etc/cli_opts.json
+          rm docs/usage.txt
+
+          # For all dependencies, check in all *.js files if they are still used; if not, remove them:
+          jq -r '.dependencies | keys[]' ./package.json | while read -r dep; do
+            dep=$(echo "$dep" | xargs)
+            if ! grep -q "$dep" lib/** && ! grep -q -s "$dep" manifest.json && ! grep -q -s "$dep" include.gypi; then
+              jq --indent 2 "del(.dependencies[\"$dep\"])" ./package.json > ./package.json.tmp
+              mv ./package.json.tmp ./package.json
+            fi
+          done
+          jq -r '.devDependencies | keys[]' ./package.json | while read -r dep; do
+            if [[ "$dep" != "@stdlib"* ]]; then
+              continue
+            fi
+            dep=$(echo "$dep" | xargs)
+            if ! grep -q "$dep" lib/** && ! grep -q -s "$dep" manifest.json && ! grep -q -s "$dep" include.gypi; then
+              jq --indent 2 "del(.devDependencies[\"$dep\"])" ./package.json > ./package.json.tmp
+              mv ./package.json.tmp ./package.json
+            fi
+          done
+
+          # Remove CLI section:
+          find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"cli\">[\s\S]+?<\!\-\- \/.cli \-\->//"
+
+          # Remove CLI from package.json:
+          jq -r 'del(.bin)' package.json > package.json.tmp
+          mv package.json.tmp package.json
+
+          # Add entry for CLI package to See Also section of README.md:
+          cliPkgName=$(jq -r '.name' package.json)-cli
+          escapedPkg=$(echo "$cliPkgName" | sed -e 's/\//\\\//g')
+          escapedPkg=$(echo "$escapedPkg" | sed -e 's/\@/\\\@/g')
+          find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/<section class=\"related\">(?:\n\n\* \* \*\n\n## See Also\n\n)?/<section class=\"related\">\n\n## See Also\n\n-   <span class=\"package-name\">[\`$escapedPkg\`][$escapedPkg]<\/span><span class=\"delimiter\">: <\/span><span class=\"description\">CLI package for use as a command-line utility.<\/span>\n/"
+
+          # Add link definition for CLI package to README.md:
+          find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/<section class=\"links\">/<section class=\"links\">\n\n[$escapedPkg]: https:\/\/www.npmjs.com\/package\/$escapedPkg/"
+
       # Replace GitHub links to individual packages with npm links:
       - name: 'Replace all GitHub links to individual packages with npm links'
         run: |
@@ -65,10 +159,35 @@ jobs:
         run: |
           find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/\`\`\`\n\nAlternatively,[^<]+<\/section>/\`\`\`\n\n<\/section>/"
 
+      # Remove unnecessary files:
+      - name: 'Remove unnecessary files'
+        run: |
+          rm docs/repl.txt
+          rm docs/types/test.ts
+
       # Replace all stdlib GitHub dependencies with the respective npm packages:
       - name: 'Replace all stdlib GitHub dependencies with the respective npm packages'
         run: |
-          find package.json -type f -print0 | xargs -0 sed -Ei 's/"github:stdlib-js[^"]*"/"^0.0.x"/g'
+          for dep in $(jq -r '.dependencies | keys | .[]' package.json); do
+            if [[ "$dep" != "@stdlib"* ]]; then
+              continue
+            fi
+            # Trim leading and trailing whitespace:
+            dep=$(echo "$dep" | xargs)
+            version="^$(npm view $dep version)"
+            jq -r --arg dep "$dep" --arg version "$version" '.dependencies[$dep] = $version' package.json > package.json.tmp
+            mv package.json.tmp package.json
+          done
+          for dep in $(jq -r '.devDependencies | keys | .[]' package.json); do
+            if [[ "$dep" != "@stdlib"* ]]; then
+              continue
+            fi
+            # Trim leading and trailing whitespace:
+            dep=$(echo "$dep" | xargs)
+            version="^$(npm view $dep version)"
+            jq -r --arg dep "$dep" --arg version "$version" '.devDependencies[$dep] = $version' package.json > package.json.tmp
+            mv package.json.tmp package.json
+          done
 
       # Publish package to npm:
       - name: 'Publish package to npm'

.github/workflows/test.yml

@@ -32,6 +32,11 @@ on:
   # Run workflow on each push to the main branch:
   push:
 
+  # Run workflow upon completion of `publish` workflow run:
+  workflow_run:
+    workflows: ["publish"]
+    types: [completed]
+
 # Workflow jobs:
 jobs:
 

.gitignore

@@ -182,3 +182,7 @@ jsconfig.json
 ################
 *.sublime-workspace
 *.sublime-project
+
+# Other editor files #
+######################
+.idea/

CONTRIBUTORS

@@ -9,9 +9,11 @@ Bruno Fenzl <[email protected]>
 Christopher Dambamuromo <[email protected]>
 Dominik Moritz <[email protected]>
 Frank Kovacs <[email protected]>
+Harshita Kalani <[email protected]>
 James <[email protected]>
 Jithin KS <[email protected]>
 Joey Reed <[email protected]>
+Jordan-Gallivan <[email protected]>
 Joris Labie <[email protected]>
 Justin Dennison <[email protected]>
 Marcus <[email protected]>

README.md

@@ -163,8 +163,8 @@ console.log( arr );
 
 ## See Also
 
--   <span class="package-name">[`@stdlib/utils/append`][@stdlib/utils/append]</span><span class="delimiter">: </span><span class="description">add elements from one collection to the end of another collection.</span>
--   <span class="package-name">[`@stdlib/utils/unshift`][@stdlib/utils/unshift]</span><span class="delimiter">: </span><span class="description">add one or more elements to the beginning of a collection.</span>
+-   <span class="package-name">[`@stdlib/utils-append`][@stdlib/utils/append]</span><span class="delimiter">: </span><span class="description">add elements from one collection to the end of another collection.</span>
+-   <span class="package-name">[`@stdlib/utils-unshift`][@stdlib/utils/unshift]</span><span class="delimiter">: </span><span class="description">add one or more elements to the beginning of a collection.</span>
 
 </section>
 

branches.md

@@ -38,12 +38,12 @@ C -->|bundle| D[esm];
 C -->|bundle| E[deno];
 C -->|bundle| F[umd];
 
-click A href "https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/utils/prepend"
-click B href "https://github.com/stdlib-js/utils-prepend/tree/main"
-click C href "https://github.com/stdlib-js/utils-prepend/tree/production"
-click D href "https://github.com/stdlib-js/utils-prepend/tree/esm"
-click E href "https://github.com/stdlib-js/utils-prepend/tree/deno"
-click F href "https://github.com/stdlib-js/utils-prepend/tree/umd"
+%% click A href "https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/utils/prepend"
+%% click B href "https://github.com/stdlib-js/utils-prepend/tree/main"
+%% click C href "https://github.com/stdlib-js/utils-prepend/tree/production"
+%% click D href "https://github.com/stdlib-js/utils-prepend/tree/esm"
+%% click E href "https://github.com/stdlib-js/utils-prepend/tree/deno"
+%% click F href "https://github.com/stdlib-js/utils-prepend/tree/umd"
 ```
 
 [stdlib-url]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/utils/prepend

package.json

@@ -37,32 +37,32 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/array-buffer": "^0.0.x",
-    "@stdlib/assert-is-array": "^0.0.x",
-    "@stdlib/assert-is-collection": "^0.0.x",
-    "@stdlib/assert-is-integer": "^0.0.x",
-    "@stdlib/assert-is-typed-array-like": "^0.0.x",
-    "@stdlib/math-base-special-ceil2": "^0.0.x",
-    "@stdlib/string-format": "^0.0.x",
-    "@stdlib/types": "^0.0.x"
+    "@stdlib/array-buffer": "^0.0.6",
+    "@stdlib/assert-is-array": "^0.0.7",
+    "@stdlib/assert-is-collection": "^0.0.8",
+    "@stdlib/assert-is-integer": "^0.0.8",
+    "@stdlib/assert-is-typed-array-like": "^0.0.8",
+    "@stdlib/math-base-special-ceil2": "^0.0.6",
+    "@stdlib/string-format": "^0.0.3",
+    "@stdlib/types": "^0.0.14"
   },
   "devDependencies": {
-    "@stdlib/array-float32": "^0.0.x",
-    "@stdlib/array-float64": "^0.0.x",
-    "@stdlib/array-int16": "^0.0.x",
-    "@stdlib/array-int32": "^0.0.x",
-    "@stdlib/array-int8": "^0.0.x",
-    "@stdlib/array-uint16": "^0.0.x",
-    "@stdlib/array-uint32": "^0.0.x",
-    "@stdlib/array-uint8": "^0.0.x",
-    "@stdlib/array-uint8c": "^0.0.x",
-    "@stdlib/bench": "^0.0.x",
-    "@stdlib/constants-int16-max": "^0.0.x",
-    "@stdlib/constants-int32-max": "^0.0.x",
-    "@stdlib/constants-int8-max": "^0.0.x",
-    "@stdlib/constants-uint16-max": "^0.0.x",
-    "@stdlib/constants-uint32-max": "^0.0.x",
-    "@stdlib/constants-uint8-max": "^0.0.x",
+    "@stdlib/array-float32": "^0.0.6",
+    "@stdlib/array-float64": "^0.0.6",
+    "@stdlib/array-int16": "^0.0.6",
+    "@stdlib/array-int32": "^0.0.6",
+    "@stdlib/array-int8": "^0.0.6",
+    "@stdlib/array-uint16": "^0.0.6",
+    "@stdlib/array-uint32": "^0.0.6",
+    "@stdlib/array-uint8": "^0.0.7",
+    "@stdlib/array-uint8c": "^0.0.8",
+    "@stdlib/bench": "^0.0.12",
+    "@stdlib/constants-int16-max": "^0.0.7",
+    "@stdlib/constants-int32-max": "^0.0.7",
+    "@stdlib/constants-int8-max": "^0.0.7",
+    "@stdlib/constants-uint16-max": "^0.0.7",
+    "@stdlib/constants-uint32-max": "^0.0.7",
+    "@stdlib/constants-uint8-max": "^0.0.7",
     "tape": "git+https://github.com/kgryte/tape.git#fix/globby",
     "istanbul": "^0.4.1",
     "tap-min": "git+https://github.com/Planeshifter/tap-min.git"
@@ -112,7 +112,7 @@
     "obj"
   ],
   "funding": {
-    "type": "patreon",
-    "url": "https://www.patreon.com/athan"
+    "type": "opencollective",
+    "url": "https://opencollective.com/stdlib"
   }
 }