python-dxf

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 on this page — 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

python-dxf on PyPI

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

Evidence: python_dxf-12.1.1-py3-none-any.whl

Keywords: docker, registry

Tags

More Internet packages