This repository hosts the code for generating the SSWG Package Collection, reflecting the SSWG incubated libraries and tools also listed on https://swift.org/server#projects.
The tool uses docker to invoke the Package Collection Generator published by Apple,
having the input captured in packages.json
and output as collection.json
.
The resulting collection.json
is the collection shared with the community.
As such it's URL (https://raw.githubusercontent.com/swift-server/sswg-collection/main/collection.json) needs to stay stable.
The tool is run by a daily (TBD) CI job such that changes to the package list or the package details are reflected quickly.
To invoke the tool locally use docker-compose -f docker/docker-compose.yaml run generate
Note GITHUB_API_TOKEN
is used to interact with GitHub and obtain metadata about the packages.
Checkouts are cached in a .cache
directory to speed up subsequent runs.