}DjdZddlmZddlmZmZddlmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZddddd d d d d dddd ZdefdZdefdZdedefdZdedefdZdedefdZdedefdZdedefdZdedefdZdDde de d e defd!Z!d"edefd#Z"dEd$ed e defd%Z#d&edefd'Z$d&edefd(Z% dEd)ee e e fd*e defd+Z&d,e defd-Z'd,edefd.Z(d/edefd0Z)d1edefd2Z*d3edefd4Z+d5eeee e e e e eeeeeeeefdefd6Z,gd7Z-e.d8k(rQdd9l/m0Z0dd:l1m2Z2e0jfjid;dd?d@AZ5e2jle5BZ7e,e7Z8e9e8yCyC)Fa This is part of Kerykeion (C) 2025 Giacomo Battaglia Context Serializer Module This module provides functionality to transform Kerykeion Pydantic models into XML representations suitable for AI consumption. The output is strictly non-qualitative and non-interpretive, providing factual representations of astrological data in semantic XML format. Optional/None fields are omitted from the output rather than rendered as empty. )Union)escape quoteattr)KerykeionPointModelLunarPhaseModelAstrologicalSubjectModelCompositeSubjectModelPlanetReturnModel AspectModelSingleChartDataModelDualChartDataModelElementDistributionModelQualityDistributionModelTransitMomentModelTransitsTimeRangeModelPointInHouseModelHouseComparisonModelMoonPhaseOverviewModelAriesTaurusGeminiCancerLeoVirgoLibraScorpio Sagittarius CapricornAquariusPisces) AriTauGemCanrVirLibScoSagCapAquPisreturnc*tt|S)z+Escape a value for use as XML text content.)rstr)values h/var/www/html/Astrologybackend/backend/venv/lib/python3.12/site-packages/kerykeion/context_serializer.py_xer1:s #e* c g}|jD]0\}}| |j|dtt|2|syddj |zS)zFormat keyword arguments as XML attributes, omitting None values. Returns a string with a leading space if any attributes are present, or an empty string if all values are None. = )itemsappendrr.join)kwargspartskeyr/s r0_attrsr=?sd Elln; U   LLC5)CJ"7!89 :;  %  r2tagc $d|tdi|dS)z7Create a self-closing XML tag: ````.r=r>r:s r0_scrDNs seF$V$%S ))r2c $d|tdi|dS)z1Create an opening XML tag: ````.r@>rArBrCs r0_orGSs seF$V$%Q ''r2cd|dS)z%Create a closing XML tag: ````.zs r0_crIXs uA;r2c P|yt|fi|t|t|S)zoCreate an XML element with text content: ``text``. Returns empty string if *text* is None. r5)rGr1rI)r>textr:s r0_elrL]s2  | T BsG9 55r2pointctj|j|j}|j|jd||j d|j |jd}|j(t|jjdd|d<|j|jrdnd|d<|j|jd |d <|j|jd|d <td i|S) a Transform a KerykeionPointModel into an XML ```` element. Provides a non-qualitative description of an astrological point including its position, sign, element, quality, house placement, and motion status. Args: point: A KerykeionPointModel representing a planet, axis, or house cusp. Returns: A self-closing XML string describing the point. Example: >>> point = subject.sun >>> kerykeion_point_to_context(point) '' .2f)namepositionsignabs_posqualityelement_r6house retrogradedirectmotion.4fspeed declination)rM)SIGN_FULL_NAMESgetrRrPrQrSrTrUrWr.replacerXr\r]rD)rMfull_sign_nameattrss r0kerykeion_point_to_contextrcls$%((UZZ@N ~~c*mmC(==== E {{U[[)11#s;g #*/*:*:,h {{!KK,g $"'"3"3C!8m  %  r2 lunar_phasectd|jt|j|jd|j S)a Transform a LunarPhaseModel into an XML ```` element. Args: lunar_phase: A LunarPhaseModel containing lunar phase information. Returns: A self-closing XML string describing the lunar phase. Example: >>> lunar_phase_to_context(subject.lunar_phase) '' rdrO)rPphasedegrees_betweenemoji)rDmoon_phase_namer. moon_phasedegrees_between_s_m moon_emoji)rds r0lunar_phase_to_contextrmsB   ( (+(()&::3?$$  r2aspect is_synastry is_transitc |rj|rdn |j}td|j|j|j|j ||j dt|jStd|j|j|j |j dt|j|jjS)aK Transform an AspectModel into an XML ```` element. Args: aspect: An AspectModel representing an aspect between two points. is_synastry: True for synastry/dual charts (adds ownership attributes). is_transit: True for transit charts (uses "Transit" as second owner). Returns: A self-closing XML string describing the aspect. Examples: Natal chart:: Synastry chart:: Transit chart:: TransitrnrO)typep1_namep1_ownerp2_namep2_ownerorbangle)rsp1p2rxrymovement) rwrDrnrtrurvorbitr.aspect_degreesaspect_movementlower)rnrorprws r0aspect_to_contextrs2 *9 NN__NN<<$f++,   ~~~~<<$f++,++113  r2point_in_housec|j|j|jd|jd}|jr|j|d<|j |d<|j |d<tdi|S)a Transform a PointInHouseModel into an XML ```` element. Args: point_in_house: A PointInHouseModel representing a point's house placement. Returns: A self-closing XML string describing the point's house placement. Example:: rO) point_name point_ownerdegreerR owner_houseprojected_houseprojected_house_owner)r)rpoint_owner_name point_degree point_signpoint_owner_house_nameprojected_house_nameprojected_house_owner_namerD)rrbs r0point_in_house_to_contextrs"%//%66#005)) E,,-DDm-BBE %3%N%NE !"  )5 ))r2house_comparisoncFtdg}|jr|jdtd|j|j|jD]}|jdt |!|jdt d|jr|rd|j}}n|j|j}}|jdtd|||jD]}|jdt |!|jdt d|jr|r|jd}}n|j|j}}|jdtd|||jD]}|jdt |!|jdt d|jr|rd|j}}n|j|j}}|jdtd |||jD]}|jdt |!|jdt d |jt dd j|S) a Transform a HouseComparisonModel into an XML ```` element. Provides bidirectional house overlay analysis between two subjects. Args: house_comparison: A HouseComparisonModel with bidirectional house placements. is_transit: If True, handles transit chart logic. Returns: A multi-line XML string describing the house comparison. house_overlay first_points_in_second)subjecttarget rrsecond_points_in_firstfirst_cusps_in_secondsecond_cusps_in_first ) rGfirst_points_in_second_housesr8first_subject_namesecond_subject_namerrIsecond_points_in_first_housesfirst_cusps_in_second_housessecond_cusps_in_first_housesr9)rrplinesrMsubjtgtcusps r0house_comparison_to_contextrs !E55 ,6F6Y6YbrcGcGHI J &CC DE LL4 9% @AB C D r"5678955 !#3#F#F#D(<<>N>a>a#D r"5tCPQRS%CC DE LL4 9% @AB C D r"5678944 (;;Y#D(;;=M=a=a#D r"4d3OPQR$AA CD LL4 9$ ?@A B C r"4567844 !#3#F#F#D(<<>N>a>a#D r"4d3OPQR$AA CD LL4 9$ ?@A B C r"45678 LLO$% 99U r2 distributionctd|jd|jd|jd|jdS)ak Transform an ElementDistributionModel into an XML ```` element. Args: distribution: An ElementDistributionModel with element percentages. Returns: A self-closing XML string describing the element distribution. Example:: element_distribution%)fireearthairwater)rDfire_percentageearth_percentageair_percentagewater_percentagers r0element_distribution_to_contextr=sX ,,-Q /../q1**+1 -../q1  r2cntd|jd|jd|jdS)ae Transform a QualityDistributionModel into an XML ```` element. Args: distribution: A QualityDistributionModel with quality percentages. Returns: A self-closing XML string describing the quality distribution. Example:: quality_distributionr)cardinalfixedmutable)rDcardinal_percentagefixed_percentagemutable_percentagers r0quality_distribution_to_contextrTsG  445Q7../q122315  r2ris_transit_subjectcZtd|jg}t|tr|rdnd}|jdkrdnd}|j dt ||jd |jd d |jd d |jd d |jd  |j|j|jd |jd ||j|j |j"|j$d}|j&r|j&|d<|j dt d!i|t|t(rS|j dt d|j*|j,j|j.jt|t0r)|j dt d|j2gd}g}|D]/}t5||d} | |j dt7| 1|rK|j dtd|j9||j dt;dgd} g} | D]/} t5|| d} | | j dt7| 1dD]/}t5||d}|| j dt7|1| rK|j dtd|j9| |j dt;dgd}|j dtd|D]q}t5||d}||j dt d|j|j<d t>jA|jB|jBs|j dt;d|jD'|j dtG|jD|j t;dd jI|S)"a Transform an AstrologicalSubjectModel into a comprehensive XML ```` element. Provides a complete description of an astrological chart including metadata, planetary positions, house cusps, and lunar phase. Args: subject: An AstrologicalSubjectModel, CompositeSubjectModel, or PlanetReturnModel. is_transit_subject: If True, uses ```` instead of ````. Returns: A multi-line XML string describing the complete chart. chart)rP transit_data birth_datarWEr-02dr6:rO)datecitynationlatlnglng_dirtz)zodiac house_system perspective sidereal_modecomposite_info)rs first_subjectsecond_subject return_infors)sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutochiron mean_lilith true_lilithcerespallasjunovestaNrplanets) ascendant descendant medium_coeli imum_coelivertex anti_vertex)true_north_lunar_nodetrue_south_lunar_nodeaxes) first_house second_house third_house fourth_house fifth_house sixth_house seventh_house eighth_house ninth_house tenth_houseeleventh_house twelfth_househousesrW)rPrrRr)config)%rGrP isinstancerrr8rDyearmonthdayhourminuterrrtz_str zodiac_typehouses_system_nameperspective_typerr composite_chart_typerrr return_typegetattrrcextendrIrQr^r_rRrdrmr9)rrrdata_tagr config_attrscelestial_point_names planet_linesrrMr axes_lines axis_nameaxis node_namenode house_names house_namerWs r0astrological_subject_to_contextrjs gll + ,E'34%7>\ q#c Xw||nAgmmC5H'++VYIZZ[\c\h\hil[mmnovo}o}BoC%DKRKWKW`g`n`nw~wBwBCFvGQXQ\Q\]`PalsxxFxFGH I %%22//L (/(=(= _% LL2c3l3456'01 %G,H,HX_XmXmXrXrDKDZDZD_D_`a b ',- r#m'2E2EFGHI&L+L T2     $'A%'H&I J KL  r"Y-)* \" r"Y-)* ^DJI w 40     %?%E$FG HI HI w 40     %?%E$FG HI  r"V*&' Z  r"V*&' K LL2bl^$%! T2   LLs7U^^C`` element. Args: chart_data: A SingleChartDataModel containing complete chart data. Returns: A multi-line XML string describing the chart data. chart_analysisrrraspectscountrF)ro active_points, rP (rx)active_aspects)rG chart_typerrsplitr8rrrrrr.lenrrIrLr9r"r&)rr subject_xmllinernaactive_aspects_strs r0single_chart_data_to_contextr.s z'<'< = >E2*2D2DEK!!$'" r$[!" LL25j6U6UVWXY LL25j6U6UVWXY r"Yc#j6H6H2I.JKLMN (( PF LL4 1&e LMN O P r"Y-)* LL2c/499Z5M5M+NOPQRIbIb#cAqykAeH:Q$?#cd LL2c*,>?@AB LL$%& 99U  $ds G/c (g}|jdk(}|jtd|j|jdtdt|j}|j dD]}|jd||jdt d|rdnd }|jdt|t|j| }|j dD]}|jd||jdt ||jr|jdtd tt|j |jD]"}|jdt|d |$|jdt d |jAt|j|}|j dD]}|jd||jl|j} |jdtdt| j d| j"t| j$j'|jdt)|j*|jdt-|j.|jdt1ddj3|j4dj3|j6D cgc]} | dd| ddc} } |jdt1d| |jt ddj3|Scc} w)z Transform a DualChartDataModel into an XML ```` element. Args: chart_data: A DualChartDataModel containing dual chart data. Returns: A multi-line XML string describing the dual chart data. rrrrrrrrtransit_subjectr)rrr Trorp)rprelationship_score44)r/max description destiny_signr"r#rPr$rxr%r&)r'r8rGrrr(rIrrr.r)rrrr2rD score_valuescore_descriptionis_destiny_signrrrrrrLr9r"r&) rrrp first_xmlr+ wrapper_tag second_xmlrnhc_xmlscorer,r-s r0dual_chart_data_to_contextr?sa E&&)3J LL$:+@+@AB LL2b)*+,/ 0H0HII%$ tD6]#$ LL2b)*+,(2#7GK LL2bo&'(01J1J_ijJ  &$ tD6]#$ LL2bo&'( r"Yc#j6H6H2I.JKLMN (( fF LL4 1&dWa bcd e f r"Y-)*"".,Z-H-HU_`LL& &D LL2dV % &$$0-- )U5F5F1GT_d_v_vFIJOJ_J_F`FfFfFhij k  LL25j6U6UVWXY LL25j6U6UVWXY LL2c/499Z5M5M+NOPQRIbIb#cAqykAeH:Q$?#cd LL2c*,>?@AB LL$%& 99U  $ds*Ntransitc |jrtd|jg}|jdtdt t |j|jD]"}|jdt |dd$|jdtd|jtdd j|Std|jd S) z Transform a TransitMomentModel into an XML ```` element. Args: transit: A TransitMomentModel representing a transit snapshot. Returns: An XML string describing the transit moment. transit_moment)rrrr rTr1r0)rr) rrGrr8r.r)rrIr9rD)r@rrns r0transit_moment_to_contextrDMs$7<<89 r"Yc#goo2F.GHIJKoo `F LL4 1&dW[ \]^ _ ` r"Y-)* R()*yy#',,DDr2transitscg}dtt|ji}|jr|jj|d<|j r$|j d|d<|j d|d<|j td i||jD]7}t|}|jdD]}|j d |9|j tddj|S) a Transform a TransitsTimeRangeModel into an XML ```` element. Args: transits: A TransitsTimeRangeModel containing multiple transit moments. Returns: A multi-line XML string describing the transit time range. momentsrr from_dateto_datetransit_analysisrr)rK) r.r)rErrPdatesr8rGrDr(rIr9)rErrbr@ transit_xmlr+s r0transits_time_range_to_contextrNcs Ec#h&7&7"89:E#++00i~~%^^A.k#>>"-i LL0%01$$&/8 %%d+ &D LL2dV % &&  LL&'( 99U r2overviewc tdt|j|jg}|j}|j dtd|j *|j dtd|j d|j(|j dtd|j|j(|j dtd |j|j(|j dtd |j|j(|j dtd |j|j1|j dtd t|j|j(|j dtd |j|j(|j dtd|j|jH|j dt!d|jj"|jj$|j&(|j dtd|j&|j(1|j dtdt|j(|j*(|j dtd|j*|j,1|j dtdt|j,|j.|j.}i}|jt|j|d<|j|j|d<|j0|j0|d<|j2|j2|d<|j dt!dRi||j4g|j4}|j dtd|j6|j6}i}|j8|j8d|d<|j:|j:d|d<|j<|j<d|d<|j>|j>d|d<|j@|j@d|d<|j d t!dSi||jB|jB}i} |jD|jDd!| d"<|jF|jF| d#<|jH|jH| d$<|j|j| d <|jJD|j d tdTi| |jJ} i} | jL| jL| d&<| jN|j d'tdUi| | jN} i} | jP| jP| d)<| jR| jR| d*<| jT| jT| d+<|j d,t!dVi| |j d'tWd(n|j d't!dUi| |j d tWd%n|j d t!dTi| |jX|jX}|j d td-d.|jZfd/|j\fd0|j^fd1|j`ffD]G\}}| |j d't|d2|jbfd3|jdffD]\}}| i}|jt|j|d<|j|j|d<|jft|jf|d4<|jht|jh|d5<|jj|jj|d6<|jl|jl|d7<|j d,t!|fi||j d'tW|J|j d tWd-|jn|jn}i}|jp|jpd!|d8<|jr|jrd9|d:<|j@|j@d|d<|j d t!dWi||j dtWd|jt|jt}i}|jv&t|jvjy|d;<|jz&t|jzjy|d<<|j|b|j dtdXi||j|}i}|j~|j~|d><|j|j|d?<|j|jd!|d@<|j|j|dA<|jrt|jdBkDrj|j d tdYi||jD] }|j d'tdD|"|j d tWdCn|j d t!dYi||j dtWd=n|j dt!dXi||j dtWd|j|j}|j dtdE|j1|j dtdFt|j|j(|j dtdG|j|j1|j dtdHt|j|j(|j dtdI|j|j(|j dtdJ|j|j(|j dtdK|j|j6|j6}i}|j8|j8d|d<|j:|j:d|d<|j<|j<d|d<|j dt!dSi||j|j}i}|jt|j|d<|j|j|d<|j0|j0|d<|j2|j2|d<|j dt!dZi||j dtWdE|j|j}i}|j|j|dL<|j|j|dM<|jt|j|dN<|j&t|jjy|dO<|j|j|dP<|j dt!d[i||j tWddQj|S)\a Transform a MoonPhaseOverviewModel into an XML ```` element. Provides a comprehensive description of the current lunar phase, sun info, and location context. All optional/None fields are omitted. Args: overview: A MoonPhaseOverviewModel containing moon phase details. Returns: A multi-line XML string describing the moon phase overview. moon_phase_overview) timestamp datestamprrrrfz.3f phase_name major_phasestage illuminationage_days lunar_cyclerhr)sun_sign moon_signmoonrisemoonrise_timestampmoonsetmoonset_timestamprRrSrsvisibility_regionsdetailedrOaltitudeazimuthdistanceparallactic_angle phase_anglez z.1f visible_hoursbest_viewing_timevisibility_rating visibility phase_qualityz viewing_conditionsfilters telescopebest_magnificationz upcoming_phasesnew_moon first_quarter full_moon last_quarterlastnextdays_ago days_aheadrPr5 percentager[visible_fractionmoonrise_visiblemoonset_visibleevents start_timeend_timeduration_hoursviewing_qualityroptimal_viewing_periodrecommendationrsunrisesunrise_timestampsunsetsunset_timestamp solar_noon day_lengthlatitude longitude precisionusing_default_locationnoter)next_lunar_eclipse)rQ)rj)rl)recommended_equipment)illumination_details)r})r)next_solar_eclipse)location)TrGr.rRrSrr8rfrLrTrUrVrWrXrYrhrrDrZr[r\r]r^r_rrsr`rarQrbrcrdrerfrjrgrhrirlrkrrmrnrorIrprqrrrsrtrurvrwrxrPr5rryrzr}r{rr|rr~rrrrecommendationsr)rrrrrrrrrrrrrrr9) rOrrecl ecl_attrsrapos pos_attrsvis vis_attrsvcvc_attrseqeq_attrsup phase_tag phase_window moment_tagmomentm_attrsill ill_attrsevev_attrsovp ovp_attrsrecrsp_attrsse_attrsloc loc_attrss r0moon_phase_overview_to_contextrs%%X5G5G1HT\TfTf g hE ==D LL2bj\"# zz tCDJJs+;=>?@ " tC doo>?@A # tC t/?/?@ABC zz tC4567 $ tC0A0ABCDE }}  tC C ,>?@AB # tC t/?/?@ABC zz tC4567 {{ tC4;;3G3GSWS^S^ShShijkl }}  tC DMM:;<= * tC 4c$:Q:Q6RSTUV || tC 4<<89:; ) tC 3S9O9O5PQRST *%% == $%(%7Ik " == $%(]]Ik " 88  #If   ! ! -.1.D.DI* + tCB BCDE }} == tBzN+,-    (##C I||'+.<<*< *%{{&*-++c): )$||'+.<<*< *%$$0474I4I#3N -.*.1ooc-B -( LL6#">I">!?@ A    *%%C I  ,030A0A#/F /*$$0141F1F -.$$0141F1F -.+,/,<,< .)%%1 vb&C&C%DEF++!###/020@0@H_-++7LL8B,Px,P+Q!RS11B%'Hzz-.0jj+||/02 -,,89;9N9N!56LL:c.VX.V-W!XYLL8B/C,D+E!FGLL8C,Q,Q+R!ST vb&6%789 vc&D)&D%EFG  # # /))B LL6"%6"7!89 :R[[) ""2"23bll+1 , =' <  +LL8ByM?!;<06 8I8I/JVUaUfUfLg.hT* F!-,.G%//;7:6;K;K7L 4%//;7=7G7G 4%:69&//6J 3%00<8;F+>'?!'C vb&OY&O%PQR..JCLL8C0@#,F+G!HIJ vb)A&B%CDE vc&Pi&P%QRS LL48 ~. / LL4 9 9:; < LL2bj\"#||ll r"U)%& ;; " LL4Is3;;/? @AB C  , LL4$79N9N OPQ R :: ! LL4Hc#**o >?@ A    + LL4$68L8L MNO P >> % LL4L#.. ABC D >> % LL4L#.. ABC D << #,,CH||'*-,,s);${{&),S(9#||'*-,,s);$ LL4 ;( ;<= >  ! ! -((CH}}((+CMM(:%}}((+ %xx##&88 %%1141G1G-. LL4 EH EFG H r"U)%&$ << #$'LLIj ! == $%(]]Ik " == $%(%7Ik "  % % 125c6P6P2Q2W2W2YI. / 88  #If  r#6I6789 LL)*+ 99U r2modelct|tr t|St|tr t |St|t r t |St|tr t|St|tr t|St|tttfr t|St|tr t!|St|t"r t%|St|t&r t)|St|t*r t-|St|t.r t1|St|t2r t5|St|t6r t9|St;dt=|j>d)ax Main dispatcher function to convert any Kerykeion model to XML context. This function automatically detects the model type and routes to the appropriate transformer function. Args: model: Any supported Kerykeion Pydantic model. Returns: A string containing the XML representation of the model. Raises: TypeError: If the model type is not supported. Example: >>> from kerykeion import AstrologicalSubjectFactory, to_context >>> subject = AstrologicalSubjectFactory.from_birth_data(...) >>> context = to_context(subject) >>> print(context) zUnsupported model type: aW. Supported types are: KerykeionPointModel, LunarPhaseModel, AstrologicalSubjectModel, CompositeSubjectModel, PlanetReturnModel, AspectModel, SingleChartDataModel, DualChartDataModel, ElementDistributionModel, QualityDistributionModel, TransitMomentModel, TransitsTimeRangeModel, PointInHouseModel, HouseComparisonModel, MoonPhaseOverviewModel) rr r.r r?rrNrrDrrrr r rrrcrrmr rrrrrrrrr TypeErrorrs__name__)rs r0 to_contextrsUP%-.+E22 E- .)%00 E1 2-e44 E- .(// E1 2-e44 E46KM^_ `.u55 E. /)%00 E? +%e,, E; ' '' E3 4.u55 E3 4.u55 E, -(// E/ 0*511&tE{';';&<=N O  r2)rrcrmrrrrrrr.r?rDrNr__main__)astrological_subject_factory)ChartDataFactoryz Test Subjectz1990-01-01T12:00:00ZzNew YorkUSg^K=[D@gMbR)rP iso_utc_timerrrr)rN)FF)F):__doc__typingrxml.sax.saxutilsrrkerykeion.schemas.kr_modelsrrrr r r r r rrrrrrrr^r.r1r=rDrGrIrLrcrmboolrrrrrrr.r?rDrNrr__all__r kerykeionrkerykeion.chart_data_factoryrAstrologicalSubjectFactoryfrom_iso_utc_time natal_modelcreate_natal_chart_datarcontextprintrAr2r0rs .*             *# ! !*S*s* (C(c( CC 6S6S6)!&9)!c)!XC.. k. . RV. cf. b*.?*C*@:2F:TX:eh:z2Js.2Js.ty| +-BDUU V|lp||~"-A"c"J<+=<#<~E'9EcE,-C