-
-
Notifications
You must be signed in to change notification settings - Fork 42
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[code-infra] Remove releaseChangelog.mjs duplication (#273)
- Loading branch information
1 parent
f1a32ff
commit b02d055
Showing
2 changed files
with
2 additions
and
214 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,213 +1 @@ | ||
/* eslint-disable no-restricted-syntax */ | ||
import childProcess from 'child_process'; | ||
import { promisify } from 'util'; | ||
import { Octokit } from '@octokit/rest'; | ||
import chalk from 'chalk'; | ||
import yargs from 'yargs'; | ||
|
||
const exec = promisify(childProcess.exec); | ||
|
||
/** | ||
* @param {string} commitMessage | ||
* @returns {string} The tags in lowercases, ordered ascending and comma separated | ||
*/ | ||
function parseTags(commitMessage) { | ||
const tagMatch = commitMessage.match(/^(\[[\w-]+\])+/); | ||
if (tagMatch === null) { | ||
return ''; | ||
} | ||
const [tagsWithBracketDelimiter] = tagMatch; | ||
return tagsWithBracketDelimiter | ||
.match(/([\w-]+)/g) | ||
.map((tag) => { | ||
return tag.toLocaleLowerCase(); | ||
}) | ||
.sort((a, b) => { | ||
return a.localeCompare(b); | ||
}) | ||
.join(','); | ||
} | ||
|
||
/** | ||
* @param {Octokit.ReposCompareCommitsResponseCommitsItem} commitsItem | ||
*/ | ||
function filterCommit(commitsItem) { | ||
// TODO: Use labels | ||
// Filter dependency updates | ||
return !commitsItem.commit.message.startsWith('Bump'); | ||
} | ||
|
||
async function findLatestTaggedVersion() { | ||
const { stdout } = await exec( | ||
[ | ||
'git', | ||
'describe', | ||
// Earlier tags used lightweight tags + commit. | ||
// We switched to annotated tags later. | ||
'--tags', | ||
'--abbrev=0', | ||
// only include "version-tags" | ||
'--match "v*"', | ||
].join(' '), | ||
); | ||
|
||
return stdout.trim(); | ||
} | ||
|
||
async function main(argv) { | ||
const { githubToken, lastRelease: lastReleaseInput, release, repo } = argv; | ||
|
||
if (!githubToken) { | ||
throw new TypeError( | ||
'Unable to authenticate. Make sure you either call the script with `--githubToken $token` or set `process.env.GITHUB_TOKEN`. The token needs `public_repo` permissions.', | ||
); | ||
} | ||
const octokit = new Octokit({ | ||
auth: githubToken, | ||
request: { | ||
fetch, | ||
}, | ||
}); | ||
|
||
const latestTaggedVersion = await findLatestTaggedVersion(); | ||
const lastRelease = lastReleaseInput !== undefined ? lastReleaseInput : latestTaggedVersion; | ||
if (lastRelease !== latestTaggedVersion) { | ||
console.warn( | ||
`Creating changelog for ${lastRelease}..${release} when latest tagged version is '${latestTaggedVersion}'.`, | ||
); | ||
} | ||
|
||
/** | ||
* @type {AsyncIterableIterator<Octokit.Response<Octokit.ReposCompareCommitsResponse>>} | ||
*/ | ||
const timeline = octokit.paginate.iterator( | ||
octokit.repos.compareCommits.endpoint.merge({ | ||
owner: 'mui', | ||
repo, | ||
base: lastRelease, | ||
head: release, | ||
}), | ||
); | ||
|
||
/** | ||
* @type {Octokit.ReposCompareCommitsResponseCommitsItem[]} | ||
*/ | ||
const commitsItems = []; | ||
for await (const response of timeline) { | ||
const { data: compareCommits } = response; | ||
commitsItems.push(...compareCommits.commits.filter(filterCommit)); | ||
} | ||
|
||
let warnedOnce = false; | ||
|
||
const getAuthor = (commit) => { | ||
if (!commit.author) { | ||
if (!warnedOnce) { | ||
console.warn( | ||
`The author of the commit: ${commit.commit.tree.url} cannot be retrieved. Please add the github username manually.`, | ||
); | ||
} | ||
warnedOnce = true; | ||
return chalk.red("TODO INSERT AUTHOR'S USERNAME"); | ||
} | ||
|
||
return commit.author?.login; | ||
}; | ||
|
||
const authors = Array.from( | ||
new Set( | ||
commitsItems.map((commitsItem) => { | ||
return getAuthor(commitsItem); | ||
}), | ||
), | ||
); | ||
const contributorHandles = authors | ||
.sort((a, b) => a.localeCompare(b)) | ||
.map((author) => `@${author}`) | ||
.join(', '); | ||
|
||
// We don't know when a particular commit was made from the API. | ||
// Only that the commits are ordered by date ASC | ||
const commitsItemsByDateDesc = commitsItems.slice().reverse(); | ||
// Sort by tags ASC, date desc | ||
// Will only consider exact matches of tags so `[Slider]` will not be grouped with `[Slider][Modal]` | ||
commitsItems.sort((a, b) => { | ||
const aTags = parseTags(a.commit.message); | ||
const bTags = parseTags(b.commit.message); | ||
if (aTags === bTags) { | ||
return commitsItemsByDateDesc.indexOf(a) - commitsItemsByDateDesc.indexOf(b); | ||
} | ||
return aTags.localeCompare(bTags); | ||
}); | ||
const changes = commitsItems.map((commitsItem) => { | ||
// Helps changelog author keeping track of order when grouping commits under headings. | ||
// ​ is a zero-width-space that ensures that the content of the listitem is formatted properly | ||
const dateSortMarker = `​<!-- ${(commitsItems.length - commitsItems.indexOf(commitsItem)) | ||
.toString() | ||
// Padding them with a zero means we can just feed a list into online sorting tools like https://www.online-utility.org/text/sort.jsp | ||
// i.e. we can sort the lines alphanumerically | ||
.padStart(Math.floor(Math.log10(commitsItemsByDateDesc.length)) + 1, '0')} -->`; | ||
const shortMessage = commitsItem.commit.message.split('\n')[0]; | ||
return `- ${dateSortMarker}${shortMessage} @${getAuthor(commitsItem)}`; | ||
}); | ||
const nowFormatted = new Date().toLocaleDateString('en-US', { | ||
month: 'short', | ||
day: 'numeric', | ||
year: 'numeric', | ||
}); | ||
|
||
const changelog = ` | ||
## TODO RELEASE NAME | ||
<!-- generated comparing ${lastRelease}..${release} --> | ||
_${nowFormatted}_ | ||
A big thanks to the ${ | ||
authors.length | ||
} contributors who made this release possible. Here are some highlights ✨: | ||
TODO INSERT HIGHLIGHTS | ||
${changes.join('\n')} | ||
All contributors of this release in alphabetical order: ${contributorHandles} | ||
`; | ||
|
||
// eslint-disable-next-line no-console -- output of this script | ||
console.log(changelog); | ||
} | ||
|
||
yargs(process.argv.slice(2)) | ||
.command({ | ||
command: '$0', | ||
description: 'Creates a changelog', | ||
builder: (command) => { | ||
return command | ||
.option('lastRelease', { | ||
describe: | ||
'The release to compare against e.g. `v5.0.0-alpha.23`. Default: The latest tag on the current branch.', | ||
type: 'string', | ||
}) | ||
.option('githubToken', { | ||
default: process.env.GITHUB_TOKEN, | ||
describe: | ||
'The personal access token to use for authenticating with GitHub. Needs public_repo permissions.', | ||
type: 'string', | ||
}) | ||
.option('release', { | ||
// #default-branch-switch | ||
default: 'master', | ||
describe: 'Ref which we want to release', | ||
type: 'string', | ||
}) | ||
.option('repo', { | ||
default: 'pigment-css', | ||
describe: 'Repository to generate a changelog for', | ||
type: 'string', | ||
}); | ||
}, | ||
handler: main, | ||
}) | ||
.help() | ||
.strict(true) | ||
.version(false) | ||
.parse(); | ||
import '@mui/monorepo/scripts/releaseChangelog.mjs'; |