win-depends 0.1.0__tar.gz

win_depends-0.1.0/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: win_depends
+Version: 0.1.0
+Summary: A tool to analyze Windows DLL/EXE dependencies
+Author: Vorga
+Author-email: Your Name <you@example.com>
+License: MIT
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: pefile
+Requires-Dist: tqdm
+Dynamic: author
+Dynamic: requires-python
+
+# depends
+
+🧩 Windows DLL/EXE Dependency Tree Analyzer using `dumpbin`.
+
+This tool analyzes dependencies of `.dll` or `.exe` files on Windows, builds a dependency tree, and reports missing dependencies. It uses `dumpbin.exe` from Visual Studio toolchains.
+
+## 🔧 Features
+
+- Automatically finds `dumpbin.exe`
+- Supports both single file and directory analysis
+- Outputs:
+  - Tree structure with optional max depth
+  - DOT graph format for Graphviz
+  - Missing dependency check
+- Optional inclusion of system DLLs
+- Threaded for performance
+
+## 📦 Installation
+
+```bash
+pip install .

win_depends-0.1.0/README.md

@@ -0,0 +1,21 @@
+# depends
+
+🧩 Windows DLL/EXE Dependency Tree Analyzer using `dumpbin`.
+
+This tool analyzes dependencies of `.dll` or `.exe` files on Windows, builds a dependency tree, and reports missing dependencies. It uses `dumpbin.exe` from Visual Studio toolchains.
+
+## 🔧 Features
+
+- Automatically finds `dumpbin.exe`
+- Supports both single file and directory analysis
+- Outputs:
+  - Tree structure with optional max depth
+  - DOT graph format for Graphviz
+  - Missing dependency check
+- Optional inclusion of system DLLs
+- Threaded for performance
+
+## 📦 Installation
+
+```bash
+pip install .

win_depends-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "win_depends"
+version = "0.1.0"
+description = "A tool to analyze Windows DLL/EXE dependencies"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+authors = [
+    {name = "Your Name", email = "you@example.com"}
+]
+dependencies = [
+    "pefile",
+    "tqdm"
+]
+
+[project.scripts]
+win_depends = "win_depends.cli:main"

win_depends-0.1.0/setup.cfg

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

win_depends-0.1.0/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="win_depends",
+    version="0.1.0",
+    description="Windows DLL/EXE dependency tree and graph tool",
+    author="Vorga",
+    license="MIT",
+    packages=find_packages(),
+    entry_points={
+        "console_scripts": [
+            "win_depends=win_depends.cli:main"
+        ],
+    },
+    python_requires=">=3.6",
+    install_requires=[
+        "tqdm>=4.64.1",  # 进度条库（可选）
+        "pefile>=2024.5.17",  # PE文件解析库
+    ],
+)

win_depends-0.1.0/win_depends/cli.py

@@ -0,0 +1,77 @@
+import argparse
+import os
+import sys
+from concurrent.futures import ThreadPoolExecutor
+from .core import (
+    build_dependency_map_for_dir,
+    build_dependency_map_for_file,
+    report_missing_files,
+    report_unused_files,
+    print_tree,
+    export_dot
+)
+
+def main():
+    parser = argparse.ArgumentParser(description="Analyze DLL/EXE dependencies.")
+    parser.add_argument("target", help="Target DLL/EXE file or directory.")
+    parser.add_argument("--tree", nargs="?", const=-1, type=int, metavar="LEVEL",
+                        help="Print dependency tree up to specified depth (default: unlimited).")
+    parser.add_argument("--graph", action="store_true", help="Print dependency graph in DOT format.")
+    parser.add_argument("--dot", metavar="FILENAME", help="Write DOT graph to file.")
+    parser.add_argument("--check-missing", action="store_true", help="Check for missing dependencies.")
+    parser.add_argument("--check-unused", action="store_true", help="Check for unused local DLL/EXE files.")
+    parser.add_argument("--detect-system", action="store_true",
+                        help="Analyze system DLLs (default: off; only analyzes files in current directory).")
+
+    args = parser.parse_args()
+
+    target = args.target
+    is_dir = os.path.isdir(target)
+    is_file = os.path.isfile(target)
+
+    if not is_dir and not (is_file and target.lower().endswith((".dll", ".exe"))):
+        print(f"Error: '{target}' is not a valid DLL/EXE file or directory.")
+        sys.exit(1)
+
+    base_dir = target if is_dir else os.path.dirname(os.path.abspath(target))
+    file_set = {
+        f for f in os.listdir(base_dir)
+        if f.lower().endswith((".dll", ".exe")) and os.path.isfile(os.path.join(base_dir, f))
+    }
+
+    ignore_system = not args.detect_system
+
+    with ThreadPoolExecutor(max_workers=8) as executor:
+        if is_dir:
+            dep_map = build_dependency_map_for_dir(base_dir, file_set, executor,
+                                                    ignore_system=ignore_system,
+                                                    detect_system=args.detect_system)
+        else:
+            dep_map = build_dependency_map_for_file(target, base_dir, file_set, executor,
+                                                    ignore_system=ignore_system,
+                                                    detect_system=args.detect_system)
+
+    print(f"Analyzing dependencies in: {base_dir}")
+
+    missing = set()
+    if args.check_missing or args.tree is not None:
+        missing = report_missing_files(dep_map, base_dir, local_file_set=file_set, detect_system=args.detect_system)
+
+    if args.check_unused:
+        report_unused_files(dep_map, base_dir)
+
+    if args.tree is not None:
+        max_depth = None if args.tree == -1 else args.tree
+        print_tree(dep_map, max_depth=max_depth, missing_set=missing, local_file_set=file_set)
+
+    elif args.graph:
+        dot = export_dot(dep_map)
+        if args.dot:
+            with open(args.dot, "w", encoding="utf-8") as f:
+                f.write(dot)
+            print(f"DOT graph written to: {args.dot}")
+        else:
+            print(dot)
+
+if __name__ == "__main__":
+    main()

