Add script to automate release of new versions

[jntesteves]

New year, new PR. Same issues... Still trying to resolve #189

So, what changed:
I've come to accept that I'll never reach out to the guys on Discord to work on the upstream CI, so the problem has to be solved on this repository alone. I've decided to use the GitHub API to get the last commit hashes from the repositories of the modules and just update the template with that. Sounds like a cheap lazy excuse of a solution, but in fact it works much better than I expected.

I've just created a test release on a local branch with this command:

[UPDATED with the changes discussed in comments below]

./release.sh --git-tag=v1.10.0 1.10.0+test.0

You can use --help to get the usual usage help. Note that the script commits to git and creates a tag, so use a branch to test and take care not to push test releases.

This time it works, I swear.

[flathubbot]

Started test build 78771

[flathubbot]

Started test build 78772

[flathubbot]

Build 78771 successful
To test this build, install it from the testing repository:

flatpak install --user https://dl.flathub.org/build-repo/76651/org.libretro.RetroArch.flatpakref

[flathubbot]

Build 78772 successful
To test this build, install it from the testing repository:

flatpak install --user https://dl.flathub.org/build-repo/76652/org.libretro.RetroArch.flatpakref

[RobLoach]

Very cool! Could we disable push by default? Or enable --no-push by default? Thanks for taking this on. Even having the latest commit attached is a huge step in the right direction.

[flathubbot]

Started test build 78796

[jntesteves]

Very cool! Could we disable push by default? Or enable --no-push by default? Thanks for taking this on. Even having the latest commit attached is a huge step in the right direction.

Yes, I inverted the option to --push and just force-pushed the change. Since this was supposed to run on CI, I didn't think much of ergonomics for local use, but yeah, not pushing by default makes much more sense.

[flathubbot]

Build 78796 successful
To test this build, install it from the testing repository:

flatpak install --user https://dl.flathub.org/build-repo/76676/org.libretro.RetroArch.flatpakref

[flathubbot]

Started test build 78912

[flathubbot]

Build 78912 successful
To test this build, install it from the testing repository:

flatpak install --user https://dl.flathub.org/build-repo/76795/org.libretro.RetroArch.flatpakref

[RobLoach]

Seem to be getting this error when running. Am I running it wrong?

./release.sh --git-tag=v1.10.1 1.10.1           
2022-03-04T19:13:55-05:00 INFO Rendering template from org.libretro.RetroArch.json.tmpl with VERSION_TAG=v1.10.1 to file org.libretro.RetroArch.json
./release.sh: 140: local: {: bad variable name

[jntesteves]

Seem to be getting this error when running. Am I running it wrong?

./release.sh --git-tag=v1.10.1 1.10.1           
2022-03-04T19:13:55-05:00 INFO Rendering template from org.libretro.RetroArch.json.tmpl with VERSION_TAG=v1.10.1 to file org.libretro.RetroArch.json
./release.sh: 140: local: {: bad variable name

Hi, thanks for testing this. So, shell script is a complicated beast compatibility-wise. This seems to be a problem with dash and non-quoted variable assignment. I've used the opportunity while working on this script to improve my knowledge of POSIX-compliant shell script, testing with bash, dash, zsh and ash/busybox on an Alpine container, and still I let this one slip. That's how hard shell compatibility is.

What shell are you using? What OS?

PS: I just fixed it, but the fix broke zsh 😬

[RobLoach]

We could flip it to use Node.js, or Python, or anything 🤷

[jntesteves]

We could flip it to use Node.js, or Python, or anything shrug

I wanted something with no dependencies, so it would run on any CI server so I wouldn't need to care to ask what's running on it. And I also wanted to improve my script-fu. And shell script always feels like a good fit for build automation.

Anyway, I fixed it, it was just some creative quoting on my part. Quoting rules are by far the most complicated part of shell script in my opinion. I'm waiting one hour just to test some more. Github has a very low rate limit for their API, I can only test the script about 7 times before hitting it.

[flathubbot]

Started test build 80480

[jntesteves]

@RobLoach I've amended and force-pushed it. Tested with on every shell this time.

[flathubbot]

Build 80480 successful
To test this build, install it from the testing repository:

flatpak install --user https://dl.flathub.org/build-repo/78373/org.libretro.RetroArch.flatpakref