U NfZ@sddlZddlZddlmZddlmZddlmZmZmZm Z m Z m Z m Z m Z mZmZddlmZddlmZmZddlmZdd lmZmZmZmZdd lmZdd lm Z!dd lm"Z"m#Z#m$Z$dd lm%Z&ddlm'Z(ddlm)Z*ddlm+Z,ddlm-Z.ddl/m0Z0ddl1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCddlDmEZEmFZFddlGmHZHeIeJeeJe edffdddZKGddde6ZLGdddZMGddde eefZNdS) N)abstractmethod)datetime) AnyDictIterableIteratorListMappingOptionalTupleUnioncast) Encryption) PageObject _VirtualList) index2label)b_deprecate_with_replacementlogger_warningparse_iso8824_date)CatalogAttributes)CatalogDictionary)CheckboxRadioButtonAttributesGoToActionArgumentsUserAccessPermissions)Core)DocumentInformationAttributes)FieldDictionaryAttributes)PageAttributes)PagesAttributes) PdfReadError) ArrayObject BooleanObjectByteStringObject DestinationDictionaryObjectEncodedStreamObjectFieldFit FloatObjectIndirectObject NameObject NullObject NumberObject PdfObjectTextStringObject TreeObjectViewerPreferencescreate_string_object) OutlineType PagemodeType)XmpInformation.)dsizereturncCs4|dkrtdd|}|dd}td|dS)Nzinvalid size in convert_to_intsiz>qr)r!structunpack)r7r8r=5/tmp/pip-unpacked-wheel-zevpxvmc/pypdf/_doc_common.pyconvert_to_int`s  r?c@sfeZdZdZddddZeeedddZeeedd d Z eeedd d Z eeedd dZ eeedddZ eeedddZ eeedddZeeedddZeeedddZeeedddZeeedddZeeedddZeeeddd Zeeedd!d"Zeeedd#d$ZdS)%DocumentInformationa A class representing the basic document metadata provided in a PDF File. This class is accessible through :py:class:`PdfReader.metadata`. All text properties of the document metadata have *two* properties, eg. author and author_raw. The non-raw property will always return a ``TextStringObject``, making it ideal for a case where the metadata is being displayed. The raw property can sometimes return a ``ByteStringObject``, if pypdf was unable to decode the string's text encoding; this requires additional safety in the caller and therefore is not as commonly accessed. Nr9cCst|dSN)r&__init__selfr=r=r>rCwszDocumentInformation.__init__keyr9cCs||d}t|tr|SdSrB)get isinstancer0)rErGretvalr=r=r> _get_textzs  zDocumentInformation._get_textcCs,|tjr(|tjp*|tjSdS)z Read-only property accessing the document's title. Returns a ``TextStringObject`` or ``None`` if the title is not specified. N)rHDITITLErK get_objectrDr=r=r>titles zDocumentInformation.titlecCs |tjS)z>The "raw" version of title; can return a ``ByteStringObject``.)rHrLrMrDr=r=r> title_rawszDocumentInformation.title_rawcCs |tjS)z Read-only property accessing the document's author. Returns a ``TextStringObject`` or ``None`` if the author is not specified. )rKrLAUTHORrDr=r=r>authorszDocumentInformation.authorcCs |tjS)z?The "raw" version of author; can return a ``ByteStringObject``.)rHrLrQrDr=r=r> author_rawszDocumentInformation.author_rawcCs |tjS)z Read-only property accessing the document's subject. Returns a ``TextStringObject`` or ``None`` if the subject is not specified. )rKrLSUBJECTrDr=r=r>subjectszDocumentInformation.subjectcCs |tjS)z@The "raw" version of subject; can return a ``ByteStringObject``.)rHrLrTrDr=r=r> subject_rawszDocumentInformation.subject_rawcCs |tjS)ac Read-only property accessing the document's creator. If the document was converted to PDF from another format, this is the name of the application (e.g. OpenOffice) that created the original document from which it was converted. Returns a ``TextStringObject`` or ``None`` if the creator is not specified. )rKrLCREATORrDr=r=r>creators zDocumentInformation.creatorcCs |tjS)z@The "raw" version of creator; can return a ``ByteStringObject``.)rHrLrWrDr=r=r> creator_rawszDocumentInformation.creator_rawcCs |tjS)aI Read-only property accessing the document's producer. If the document was converted to PDF from another format, this is the name of the application (for example, macOS Quartz) that converted it to PDF. Returns a ``TextStringObject`` or ``None`` if the producer is not specified. )rKrLPRODUCERrDr=r=r>producers zDocumentInformation.producercCs |tjS)zAThe "raw" version of producer; can return a ``ByteStringObject``.)rHrLrZrDr=r=r> producer_rawsz DocumentInformation.producer_rawcCst|tjS)z:Read-only property accessing the document's creation date.)rrKrL CREATION_DATErDr=r=r> creation_datesz!DocumentInformation.creation_datecCs |tjS)z The "raw" version of creation date; can return a ``ByteStringObject``. Typically in the format ``D:YYYYMMDDhhmmss[+Z-]hh'mm`` where the suffix is the offset from UTC. )rHrLr]rDr=r=r>creation_date_rawsz%DocumentInformation.creation_date_rawcCst|tjS)z Read-only property accessing the document's modification date. The date and time the document was most recently modified. )rrKrLMOD_DATErDr=r=r>modification_datesz%DocumentInformation.modification_datecCs |tjS)z The "raw" version of modification date; can return a ``ByteStringObject``. Typically in the format ``D:YYYYMMDDhhmmss[+Z-]hh'mm`` where the suffix is the offset from UTC. )rHrLr`rDr=r=r>modification_date_raws z)DocumentInformation.modification_date_raw)__name__ __module__ __qualname____doc__rCstrr rKpropertyrOrPrRrSrUrVrXrYr[r\rr^r_rarbr=r=r=r>r@hs>      r@c @seZdZUdZdZeed<dZee ed<e e e dddZ e e edd d Ze eeefeed d d Ze eeedddZe e ee dddZe eedddZe eedddZe dzedeefedeefeeefdddZe eedddZ dZ!ee"e#ed<edddZ$ee#dd d!Z%e eeefdd"d#Z&e'dd$d%Z(d{ee)dfeeeeefd&d'd(Z*d|ee)eeeefeeeeeefd)d*d+Z+e ed,d-d.Z,ee)e feeefeedd/d0d1Z-ee)e feedd)d2d3Z.eeedd4d5d6Z/d}eeeefd7d8d9Z0ee1eefe"e#d:d;d<Z2e ede3e4e5fdd=d>Z6e6j7edee3e#fdd?d@d>Z6e e8ddAdBZ9d~ee eee8dCdDdEZ:e ee'ddFdGZ;e edeee3eedMdNdOZ?eee"ee@ede root_objectszPdfDocCommon.root_objectcCsdSrBr=rDr=r=r> pdf_headerszPdfDocCommon.pdf_header)indirect_referencer9cCsdSrBr=rErnr=r=r>rN szPdfDocCommon.get_object)indirectobjr9cCsdSrBr=)rErprqr=r=r>_replace_objectszPdfDocCommon._replace_objectcCsdSrBr=rDr=r=r>_infoszPdfDocCommon._infocCs$t}|jdkrdS||j|S)a Retrieve the PDF file's document information dictionary, if it exists. Note that some PDF files use metadata streams instead of document information dictionaries, and these metadata streams will not be accessed by this function. N)r@rsupdate)rErJr=r=r>metadatas   zPdfDocCommon.metadatacCsdSrBr=rDr=r=r> xmp_metadata*szPdfDocCommon.xmp_metadata)includeexcluder9cCsdS)z Integration into Jupyter Notebooks. This method returns a dictionary that maps a mime-type to it's representation. See https://ipython.readthedocs.io/en/stable/config/integrating.html Nr=)rErwrxr=r=r>_repr_mimebundle_.szPdfDocCommon._repr_mimebundle_cCsd|jtjd}|dkrdS|}t|ts`t|}t|drP||j |n||jt tj<|S)zCReturns the existing ViewerPreferences as an overloaded dictionary.Nrn) rlrHCDZVIEWER_PREFERENCESrNrIr2hasattrrrrnr,)rEor=r=r>viewer_preferences>s  zPdfDocCommon.viewer_preferencesflattened_pagescCsB|jr|jddS|jdkr&||jdk s4tt|jSdS)a Calculate the number of pages in this PDF file. Returns: The number of pages of the parsed PDF file Raises: PdfReadError: if file is encrypted and restrictions prevent this action. /Pages/CountN) is_encryptedrlr~_flattenAssertionErrorlenrDr=r=r> get_num_pagesOs  zPdfDocCommon.get_num_pages) page_numberr9cCs.|jdkr||jdk s$td|j|S)a@ Retrieve a page by number from this PDF file. Most of the time ```.pages[page_number]``` is preferred. Args: page_number: The page number to retrieve (pages begin at zero) Returns: A :class:`PageObject` instance. Nz hint for mypy)r~rr)rErr=r=r>get_pagees zPdfDocCommon.get_pagecCs|S)zu A read-only dictionary which maps names to :class:`Destinations` )_get_named_destinationsrDr=r=r>named_destinationsvszPdfDocCommon.named_destinationscCs2t}tj|jkrt|jtjtrtt|jtj}|j}tj|krt|tjtrtt|tj}|j}tj|krtt|tj}qt}||t tj<n6t |drt}| |}||t tj<||t tj<nXt |dr.t}| |}||jt tj<t}| |}||t tj<||t tj<|S)N _add_object) r"CANAMESrlrIr&r rnDESTSr,r{r)rEZ named_destnamesZ names_refZdestsZ dests_refr=r=r>get_named_dest_root~s8       z PdfDocCommon.get_named_dest_root)treerJr9c Cs|dkrbi}|j}tj|kr.tt|tj}n4tj|krbtt|tj}tj|krbtt|tj}|dkrn|Stj|krtt |tjD]}| | |qn,tj|krltt|tj}d}|t |krtt || }|d7}t|t sqz|| }Wntk r"YqYnX|d7}t|trLd|kr|d}nq|||} | dk r| ||<qnb|D]X\} } | } t| trd| krt| d } nqt|| | } | dk rt| || <qt|S)z Retrieve the named destinations present in the document. Args: tree: retval: Returns: A dictionary which maps names to :class:`Destinations`. Nrr/D)rlrrr r1rr&PAKIDSr"rrNrrgrI IndexError_build_destinationitems) rErrJcatalogrkidirGvaluedestZk__Zv__valr=r=r>rsX                z$PdfDocCommon._get_named_destinations)rrJfileobjr9c Cst}|t|dkrLi}|j}tj|krHttt |tj}ndS|dkrX|S| ||||D] }||krj| ||||qqjd|krtt |d}|D]}| } | | |||q|S)aX Extract field data if this PDF contains interactive form fields. The *tree* and *retval* parameters are for recursive use. Args: tree: retval: fileobj: A file object (usually a text file) to write a report to on all interactive form fields found. Returns: A dictionary where each key is a field name, and each value is a :class:`Field` object. By default, the mapping name is used for keys. ``None`` if form data could not be located. Nz/Fields)FAZattributes_dictrtrrlrzZ ACRO_FORMr r r1 _check_kids _build_fieldr"rN) rErrJrfield_attributesrattrfieldsffieldr=r=r> get_fieldss* zPdfDocCommon.get_fields)parentr9cCs^d|krtt|dSd|krH|tt|ddtt|ddStt|ddSdS)N/TM/Parent./T)r rg_get_qualified_field_namer&rH)rErr=r=r>rs z&PdfDocCommon._get_qualified_field_name)rrJrrr9c CsV||||ztt|d}Wnjtk rzr*sV   0 zPdfDocCommon._build_fieldcCs0tj|kr,|tjD]}||||qdSrB)rrrrN)rErrJrrr=r=r>r`s zPdfDocCommon._check_kids)rrrr9c Cst}|t}|D]}|tjtjfkr.q||}z|tjkr|ddddd}|||kr||d|||dnr|tjkrz||tj}Wn"t k r||tj }YnX||d|dn||d||dWqt k rYqXqdS)NZButtonTextZChoice Signature)r/Txrz/Sig: r) r attributesrrZAArrZParentZTMrT) rErrrZfield_attributes_tupler attr_nametypesnamer=r=r>rhs8     zPdfDocCommon._write_field)full_qualified_namer9cCsttttftddd}|}|dkr.iSi}|D]H\}}|ddkr:|rd|d||<q:|d||tt|d|<q:|S) a Retrieve form fields from the document with textual data. Args: full_qualified_name: to get full name Returns: A dictionary. The key is the name of the form field, the value is the content of the field. If the document contains multiple form fields with the same name, the second and following will get the suffix .2, .3, ... )rrr9cs6|kr Sdttfdd|DdSdS)Nrcsg|]}|drdqS)rr) startswith).0kkrr=r> szJPdfDocCommon.get_form_text_fields..indexed_key..)rgsum)rrr=rr> indexed_keysz6PdfDocCommon.get_form_text_fields..indexed_keyN/FTrz/Vr)rgrrrrrHr )rErrZ formfieldsffrrr=r=r>get_form_text_fieldss  z!PdfDocCommon.get_form_text_fields)rr9c s.tttdfdd zttjWn,tk rV}ztd|W5d}~XYnXddkrntdg}dd d krd krd g}nfd d j D}nldd}|D]Zdd d krdkrd kr|d g7}q|fdd j D7}qfdd |DS)a Provides list of pages where the field is called. Args: field: Field Object, PdfObject or IndirectObject referencing a Field Returns: List of pages: - Empty list: The field has no widgets attached (either hidden field or ancestor field). - Single page list: Page where the widget is present (most common). - Multi-page list: Field with multiple kids widgets (example: radio buttons, field repeated on multiple pages). )rqrGr9cs8||kr||Sd|kr0tt|d|SdSdS)Nr)r r&rN)rqrG)_get_inheritedr=r>rsz._get_inheritedzfield type is invalidNrzfield is not validz/Subtyperz/Widgetz/Pcs"g|]}j|ddkr|qSz/AnnotsrrnrHrp)rr=r>rsz8PdfDocCommon.get_pages_showing_field..z/Kidsr=rcs"g|]}j|ddkr|qSrrrrr=r>rscs,g|]$}t|tr|nj|jqSr=)rIrpages_get_page_number_by_indirectrn)rxrDr=r>rs) r&rgrr rnrN Exception ValueErrorrHr)rErexcretZkidsr=)rrrrEr>get_pages_showing_fields4       z$PdfDocCommon.get_pages_showing_fieldc Csd|jkrdS|jd}t|tr*|}t|tropen_destinations      (zPdfDocCommon.open_destination)rr9cCs tddS)Nzno setter for open_destination)NotImplementedError)rErr=r=r>rscCs|S)z Read-only property for the outline present in the document. (i.e., a collection of 'outline items' which are also known as 'bookmarks') ) _get_outlinerDr=r=r>outlineszPdfDocCommon.outline)noderr9cCs|dkrbg}|j}tj|krXtt|tj}t|tr:|S|dk rXd|krXtt|d}||_|dkrn|S| |}|r| |d|krg}| tt|d||r| |d|krqtt|d}qn|S)Nz/Firstz/Next) rlCOZOUTLINESr r&rIr-r _namedDests_build_outline_itemrr)rErrrlinesZ outline_objZ sub_outliner=r=r>r%s0      zPdfDocCommon._get_outlinecCs(|j}tj|kr td|tjSdSdS)u Read-only property for the list of threads. See §8.3.2 from PDF 1.7 spec. It's an array of dictionaries with "/F" and "/I" properties or None if there are no articles. r"N)rlrZTHREADSr )rErr=r=r>threadsNs  zPdfDocCommon.threadscCsdSrBr=ror=r=r>r^sz)PdfDocCommon._get_page_number_by_indirect)rr9cCs ||jS)a Retrieve page number of a given PageObject. Args: page: The page to get page number. Should be an instance of :class:`PageObject` Returns: The page number or None if page is not found )rrn)rErr=r=r>get_page_numberds zPdfDocCommon.get_page_number) destinationr9cCs ||jS)z Retrieve page number of a given Destination object. Args: destination: The destination to get page number. Returns: The page number or None if page is not found )rr)rErr=r=r>get_destination_page_numberqs z(PdfDocCommon.get_destination_page_number)rOrr9cCsd\}}t|ttfs4t|tr,t|dks4|dkrJt}t||tS|dd\}}|dd}zt||t||dWStk rt d|d|t |j r|j dj }|dkrtn|}t||tYSXdS)N)NNrr)Zfit_typeZfit_argszUnknown destination:  )rIr-rgr"rr%r)rr!rrcrjrrn)rErOrrrtmprnr=r=r>r}s,     zPdfDocCommon._build_destination)rr9cCs d\}}}ztd|d}Wn,tk rH|jr@td|d}YnXd|krtt|d}tt|tj}|dkr|tj}n*d|kr|d}t |trd |kr|d }t |t r| ||}nt |t rz| ||j |j}Wn"tk r | |d}YnXnN|dkr(| ||}n6|jr@td |ntd |d t| |d}|rd |krt dd|d D|td <d|kr|d|td<d|kr|d|td<t|dddk|td<||_z |j|_Wntk rYnX|S)N)NNNrgz/Titlez(Outline Entry Missing /Title attribute: rz/Az/GoToz/DestrzUnexpected destination zRemoved unexpected destination z from destinationz/Ccss|]}t|VqdSrB)r*)rcr=r=r> sz3PdfDocCommon._build_outline_item../Frrz /%is_open%)r rrjr!r&r,rSDrIr"rrgrZ dest_arrayrrcr#rHrrnAttributeError)rErrrOZ outline_itemactionZ action_typer=r=r>rsf              z PdfDocCommon._build_outline_itemcCst|j|jS)aR Property that emulates a list of :class:`PageObject`. this property allows to get a page or a range of pages. For PdfWriter Only: It provides also capability to remove a page/range of page from the list (through del operator) Note: only the page entry is removed. As the objects beneath can be used somewhere else. A solution to completely remove them - if they are not used anywhere - is to write to a buffer/temporary file and to load it into a new PdfWriter object afterwards. )rrrrDr=r=r>rszPdfDocCommon.pagescsfddttjDS)z A list of labels for the pages in this document. This property is read-only. The labels are in the order that the pages appear in the document. csg|]}t|qSr=)page_index2page_label)rrrDr=r>rsz,PdfDocCommon.page_labels..)rangerrrDr=rDr> page_labelsszPdfDocCommon.page_labelscCs0ztt|jtjWStk r*YdSXdS)a Get the page layout currently being used. .. list-table:: Valid ``layout`` values :widths: 50 200 * - /NoLayout - Layout explicitly not specified * - /SinglePage - Show one page at a time * - /OneColumn - Show one column at a time * - /TwoColumnLeft - Show pages in two columns, odd-numbered pages on the left * - /TwoColumnRight - Show pages in two columns, odd-numbered pages on the right * - /TwoPageLeft - Show two pages at a time, odd-numbered pages on the left * - /TwoPageRight - Show two pages at a time, odd-numbered pages on the right N)r r,rlrzZ PAGE_LAYOUTrrDr=r=r> page_layoutszPdfDocCommon.page_layoutcCs(z |jdWStk r"YdSXdS)a2 Get the page mode currently being used. .. list-table:: Valid ``mode`` values :widths: 50 200 * - /UseNone - Do not show outline or thumbnails panels * - /UseOutlines - Show outline (aka bookmarks) panel * - /UseThumbs - Show page thumbnails panel * - /FullScreen - Fullscreen view * - /UseOC - Show Optional Content Group (OCG) panel * - /UseAttachments - Show attachments panel z /PageModeN)rlrrDr=r=r> page_modes zPdfDocCommon.page_mode)rinheritrnr9cCsVttjttjttjttjf}|dkr0i}|dkr^|j}|d}t|t sXt g|_ t j |krztt|t j }nt j|krd}nd}|dkr|D]}||kr||||<qtt|t jD]6}i} t|tr|| d<|} | r|j| |f| qnT|dkrRt|D]\} } | |kr| || <qt||} | ||j | dS)Nrz/Pagern)r,PGZ RESOURCESZMEDIABOXZCROPBOXZROTATErlrNrIr&rr~rZTYPEr rgrr"r+rrrrrtr)rErrrnZinheritable_page_attributesrtrrZaddtrqZattr_inrZpage_objr=r=r>r9sF         zPdfDocCommon._flatten)rcleanr9cCs|jdkr||jdk s tt|trN|}t|tsJtdtdS|}t|t sz|j |}Wn t k rtdtYdSXd|krt |jksntdtdS|j |j}|j |=|r|dk r||tdS)a Remove page from pages list. Args: page: int / PageObject / IndirectObject PageObject : page to be removed. If the page appears many times only the first one will be removed IndirectObject: Reference to page to be removed int: Page number to be removed clean: replace PageObject with NullObject to prevent destination, annotation to reference a detached page Nz(IndirectObject is not referencing a pagezCannot find page in pagesrzPage number is out of range)r~rrrIr+rNrrrcintrrrrrnrrr-)rErrrindr=r=r> remove_pageos,         zPdfDocCommon.remove_page)numgenr9cCst|||S)a/ Used to ease development. This is equivalent to generic.IndirectObject(num,gen,self).get_object() Args: num: The object number of the indirect object. gen: The generation number of the indirect object. Returns: A PdfObject )r+rN)rErrr=r=r>_get_indirect_objects z!PdfDocCommon._get_indirect_object)permissions_coder9c sJtddddtjtjtjtjtjtjtjtj d}fdd| DS)z>Take the permissions as an integer, return the allowed access.decode_permissionsuser_access_permissionsz5.0.0)Zold_namenew_nameZ removed_in)printmodifycopy annotationsZformsZ accessabilityZassembleZprint_high_qualitycsi|]\}}||@dkqS)rr=)rrGflagr r=r> sz3PdfDocCommon.decode_permissions..) rrZPRINTZMODIFYZEXTRACTZ ADD_OR_MODIFYZFILL_FORM_FIELDSZEXTRACT_TEXT_AND_GRAPHICSZ ASSEMBLE_DOCZPRINT_TO_REPRESENTATIONr)rEr Zpermissions_mappingr=rr>r s" zPdfDocCommon.decode_permissionscCs|jdkrdSt|jjS)zWGet the user access permissions for encrypted documents. Returns None if not encrypted.N)rkrPrDr=r=r>r s z$PdfDocCommon.user_access_permissionscCsdS)z Read-only boolean property showing whether this PDF file is encrypted. Note that this property, if true, will remain true even after the :meth:`decrypt()` method is called. Nr=rDr=r=r>rs zPdfDocCommon.is_encryptedc Csd}i}|j}d|ks|ds"dStt|d}d|krtt|d}t|}|D]H}|}t|}t|trRttt | }|rRt t |j} | ||<qR|S)Nz /AcroFormz/XFA)rlr r1r"iternextrIr+r r'rNzlib decompressr_data) rErrJrrrrtagresr=r=r>xfas$  zPdfDocCommon.xfacstfddDS)Ncsi|]}|j|fqSr=)_get_attachment_list)rrrDr=r>rsz,PdfDocCommon.attachments..)LazyDict_list_attachmentsrDr=rDr> attachmentss  zPdfDocCommon.attachmentscCsX|j}z&tttttt|ddd}Wntk rDgYSXdd|D}|S)zv Retrieves the list of filenames of file attachments. Returns: list of filenames /Names/EmbeddedFilescSsg|]}t|tr|qSr=)rIrg)rrr=r=r>r s z2PdfDocCommon._list_attachments..)rlr r"r&r)rEr filenamesZattachments_namesr=r=r>r s zPdfDocCommon._list_attachments)rr9cCs"|||}t|tr|S|gSrB)_get_attachmentsrIr)rEroutr=r=r>rs z!PdfDocCommon._get_attachment_list)filenamer9c Cs|j}z&tttttt|ddd}Wntk rDiYSXi}tt|D]}||}t|trV|dk r~||kr~qV|}||d }|dd } ||krt||t s||g||<|| | qV| ||<qV|S)a Retrieves all or selected file attachments of the PDF as a dictionary of file names and the file data as a bytestring. Args: filename: If filename is None, then a dictionary of all attachments will be returned, where the key is the filename and the value is the content. Otherwise, a dictionary with just a single key - the filename - and its content will be returned. Returns: dictionary of filename -> Union[bytestring or List[ByteString]] If the filename exists multiple times a list of the different versions will be provided. r"r#Nrz/EFr) rlr r"r&rrrrIrgrNget_datarr) rEr'rr$r!rrrZf_dictZf_datar=r=r>r%s8   zPdfDocCommon._get_attachments)NN)NN)NNN)F)NN)NNN)F)N)Vrcrdrerfrjbool__annotations__rkr rrhrr&rlrgrmr rr+r/rNrrrsr@rur6rvrrrryr2r}r~rrrrrr"rr1rrrrrrrr(rr%r0r$rsetterr4rrrr-rrrr.rrrrrr5rrrr r rr rrr rr!r rr%r=r=r=r>ris"    %  K 2   7  %'  F  )  K   9  -  ric@s\eZdZeeddddZeedddZeedd d Ze dd d Z edd dZ dS)rN)argskwr9cOst|||_dSrB)dict _raw_dict)rEr,r-r=r=r>rCFszLazyDict.__init__rFcCs|j|\}}||SrB)r/ __getitem__)rErGfuncargr=r=r>r0IszLazyDict.__getitem__rAcCs t|jSrB)rr/rDr=r=r>__iter__MszLazyDict.__iter__cCs t|jSrB)rr/rDr=r=r>__len__PszLazyDict.__len__cCsdt|dS)NzLazyDict(keys=))rrrDr=r=r>__str__SszLazyDict.__str__) rcrdrerrCrgr0rr3rr4r6r=r=r=r>rEs r)Or;rabcrrtypingrrrrrr r r r r rkrZ_pagerrZ _page_labelsrr_utilsrrrr constantsrrrrzrrrrrrrLrrrrr rerrorsr!Zgenericr"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3rr4r5xmpr6rrr?r@rirr=r=r=r>sB  0          P "V