docker-diff 0.0.7__py3-none-any.whl → 0.0.8__py3-none-any.whl

docker_diff-0.0.8.dist-info/METADATA

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: docker-diff
+Version: 0.0.8
+Summary: Docker Image Comparison Database Manager
+License: This is free and unencumbered software released into the public domain.
+        
+        Anyone is free to copy, modify, publish, use, compile, sell, or
+        distribute this software, either in source code form or as a compiled
+        binary, for any purpose, commercial or non-commercial, and by any
+        means.
+        
+        In jurisdictions that recognize copyright laws, the author or authors
+        of this software dedicate any and all copyright interest in the
+        software to the public domain. We make this dedication for the benefit
+        of the public at large and to the detriment of our heirs and
+        successors. We intend this dedication to be an overt act of
+        relinquishment in perpetuity of all present and future rights to this
+        software under copyright law.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+        IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+        OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+        ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+        OTHER DEALINGS IN THE SOFTWARE.
+        
+        For more information, please refer to <https://unlicense.org>
+        
+Project-URL: Repository, https://github.com/eapolinario/docker-diff
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: libsql-client>=0.3
+Dynamic: license-file
+
+docker-diff
+===========
+
+Docker Image Comparison Database Manager. Scans Docker images, stores file listings and comparisons in SQLite, and provides a simple CLI to query results.
+
+Quick Start
+-----------
+
+- Install dependencies and project env (uv):
+  - `uv sync`
+- Run the CLI:
+  - Local: `uv run docker_diff_pkg/cli.py list images`
+  - After install: `docker-diff list images`
+
+Database Backends
+-----------------
+
+This project supports two SQLite-compatible backends:
+
+- Local SQLite file via Python `sqlite3` (default) at `docker_images.db`.
+- Remote Turso via `libsql` Python client.
+
+The database schema initializes automatically on first run from `docker_diff_pkg/schema.sql`.
+
+Using Turso (libsql)
+--------------------
+
+1) Ensure dependency is installed
+- The project declares `libsql-client` in `pyproject.toml`. If you updated sources, run `uv sync`.
+
+2) Set environment variables
+- URL: `TURSO_DATABASE_URL` (preferred) or `LIBSQL_URL`
+- Token: `TURSO_AUTH_TOKEN` or `LIBSQL_AUTH_TOKEN`
+
+Examples (macOS/Linux):
+- Prefer HTTPS (avoids WebSocket restrictions):
+  - `export TURSO_DATABASE_URL="https://<your-db>.turso.io"`
+  - `export TURSO_AUTH_TOKEN="<your-token>"`
+- WebSocket (Hrana) alternative:
+  - `export TURSO_DATABASE_URL="libsql://<your-db>.turso.io"`
+  - `export TURSO_AUTH_TOKEN="<your-token>"`
+
+3) Run a command
+- `uv run docker_diff_pkg/cli.py list images`
+- or: `python -m docker_diff_pkg.cli list images`
+
+Troubleshooting
+---------------
+
+- WebSocket handshake errors (e.g., `WsServerHandshakeError`):
+  - Cause: `libsql://` uses WebSockets (Hrana). Corporate proxies/firewalls often block `wss`.
+  - Fix: Switch to HTTPS: set `TURSO_DATABASE_URL="https://<db>.turso.io"` and keep the same token.
+  - Optional: adjust proxies: unset `HTTP(S)_PROXY`, or set `NO_PROXY="*.turso.io,localhost,127.0.0.1"`.
+
+- Command hangs and does not exit:
+  - The libsql client runs a background event loop thread. The CLI now closes the client on exit. If embedding `DockerImageDB` in your own code, call `db.close()` when done.
+
+- Auth failures (401/403):
+  - Ensure the token belongs to the target DB and hasn’t expired.
+
+CLI Overview
+------------
+
+- Scan images: `docker-diff scan <image...>`
+- Compare images: `docker-diff compare <image...> [--name NAME]`
+- List images: `docker-diff list images`
+- List comparisons: `docker-diff list comparisons`
+- Summary: `docker-diff summary <id>`
+- Unique files: `docker-diff unique <id> [--limit N]`
+
+Development
+-----------
+
+- Build: `make build`
+- Clean: `make clean`
+- Integration Test: `make integration-test`
+- Add dev dep: `uv add --group dev <package>`
+
+Notes
+-----
+
+- Python 3.10+ with type hints.
+- SQLite with proper FKs and indexes; schema in `docker_diff_pkg/schema.sql`.
+- DB access is abstracted to support both backends without changing CLI usage.

