dotdiff 0.2.0__py3-none-any.whl

dotdiff/__init__.py

@@ -0,0 +1 @@
+# dotdiff/__init__.py

dotdiff/all_diffs.py

@@ -0,0 +1,37 @@
+import subprocess
+import os
+import sys
+from git import Repo
+from dotdiff.diff_generator import run_pipeline
+
+def get_changed_dot_files(repo_path, commit1="HEAD^", commit2="HEAD"):
+    cmd = ["git", "-C", repo_path, "diff", "--name-only", f"{commit1}", f"{commit2}"]
+    result = subprocess.run(cmd, stdout=subprocess.PIPE, text=True)
+    files = result.stdout.strip().split('\n')
+    return [f for f in files if f.endswith(".dot")]
+
+def run_on_all_changed_dot_files(repo_path, output_dir="dot_diffs", commit1="HEAD^", commit2="HEAD"):
+    changed_files = get_changed_dot_files(repo_path, commit1, commit2)
+
+    if not changed_files or changed_files == ['']:
+        print("[✓] No .dot files changed between commits.")
+        return
+
+    print(f"[i] Changed .dot files: {changed_files}")
+
+    for path in changed_files:
+        safe_name = path.replace("/", "_").replace("\\", "_")
+        output_subdir = os.path.join(output_dir, safe_name)
+        print(f"[→] Running diff for {path}")
+        run_pipeline(repo_path, path, output_dir=output_subdir, commit_old=commit1, commit_new=commit2)
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: dotdiff-all <repo_path> [<commit1> <commit2>]")
+        sys.exit(1)
+
+    repo_path = sys.argv[1]
+    commit1 = sys.argv[2] if len(sys.argv) > 2 else "HEAD^"
+    commit2 = sys.argv[3] if len(sys.argv) > 3 else "HEAD"
+
+    run_on_all_changed_dot_files(repo_path, commit1=commit1, commit2=commit2)

dotdiff/diff_generator.py

