Files
plan2code/scripts/set-version.mjs
T

138 lines
6.4 KiB
JavaScript
Raw Normal View History

// Writes one version into every file that carries it, so a release never leaves one behind:
// version.json (and its releaseDate), the root package.json, README's "Version X.Y.Z" line, and
// under plan2code-app/: package.json, package-lock.json (two lines), src-tauri/tauri.conf.json,
// src-tauri/Cargo.toml, fake-agent/Cargo.toml and Cargo.lock (the plan2code-app and fake-agent
// entries). It never touches CHANGELOG.md: write its heading by hand, then run this.
// `check-versions.mjs` is the reader of the same places and stays the judge.
//
// node scripts/set-version.mjs <x.y.z> [--date YYYY-MM-DD] [--root <dir>]
//
// The release date defaults to today (local time). Every carrier is read and checked before any is
// written, so a file that has no version leaves the tree as it was. Exit 0 when written, 1 when a
// carrier could not be edited, 2 for bad arguments.
import fs from "node:fs";
import path from "node:path";
import { fileURLToPath } from "node:url";
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const SEMVER = /^\d+\.\d+\.\d+$/;
const DATE = /^\d{4}-\d{2}-\d{2}$/;
const validDate = (d) => {
if (!DATE.test(d)) return false;
const at = new Date(`${d}T00:00:00Z`);
return !Number.isNaN(at.getTime()) && at.toISOString().slice(0, 10) === d;
};
// Replace the first match of `pattern` (its first group is kept, then the new value, then its
// last group). A text edit, never a JSON round trip, so each file's formatting stays as it was.
function swap(text, pattern, value, what) {
if (!pattern.test(text)) throw new Error(`no ${what} found`);
return text.replace(pattern, (_, before, _old, after = "") => `${before}${value}${after}`);
}
const JSON_VERSION = /^(\s*"version"\s*:\s*")([^"]*)(")/m;
const CARGO_VERSION = /^(\s*version\s*=\s*")([^"]*)(")/m;
// A JSON file's top-level version, checked by parsing the result.
function jsonVersion(text, version, what) {
const out = swap(text, JSON_VERSION, version, `${what} "version"`);
if (JSON.parse(out).version !== version) throw new Error(`the first "version" in ${what} is not the top-level one`);
return out;
}
const lockEntry = (name) => new RegExp(`(^name = "${name}"\\r?\\nversion = ")([^"]*)(")`, "m");
/** Each carrier: its path under the root and how to rewrite its text. */
const CARRIERS = [
{ file: "version.json", edit: (t, v, d) => swap(jsonVersion(t, v, "version.json"), /^(\s*"releaseDate"\s*:\s*")([^"]*)(")/m, d, "releaseDate") },
{ file: "package.json", edit: (t, v) => jsonVersion(t, v, "package.json") },
{ file: "README.md", edit: (t, v) => swap(t, /^(Version )(\d+\.\d+\.\d+)(\b)/m, v, '"Version X.Y.Z" line') },
{ file: "plan2code-app/package.json", edit: (t, v) => jsonVersion(t, v, "package.json") },
{ file: "plan2code-app/src-tauri/tauri.conf.json", edit: (t, v) => jsonVersion(t, v, "tauri.conf.json") },
{
file: "plan2code-app/package-lock.json",
edit: (t, v) => {
// The top-level version, then the one inside packages[""].
let out = jsonVersion(t, v, "package-lock.json");
const at = out.indexOf('"packages"');
if (at < 0) throw new Error('no "packages" block found');
const head = out.slice(0, at);
const tail = swap(out.slice(at), JSON_VERSION, v, 'packages[""] "version"');
out = head + tail;
if (JSON.parse(out).packages?.[""]?.version !== v) throw new Error('packages[""].version was not updated');
return out;
},
},
{ file: "plan2code-app/src-tauri/Cargo.toml", edit: (t, v) => swap(t, CARGO_VERSION, v, "version line") },
{ file: "plan2code-app/fake-agent/Cargo.toml", edit: (t, v) => swap(t, CARGO_VERSION, v, "version line") },
{
file: "plan2code-app/Cargo.lock",
edit: (t, v) => swap(swap(t, lockEntry("plan2code-app"), v, "plan2code-app entry"), lockEntry("fake-agent"), v, "fake-agent entry"),
},
];
function today() {
const d = new Date();
const pad = (n) => String(n).padStart(2, "0");
return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
}
/**
* Write `version` into every carrier under `root`. Returns `{ ok, written: [file], problems: [string] }`;
* nothing is written unless every carrier edits cleanly.
*/
export function setVersion(root, version, date = today()) {
const problems = [];
const staged = [];
for (const { file, edit } of CARRIERS) {
const full = path.join(root, file);
try {
const before = fs.readFileSync(full, "utf8");
staged.push({ file, full, before, after: edit(before, version, date) });
} catch (error) {
problems.push(`${file}: ${error.code === "ENOENT" ? "file is missing" : error.message}`);
}
}
if (problems.length) return { ok: false, written: [], problems };
const written = [];
try {
for (const { file, full, before, after } of staged) {
if (after !== before) fs.writeFileSync(full, after);
written.push(file);
}
} catch (error) {
// A write failed part way (permissions, a locked file): put back what was already written.
for (const { file, full, before } of staged) if (written.includes(file)) fs.writeFileSync(full, before);
return { ok: false, written: [], problems: [`write failed (${error.code || error.message}); restored the files already written`] };
}
return { ok: true, written, problems };
}
export const CARRIER_FILES = CARRIERS.map((c) => c.file);
if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
const args = process.argv.slice(2);
const take = (flag) => {
const at = args.indexOf(flag);
if (at < 0) return undefined;
const [, value] = args.splice(at, 2);
return value ?? "";
};
const date = take("--date");
const rootArg = take("--root");
const [version, ...extra] = args;
const usage = "Usage: node scripts/set-version.mjs <x.y.z> [--date YYYY-MM-DD] [--root <dir>]";
if (!version || extra.length || !SEMVER.test(version) || (date !== undefined && !validDate(date)) || rootArg === "") {
console.error(usage);
process.exit(2);
}
const { ok, written, problems } = setVersion(rootArg ? path.resolve(rootArg) : ROOT, version, date);
if (!ok) {
for (const problem of problems) console.error(`CANNOT SET: ${problem}`);
console.error("Nothing was written.");
process.exit(1);
}
for (const file of written) console.log(`${version.padEnd(10)} ${file}`);
console.log(`Wrote ${version} to ${written.length} files. CHANGELOG.md is yours to edit; then run: node scripts/check-versions.mjs`);
}