Repository navigation
Add a client libraries page (1.13.83) - #23
Merged
Merged
Conversation
client-libraries.html lists the eight official language clients and seven packages built on them. It is a guide in the GUIDES list. The first table has the install command, the registry, the latest published version, the minimum runtime, the licence and the repository of each package. The second says which of them cover REST, the live stream, file export and MCP. The third shows which endpoint groups each language client reaches. Versions, runtimes and licences were read from PyPI, npm, the Go module proxy, Packagist, NuGet, pub.dev and R-universe on 2026-11-12. The Swift client has no registry, so its version is the newest Git tag. Coverage was read from the source of each published version. Each quick start is the README block of that version, unchanged. scripts/check_client_versions.py reads the registries again and exits 1 when a row is behind. It needs the network, so no workflow runs it. _clients_drift fails the build when the endpoint table names an operation the spec does not define. The docs menu, the docs home, the sitemap, llms.txt and the README link the page. llms.txt also lists the six language clients it did not have. Nothing on the wire changed.
The first cell of each row on the client libraries page is now a row header. A screen reader then names the library next to each value. Inline declarations keep it looking like a data cell. The Python quick start note says the spec lets score be null. The README example reads score.sets without a check. check_client_versions.py always compares an SPDX licence expression, however long it is. Only the older free-text field is skipped when it holds a whole licence text. A version with build metadata after a plus sign counts as a stable release.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
docs/client-libraries.html, a page that lists every official client library with its version, minimum runtime and coverage. Spec version 1.13.83, with a changelog entry. Nothing on the wire changed.What is on the page
The page is a guide in
GUIDES, built likeexport-formats.html. It adds no new component and no CSS. Some cells carry an inlinewhite-spaceoroverflow-wrapso a package name is not split mid-word. The first cell of each row is a row header, styled inline to look like a data cell.Plugins for apps and automation platforms are left out. The page points to the GitHub organisation for those.
Where the facts come from
Three registries are behind their repositories. The page shows what is published: .NET 1.2.1, Dart 1.2.1 and Haystack 0.2.0.
New checks
_clients_driftstops the build when the endpoint table names an operation the spec does not define. It also stops the build when a row changes in a way the prose no longer matches.scripts/check_client_versions.pyreads every registry again. It compares the version, the minimum runtime and the licence with the table. It exits 1 when a row is behind and 2 when a registry could not be read. It needs the network, so no workflow runs it. No workflow changed.Checks run
python3 scripts/build_reference.py --check: generated docs are currentsh scripts/truthcheck.sh: truthcheck OKlint.yml: OK, 48 paths, 49 operations, 66 schemaspython3 scripts/check_client_versions.py: 15 of 15 rows match their registryThe page copy, the changelog entry, the commit message and this text were linted with
hw_lint.py.After merge
The page goes live at https://docs.livetennisapi.com/client-libraries.html when the docs are next published from main. PRs #15 and #16 also change
scripts/build_reference.py, and #15 changesdocs/index.html. Whichever merges later needs a rebase and a rebuild of the generated pages. This PR takes spec version 1.13.83.