docker_diff-0.0.8.dist-info/RECORD

@@ -0,0 +1,10 @@
+docker_diff-0.0.8.dist-info/licenses/LICENSE,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
+docker_diff_pkg/__init__.py,sha256=aG5WUO74Z5ax04A5iwh6thCpHcFXBsdH5v-ph-uUJuI,321
+docker_diff_pkg/_version.py,sha256=j-ar4gJGiWIawqKXhvv9hGJWLfwu0tISl-0GV97B7a0,704
+docker_diff_pkg/cli.py,sha256=C6LYpgFGmiZsBZ8MO4TJKmtKMvg1EqB6qYlpilbq6pI,21549
+docker_diff_pkg/schema.sql,sha256=xI3kOohbUEzwFhmIGQs2_abN_tJn1BBdAya7tVbw6n8,5477
+docker_diff-0.0.8.dist-info/METADATA,sha256=7B6M1QDA_F4YtmzjQduM7KTbmP4_6_P0ii-4QklOqNs,4549
+docker_diff-0.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+docker_diff-0.0.8.dist-info/entry_points.txt,sha256=nEDTWZsgB5fRJgeXHJbXJyaHKMmKyN9Qypf3X78tosw,57
+docker_diff-0.0.8.dist-info/top_level.txt,sha256=GB5Qrc3AH1pk0543cQz9SRNr5Fatrj-c0Cdp3rCvTM8,16
+docker_diff-0.0.8.dist-info/RECORD,,

docker_diff_pkg/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.7'
-__version_tuple__ = version_tuple = (0, 0, 7)
+__version__ = version = '0.0.8'
+__version_tuple__ = version_tuple = (0, 0, 8)
 
 __commit_id__ = commit_id = None

docker_diff-0.0.7.dist-info/METADATA

@@ -1,34 +0,0 @@
-Metadata-Version: 2.4
-Name: docker-diff
-Version: 0.0.7
-Summary: Docker Image Comparison Database Manager
-License: This is free and unencumbered software released into the public domain.
-        
-        Anyone is free to copy, modify, publish, use, compile, sell, or
-        distribute this software, either in source code form or as a compiled
-        binary, for any purpose, commercial or non-commercial, and by any
-        means.
-        
-        In jurisdictions that recognize copyright laws, the author or authors
-        of this software dedicate any and all copyright interest in the
-        software to the public domain. We make this dedication for the benefit
-        of the public at large and to the detriment of our heirs and
-        successors. We intend this dedication to be an overt act of
-        relinquishment in perpetuity of all present and future rights to this
-        software under copyright law.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-        IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
-        OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-        ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-        OTHER DEALINGS IN THE SOFTWARE.
-        
-        For more information, please refer to <https://unlicense.org>
-        
-Project-URL: Repository, https://github.com/eapolinario/docker-diff
-Requires-Python: >=3.10
-License-File: LICENSE
-Requires-Dist: libsql-client>=0.3
-Dynamic: license-file

docker_diff-0.0.7.dist-info/RECORD

@@ -1,10 +0,0 @@
-docker_diff-0.0.7.dist-info/licenses/LICENSE,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
-docker_diff_pkg/__init__.py,sha256=aG5WUO74Z5ax04A5iwh6thCpHcFXBsdH5v-ph-uUJuI,321
-docker_diff_pkg/_version.py,sha256=AV58KqMkBGaCvmPdbd3g9huyNXfIVxjw8QbCMdaeivU,704
-docker_diff_pkg/cli.py,sha256=C6LYpgFGmiZsBZ8MO4TJKmtKMvg1EqB6qYlpilbq6pI,21549
-docker_diff_pkg/schema.sql,sha256=xI3kOohbUEzwFhmIGQs2_abN_tJn1BBdAya7tVbw6n8,5477
-docker_diff-0.0.7.dist-info/METADATA,sha256=na6gAxdT1d2_cZeuQMqfFEu9k7gqUKhPPm-wGGRBr8c,1688
-docker_diff-0.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-docker_diff-0.0.7.dist-info/entry_points.txt,sha256=nEDTWZsgB5fRJgeXHJbXJyaHKMmKyN9Qypf3X78tosw,57
-docker_diff-0.0.7.dist-info/top_level.txt,sha256=GB5Qrc3AH1pk0543cQz9SRNr5Fatrj-c0Cdp3rCvTM8,16
-docker_diff-0.0.7.dist-info/RECORD,,