History

Dawid Dziurla b91baffed3 node_modules: update		2020-11-12 16:37:43 +01:00
..
dist	node_modules: update	2020-11-12 16:37:43 +01:00
package.json	node_modules: update	2020-11-12 16:37:43 +01:00
README.md	update	2020-03-26 15:37:35 +01:00

README.md

docker-hub-utils

What is this?

docker-hub-utils is an NPM package (packaged to work both in node.js as well as in the browser), providing utility functions wrapping the Docker Hub API. This was created because the native API provides little to no support for basic operations like filtering queries, and can be quite verbose when e.g., fetching Manifest Lists, which is required to determine which architectures a given image supports.

Currently supported operations

Querying top repos by username / organization name.
Filtering top user / org repositories by date last updated; this is useful when you're only interested in repositories that have been updated in the past N months / years / etc, a feature missing from the native API.
Fetching Manifest Lists for any repository image in a single function call, abstracting away the bearer token authentication dance.

You can see examples of these operations in use within the docker-hub-graphql-api project, or in this project's test cases.