Provide VERSION file with asset bundle, read in application

[grahamalama]

This PR adds a script to generate a VERSION file that gets packaged with our built asset bundle. This is so that applications can read that file to report the Kinto Admin version in a Kinto capabilities object

> npm run build
> tree build -L 1
build
├── VERSION
├── assets
└── index.html

[grahamalama]

Ugh, forgot about Windows compatibility. I'll port this to Javascript

[alexcottner]

I suppose requiring WSL to build a UI is too much.

[grahamalama]

This seems like a job for a Makefile, which can come in another PR. It'd be nice to add our common targets like build, start, lint, format, etc. while we're at it.

[alexcottner]

I don't think I've ever seen a Makefile for a pure react project before. I'm not opposed to this, but it might cause friction with pure UI devs. We should ask around a bit.

[grahamalama]

If/when we move a "real" file into here, we can ditch this .gitkeep file

[alexcottner]

I think this would be the more "node way" of doing things. But honestly I'm never a fan of just following established patterns, I always prefer what is most readable unless there is a performance issue with that.

#!/usr/bin/env node
import { execSync } from "child_process";
import { writeFileSync } from "fs";
import fetch from "node-fetch"; // i think fetch is the most common package to use, axios is good too

async function getLatestRelease() {
  const res = await fetch("https://api.github.com/repos/Kinto/kinto-admin/releases/latest");
  const body = await res.json();
  return body.tag_name;
}

function getGitLatestReleaseVersion() {
  try {
    return execSync("git describe --tags --abbrev=4", {
      encoding: "utf-8",
    }).trim();
  } catch (error) {
    console.log(error);
  }
};

(async() => {
  const kintoAdminVersion = process.env.KINTO_ADMIN_VERSION // coalesce until we get something
    || getGitLatestReleaseVersion() 
    || await getLatestRelease();
  writeFileSync("./public/VERSION", kintoAdminVersion);
})();

Note: This requires the node-fetch package as a dev dependency.

[grahamalama]

Note: This requires the node-fetch package as a dev dependency.

At first I was trying to rely only on the standard library, but since people need to node ci before running node run build anyway, what's one more dependency?

[alexcottner]

I try to keep dependencies slim, but when it comes to things like http clients or database clients I think they're worth it.