test-action-debian-package/node_modules/docker-hub-utils/README.md
Dawid Dziurla 9308795b8b
update
2020-03-26 15:37:35 +01:00

51 lines
2.1 KiB
Markdown

<p align="center">
<a href="https://github.com/jessestuart/docker-hub-utils">
<img
src="https://github.com/jessestuart/docker-hub-utils/blob/master/assets/nodejs-docker.png?raw=true"
width="50%"
/>
</a>
</p>
<h1 align="center">
docker-hub-utils
</h1>
[![CircleCI][circleci-badge]][circleci-link] [![npm][npm-badge]][npm-link]
[![codecov][codecov]][codecov 2]
### What is this?
`docker-hub-utils` is an [NPM package][npm-link] (packaged to work both in
`node.js` as well as in the browser), providing utility functions wrapping the
[Docker Hub API][docker 2]. 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][docker], 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`][github 2] project, or in this project's test cases.
[circleci-badge]:
https://circleci.com/gh/jessestuart/docker-hub-utils.svg?style=shield
[circleci-link]: https://circleci.com/gh/jessestuart/docker-hub-utils
[codecov 2]: https://codecov.io/gh/jessestuart/docker-hub-utils
[codecov]:
https://codecov.io/gh/jessestuart/docker-hub-utils/branch/master/graph/badge.svg
[docker 2]: https://docs.docker.com/registry/spec/api/
[docker]: https://docs.docker.com/registry/spec/manifest-v2-2/
[github 2]: https://github.com/jessestuart/docker-hub-graphql-api
[github]: https://github.com/jessestuart/multiar.ch
[npm-badge]: https://img.shields.io/npm/v/docker-hub-utils.svg
[npm-link]: https://www.npmjs.com/package/docker-hub-utils