roboto.domain.files.lazy_lookup_file

Bases: roboto.domain.files.file.File

A File subclass that defers instantiation (hydration) of the real File until any non‐internal attribute is first accessed.

This is useful for scenarios where we know how to dereference a File (e.g., by ID), and we want to return a handle in case the caller wants to work with it, but we don’t want to pay the cost of dereferencing it unless necessary.