first commit for mergeq (#6107)

Signed-off-by: Dj Walker-Morgan <[email protected]>

tools/user/mergeq/.gitignore

@@ -0,0 +1,2 @@
+.envrc
+node_modules

tools/user/mergeq/README.md

@@ -0,0 +1,15 @@
+# Mergeq
+
+Utility which reads the docs github repo and finds any PRs which have been merged but not yet published in production release. It then generates a list of PRs with their titles, to assist generating the PR for a production release.
+
+## Usage
+
+From the docs root:
+
+```bash
+$ tools/user/mergeq/mergeq.js
+```
+
+This will output a list of PRs which have been merged but not yet published in a production release.
+
+

tools/user/mergeq/mergeq.js

@@ -0,0 +1,62 @@
+#! /usr/bin/env node
+import fetch from "node-fetch";
+
+// Replace with your details
+const owner = "enterprisedb";
+const repo = "docs";
+const token = ""; /*process.env.GITHUB_TOKEN*/ // Optional - if we ever need to make authenticated requests
+
+async function getLatestReleaseDate(owner, repo, token) {
+  const url = `https://api.github.com/repos/${owner}/${repo}/releases/latest`;
+  const headers = token ? { Authorization: `token ${token}` } : {};
+  const response = await fetch(url, { headers });
+  if (!response.ok) {
+    throw new Error(`Error fetching latest release: ${response.statusText}`);
+  }
+  const data = await response.json();
+  return new Date(data.published_at);
+}
+
+async function getMergedPullRequestsSince(owner, repo, sinceDate, token) {
+  const url = `https://api.github.com/repos/${owner}/${repo}/pulls`;
+  const headers = token ? { Authorization: `token ${token}` } : {};
+  const params = new URLSearchParams({
+    state: "closed",
+    base: "develop",
+    sort: "updated",
+    direction: "desc",
+  });
+  const response = await fetch(`${url}?${params.toString()}`, { headers });
+  if (!response.ok) {
+    throw new Error(`Error fetching pull requests: ${response.statusText}`);
+  }
+  const pulls = await response.json();
+  const mergedPulls = pulls.filter(
+    (pr) => pr.merged_at && new Date(pr.merged_at) > sinceDate,
+  );
+  var finalpulls = mergedPulls.map((pr) => `#${pr.number} : ${pr.title}`);
+  return finalpulls;
+}
+
+async function main() {
+  try {
+    const latestReleaseDate = await getLatestReleaseDate(owner, repo, token);
+    const pulls = await getMergedPullRequestsSince(
+      owner,
+      repo,
+      latestReleaseDate,
+      token,
+    );
+    for (const pull of pulls) {
+      console.log(pull);
+    }
+    console.log();
+    console.log(
+      `Number of merged pull requests since the last release: ${pulls.length}`,
+    );
+  } catch (error) {
+    console.error("Error fetching data from GitHub API:", error);
+  }
+}
+
+main();

tools/user/mergeq/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "mergeq",
+  "version": "1.0.0",
+  "description": "Calculate the backlog of Merged PRs since last production builds",
+  "main": "mergeq.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  }
+}