From c674599c102adee1882ccb6778e9c819dfccd305 Mon Sep 17 00:00:00 2001 From: Brian Potchik Date: Fri, 30 Jan 2026 14:04:22 -0500 Subject: Improve filename handling for container files. --- python/filemetadata.py | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) (limited to 'python/filemetadata.py') diff --git a/python/filemetadata.py b/python/filemetadata.py index 48ac9065..810d4d17 100644 --- a/python/filemetadata.py +++ b/python/filemetadata.py @@ -210,7 +210,13 @@ class FileMetadata: @property def virtual_path(self) -> str: - """The virtual path of the file including container and internal path (e.g., 'archive.zip:folder/file.bin') (read/write)""" + """ + ``virtual_path`` is a logical (non-filesystem) path that describes how this file was derived from container transform system. + + This path records provenance for files extracted from the transform system. It may include a sequence of transform steps and selection names. + + .. note:: An empty `virtual_path` indicates the file has not yet been processed by the transform system. If `virtual_path` matches `filename`, the file is not the result of an extraction or transform. + """ return core.BNGetVirtualPath(self.handle) @virtual_path.setter -- cgit v1.3.1