@@ -0,0 +1,199 @@
+import pydot
+import json
+import tempfile
+import os
+import sys
+from git import Repo
+
+def parse_dot_content(dot_str):
+    graphs = pydot.graph_from_dot_data(dot_str)
+    return graphs[0] if graphs else None
+
+def normalize_graph(graph):
+    nodes = sorted((n.get_name(), dict(n.get_attributes())) for n in graph.get_nodes() if n.get_name() not in ('node', 'graph', 'edge'))
+    edges = sorted((e.get_source(), e.get_destination(), dict(e.get_attributes())) for e in graph.get_edges())
+    return nodes, edges
+
+def diff_graphs(nodes_old, edges_old, nodes_new, edges_new):
+    node_names_old = {n[0] for n in nodes_old}
+    node_names_new = {n[0] for n in nodes_new}
+
+    added_nodes = [n for n in nodes_new if n[0] not in node_names_old]
+    removed_nodes = [n for n in nodes_old if n[0] not in node_names_new]
+
+    changed_node_attrs = [
+        (n_new[0], n_old[1], n_new[1])
+        for n_old in nodes_old
+        for n_new in nodes_new
+        if n_old[0] == n_new[0] and n_old[1] != n_new[1]
+    ]
+
+    added_edges = [e for e in edges_new if e not in edges_old]
+    removed_edges = [e for e in edges_old if e not in edges_new]
+
+    changed_edge_attrs = [
+        (e_new[0], e_new[1], e_old[2], e_new[2])
+        for e_old in edges_old
+        for e_new in edges_new
+        if e_old[0:2] == e_new[0:2] and e_old[2] != e_new[2]
+    ]
+
+    return {
+        "added_nodes": added_nodes,
+        "removed_nodes": removed_nodes,
+        "changed_node_attrs": changed_node_attrs,
+        "added_edges": added_edges,
+        "removed_edges": removed_edges,
+        "changed_edge_attrs": changed_edge_attrs
+    }
+
+def create_diff_visualization_full(current_graph, diff, output_path="dot_diff_full_visual.png"):
+    graph = pydot.Dot(graph_type=current_graph.get_type())
+
+    # Keep track of what's already added to avoid duplicates
+    added_node_names = set()
+    added_edge_keys = set()
+
+    # Add current nodes and highlight additions/changes
+    for node in current_graph.get_nodes():
+        name = node.get_name()
+        if name in ("node", "graph", "edge"):
+            continue
+        attrs = node.get_attributes()
+        style = {"style": "filled"}
+
+        # Color based on diff
+        if any(n[0] == name for n in diff['added_nodes']):
+            style["fillcolor"] = "green"
+        elif any(n[0] == name for n in diff['changed_node_attrs']):
+            style["fillcolor"] = "yellow"
+        else:
+            style["fillcolor"] = "white"
+
+        graph.add_node(pydot.Node(name, **attrs, **style))
+        added_node_names.add(name)
+
+    # Add deleted nodes (from diff)
+    for name, attrs in diff['removed_nodes']:
+        if name not in added_node_names:
+            style = {"style": "filled,dashed", "fillcolor": "red"}
+            graph.add_node(pydot.Node(name, **attrs, **style))
+            added_node_names.add(name)
+
+    # Add current edges and highlight additions/changes
+    for edge in current_graph.get_edges():
+        src = edge.get_source()
+        dst = edge.get_destination()
+        attrs = edge.get_attributes()
+        edge_key = (src, dst)
+        color = "black"
+
+        if edge_key in [(e[0], e[1]) for e in diff['added_edges']]:
+            color = "green"
+        elif edge_key in [(e[0], e[1]) for e in diff['changed_edge_attrs']]:
+            color = "yellow"
+
+        graph.add_edge(pydot.Edge(src, dst, color=color, **attrs))
+        added_edge_keys.add(edge_key)
+
+    # Add deleted edges
+    for src, dst, attrs in diff['removed_edges']:
+        edge_key = (src, dst)
+        if edge_key not in added_edge_keys:
+            graph.add_edge(pydot.Edge(src, dst, color="red", style="dashed", **attrs))
+            added_edge_keys.add(edge_key)
+
+    graph.write_png(output_path)
+    print(f"[✓] Full diff visualization (with deletions) saved to: {output_path}")
+
+
+def extract_file_from_commit(repo, commit_hash, file_path):
+    try:
+        blob = repo.commit(commit_hash).tree / file_path
+        return blob.data_stream.read().decode()
+    except Exception as e:
+        print(f"[!] Error extracting {file_path} from {commit_hash}: {e}")
+        return None
+
+def run_pipeline(repo_path, dot_file_path, output_dir=".", commit_old="HEAD^", commit_new="HEAD"):
+    repo = Repo(repo_path)
+
+    dot_old = extract_file_from_commit(repo, commit_old, dot_file_path)
+    dot_new = extract_file_from_commit(repo, commit_new, dot_file_path)
+
+    os.makedirs(output_dir, exist_ok=True)
+    visual_path = os.path.join(output_dir, "dot_diff_full_visual.png")
+
+    # Case 1: New file added
+    if not dot_old and dot_new:
+        print(f"[+] {dot_file_path} was added.")
+        graph_new = parse_dot_content(dot_new)
+        if not graph_new:
+            print(f"[!] Failed to parse new DOT file.")
+            return
+
+        nodes_new, edges_new = normalize_graph(graph_new)
+        diff = {
+            "added_nodes": nodes_new,
+            "removed_nodes": [],
+            "changed_node_attrs": [],
+            "added_edges": edges_new,
+            "removed_edges": [],
+            "changed_edge_attrs": []
+        }
+        create_diff_visualization_full(graph_new, diff, output_path=visual_path)
+        return
+
+    # Case 2: File was deleted
+    if dot_old and not dot_new:
+        print(f"[-] {dot_file_path} was deleted.")
+        graph_old = parse_dot_content(dot_old)
+        if not graph_old:
+            print(f"[!] Failed to parse old DOT file.")
+            return
+
+        nodes_old, edges_old = normalize_graph(graph_old)
+        diff = {
+            "added_nodes": [],
+            "removed_nodes": nodes_old,
+            "changed_node_attrs": [],
+            "added_edges": [],
+            "removed_edges": edges_old,
+            "changed_edge_attrs": []
+        }
+        create_diff_visualization_full(graph_old, diff, output_path=visual_path)
+        return
+
+    # Case 3: Normal comparison
+    if dot_old and dot_new:
+        graph_old = parse_dot_content(dot_old)
+        graph_new = parse_dot_content(dot_new)
+
+        if not graph_old or not graph_new:
+            print("[!] Failed to parse one or both DOT files.")
+            return
+
+        nodes_old, edges_old = normalize_graph(graph_old)
+        nodes_new, edges_new = normalize_graph(graph_new)
+
+        diff = diff_graphs(nodes_old, edges_old, nodes_new, edges_new)
+
+        print("[i] Semantic diff JSON:")
+        print(json.dumps(diff, indent=2))
+
+        create_diff_visualization_full(graph_new, diff, output_path=visual_path)
+        return
+
+    # Case 4: File not present in either commit
+    print(f"[!] {dot_file_path} not found in either commit.")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 3:
+        print("Usage: python dot_semantic_ci_diff.py <repo_path> <path/to/file.dot>")
+        sys.exit(1)
+
+    repo_path = sys.argv[1]
+    file_path = sys.argv[2]
+
+    run_pipeline(repo_path, file_path)

