docker-diff 0.0.2__py3-none-any.whl → 0.0.4__py3-none-any.whl

{docker_diff-0.0.2.dist-info → docker_diff-0.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docker-diff
-Version: 0.0.2
+Version: 0.0.4
 Summary: Docker Image Comparison Database Manager
 License: This is free and unencumbered software released into the public domain.
         

docker_diff-0.0.4.dist-info/RECORD

@@ -0,0 +1,10 @@
+docker_diff-0.0.4.dist-info/licenses/LICENSE,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
+docker_diff_pkg/__init__.py,sha256=aG5WUO74Z5ax04A5iwh6thCpHcFXBsdH5v-ph-uUJuI,321
+docker_diff_pkg/_version.py,sha256=QlXZ5JTjE_pgpDaeHk0GTExkc75xUZFmd0hA7kGYCJ0,704
+docker_diff_pkg/cli.py,sha256=iXC5GR1jCzhmJpFCSJHSujL3vdAkXQOpeOtBJYGQy_A,15983
+docker_diff_pkg/schema.sql,sha256=xI3kOohbUEzwFhmIGQs2_abN_tJn1BBdAya7tVbw6n8,5477
+docker_diff-0.0.4.dist-info/METADATA,sha256=OlE5flK3eKlHJEwHEv6JnuTUSLd-rOL8qevNyUnGfkM,1654
+docker_diff-0.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+docker_diff-0.0.4.dist-info/entry_points.txt,sha256=nEDTWZsgB5fRJgeXHJbXJyaHKMmKyN9Qypf3X78tosw,57
+docker_diff-0.0.4.dist-info/top_level.txt,sha256=GB5Qrc3AH1pk0543cQz9SRNr5Fatrj-c0Cdp3rCvTM8,16
+docker_diff-0.0.4.dist-info/RECORD,,

docker_diff-0.0.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+docker-diff = docker_diff_pkg.cli:main

docker_diff-0.0.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+docker_diff_pkg

docker_diff_pkg/__init__.py

@@ -0,0 +1,10 @@
+"""
+Docker Image Comparison Database Manager
+Provides functions to store and query Docker image file comparison results in SQLite
+"""
+
+from .cli import DockerImageDB, main
+try:
+    from ._version import version as __version__
+except Exception:  # pragma: no cover - fallback for editable/no-scm
+    __version__ = "0.0.0"

docker_diff_pkg/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.0.4'
+__version_tuple__ = version_tuple = (0, 0, 4)
+
+__commit_id__ = commit_id = None

docker_diff.py → docker_diff_pkg/cli.py

@@ -20,10 +20,18 @@ class DockerImageDB:
     def init_database(self):
         """Initialize the database with schema"""
         with sqlite3.connect(self.db_path) as conn:
-            # Read and execute schema
-            schema_path = Path(__file__).parent / "schema.sql"
-            with open(schema_path) as f:
-                conn.executescript(f.read())
+            # Read schema using importlib.resources for proper packaging
+            try:
+                import importlib.resources as pkg_resources
+                with pkg_resources.files('docker_diff_pkg').joinpath('schema.sql').open('r') as f:
+                    schema_content = f.read()
+            except (ImportError, AttributeError):
+                # Fallback for Python < 3.9
+                import importlib_resources as pkg_resources
+                with pkg_resources.files('docker_diff_pkg').joinpath('schema.sql').open('r') as f:
+                    schema_content = f.read()
+            
+            conn.executescript(schema_content)
     
     def add_image(self, name: str, digest: str = None, size_bytes: int = None) -> int:
         """Add an image to the database, return image_id"""

docker_diff_pkg/schema.sql

@@ -0,0 +1,138 @@
+-- SQLite schema for Docker image file comparison results
+-- This database stores file listings and comparison results across multiple images
+
+-- Table to store unique images being analyzed
+CREATE TABLE IF NOT EXISTS images (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE,           -- e.g., 'ubuntu:20.04'
+    digest TEXT,                         -- SHA256 digest if available
+    size_bytes INTEGER,                  -- Total image size
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    scanned_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Table to store files found in each image
+CREATE TABLE IF NOT EXISTS files (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    image_id INTEGER NOT NULL,
+    file_path TEXT NOT NULL,             -- Full path: /usr/bin/curl
+    file_size INTEGER,                   -- Size in bytes
+    file_mode TEXT,                      -- File permissions (optional)
+    modified_time INTEGER,              -- Unix timestamp
+    file_type TEXT DEFAULT 'file',      -- 'file', 'directory', 'symlink'
+    checksum TEXT,                       -- MD5/SHA256 if calculated
+    FOREIGN KEY (image_id) REFERENCES images(id) ON DELETE CASCADE,
+    UNIQUE(image_id, file_path)
+);
+
+-- Table to store comparison sessions
+CREATE TABLE IF NOT EXISTS comparisons (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT,                           -- Optional comparison name
+    description TEXT,                    -- Optional description
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Junction table linking images to comparisons
+CREATE TABLE IF NOT EXISTS comparison_images (
+    comparison_id INTEGER NOT NULL,
+    image_id INTEGER NOT NULL,
+    FOREIGN KEY (comparison_id) REFERENCES comparisons(id) ON DELETE CASCADE,
+    FOREIGN KEY (image_id) REFERENCES images(id) ON DELETE CASCADE,
+    PRIMARY KEY (comparison_id, image_id)
+);
+
+-- Table to store file differences between images
+CREATE TABLE IF NOT EXISTS file_differences (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    comparison_id INTEGER NOT NULL,
+    file_path TEXT NOT NULL,
+    difference_type TEXT NOT NULL,       -- 'added', 'removed', 'modified', 'common'
+    source_image_id INTEGER,             -- Image where file exists/existed
+    target_image_id INTEGER,             -- Image being compared to
+    old_size INTEGER,                    -- Previous size (for modified files)
+    new_size INTEGER,                    -- New size (for modified files)
+    size_change INTEGER,                 -- Calculated: new_size - old_size
+    FOREIGN KEY (comparison_id) REFERENCES comparisons(id) ON DELETE CASCADE,
+    FOREIGN KEY (source_image_id) REFERENCES images(id),
+    FOREIGN KEY (target_image_id) REFERENCES images(id)
+);
+
+-- Table for summary statistics per comparison
+CREATE TABLE IF NOT EXISTS comparison_stats (
+    comparison_id INTEGER PRIMARY KEY,
+    total_files_compared INTEGER,
+    files_added INTEGER,
+    files_removed INTEGER,
+    files_modified INTEGER,
+    files_common INTEGER,
+    total_size_change INTEGER,           -- Net size change in bytes
+    largest_file_added TEXT,             -- Path to largest added file
+    largest_file_removed TEXT,           -- Path to largest removed file
+    FOREIGN KEY (comparison_id) REFERENCES comparisons(id) ON DELETE CASCADE
+);
+
+-- Indexes for better query performance
+CREATE INDEX IF NOT EXISTS idx_files_image_id ON files(image_id);
+CREATE INDEX IF NOT EXISTS idx_files_path ON files(file_path);
+CREATE INDEX IF NOT EXISTS idx_files_size ON files(file_size);
+CREATE INDEX IF NOT EXISTS idx_differences_comparison ON file_differences(comparison_id);
+CREATE INDEX IF NOT EXISTS idx_differences_type ON file_differences(difference_type);
+CREATE INDEX IF NOT EXISTS idx_differences_path ON file_differences(file_path);
+
+-- Views for common queries
+
+-- View: Files unique to each image in a comparison
+CREATE VIEW IF NOT EXISTS unique_files AS
+SELECT 
+    c.name as comparison_name,
+    i.name as image_name,
+    f.file_path,
+    f.file_size,
+    'unique' as status
+FROM files f
+JOIN images i ON f.image_id = i.id
+JOIN comparison_images ci ON i.id = ci.image_id
+JOIN comparisons c ON ci.comparison_id = c.id
+WHERE f.file_path NOT IN (
+    SELECT DISTINCT f2.file_path 
+    FROM files f2 
+    JOIN comparison_images ci2 ON f2.image_id = ci2.image_id 
+    WHERE ci2.comparison_id = ci.comparison_id 
+    AND f2.image_id != f.image_id
+);
+
+-- View: Files common across all images in a comparison
+CREATE VIEW IF NOT EXISTS common_files AS
+SELECT 
+    c.name as comparison_name,
+    f.file_path,
+    COUNT(DISTINCT f.image_id) as image_count,
+    MIN(f.file_size) as min_size,
+    MAX(f.file_size) as max_size,
+    AVG(f.file_size) as avg_size
+FROM files f
+JOIN images i ON f.image_id = i.id
+JOIN comparison_images ci ON i.id = ci.image_id
+JOIN comparisons c ON ci.comparison_id = c.id
+GROUP BY c.id, f.file_path
+HAVING COUNT(DISTINCT f.image_id) = (
+    SELECT COUNT(*) 
+    FROM comparison_images ci2 
+    WHERE ci2.comparison_id = c.id
+);
+
+-- View: Size comparison between images
+CREATE VIEW IF NOT EXISTS image_sizes AS
+SELECT 
+    c.name as comparison_name,
+    i.name as image_name,
+    COUNT(f.id) as file_count,
+    SUM(f.file_size) as total_file_size,
+    AVG(f.file_size) as avg_file_size,
+    MAX(f.file_size) as largest_file_size
+FROM images i
+JOIN files f ON i.id = f.image_id
+JOIN comparison_images ci ON i.id = ci.image_id
+JOIN comparisons c ON ci.comparison_id = c.id
+GROUP BY c.id, i.id;

docker_diff-0.0.2.dist-info/RECORD

@@ -1,7 +0,0 @@
-docker_diff.py,sha256=_Jt20fhQqZQGac-PacGyV9IU10FXNoCrc6lqlZe4Gps,15516
-docker_diff-0.0.2.dist-info/licenses/LICENSE,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
-docker_diff-0.0.2.dist-info/METADATA,sha256=BLooTmbTBpdHy8SGPYURksA-bIBvA6uxfQ-CildqBkY,1654
-docker_diff-0.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-docker_diff-0.0.2.dist-info/entry_points.txt,sha256=Hknxh2UZBgBH5Lwe55BK5Gh813R1qHZSPIYQ9dzKQXk,49
-docker_diff-0.0.2.dist-info/top_level.txt,sha256=HSDBG4y8znoDTP5jcUCH2gZZ-qiZW0_6AsIeXry71Ew,12
-docker_diff-0.0.2.dist-info/RECORD,,

docker_diff-0.0.2.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-docker-diff = docker_diff:main

docker_diff-0.0.2.dist-info/top_level.txt

@@ -1 +0,0 @@
-docker_diff