win_depends-0.1.0/win_depends/core.py

@@ -0,0 +1,175 @@
+import os
+import shutil
+from collections import defaultdict
+from tqdm import tqdm
+import concurrent.futures
+import pefile
+from functools import lru_cache
+
+def get_env_paths():
+    paths = set()
+    for p in os.environ.get("PATH", "").split(os.pathsep):
+        if os.path.isdir(p):
+            paths.add(os.path.normcase(os.path.abspath(p)))
+    return paths
+
+def is_valid_dependency(filename):
+    return filename.lower().endswith(".dll") or filename.lower().endswith(".exe")
+
+def is_system_dll(filename):
+    name = filename.lower()
+    for path in get_env_paths():
+        candidate = os.path.join(path, name)
+        if os.path.isfile(candidate):
+            return True
+    return False
+
+@lru_cache(maxsize=2048)
+def get_cached_dependents(file_path, ignore_system, local_file_set_key, detect_system):
+    return tuple(get_dependents_uncached(file_path, ignore_system, local_file_set_key, detect_system))
+
+def get_dependents_uncached(file_path, ignore_system, local_file_set_key, detect_system):
+    try:
+        pe = pefile.PE(file_path, fast_load=True)
+        pe.parse_data_directories()
+        deps = set()
+        for attr in ['DIRECTORY_ENTRY_IMPORT', 'DIRECTORY_ENTRY_DELAY_IMPORT', 'DIRECTORY_ENTRY_BOUND_IMPORT']:
+            entries = getattr(pe, attr, [])
+            for entry in entries:
+                dll = (getattr(entry, 'dll', None) or getattr(entry, 'name', b'')).decode(errors='ignore')
+                if is_valid_dependency(dll) and not (ignore_system and is_system_dll(dll)):
+                    deps.add(dll)
+        return list(deps)
+    except Exception:
+        return []
+
+def get_dependents(file_path, ignore_system=True, local_file_set=None, detect_system=False):
+    key = frozenset(local_file_set or [])
+    return list(get_cached_dependents(file_path, ignore_system, key, detect_system))
+
+def build_dependency_map_for_dir(base_dir, local_file_set, executor, ignore_system=True, detect_system=False):
+    dep_map = defaultdict(list)
+    def analyze_file(file):
+        full_path = os.path.join(base_dir, file)
+        deps = get_dependents(full_path, ignore_system=ignore_system, local_file_set=local_file_set, detect_system=detect_system)
+        return file, deps
+
+    files = [entry.name for entry in os.scandir(base_dir)
+        if entry.is_file() and entry.name.lower().endswith((".dll", ".exe"))]
+
+    futures = {executor.submit(analyze_file, file): file for file in files}
+    for future in tqdm(concurrent.futures.as_completed(futures), total=len(futures), desc="Analyzing files", unit="file"):
+        file, deps = future.result()
+        dep_map[file] = deps
+    return dep_map
+
+def build_dependency_map_for_file(file_path, base_dir, local_file_set, executor, ignore_system=True, detect_system=False):
+    dep_map = defaultdict(list)
+    visited = set()
+    futures = {}
+
+    def submit(file):
+        if file in visited or file not in local_file_set:
+            return
+        visited.add(file)
+        full_path = os.path.join(base_dir, file)
+        futures[file] = executor.submit(get_dependents, full_path, ignore_system, local_file_set, detect_system)
+
+    root_file = os.path.basename(file_path)
+    submit(root_file)
+
+    with tqdm(total=1, desc="Resolving dependencies", unit="file") as pbar:
+        while futures:
+            done_files = list(futures.keys())
+            for file in done_files:
+                future = futures.pop(file)
+                deps = future.result()
+                dep_map[file] = deps
+                for dep in deps:
+                    if dep not in visited and dep in local_file_set:
+                        submit(dep)
+                        pbar.total += 1
+                        pbar.refresh()
+                pbar.update(1)
+
+    return dep_map
+
+@lru_cache(maxsize=2)
+def get_all_present_files(base_dir):
+    present = set()
+    for root, _, files in os.walk(base_dir):
+        for name in files:
+            if name.lower().endswith((".dll", ".exe")):
+                present.add(name)
+    return present
+
+def report_missing_files(dep_map, base_dir, local_file_set, detect_system=False):
+    all_required = set()
+    for deps in dep_map.values():
+        all_required.update(deps)
+
+    present_files = get_all_present_files(base_dir)
+
+    missing = sorted(
+        dep for dep in (all_required - present_files)
+        if not is_system_dll(dep)
+    )
+
+    if not missing:
+        print("No missing dependencies.")
+    else:
+        print("Missing dependencies:")
+        for f in missing:
+            print(f"  {f}")
+
+    return set(missing)
+
+def report_unused_files(dep_map, base_dir):
+    required = set()
+    for deps in dep_map.values():
+        required.update(deps)
+    used = required.union(dep_map.keys())
+
+    present_files = get_all_present_files(base_dir)
+    unused = sorted(present_files - used)
+
+    if not unused:
+        print("No unused files.")
+    else:
+        print("Unused files:")
+        for f in unused:
+            print(f"  {f}")
+
+def print_tree(dep_map, max_depth=None, missing_set=None, local_file_set=None):
+    def recurse(file, prefix="", is_last=True, depth=0, path=None):
+        if path is None:
+            path = set()
+        connector = "└── " if is_last else "├── "
+        label = file
+        is_circular = file in path
+        if is_circular:
+            label += " 🔁"
+        if missing_set and file in missing_set:
+            label += " ❌"
+        print(f"{prefix}{connector}{label}")
+        if is_circular or (max_depth is not None and depth >= max_depth):
+            return
+        path.add(file)
+        children = [c for c in dep_map.get(file, []) if c != file]
+        for idx, dep in enumerate(children):
+            last = idx == len(children) - 1
+            new_prefix = prefix + ("    " if is_last else "│   ")
+            recurse(dep, new_prefix, last, depth + 1, path)
+        path.remove(file)
+
+    roots = list(dep_map.keys())
+    for idx, root in enumerate(roots):
+        recurse(root, "", idx == len(roots) - 1)
+
+def export_dot(dep_map):
+    lines = ["digraph G {"]
+    for src, deps in dep_map.items():
+        for dep in deps:
+            lines.append(f'    "{src}" -> "{dep}";')
+    lines.append("}")
+    return "\n".join(lines)

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

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: win_depends
+Version: 0.1.0
+Summary: A tool to analyze Windows DLL/EXE dependencies
+Author: Vorga
+Author-email: Your Name <you@example.com>
+License: MIT
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: pefile
+Requires-Dist: tqdm
+Dynamic: author
+Dynamic: requires-python
+
+# depends
+
+🧩 Windows DLL/EXE Dependency Tree Analyzer using `dumpbin`.
+
+This tool analyzes dependencies of `.dll` or `.exe` files on Windows, builds a dependency tree, and reports missing dependencies. It uses `dumpbin.exe` from Visual Studio toolchains.
+
+## 🔧 Features
+
+- Automatically finds `dumpbin.exe`
+- Supports both single file and directory analysis
+- Outputs:
+  - Tree structure with optional max depth
+  - DOT graph format for Graphviz
+  - Missing dependency check
+- Optional inclusion of system DLLs
+- Threaded for performance
+
+## 📦 Installation
+
+```bash
+pip install .

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

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+setup.py
+win_depends/__init__.py
+win_depends/cli.py
+win_depends/core.py
+win_depends.egg-info/PKG-INFO
+win_depends.egg-info/SOURCES.txt
+win_depends.egg-info/dependency_links.txt
+win_depends.egg-info/entry_points.txt
+win_depends.egg-info/requires.txt
+win_depends.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+[console_scripts]
+win_depends = win_depends.cli:main

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

@@ -0,0 +1,2 @@
+pefile
+tqdm

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

@@ -0,0 +1 @@
+win_depends