dotdiff-0.2.0.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: dotdiff
+Version: 0.2.0
+Summary: Generate semantic visual diffs for DOT graph files in Git repos
+Author-email: Austin Song <austinjsong19@gmail.com>
+License: MIT
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydot
+Requires-Dist: GitPython
+Dynamic: license-file
+
+# dotdiff
+
+A tool to compute semantic differences between `.dot` files in Git repos and generate visual diagrams.
+
+## Installation
+
+```bash
+python -m pip install dotdiff
+```
+
+## Usage
+Coming soon...

dotdiff-0.2.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+dotdiff/__init__.py,sha256=cSqZb_3EOGixp5guExZWJVSShbAkS7GAzxL3bSXqcJc,22
+dotdiff/all_diffs.py,sha256=Tgl4VlDR2AND2REWV11Jlxh2321VzANPdmXh0hsQr7Y,1452
+dotdiff/diff_generator.py,sha256=SyzQeb6Ah6Lu35MDFF8qH-ALVz9kd-7HyTfJkbjFLoo,6831
+dotdiff-0.2.0.dist-info/licenses/LICENSE,sha256=RZ244RdR4HIJ8HKfQOjmBPYTQxoONf9xgmghS-IQT0Y,542
+dotdiff-0.2.0.dist-info/METADATA,sha256=Y95hZCeU1MlvBTsrkHXO2452lw2ZJ20sUOS8zrtL4ok,542
+dotdiff-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+dotdiff-0.2.0.dist-info/entry_points.txt,sha256=1UEQkG0voSaMYGFX2JzddUXfvJcYJsX7Iak1r5qU9Aw,75
+dotdiff-0.2.0.dist-info/top_level.txt,sha256=SyotHTScJ7Pi_OyNmt9W_F-MhOrPXleHAPwKP7lyaec,8
+dotdiff-0.2.0.dist-info/RECORD,,

dotdiff-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dotdiff-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dotdiff = dotdiff.all_diffs:run_on_all_changed_dot_files

dotdiff-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,11 @@
+This software is licensed under a "dual license" model.
+
+You may choose to use, distribute, and modify this software under the terms of:
+
+  - The MIT License (see LICENSES/MIT.txt)
+  - The GNU General Public License v3.0 (GPL-3.0) (see LICENSES/GPL-3.0.txt)
+  - The Apache License, Version 2.0 (see LICENSES/Apache-2.0.txt)
+
+You may select the license that best fits your intended use.
+
+Unless required by applicable law or agreed to in writing, this software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.

dotdiff-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dotdiff