chore: automate release

.github/workflows/process-release.yml

@@ -0,0 +1,23 @@
+name: Process release
+on:
+  issues:
+    types:
+      - closed
+jobs:
+  build:
+    name: Release
+    runs-on: ubuntu-20.04
+    if: "startsWith(github.event.issue.title, 'chore: release')"
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+
+      - name: Setup
+        id: setup
+        uses: ./.github/actions/setup
+
+      - run: ./scripts/release/process-release.js
+        env:
+          EVENT_NUMBER: ${{ github.event.issue.number }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

config.json

@@ -0,0 +1,8 @@
+{
+  "release": {
+    "releasedTag": "released",
+    "mainBranch": "main",
+    "owner": "algolia",
+    "repo": "api-clients-automation"
+  }
+}

package.json

@@ -27,14 +27,17 @@
     "playground": "./scripts/multiplexer.sh ${2:-nonverbose} ./scripts/playground.sh ${0:-javascript} ${1:-search}",
     "specs:fix": "eslint --ext=yml specs/ --fix",
     "specs:lint": "eslint --ext=yml specs/$0",
-    "github-actions:lint": "eslint --ext=yml .github/"
+    "github-actions:lint": "eslint --ext=yml .github/",
+    "release": "./scripts/release/create-release-issue.js"
   },
   "devDependencies": {
+    "@octokit/rest": "18.12.0",
     "@openapitools/openapi-generator-cli": "2.4.26",
     "@redocly/openapi-cli": "1.0.0-beta.79",
     "@typescript-eslint/eslint-plugin": "5.5.0",
     "@typescript-eslint/parser": "5.5.0",
     "babel-eslint": "10.1.0",
+    "dotenv": "14.3.2",
     "eslint": "8.6.0",
     "eslint-config-algolia": "20.0.0",
     "eslint-config-prettier": "8.3.0",
@@ -45,10 +48,12 @@
     "eslint-plugin-prettier": "4.0.0",
     "eslint-plugin-unused-imports": "2.0.0",
     "eslint-plugin-yml": "0.12.0",
+    "execa": "5.1.1",
     "json": "11.0.0",
     "mustache": "4.2.0",
     "prettier": "2.5.1",
     "prettier-plugin-java": "1.6.0",
+    "semver": "7.3.5",
     "typescript": "4.5.4"
   },
   "engines": {

scripts/release/common.js

@@ -0,0 +1,36 @@
+/* eslint-disable @typescript-eslint/no-var-requires */
+/* eslint-disable import/no-commonjs */
+const execa = require('execa'); // https://github.com/sindresorhus/execa/tree/v5.1.1
+const config = require('../../config.json');
+const openapitools = require('../../openapitools.json');
+
+function run(command, { errorMessage = undefined } = {}) {
+  let result;
+  try {
+    result = execa.commandSync(command);
+  } catch (err) {
+    if (errorMessage) {
+      throw new Error(`[ERROR] ${errorMessage}`);
+    } else {
+      throw err;
+    }
+  }
+  return result.stdout;
+}
+
+const LANGS = [
+  ...new Set(
+    Object.keys(openapitools['generator-cli'].generators).map(
+      (key) => key.split('-')[0]
+    )
+  ),
+];
+
+module.exports = {
+  RELEASED_TAG: config.release.releasedTag,
+  MAIN_BRANCH: config.release.mainBranch,
+  OWNER: config.release.owner,
+  REPO: config.release.repo,
+  LANGS,
+  run,
+};

scripts/release/create-release-issue.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+/* eslint-disable import/no-commonjs */
+/* eslint-disable @typescript-eslint/no-var-requires */
+const fs = require('fs');
+
+const { Octokit } = require('@octokit/rest');
+const dotenv = require('dotenv');
+const semver = require('semver');
+
+const {
+  RELEASED_TAG,
+  MAIN_BRANCH,
+  OWNER,
+  REPO,
+  LANGS,
+  run,
+} = require('./common');
+
+dotenv.config();
+
+const TEXT = require('./text');
+
+function readVersions() {
+  const versions = {};
+
+  const generators = JSON.parse(
+    fs.readFileSync('openapitools.json').toString()
+  )['generator-cli'].generators;
+
+  Object.keys(generators).forEach((generator) => {
+    const lang = generator.split('-')[0];
+    if (!versions[lang]) {
+      versions[lang] = {
+        current: generators[generator].additionalProperties.packageVersion,
+        langName: lang,
+        next: undefined,
+      };
+    }
+  });
+  return versions;
+}
+
+if (!process.env.GITHUB_TOKEN) {
+  throw new Error('Environment variable `GITHUB_TOKEN` does not exist.');
+}
+
+if (run('git rev-parse --abbrev-ref HEAD') !== MAIN_BRANCH) {
+  throw new Error(
+    `You can run this script only from \`${MAIN_BRANCH}\` branch.`
+  );
+}
+
+if (run('git status --porcelain')) {
+  throw new Error(
+    'Working directory is not clean. Commit all the changes first.'
+  );
+}
+
+run(`git rev-parse --verify refs/tags/${RELEASED_TAG}`, {
+  errorMessage: '`released` tag is missing in this repository.',
+});
+
+// Reading versions from `openapitools.json`
+const versions = readVersions();
+
+console.log('Pulling from origin...');
+run(`git pull origin ${MAIN_BRANCH}`);
+
+console.log('Pushing to origin...');
+run(`git push origin ${MAIN_BRANCH}`);
+
+const commitsWithoutScope = [];
+const commitsWithNonLanguageScope = [];
+// Reading commits since last release
+const latestCommits = run(`git log --oneline ${RELEASED_TAG}..${MAIN_BRANCH}`)
+  .split('\n')
+  .filter(Boolean)
+  .map((commit) => {
+    const hash = commit.slice(0, 7);
+    let message = commit.slice(8);
+    let type = message.slice(0, message.indexOf(':'));
+    const matchResult = type.match(/(.+)\((.+)\)/);
+    if (!matchResult) {
+      commitsWithoutScope.push(commit);
+      return undefined;
+    }
+    message = message.slice(message.indexOf(':') + 2);
+    type = matchResult[1];
+    const lang = matchResult[2];
+
+    if (!LANGS.includes(lang)) {
+      commitsWithNonLanguageScope.push(commit);
+      return undefined;
+    }
+
+    return {
+      hash,
+      type, // `fix` | `feat` | `chore` | ...
+      lang, // `javascript` | `php` | `java` | ...
+      message,
+      raw: commit,
+    };
+  })
+  .filter(Boolean);
+
+console.log('[INFO] Skipping these commits due to lack of language scope:');
+console.log(commitsWithoutScope.map((commit) => `  ${commit}`).join('\n'));
+
+console.log('');
+console.log('[INFO] Skipping these commits due to wrong scopes:');
+console.log(
+  commitsWithNonLanguageScope.map((commit) => `  ${commit}`).join('\n')
+);
+
+LANGS.forEach((lang) => {
+  const commits = latestCommits.filter(
+    (lastestCommit) => lastestCommit.lang === lang
+  );
+  const currentVersion = versions[lang].current;
+
+  if (commits.length === 0) {
+    versions[lang].next = currentVersion;
+    versions[lang].noCommit = true;
+    return;
+  }
+
+  if (semver.prerelease(currentVersion)) {
+    // if version is like 0.1.2-beta.1, it increases to 0.1.2-beta.2, even if there's a breaking change.
+    versions[lang].next = semver.inc(currentVersion, 'prerelease');
+    return;
+  }
+
+  if (commits.some((commit) => commit.message.includes('BREAKING CHANGE'))) {
+    versions[lang].next = semver.inc(currentVersion, 'major');
+    return;
+  }
+
+  const commitTypes = new Set(commits.map(({ type }) => type));
+  if (commitTypes.has('feat')) {
+    versions[lang].next = semver.inc(currentVersion, 'minor');
+    return;
+  }
+
+  versions[lang].next = semver.inc(currentVersion, 'patch');
+  if (!commitTypes.has('fix')) {
+    versions[lang].skipRelease = true;
+  }
+});
+
+const versionChanges = LANGS.map((lang) => {
+  const { current, next, noCommit, skipRelease, langName } = versions[lang];
+
+  if (noCommit) {
+    return `- ~${langName}: v${current} (${TEXT.noCommit})~`;
+  }
+
+  if (!current) {
+    return `- ~${langName}: (${TEXT.currentVersionNotFound})~`;
+  }
+
+  const checked = skipRelease ? ' ' : 'x';
+  return [
+    `- [${checked}] ${langName}: v${current} -> v${next}`,
+    skipRelease && TEXT.descriptionForSkippedLang(langName),
+  ]
+    .filter(Boolean)
+    .join('\n');
+}).join('\n');
+
+const changelogs = LANGS.filter(
+  (lang) => !versions[lang].noCommit && versions[lang].current
+)
+  .flatMap((lang) => {
+    if (versions[lang].noCommit) {
+      return [];
+    }
+
+    return [
+      `### ${versions[lang].langName}`,
+      ...latestCommits
+        .filter((commit) => commit.lang === lang)
+        .map((commit) => `- ${commit.raw}`),
+    ];
+  })
+  .join('\n');
+
+const body = [
+  TEXT.header,
+  TEXT.versionChangeHeader,
+  versionChanges,
+  TEXT.changelogHeader,
+  TEXT.changelogDescription,
+  changelogs,
+  TEXT.approvalHeader,
+  TEXT.approval,
+].join('\n\n');
+
+const octokit = new Octokit({
+  auth: `token ${process.env.GITHUB_TOKEN}`,
+});
+
+octokit.rest.issues
+  .create({
+    owner: OWNER,
+    repo: REPO,
+    title: `chore: release ${new Date().toISOString().split('T')[0]}`,
+    body,
+  })
+  .then((result) => {
+    const {
+      data: { number, html_url: url },
+    } = result;
+
+    console.log('');
+    console.log(`Release issue #${number} is ready for review.`);
+    console.log(`  > ${url}`);
+  });