refresh()

Force-rescans the scene's InfoNode and returns the latest reference list with file-time checks. v2 new method.

Signature

api.refresh() -> list

Return Value

[
    {
        "slot": int,
        "name": str,
        "filename": str,
        "namespace": str,
        "space_activate": bool,
        "unpack": bool,
        ...
    },
    ...
]

Returns the complete list of currently active reference data.

Example

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
data = api.refresh()
active = [d for d in data if d.get('name')]
print(f"Active references: {len(active)}")

Note: get_reference_list() returns cached data, while refresh() re-parses the InfoNode directly. Use this when the scene state has been changed externally (e.g., another script added references) and you need the latest data.