Skip to content

solidworks_mcp.tools.file_facts

solidworks_mcp.tools.file_facts

Honest filesystem facts for tools that compare files without opening them.

compare_drawing_versions and compare_templates cannot parse SolidWorks file internals, so they report only what the filesystem can say: existence, size, modification time and a content hash.

Functions:

file_fact_snapshot 

file_fact_snapshot(path_str: str) -> dict[str, Any] | None

Read basic filesystem facts about a file: size, mtime, SHA-256.

Parameters:

Name Type Description Default
path_str str

Path to the file.

 required

Returns:

Type Description
dict[str, Any] | None

dict[str, Any] | None: path, size_bytes, modified_time and
dict[str, Any] | None

sha256; None when the path is empty or not an existing file.
Source code in src/solidworks_mcp/tools/file_facts.py 
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
def file_fact_snapshot(path_str: str) -> dict[str, Any] | None:
    """Read basic filesystem facts about a file: size, mtime, SHA-256.

    Args:
        path_str: Path to the file.

    Returns:
        dict[str, Any] | None: ``path``, ``size_bytes``, ``modified_time`` and
        ``sha256``; ``None`` when the path is empty or not an existing file.
    """
    if not path_str:
        return None
    path = pathlib.Path(path_str)
    if not path.is_file():
        return None
    stat = path.stat()
    digest = hashlib.sha256()
    with path.open("rb") as handle:
        for chunk in iter(lambda: handle.read(1024 * 1024), b""):
            digest.update(chunk)
    return {
        "path": str(path),
        "size_bytes": stat.st_size,
        "modified_time": stat.st_mtime,
        "sha256": digest.hexdigest(),
    }