registry-testkit
A minimal, OCI-compliant container registry mock for testing.
Usage
Start a registry in your tests:
use registry_testkit::{RegistryConfig, RegistryServer};
#[tokio::test]
async fn test_docker_operations() {
let config = RegistryConfig::memory();
let server = RegistryServer::new(config).await.unwrap();
let registry_url = server.url();
let port = server.port();
}
Configuration
let config = RegistryConfig::memory();
let config = RegistryConfig::temp_dir();
let config = RegistryConfig::memory().with_port(5000);
let config = RegistryConfig::memory().with_host("127.0.0.1");
Example Tests
See tests/integration_test.rs for complete examples:
use bollard::Docker;
use bollard::image::{PushImageOptions, TagImageOptions};
use futures_util::stream::StreamExt;
#[tokio::test]
async fn test_docker_push_pull() {
let config = RegistryConfig::memory();
let server = RegistryServer::new(config).await.unwrap();
let docker = Docker::connect_with_local_defaults().unwrap();
let registry_image = format!("localhost:{}/test:latest", server.port());
docker.tag_image("busybox:latest", Some(TagImageOptions {
repo: format!("localhost:{}/test", server.port()),
tag: "latest".to_string(),
})).await.unwrap();
let mut push = docker.push_image(®istry_image, None::<PushImageOptions<String>>, None);
while let Some(result) = push.next().await {
result.unwrap();
}
}
Features
- Docker Registry HTTP API V2
- OCI Distribution Specification support
- In-memory or filesystem storage
- Automatic port selection
- Compatible with Docker, Podman, and OCI tools
License
Apache-2.0