jD SrSSKrSSKrSSKrSSKJr SSKJr SSKJ r SSK J r J r J r JrJr SSKJr SSKJr SS KJr SS KJrJr SS KJr SS KJr SS KJrJr SSK J!r!J"r"J#r#J$r$J%r%J&r&J'r' SSK(J)r) SSK*J+r+ SSK,J-r- SSK.J/r/ SSK0J1r1 \Rd"\35r4Sr5\Rl"\5S5 Sr7Sr8"SS\5r9"SS5r:S\ S\;\"S\<\=\4SS4S jr>S\ S!\#SS4S"jr?S\ S#\!S$\:S\S-4S%jr@S\ S&\&SS4S'jrAS\ S(\%S$\:S\S-4S)jrBS2S\ S(\%S*\ S+\ S-S\4 S,jjrCS\ S(\%S*\$S$\:S\4 S-jrDS.\;\'S\E4S/jrFS0\=S-S\\-S-4S1jrGg)3uBackend for Apple Pages (``.pages``) documents. A ``.pages`` file is a ZIP container, but what is inside changed completely with Pages 5: * **Pages 5 and later (2013 onwards)** store the document as ``Index/*.iwa`` — Snappy-framed protobuf whose schemas Apple has never published. This is what essentially every Pages document in circulation looks like. * **iWork '09 and earlier** stored it as a plain ``index.xml``, optionally gzipped, alongside a ``QuickLook/Preview.pdf`` render that Apple stopped writing after that release. Both are read into the same model, so the backend is declarative: it builds a :class:`~docling_core.types.doc.DoclingDocument` directly rather than rendering pages and running layout analysis over them. N)BytesIO)Path)urlparse) ContentLayer DocItemLabelDoclingDocumentDocumentOriginImageRef) ListGroup)TextItem)Image)AnyUrlValidationError)override)DeclarativeDocumentBackend) pages_iwa pages_xml)BlockCommentContent ListLabel ParagraphPictureRun is_encrypted)IWorkBackendOptions) InputFormat) InputDocument)DocumentLoadErrorzapplication/vnd.apple.pagesz.pageszIndex/)z index.xmlz index.xml.gzc ^\rSrSrSr\SS\S\\-S\ S-4U4Sjjj5r S\ RS \ 4S jr\S \4S j5r\\S \4S j55r\\S \\4S j55r\S \4Sj5rSrU=r$)IWorkPagesDocumentBackendIaExtract text from Apple Pages documents of either generation. Known limitations: * Only text cells are read from a table, in either of the two storage layouts Pages has used. A cell holding a number, a date or a formula result is left empty rather than guessed at. * A picture is placed where the document anchors it, but its caption, its cropping and its accessibility description are not read. * Bold, italic, underline, strikethrough, superscript, subscript and hyperlinks are recovered; other character properties, such as colour or capitalisation, have no equivalent here. * A list item whose runs differ in formatting keeps its text but loses the formatting, since a list item carries a single one. * Text boxes are read from Pages 5+ documents, where they are floating drawables owned by the document. An iWork '09 document keeps them in the body flow, so they already appear there. * Headers, footers and footnotes are recovered into the furniture content layer and comments into the notes layer, so all of them stay out of the reading order by default. * A comment records its author but not the date it was written. * Password-protected documents cannot be read. * ``.pages`` bundles saved as a *directory* package rather than a single file are not recognised; the converter cannot address a directory as an input document. Nin_docpath_or_streamoptionscL>Uc [5n[TU] XU5 X0l[ /S9UlSUl[R"U5nURU5UlSSS5 S Ulg!,(df  N=f![a e[an[SURS35UeSnAf[[4a"n[SURSUS35UeSnAf[R[ 4an[SURS 35UeSnAff=f) N)blocksFPages document with hash z is nested too deeply to parse.z(Could not read Pages document with hash z;: the archive contains a member Docling cannot decompress (z).z(Could not open Pages document with hash z+: the file is not a readable ZIP container.T)rsuper__init__r&r_content_validzipfileZipFile_read_documentr RecursionError document_hashNotImplementedError RuntimeError BadZipFileOSError)selfr$r%r&archiveexc __class__s Z/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docling/backend/iwork_backend.pyr+"IWorkPagesDocumentBackend.__init__dsD ?)+G 9,3 r*   0G $ 3 3G < 16 710    $+D,>,>+?@## $\2  $:4;M;M:NOLLO5PRT ""G, #:4;M;M:NO<<  sMB A8(B 8 BB B D#B77D# C''D#DD#r8returnc~^UR5n[U5URR:a/[ S[U5SURRS35e[ SU55nX0RR :a&[ SUSURR S35e[SU55(a[ SURS 35eUVs1sHoDRiM snm[S T55(a6[R"XURRUR5$[U4S j[5S 5nUb6[R"XURR UR5$[ S URS35es snf)zDDispatch to the reader for whichever generation wrote the container.zPages archive has z2 members, exceeding the max_member_count limit of .c38# UHoRv M g7fN) file_size.0infos r; ;IWorkPagesDocumentBackend._read_document..s;UT..UzPages archive expands to z/ bytes, exceeding the max_total_bytes limit of c38# UHn[U5v M g7frArrCs r;rFrGs4ed|D!!erHr)zs is password-protected; Docling cannot read encrypted iWork documents. Remove the password in Pages and save again.c3J# UHoR[5v M g7frA) startswith_MODERN_INDEX_PREFIX)rDnames r;rFrGsG344s!#c36># UHoT;dM Uv M g7frA)rDnnamess r;rFrGsF"7Q:qq"7s  NzDocument with hash zo is a ZIP archive but does not look like a Pages document: it has neither an Index/ directory nor an index.xml.)infolistlenr&max_member_countr summax_total_bytesanyr2filenamer read_contentmax_file_bytesnext_LEGACY_INDEX_MEMBERSr)r7r8infos total_bytesrElegacyrQs @r;r0(IWorkPagesDocumentBackend._read_documents  " u: 55 5#$SZL1--1\\-J-J,K1N ;U;; 55 5#+K=9,,0LL,H,H+IL  4e4 4 4#+D,>,>+?@JJ  ,115451 GG G G)) ; ;T=O=O F"7FM  ))!=!=t?Q?Q  !$"4"4!56    2s)F:cUR$rA)r-r7s r;is_valid"IWorkPagesDocumentBackend.is_valids {{cg)NFrOclss r;supports_pagination-IWorkPagesDocumentBackend.supports_paginationsrec$[R1$rA)r IWORK_PAGESrgs r;supported_formats+IWorkPagesDocumentBackend.supported_formatss''((recrUR5(d[SURS35e[URR =(d S[ URS9n[URR=(d SUS9n[U5n0nURRHOn[X%U5n[U[5(dM&UcM+URHnUR!Xv5 M MQ [#X R5 [%X RR&U5 U$)Nz(Cannot convert Pages document with hash z$ because the backend failed to init.file)rXmimetype binary_hash)rMorigin)rcr4r2r rprM_PAGES_MIMETYPErstem _ListStackr,r( _add_block isinstanceranchors setdefault_add_furniture _add_commentscomments)r7rsdoclists annotatedblockitemanchors r;convert!IWorkPagesDocumentBackend.converts}}:4;M;M:NO66   YY^^-v$**  499>>#;VFK3)+ ]]))Ec%0D%++0@#mmF((6,* sMM*c==119= re)r,r-r&rA)__name__ __module__ __qualname____firstlineno____doc__rrrrrr+r.r/rr0boolrc classmethodrisetrrmrr__static_attributes__ __classcell__)r:s@r;r"r"Is4 /3 ** $*%t+ **X& goo& '& P$ D )#k"2))rer"cF\rSrSrSrS\SS4SjrS SjrS\S\ 4S jr S r g) rvaXThe list groups open while consecutive list items keep arriving. Pages records a nesting depth per paragraph rather than opening and closing lists, so the groups a :class:`DoclingDocument` needs are inferred here: a deeper item opens groups down to its depth, a shallower one closes back to it, and any other paragraph ends the list entirely. r~r=NcXl/UlgrA_doc_groups)r7r~s r;r+_ListStack.__init__s (* rec8URR5 g)z0End the list, so the next item starts a new one.N)rclearrbs r;close_ListStack.closes redepthcRURUS-S2 [UR5U::anURRURR SUR(aURSOSS95 [UR5U::aMnURU$)zReturn the group a list item at ``depth`` belongs in, opening it if needed. Args: depth: The item's nesting depth, counted from zero. Returns: The innermost open group. Nlist)rMparent)rrSappendradd_list_group)r7rs r; group_for_ListStack.group_fors LL %$,,5( LL   ((DLL R(8d) $,,5( ||E""rer)r=N) rrrrrrr+rintr rrrOrer;rvrvs2+O++#s#y#rervr~r}rr=cUHBnURUR5nURURU(aU/OSS9 MD g)aAdd the document's comments, linked to the text they annotate. Comments go into the notes content layer, where the Word backend puts them too, and each is attached to the item holding the text it was written about whenever that text was recovered. Args: doc: The document being built. comments: The comments read from the Pages document. annotated: The item each comment anchor was recovered into. N)texttargets)getr add_commentr)r~r}rcommenttargets r;r|r|s:w~~. W\\vF84PrecontentcUR[R4UR[R4UR [R 44H)up#UHn[XU[R5 M M+ g)aMAdd the document's headers, footers and footnotes. They go into the furniture layer, where the Word backend puts a header and a footer too, so they are available to callers that ask for it but stay out of the reading order by default. Args: doc: The document being built. content: The content read from the Pages document. N) headersr PAGE_HEADERfooters PAGE_FOOTER footnotesFOOTNOTE _add_runsr FURNITURE)r~r paragraphslabel paragraphs r;r{r{si ,223 ,223   L112 $I ce\-C-C D$ rerrc[U[5(a [XU5$UR5 [U[5(a [ X5 gUR US9 g)a9Add one block of content, in the order Pages lays the document out. Args: doc: The document being built. block: The block to add. lists: The list groups currently open. Returns: The item a paragraph became, so a comment can be attached to it, or None for anything a comment cannot annotate. )dataN)rxr_add_paragraphrr _add_picture add_table)r~rrs r;rwrw.sV%##c%00 KKM%!!S   5 ! repicturecSnURbW[R"[UR55n[R "UR S5SS9nSSS5 URUS9 g!,(df  N=f![[4a+n[RSURU5 SnANWSnAff=f)zAdd one picture, embedding its image when the bytes can be decoded. Args: doc: The document being built. picture: The picture to add. NRGBH)imagedpiz#Could not decode Pages image %s: %s)r) rr openrr from_pilrr6 ValueError_logdebugrM add_picture)r~rropenedr9s r;rrHs"E|| QGGLL12f ))u0E2N3OO%O 32$ Q JJ>CrcURcUR5 O[XURU5$UR[R :XaUR URS9$UR[R:Xa-URURUR=(d SS9$[XUR5$)aAdd one paragraph, as a heading, a list item or body text. Args: doc: The document being built. paragraph: The paragraph to add. lists: The list groups currently open. Returns: The item the paragraph became, or its first when its runs differ. )rr)rlevel) list_labelr_add_list_itemrrTITLE add_titlerSECTION_HEADER add_headingrr)r~rrs r;rr\s# ci.B.BEJJ,,,,}})..}11,555INN)//:NQOO SY__ 55rer content_layerc URVs/sHoDR(dMUPM nn[U5(aRU(aUSO [SS5nUR UURUR [ UR5US9$URUS9nUVs/sH>nUR UURUR [ UR5UUS9PM@ nnUS$s snfs snf)uAdd a paragraph's runs, keeping the formatting attached to each one. ``TextItem`` carries a single ``Formatting`` and a single hyperlink, so a paragraph whose runs differ in either has to become an inline group of items — the same shape the Word and HTML backends produce for mixed runs. Args: doc: The document being built. paragraph: The paragraph to add. label: The label to give the item, or every item of the group. content_layer: The layer to add to, or None for the document's default. Returns: The item added, or the first of the group. A comment annotates a stretch of the paragraph, and the first item is the one that always exists, whichever run that stretch began in. rN)rr formatting hyperlinkr)r)rrrrrr) runsr_uniformradd_textr _hyperlinkradd_inline_group) r~rrrrunrfirstgroupitemss r;rrvs.%>> 6>CXXC>D 6~~QST]||'' 1'     } =E C ~~ /'    8O/ 7 sC0C0$AC5c URUR5nURVs/sHoUR(dMUPM nnU(a[ U5(aUSO [ SS5nUR URURURUUR[UR5S9$s snf)z?Add one list item under the group its nesting depth belongs to.rrN)r enumeratedmarkerrrr) rrrrrr add_list_itemrrrrr)r~rrrrrruniforms r;rrs OOEKK (E$>> 6>CXXC>D 6(4..d1gc"dmG    ^^##||%%W../   7s CCrcX^[U5S::agUSm[U4SjU55$)zReport whether every run shares one formatting and one link. ``Formatting`` is a model rather than a hashable value, so the runs are compared against the first rather than deduplicated through a set. rTrc3># UH>nURTR:H=(a URTR:Hv M@ g7frA)rr)rDrrs r;rF_uniform..s<C %***Os}}/OOsAA )rSall)rrs @r;rrs6  4yA~ GE  readdresscU(dg[U5R(d [U5$[U5$![a [ R SU5 gf=f)amResolve a link's address to a URL or a local path. A Pages document can link to a file next to it as well as to a URL, and an address Pydantic will not accept is dropped rather than allowed to fail the whole conversion. Args: address: The address the document recorded, if any. Returns: The address as a URL or a path, or None when there is none to use. Nz.Skipping malformed Pages hyperlink address: %r)rschemerrrrr)rs r;rrsR  G  # #G}g  CWMs : AArA)Hrlogging mimetypesr.iorpathlibr urllib.parserdocling_core.types.docrrrr r "docling_core.types.doc.items.groupr !docling_core.types.doc.items.textr PILr pydanticrrtyping_extensionsr docling.backend.abstract_backendrdocling.backend.iworkrrdocling.backend.iwork.contentrrrrrrrdocling.backend.iwork.iwar!docling.datamodel.backend_optionsrdocling.datamodel.base_modelsrdocling.datamodel.documentrdocling.exceptionsr getLoggerrrrtadd_typerLr\r"rvrdictstrr|r{rwrrrrrrrrOrer;rs"!96,&G63A540"/  ?H-5W :Wt!#!#HQ Q$(MQ>B3=>QQ Q&EE'EdE( !&/9 _4!o!!D!(6 6%.67A6 _6<*. . .. . $& .  .b %.7@IS " 49  d v}t';re