---
id: python-dxf
version: "12.1.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# python-dxf — Package for accessing a Docker v2 registry

License: permissive · Maintenance: aging · Downloads: 161.7K/mo

## What it is and what it does

python-dxf is a Python module and CLI tool for storing and retrieving arbitrary data in Docker registries. It treats registries as blob stores, allowing you to push files, retrieve them by content hash or named alias, and manage those aliases—all without generating Docker container configurations. The package implements Docker registry schema v2 and requires Python 3.8+.

You interact with it either programmatically (importing DXF and calling methods like push_blob, pull_blob, set_alias) or via command-line commands (dxf push-blob, dxf pull-blob, dxf set-alias). It handles authentication automatically using environment variables or explicit credentials, supports TLS verification options, and can display progress bars during transfers. The core dependencies are requests for HTTP, www-authenticate for parsing auth headers, and tqdm for progress display.

Use it for:

- Store and retrieve non-container data (logs, datasets, configs) in a Docker registry as a generic blob store
- Set up named aliases to blob digests for easier reference and retrieval without remembering content hashes
- Cross-mount blobs between repositories in the same registry to avoid re-uploading identical data
- Automate data transfer workflows using the CLI with environment variable configuration
- Integrate registry-backed blob storage into Python applications via the module API

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Stores and retrieves arbitrary data blobs in Docker registries using content addressing and named aliases, accessible via Python module or command-line tool.

Yes, if you need to use a Docker registry as a generic blob store and are comfortable with the aging maintenance status. The package is stable, has no known vulnerabilities, and low install friction. However, the 466-day gap since last release suggests limited active development; verify it meets your Docker registry version and use case before committing to production.

## Install

pip install python-dxf
uv add python-dxf
poetry add python-dxf

## Installing python-dxf

Before you install: Low install friction with three lightweight runtime dependencies (www-authenticate, requests, tqdm). Maintenance status is aging—last release was 466 days ago, though the repository remains active and not archived.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal legal constraints.

Quickstart:

pip install python-dxf

from dxf import DXF

def auth(dxf, response):
    dxf.authenticate('username', 'password', response=response)

dxf = DXF('registry-1.docker.io', 'user/repo', auth)
dgst = dxf.push_blob('file.dat')
dxf.set_alias('my-alias', dgst)
for chunk in dxf.pull_blob(dgst):
    print(chunk)

Requires Python 3.8 or later; Docker registry must support schema v2; authentication credentials or token must be provided via callback or environment variables.

Verify before relying:

- Whether the package works reliably with current Docker registry implementations beyond schema v2
- Performance characteristics when handling large blobs or high-frequency operations
- Community adoption and real-world usage patterns beyond the stated 161686 monthly downloads

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 161.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

docker registry blob storage, content addressable storage docker, push pull data docker registry, docker registry client python, blob management docker v2, docker-registry, blob-storage, content-addressable

[View on SkillFed](https://skillfed.io/packages/python-dxf) · [View on PyPI](https://pypi.org/project/python-dxf/)