Support aria2c/aria2p & huge refactor

.gitignore

@@ -0,0 +1,18 @@
+*.log
+.*/
+*/**
+
+**/.idea/
+**/__pycache__/
+**/.pytest_cache/
+**/venv/
+**/.env
+**/*.lock
+**/mirror_cn.py
+
+*.egg-info/
+*.log
+output/
+out/
+./test*.py
+*.egg-info

README.md

@@ -1,8 +1,23 @@
-# docker-drag
+# docker-pull
 This repository contains Python scripts for interacting with Docker Hub or other registries, without needing the Docker client itself.
 
 It relies on the Docker registry [HTTPS API v2](https://docs.docker.com/registry/spec/api/).
 
+## Use aria2c as downloader
+
+You need to install `aria2c` manually.
+
+```sh
+# use pixi as package manager
+pixi global install aria2c
+# install docker-pull
+uv pip install docker_pull[aria2]@git+https://github.com/aclon314/docker-pull.git
+# example
+docker-pull busybox
+```
+
+> Because some huge layers (>5GB) could easily failed to download, and docker/podman DON'T support resume download(though they support cached layers if the layers are 100% downloaded).
+
 ## Pull a Docker image in HTTPS
 
 `python docker_pull.py hello-world`

__init__.py

@@ -0,0 +1,17 @@
+"""
+Usage:
+```python
+puller = DockerPull(
+    args.image,
+    output_path=args.output_path,
+    registry_username=args.username,
+    registry_password=args.password,
+)
+puller.save_image(skip=args.skip, keep_tmp=args.verbose)
+```
+"""
+
+from .docker_pull import (
+    DockerImage,
+    DockerPull,
+)