VersionsJSONUtil: Generate versions.json files that contain the list of Julia versions

S3 URL:

• v1: https://julialang-s3.julialang.org/bin/versions.json
• v2: [coming soon]¹

JSON Schema

schema.json contains a JSON Schema for the versions.json file.

It can be used to validate the versions file or to generate code from the schema.

Downstream tools using versions.json

This is a (not necessarily complete) list of known tools that make use of versions.json. If you maintain such a tool, please make a PR to add it to this list. This allows us to check if changes might break downstream tooling.

• abelsiqueira/jill: A Julia installer written in Bash.
• johnnychen94/jill.py: A Julia installer written in Python.
• julia-actions/setup-julia: Installs Julia in GitHub Actions CI jobs.
• JuliaCI/julia-buildkite-plugin: Buildkite plugin to install Julia for use in a pipeline. This plugin is used in Base Julia CI.
• JuliaCI/julia-snap: Snap setup for Julia.
• JuliaCI/PkgEval.jl: A package to test one or more Julia versions against the Julia package ecosystem.
• JuliaLang/Juliaup: Julia installer and version manager².
• JuliaLang/www.julialang.org: The Julia website repo (uses versions.json to auto-generate the list of Julia releases).

Devdocs

See ./devdocs/README.md.

Background and motivation

This issue provides background info that explains the motivation: JuliaLang/julia#33817

Footnotes

1. v2 is not available yet. When it becomes available, the S3 URL will probably be https://julialang-s3.julialang.org/bin/versions.v2.json ↩

2. This means that every tool that uses Juliaup is indirectly downstream of versions.json. ↩