Python library for interacting with container image registries
Project description
pyregistry
pyregistry is a Python library and CLI tool for inspecting and copying container image data from and between registries.
This library primarily focuses on being a useful tool for dealing with container image registries. It has very limited support for interpretation of the objects stored within.
Library usage
Find sub-manifest based on platform.
async with AsyncRegistryClient() as client:
manifest_ref = parse_image_name("alpine")
manifest = await client.manifest_download(manifest_ref)
if isinstance(manifest, ManifestListV2S2):
for sub_manifest in manifest.manifests:
if sub_manifest.platform.architecture == "amd64":
manifest_ref.ref = sub_manifest.digest
manifest = await client.manifest_download(manifest_ref)
break
else:
raise Exception("Found no matching platform")
else:
print("Not a manifest list")
Download layers of an image
for layer in manifest.layers:
assert layer.media_type == "application/vnd.docker.image.rootfs.diff.tar.gzip"
blob_ref = RegistryBlobRef(manifest_ref.registry, manifest_ref.repo, layer.digest)
# For example we just download into memory. In practice don't do this.
blob_data = io.BytesIO(
b"".join([chunk async for chunk in client.ref_content_stream(blob_ref)])
)
with tarfile.open(mode="r|*", fileobj=blob_data) as tar:
for tarinfo in tar.getmembers():
print(tarinfo.name)
CLI copy tool
# By default it will pull credentials based on ~/.docker/config.json
python -m aioregistry ubuntu:18.04 my.private.registry/my-repo:my-tag
# Copy all tags matching regex
python -m aioregistry ubuntu my.private.registry/my-repo --tag-pattern '18\..*'
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
aioregistry-0.6.0.tar.gz
(15.7 kB
view details)
Built Distribution
File details
Details for the file aioregistry-0.6.0.tar.gz
.
File metadata
- Download URL: aioregistry-0.6.0.tar.gz
- Upload date:
- Size: 15.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.8.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2225e2aa040cc55fbbe097f252a5a9278fa0d61e4eabf98face8f215f4d62426 |
|
MD5 | dd23c2a3fe69ab8bc84d0e9c02a1d881 |
|
BLAKE2b-256 | 21176ab2be580b01b0bb9c15cd55e1a18510968642f379c6058e2a787bed7ec6 |
File details
Details for the file aioregistry-0.6.0-py3-none-any.whl
.
File metadata
- Download URL: aioregistry-0.6.0-py3-none-any.whl
- Upload date:
- Size: 17.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.8.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4f7c1f23c316c9cd5ecdf946d31dc10731a07feed16500c5c9d2968aa2136b76 |
|
MD5 | fed8edd1690c6c41056107006164b0e2 |
|
BLAKE2b-256 | c4f681835cf19150fc2bf21a05a954553960f9186aa0a5533905bfdccd5a8530 |