`j&JdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZd Zd Zd ed Zd ed Zd edZd edZdZddddd ddZ ddZddZd dZdddd d!dZdd d"dZ d#dZd$dZy)%aHC59 XML document serializer for Liguria ISTAT XML export. Generates XSD-compliant XML documents from aggregated C59 payload rows. This module is fully isolated under xml_export/ and does not modify any existing TXT export, old ISTAT services, or API endpoints. Uses standard library xml.etree.ElementTree (lxml not required). ) annotations)date)Sequence) ElementTree)XmlPayloadValidationError)IstatC59RowPayload)format_xml_datez.http://www.regione.liguria.it/turismo/rimovclirim{z}c59z}mensilez }giornalieroz}rigac59AimantisN)available_roomsavailable_bedsoccupied_rooms software_namect|||t||}t||||t||}|D]} t || t |S)aBuild a complete XSD-compliant C59 XML document. Args: structure_code: Structure identifier (idstruttura) report_date: Report date (data) in YYYY-MM-DD format rows: Aggregated C59 payload rows (already sorted) available_rooms: Number of available rooms (numcameredisp) available_beds: Number of available beds (numlettidisp) occupied_rooms: Number of occupied rooms (numcamereoccupate) software_name: Software name (softwaregestionale), defaults to "Aimantis" Returns: Pretty-printed XML string with UTF-8 encoding and XML declaration Raises: XmlPayloadValidationError: If input data is invalid r rrr)_validate_inputs_build_root_element_add_mensile_node_add_giornaliero_node_add_rigac59_node_to_pretty_xml) structure_code report_daterowsr rrrroot giornalierorows ;/backend/istat/xml_export/serializers/c59_xml_serializer.pybuild_c59_xml_documentr!#se8^[$7 ~{ ;D '%# (^LK+s+ $ c|rt|js td| tdt|ts td| tdt |D]\}}t ||y)zValidate serializer inputs before building XML. Raises: XmlPayloadValidationError: If any input is invalid z.structure_code is required and cannot be emptyNzreport_date is requiredz#report_date must be a date instancez'rows cannot be None (use empty list []))strstripr isinstancer enumerate _validate_row)rrridxrs r rrWs| ^!4!:!:!<'(XYY'(ABB k4 ('(MNN |'(QRRdOSc3$r"ct|tstd|d|jdvrtd|d|jd|jr2|jj rt |jdk7rtd|d|jd|jdkrtd|d |j|jdkrtd|d |j|jdkrtd|d |j|jdkrtd|d |jy )zrValidate a single C59 row payload. Raises: XmlPayloadValidationError: If row data is invalid zRow z' must be an IstatC59RowPayload instance)iez#: nazione must be 'i' or 'e', got ''z+: residenza must be exactly 3 digits, got 'rz#: arrivi must be non-negative, got z%: partenze must be non-negative, got z%: presenze must be non-negative, got z#: diurni must be non-negative, got N) r&rrnazione residenzaisdigitlenarrivipartenzepresenzediurni)rindexs r r(r(ssl c- .'5'@ A   {{*$'5's||n M   ||a'5'>s||n M   zzA~'5' element with required attributes. Args: structure_code: Structure identifier report_date: Report date Returns: Root XML element idstrutturadata)rElementROOT_TAGsetr$r%r )rrrs r rrsH   x (DHH]C/5578HHV_[12 Kr"rcTtj|t}|+|dkr td|j dt ||+|dkr td|j dt ||r|nt }|j dt |j|S)a Add the (monthly summary) node. Args: root: Parent element available_rooms: Available rooms count available_beds: Available beds count software_name: Software name Returns: Mensile XML element rz$available_rooms must be non-negative numcameredispz#available_beds must be non-negative numlettidispsoftwaregestionale)r SubElement MENSILE_TAGrr=r$DEFAULT_SOFTWARE_NAMEr%)rr rrmensilesoftwares r rrs$$$T;7G" Q +6   OS%9:! A +5   NC$78!.}3HH KK$c(m&9&9&;< Nr"rctj|t}|+|dkr td|j dt ||S)zAdd the (daily movement) node. Args: root: Parent element occupied_rooms: Occupied rooms count Returns: Giornaliero XML element rz#occupied_rooms must be non-negativenumcamereoccupate)rrBGIORNALIERO_TAGrr=r$)rrrs r rrsR((?K! A +5  +S-@A r"ctj|t}|jd|j|jd|j |jdt |j|jdt |j|jdt |j|jdkDr'|jdt |j|S|jdd|S) zAdd a (movement row) node. Args: parent: Parent element (giornaliero) row: C59 row payload Returns: Rigac59 XML element r/r0r3r4r5rr60) rrB RIGAC59_TAGr=r/r0r$r3r4r5r6)parentrrigas r rrs  ! !&+ 6D HHY $HH[#--(HHXs3::'HHZS\\*+HHZS\\*+ zzA~ 3szz?+ K 3 Kr"cTtjtttj|dd}ddl}|j jj|}|jdd}|jdDcgc]}|js|}}dj|dz}|jd r|jd d }|S|jd r|jd d }|S|jd r|jd d }|Scc}w) zSerialize XML tree to pretty-printed UTF-8 string. Args: root: Root XML element Returns: Pretty-printed XML string with declaration unicodexml)encodingmethodrNz )indentrR zz&zz&)rregister_namespaceNAMESPACE_PREFIX C59_NAMESPACEtostringxml.dom.minidomdomminidom parseString toprettyxmlsplitr%join startswithreplace)r xml_stringrQr[ pretty_xmllineliness r rrs-""#3]C%%dYuMJ ''// % %j 1C>J)..t4 E4d T4E E5!D(J45'' # 4     7 8'' $ 4     G H'' 4 4 ) Fs D%D%)rr$rrrSequence[IstatC59RowPayload]r int | Nonerrhrrhr str | Nonereturnr$)rr$rrrrgrjNone)rrr7intrjrk)rr$rrrjElementTree.Element) rrmr rhrrhrrirjrm)rrmrrhrjrm)rMrmrrrjrm)rrmrjr$)__doc__ __future__rdatetimertypingr xml.etreeristat.xml_export.exceptionsr#istat.xml_export.models.c59_payloadristat.xml_export.xml.xml_utilsr rXrWr<rCrIrLrDr!rr(rrrrrr"r rws#!AB:A  e $=/+ }o]3=/+ ##'!%!% $1 1 1  ' 1  1  1 1 1  1 h    '   8' T &#'!% $ ' ' ' '  '  'Z"&  6  @+r"