REST API

[edqx]

It would be quite helpful to many people to make use of a public REST API for Ziglist, so that people can make their own applications that make use of the knowledge available. For example, someone's package manager CLI could make use of the directory, or someone could make a CLI for Ziglist, or a discord bot, etc.

Here's some example endpoints I had in mind:

# get basic statistics about the repository, i.e. package counts
GET /

# get front-page packages
GET /packages?sort=active
GET /packages?sort=new
GET /packages?sort=top

# get package dependencies
GET /deps

# search packages
GET /packages?q=http
GET /packages?q=websocket

# get a specific package by its 'name' on ziglist
GET /packages/karlseguin/http.zig

[pixqc]

Unless there's strong demands, I don't think an API makes sense.

If people want the data Ziglist has, they can:

• pull data from GitHub directly: Ziglist is MIT, just copy-paste the code
• scrape the page, it's raw html
• get the SQLite dump and play with it (https://drive.google.com/file/d/1pL8FhVRSFt82jxeMlYa9ILjvDiCoz2fb/view?usp=share_link)

I think these three solutions work fine for most cases without the overhead of designing+maintaining API endpoints.