check_file_status() — Fast Ref API Reference

각 레퍼런스의 소스 파일이 최신인지, 변경됐는지, 없어졌는지 확인합니다.

시그니처

api.check_file_status() -> dict

반환값

{
    "success": True,
    "data": [
        {
            "name": str,
            "file_path": str,
            "status": str,
        },
        ...
    ]
}

상태값 (status)

값	의미
`"latest"`	소스 파일이 마지막 로드 이후 변경되지 않음
`"outdated"`	소스 파일이 마지막 로드 이후 수정됨
`"missing"`	소스 파일이 디스크에 없음
`"converted"`	레퍼런스가 씬 오브젝트로 변환됨
`"unknown"`	상태를 확인할 수 없음

예제

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
status = api.check_file_status()

for s in status['data']:
    print(f"  {s['name']}: {s['status']}")

활용 예 — 변경된 파일만 리로드

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
status = api.check_file_status()

if any(s['status'] == 'outdated' for s in status['data']):
    result = api.reload_all_references()
    print(result['message'])  # e.g. "Reload complete: 3 succeeded, 0 failed, 0 skipped"