Merge branch 'main' into re-add-winston

Author: Trott

.eslintrc.yml

@@ -0,0 +1,34 @@
+name: Close stalled issues and PRs
+on:
+  schedule:
+    - cron: 0 0 * * *
+
+env:
+  CLOSE_MESSAGE: >
+    Closing this because it has stalled. Feel free to reopen if this issue/PR is
+    still relevant, or to ping the collaborator who labelled it stalled if you
+    have any questions.
+
+permissions:
+  contents: read
+
+jobs:
+  stale:
+    permissions:
+      issues: write # for actions/stale to close stale issues
+      pull-requests: write # for actions/stale to close stale PRs
+    if: github.repository == 'nodejs/citgm'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@28ca1036281a5e5922ead5184a1bbf96e5fc984e # v9.0.0
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          days-before-close: 30
+          stale-pr-label: stalled
+          stale-issue-label: stalled
+          close-issue-message: ${{ env.CLOSE_MESSAGE }}
+          close-pr-message: ${{ env.CLOSE_MESSAGE }}
+          # used to filter issues to check whether or not should be closed, avoids hitting maximum operations allowed if needing to paginate through all open issues
+          only-labels: stalled
+          # max requests it will send per run to the GitHub API before it deliberately exits to avoid hitting API rate limits
+          operations-per-run: 500

.github/workflows/close-stalled.yml

@@ -8,7 +8,7 @@ on:
 
 jobs:
   lint:
-    name: Lint using ESLint
+    name: Lint using ESLint and Prettier
 
     runs-on: ubuntu-latest
 
@@ -19,7 +19,7 @@ jobs:
           show-progress: false
 
       - name: Use LTS Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: lts/*
 

.github/workflows/nodejs.yml

@@ -38,6 +38,8 @@ jobs:
         node-version:
           - 18.x
           - 20.x
+          - 21.x
+          - 22.x
 
     runs-on: ${{ matrix.os }}
 
@@ -50,7 +52,7 @@ jobs:
           show-progress: false
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
 

.github/workflows/test-module.yml

@@ -2,5 +2,6 @@ node_modules/
 test/scaffold/*/node_modules
 test/.*
 coverage/
+/.tap
 .nyc_output/
 .eslintcache

.gitignore

@@ -0,0 +1,2 @@
+/README.md
+/test/fixtures/custom-lookup-broken.json

.prettierignore

@@ -52,8 +52,9 @@ This is for adding a module to be included in the default `citgm-all` runs.
 - Module source code must be on Github.
 - Published versions must include a tag on Github
 - The test process must be executable with only the commands
-  `npm install && npm test` or (`yarn install && yarn test`) using the tarball
-  downloaded from the Github tag mentioned above
+  `npm install && npm test` or (`yarn install && yarn test` or
+  `pnpm install && pnpm test`) using the tarball downloaded from the GitHub tag
+  mentioned above
 - The tests pass on supported major release lines
 - The maintainers of the module remain responsive when there are problems
 - At least one module maintainer must be added to the lookup maintainers field

CONTRIBUTING.md

@@ -3,7 +3,7 @@
 citgm is a simple tool for pulling down an arbitrary module from npm and testing
 it using a specific version of the node runtime.
 
-[![Build Status](https://github.com/nodejs/citgm/workflows/Node.js%20CI/badge.svg?branch=main)](https://github.com/nodejs/citgm/actions?query=workflow%3A%22Node.js+CI%22)
+[![Build Status](https://github.com/nodejs/citgm/actions/workflows/nodejs.yml/badge.svg?branch=main)](https://github.com/nodejs/citgm/actions/workflows/nodejs.yml)
 
 The Node.js project uses citgm to smoke test our releases and controversial
 changes. The Jenkins job that utilizes citgm can be found
@@ -109,6 +109,7 @@ Options:
   --excludeTags tag1 tag2     Specify which tags to skip from the lookup (takes priority over includeTags)
                               Module names are automatically added as tags.
   -y, --yarn                  Install and test the project using yarn instead of npm
+  --pnpm                      Install and test the project using pnpm instead of npm
 ```
 
 When using a JSON config file, the properties need to be the same as the
@@ -134,13 +135,14 @@ For syntax, see [lookup.json](./lib/lookup.json), the available attributes are:
 "stripAnsi": true            Strip ansi data from output stream of npm
 "sha": "<git-commit-sha>"    Test against a specific commit
 "envVar"                     Pass an environment variable before running
-"install": ["install", "--param1", "--param2"] - Array of command line parameters passed to 'npm' or 'yarn' as install arguments
+"install": ["install", "--param1", "--param2"] - Array of command line parameters passed to `npm` or `yarn` or `pnpm` as install arguments
 "maintainers": ["user1", "user2"] - List of module maintainers to be contacted with issues
 "scripts": ["script1", "script2"] - List of scripts from package.json to run instead of 'test'
 "tags": ["tag1", "tag2"]     Specify which tags apply to the module
 "useGitClone": true          Use a shallow git clone instead of downloading the module
 "ignoreGitHead":             Ignore the gitHead field if it exists and fallback to using github tags
 "yarn":                      Install and test the project using yarn instead of npm
+"pnpm":                      Install and test the project using pnpm instead of npm
 "timeout":                   Number of milliseconds before timeout. Applies separately to `install` and `test`
 ```
 

README.md

@@ -0,0 +1,39 @@
+import js from '@eslint/js';
+import prettier from 'eslint-config-prettier';
+import globals from 'globals';
+
+export default [
+  js.configs.recommended,
+  prettier,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.node
+      }
+    },
+    rules: {
+      'capitalized-comments': [
+        'error',
+        'always',
+        { ignoreConsecutiveComments: true }
+      ],
+      eqeqeq: ['error', 'always'],
+      'no-template-curly-in-string': 'error',
+      'no-useless-escape': 'error',
+      'no-var': 'error',
+      'padding-line-between-statements': [
+        'error',
+        { blankLine: 'always', prev: 'directive', next: '*' }
+      ],
+      'prefer-arrow-callback': 'error',
+      'prefer-template': 'error',
+      strict: 'error'
+    }
+  },
+  {
+    files: ['test/fixtures/**'],
+    languageOptions: {
+      sourceType: 'commonjs'
+    }
+  }
+];

eslint.config.js

@@ -69,6 +69,7 @@ const options = {
   tmpDir: app.tmpDir,
   customTest: app.customTest,
   yarn: app.yarn,
+  pnpm: app.pnpm,
   includeTags: app.includeTags || [],
   excludeTags: app.excludeTags || []
 };