@WjSrSSKJr SSKrSSKJrJrJr SSSjjrSSSjjr SSSjjr SSSjjr SS jr SSS jjr SS jrSS jrSS jrS SjrS!SjrS"SjrS#SjrSSjrg)$z Small, dependency-free helpers shared by every analyzer. AliExpress payloads are inconsistent (strings for numbers, lists wrapped in single-key dicts, missing keys), so all extraction goes through these defensive utilities. ) annotationsN)AnyIterableOptionalc~UnURS5H%n[U[5(aXC;aUs $X4nM' U$)z{Read a nested value using a dotted path, e.g. ``"a.b.c"``. Returns ``default`` when any segment is missing or not a dict. .)split isinstancedict)datapathdefaultcurrentkeys ڋ/Users/waleedhassanin/Documents/snowflake_co_dev_github/snow_flake_back_end_deploy/mama_care_api/ali_express_ds/pms/engine/utils/helpers.pysafe_getrs@ Gzz#'4((C,>N, NcJUHn[X5nUSS/04;dMUs $ U$)z>Return the first non-empty value among several candidate keys.N)r)r keysrrvalues r first_presentrs3# r2r* *L NrcUcU$[U[[45(a [U5$[R"S[ U55nU(dU$[UR 5RSS55$)zJCoerce AliExpress numeric strings ('27.78', '19,00', 'USD 5.99') to float.z-?\d+(?:[.,]\d+)?,r)r intfloatresearchstrgroupreplace)rrmatchs rto_floatr#$sb }%#u&&U| II*CJ 7E  &&sC0 11rc>[[U[U555$N)rr#r)rrs rto_intr&0s xuW~. //rc2[[U5S-S5$)z9Round monetary / percentage values to two decimal places.)roundr)rs rround2r+4s u#Q ''rc,[U[X 55$)z$Keep a score inside its valid range.)maxmin)rlowhighs rclampr19s sC$ %%rc0Uc/$[U[5(aU$[U[5(ac[U5S:XaQ[ [ UR 555n[U[5(aU$[U[5(aU/$U/$U/$)zNormalize AliExpress list containers. The API often wraps lists as ``{"some_key_dto": [...]}`` or returns a single dict instead of a list. This flattens all of those to a plain list. )r listr lennextitervalues)rinners ras_listr:>s  } % % u:?elln-.E%&& %&&ww 7NrcLX:Xa X:XaS$S$X - X!- - n[US-5$)zMap ``value`` to 0-100 where ``best`` earns 100 and ``worst`` earns 0. Works in both directions (best < worst means "lower is better"). Y@r(r1)rbestworstratios r linear_scorerATs5  } u.3. ]u| ,E  rc0US::ag[X- S-5$)z8Map ``value`` to 0-100, saturating at ``full_score_at``.rr(r<r=r full_score_ats r ratio_scorerE_s  %'50 11rcb[U[5(d0$Un[S5HnSnUR5H8upEUR S5(dM[U[5(dM4UnSn O [UR S5[5(aUSnSnU(aM U$ U$)aPeel AliExpress API envelopes off a payload. Real API responses arrive wrapped, e.g.:: {"aliexpress_ds_product_wholesale_get_response": {"result": {...}}} {"aliexpress_ds_freight_query_response": {"result": {...}}} This walks down through any ``*_response`` wrapper and any ``result`` container until the actual data object is reached. Payloads that are already unwrapped pass through unchanged. F _responseTresult)r r rangeitemsendswithget)r r_ descendedrrs runwrap_responserPfs dD ! ! G 1X !--/JC||K((Zt-D-D  * gkk(+T 2 2h'GIy  N NrcbUcg[U[[45(a[U5nX4$[R"S[ U55Vs/sHn[U5PM nnU(dg[ U5S:Xa USUS4$[USUS5[USUS54$s snf)zParse AliExpress delivery time strings. Accepts values like ``"12-20"``, ``"15"``, ``"7 days"`` or integers. Returns ``(min_days, max_days)`` or ``(None, None)`` when unknown. )NNz\d+r3r) r rrrfindallrr5r.r-)rawdaysnnumberss rparse_delivery_daysrWs  {#U|$$3xz!zz&#c(;<;!s1v;G<  7|qqz71:%% wqz71: &GAJ (C CC =sB,cUVVs/sHupUcM US:dMX4PM nnn[SU55nUS::ag[[SU55U- 5$s snnf)aWeighted average of (score, weight) pairs on a 0-100 scale. Missing metrics are passed as ``None`` scores and are *excluded*; the remaining weights are renormalized so unavailable data never drags the result toward zero. Returns 0.0 when nothing is available. rc3*# UH upUv M g7fr%).0rNws r #weighted_average..s/YTQqYsr(c3.# UH upX-v M g7fr%rZ)r[sr\s rr]r^s1ytqQUys)sumr1)rKr`r\ available total_weights rweighted_averagerdsd%*EEDAQq1u!EIE/Y//Lq 1y11L@ AA Fs AAAcU(dgXSS::a[USS5$[XSS5H3uup#upEX::dMXB:wa X- XB- - OSn[X6XS- --5s $ [USS5$)zLinear interpolation over (value, score) anchor points. Produces smooth, gradually increasing scores instead of hard cliffs. Anchors must be sorted by value; values outside the range clamp to the first / last anchor's score. r(rr3Ng?)r1zip)ranchorsx1y1x2y2r@s rpiecewise_scorerms   1 WQZ]##!'12;7(2 ;02UZBG,cErw//0 08 Q  rcBUS::dUS::ag[X- S-S-5$)zSquare-root saturation curve on a 0-100 scale. Rewards early progress: 10% of the saturation point already earns ~32 points instead of 10. Used for volume metrics (sales, reviews) so that moderate history is not punished as if it were zero. rr(g?r<r=rCs rsaturating_scoreros-UaZ 5(S0E9 ::rr%)r rr rrrreturnr)r r rz Iterable[str]rrrpr)r()rrrrrpr)r)rrrrrpr)rrrpr)r(r<)rrr/rr0rrpr)rrrpr4)rrr>rr?rrpr)rrrDrrpr)r rrpr )rSrrpz#tuple[Optional[int], Optional[int]])rKz%'list[tuple[Optional[float], float]]'rpr)rrrhz'list[tuple[float, float]]'rpr)__doc__ __future__rrtypingrrrrrr#r&r+r1r:rArErPrWrdrmrorZrrrts`# **  20( & , 2<D& B!$ ;r