docker-assemble 0.1.0__tar.gz

docker_assemble-0.1.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: docker-assemble
+Version: 0.1.0
+Summary: A CLI tool to extract and analyze Docker images
+Author: Sina Kashipazha
+License: Apache-2.0
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: docker>=6.0.0
+
+# docker-assemble
+
+A CLI tool to extract and analyze Docker images for research & optimization purposes.
+
+## Installation
+
+```bash
+pip install docker-assemble
+```
+
+## Usage
+
+```bash
+docker-assemble -d ubuntu:20.04 output_dir
+```

docker_assemble-0.1.0/README.md

@@ -0,0 +1,15 @@
+# docker-assemble
+
+A CLI tool to extract and analyze Docker images for research & optimization purposes.
+
+## Installation
+
+```bash
+pip install docker-assemble
+```
+
+## Usage
+
+```bash
+docker-assemble -d ubuntu:20.04 output_dir
+```

docker_assemble-0.1.0/docker_assemble/docker_utils.py

@@ -0,0 +1,5 @@
+import docker
+
+def list_docker_images():
+    client = docker.from_env()
+    return client.images.list()

docker_assemble-0.1.0/docker_assemble/image_exporter.py

@@ -0,0 +1,68 @@
+import docker
+import tarfile
+import tempfile
+import os
+import shutil
+from pathlib import Path
+import logging
+
+def extract_image(image_name: str, output_dir: str):
+    client = docker.from_env()
+
+    try:
+        image = client.images.get(image_name)
+        logging.info(f"Image '{image_name}' found locally.")
+    except docker.errors.ImageNotFound:
+        logging.info(f"Image '{image_name}' not found locally. Pulling...")
+        image = client.images.pull(image_name)
+
+    container = client.containers.run(image=image_name, command="sleep infinity", detach=True)
+    logging.debug(f"Created temporary container: {container.id[:12]}")
+
+    try:
+        stream, _ = container.get_archive("/")
+        tmp_tar_path = tempfile.mktemp(suffix=".tar")
+        with open(tmp_tar_path, "wb") as f:
+            for chunk in stream:
+                f.write(chunk)
+
+        logging.debug(f"Filesystem archive saved to: {tmp_tar_path}")
+
+        output_path = Path(output_dir).resolve()
+        output_path.mkdir(parents=True, exist_ok=True)
+
+        extract_tar_safely(tmp_tar_path, output_path)
+
+        logging.info(f"Image filesystem extracted to: {output_path}")
+
+    finally:
+        container.remove(force=True)
+        if os.path.exists(tmp_tar_path):
+            os.remove(tmp_tar_path)
+        logging.debug("Cleaned up temporary container and tar file.")
+
+
+def extract_tar_safely(tar_path: str, output_path: Path):
+    # def is_safe_path(base: Path, target: Path) -> bool:
+    #     try:
+    #         return target.resolve().is_relative_to(base.resolve())
+    #     except AttributeError:
+    #         # For Python < 3.9 fallback
+    #         return str(target.resolve()).startswith(str(base.resolve()))
+
+    with tarfile.open(tar_path, "r") as tar:
+        for member in tar.getmembers():
+            member.name = member.name.lstrip("/")
+            member_path = output_path / member.name
+
+            # if not is_safe_path(output_path, member_path):
+            #     logging.warning(f"Blocked unsafe path: {member.name}, output_path: {output_path}, member_path: {member_path}")
+            #     continue
+
+            tar.extract(member, path=output_path)
+            logging.debug(f"Extracted: {member.name}")
+
+    logging.info(f"Extraction completed to: {output_path}")
+
+
+

docker_assemble-0.1.0/docker_assemble/main.py

@@ -0,0 +1,18 @@
+import argparse
+import logging
+import os
+from docker_assemble.image_exporter import extract_image
+
+def run():
+    parser = argparse.ArgumentParser(description="Docker Assemble CLI")
+    parser.add_argument("-d", action="store_true", help="Disassemble an image")
+    parser.add_argument("--debug", action="store_true", help="Enable debug mode")
+    parser.add_argument("image", help="Docker image name")
+    parser.add_argument("output_dir", nargs="?", default=".", help="Optional output directory")
+
+    args = parser.parse_args()
+
+    logging.basicConfig(level=logging.DEBUG if args.debug else logging.INFO)
+
+    logging.debug(f"Extracting image: {args.image} to directory: {args.output_dir}")
+    extract_image(image_name=args.image, output_dir=args.output_dir)

docker_assemble-0.1.0/docker_assemble.egg-info/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: docker-assemble
+Version: 0.1.0
+Summary: A CLI tool to extract and analyze Docker images
+Author: Sina Kashipazha
+License: Apache-2.0
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: docker>=6.0.0
+
+# docker-assemble
+
+A CLI tool to extract and analyze Docker images for research & optimization purposes.
+
+## Installation
+
+```bash
+pip install docker-assemble
+```
+
+## Usage
+
+```bash
+docker-assemble -d ubuntu:20.04 output_dir
+```

docker_assemble-0.1.0/docker_assemble.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+setup.py
+docker_assemble/__init__.py
+docker_assemble/docker_utils.py
+docker_assemble/image_exporter.py
+docker_assemble/main.py
+docker_assemble.egg-info/PKG-INFO
+docker_assemble.egg-info/SOURCES.txt
+docker_assemble.egg-info/dependency_links.txt
+docker_assemble.egg-info/entry_points.txt
+docker_assemble.egg-info/requires.txt
+docker_assemble.egg-info/top_level.txt

docker_assemble-0.1.0/docker_assemble.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

docker_assemble-0.1.0/docker_assemble.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+docker-assemble = docker_assemble.main:run

docker_assemble-0.1.0/docker_assemble.egg-info/requires.txt

@@ -0,0 +1 @@
+docker>=6.0.0

docker_assemble-0.1.0/docker_assemble.egg-info/top_level.txt

@@ -0,0 +1 @@
+docker_assemble

docker_assemble-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "docker-assemble"
+version = "0.1.0"
+description = "A CLI tool to extract and analyze Docker images"
+readme = "README.md"
+authors = [{ name = "Sina Kashipazha"}]
+license = { text = "Apache-2.0" }
+requires-python = ">=3.8"
+dependencies = [
+  "docker>=6.0.0"
+]
+
+[project.scripts]
+docker-assemble = "docker_assemble.main:run"

docker_assemble-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

docker_assemble-0.1.0/setup.py

@@ -0,0 +1,16 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="docker-assemble",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=["docker"],
+    entry_points={
+        "console_scripts": [
+            "docker-assemble=docker_assemble.main:run",
+        ],
+    },
+    license="Apache-2.0",
+    author="Sina",
+    description="A CLI tool to extract and analyze Docker images",
+)