Source code for geeViz.eeCatalogHelpers.properties
"""Image property and nodata resolution helpers."""from__future__importannotationsfromtypingimportAny__all__=["coerce_nodata_value","resolve_lookup_value","resolve_property_value","build_image_properties",]_LOOKUP_VALUE_ALIASES={"name":("name","version_name"),"version":("version","version_decimal"),"number":("number","version_integer"),}
[docs]defcoerce_nodata_value(value:Any)->Any:"""Normalize nodata values to native numeric types where possible."""ifvalueisNone:returnNoneifisinstance(value,str):stripped=value.strip()ifstripped=="":returnNonevalue=strippedifisinstance(value,float)andvalue.is_integer():returnint(value)try:numeric_value=float(value)except(TypeError,ValueError):returnvalueifnumeric_value.is_integer():returnint(numeric_value)returnnumeric_value
[docs]defresolve_lookup_value(record:dict[str,Any],value_key:str,default:Any=None)->Any:"""Resolve a value key with optional alias support from a lookup record."""candidate_keys=_LOOKUP_VALUE_ALIASES.get(value_key,(value_key,))forcandidate_keyincandidate_keys:ifcandidate_keyinrecord:returnrecord[candidate_key]returndefault
[docs]defresolve_property_value(spec:Any,context:dict[str,Any])->Any:"""Resolve one property spec item using raw, callable, or lookup syntax."""ifcallable(spec):returnspec(context)ifisinstance(spec,str):returncontext.get(spec,spec)ifisinstance(spec,dict):lookup=spec.get("lookup",{})lookup_key_name=spec.get("lookup_key")value_key=spec.get("value_key")default=spec.get("default")ifnotlookup_key_nameornotvalue_key:raiseValueError(f"Invalid lookup spec: {spec}")lookup_key_value=context.get(lookup_key_name,lookup_key_name)record=lookup.get(str(lookup_key_value))ifrecordisNone:record=lookup.get(lookup_key_value)ifisinstance(record,dict):returnresolve_lookup_value(record,value_key,default)returndefaultreturnspec
[docs]defbuild_image_properties(image_property_fields:list[str],image_property_lookups:dict[str,Any],image_context:dict[str,Any],)->dict[str,Any]:"""Build image properties from declarative field and lookup mappings."""properties:dict[str,Any]={}forfieldinimage_property_fields:iffieldnotinimage_property_lookups:raiseKeyError(f"No lookup defined for image property field: {field}")properties[field]=resolve_property_value(image_property_lookups[field],image_context)returnproperties