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.

Development

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.