#docker #registry #http-api #async

docker-registry

A pure-Rust asynchronous library for Docker Registry HTTP API v2

1 unstable release

0.6.0 Aug 23, 2024

#2069 in Network programming

MIT/Apache

81KB
2K SLoC

Docker Registry

A pure-Rust asynchronous library for the Docker Registry HTTP API v2.

docker-registry provides support for asynchronous interaction with container registries conformant to the Docker Registry HTTP API v2 specification.

Configurable features

The following is a list of Cargo features that consumers can enable or disable:

  • reqwest-default-tls (enabled by default): provides TLS support via system-specific library (OpenSSL on Linux)
  • reqwest-rustls: provides TLS support via the rustls library

Testing

Integration tests

This library relies on the mockito framework for mocking.

Interoperability tests

This library includes additional interoperability tests against some of the most common registries.

Those tests are not run by default as they require network access and registry credentials.

They are gated behind a dedicated "test-net-private" feature and can be run as:

cargo test --features test-net-private

Credentials for those registries must be provided via environmental flags.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~11–25MB
~373K SLoC