feat: allow installing specific Mesa3D release

[RobPasMue]

A user might want to install a specific version of Mesa3D on their self-hosted runner or GitHub runner. This change would allow them to do so. Also, it will allow the action, by default, to always pull the latest Mesa3D version available rather than a hard-coded one. See commit b2a733a

Furthermore - we should use the installers that are shipped by Mesa3D in order to avoid DLL incompatibility issues. See commits d6dd86a and adb571e

Added documentation on how to use the input, and modified the action and bash scripts as well. Let me know if there's anything else I can contribute with!

[RobPasMue]

Pinging @larsoner @tlambert03 and @banesullivan for feedback and review! Thanks in advance =)

[SMoraisAnsys]

LGTM. I feared that hardcoding values for the systemwidedeploy.cmd file might backfire but this file hasn't changed in two years, see https://github.com/pal1000/mesa-dist-win/blob/master/bin/systemwidedeploy.cmd.

[larsoner]

Just one tiny suggestion which I'll apply and merge, this is great, thanks!

[RobPasMue]

Just one tiny suggestion which I'll apply and merge, this is great, thanks!

Awesome, thanks a lot @larsoner! =) Would it be possible to get a release with this change?

[RobPasMue]

Looks like grep -P might not behave properly everywhere. Using sed directly. See https://github.com/pyvista/setup-headless-display-action/actions/runs/12121147123/job/33791452876?pr=22#step:3:17

[RobPasMue]

Hmm... for some reason the env var is giving some problems on test (windows-2022) but not on test (windows-latest)...

[larsoner]

Still comes up blank for the version 😞

[RobPasMue]

Still comes up blank for the version 😞

Yeah saw that... the thing is that it only happens with windows-2022 😮

[larsoner]

Maybe instead

$ gh api /repos/pal1000/mesa-dist-win/releases | jq .[0].tag_name
"24.3.0"

?

[RobPasMue]

jq...

jq is not available in some Windows Bash terminals 😢

[RobPasMue]

I added some extra logging to make it easy for users to debug as well

[RobPasMue]

It ended up working here: https://github.com/pyvista/setup-headless-display-action/actions/runs/12121505042/job/33793270066

Let's let it re-run again. Might have been some transient issue

[larsoner]

Looks like retrieving the version can just be a bit flaky or fail sometimes as 891324c failed but worked once I restarted it. Not sure if there's a good way around that.

[larsoner]

@RobPasMue given 1) latest can be problematic/flaky, and 2) can change over time, I am inclined to set the default to 24.3.0, the latest as of today. And then we can bump periodically, probably on major version changes of this library. It seems like a more stable choice for end-users who don't set the variable.

[larsoner]

Thanks @RobPasMue !

[larsoner]

Released as v3.1 and updated v3 to point to it

[RobPasMue]

@RobPasMue given 1) latest can be problematic/flaky, and 2) can change over time, I am inclined to set the default to 24.3.0, the latest as of today. And then we can bump periodically, probably on major version changes of this library. It seems like a more stable choice for end-users who don't set the variable.

Sounds good! Thanks @larsoner for all your support!