j-mUdZddlZddlZddlZddlZddlmZmZddl m Z m Z ddl m Z ddl mZddlmZddlmZmZdd lmZdd lmZdd lmZmZdd lmZmZdd lmZddl m!Z!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*m+Z+ej,ddZ-gdZ.e GddeZ/e GddeeZ0e Gdde0Z1e Gdde0Z2e Gdd e0Z3e Gd!d"e0Z4e Gd#d$e0Z5e Gd%d&e5Z6e Gd'd(e0Z7e Gd)d*e0Z8e Gd+d,e0Z9e Gd-d.e0Z:dZ;ej<e/e=d/<e Gd0d1e0Z>e Gd2d3e0eZ?e Gd4d5eeZ@Gd6d7eZAGd8d9eZBe Gd:d;eZCe Gd<d=eCeAeZDe Gd>d?eCeBeZEe Gd@dAeeZFe GdBdCeFeZGe GdDdEeFeZHGdFdGZIGdHdIZJGdJdKZKGdLdMZLe GdNdOZMdS)Pz^Defines Abstract Base Classes (ABC's) core to batch processing documents through Unstructured.N)ABCabstractmethod) dataclassfield)datetime)Path)DataClassJsonMixin)Json_decode_dataclass)chunk_by_title)DataSourceMetadata)BaseEmbeddingEncoderElement)EnhancedDataClassJsonMixinenhanced_field)_asdict)PartitionErrorSourceConnectionError)logger)partition_via_api) partition)convert_to_dict flatten_dictAr )bound) s3s3aabfsazgsgcsboxdropboxsftpceZdZdZdS)BaseSessionHandlezAbstract Base Class for sharing resources that are local to an individual process. e.g., a connection for making a request for fetching documents.N__name__ __module__ __qualname____doc__h/lsinfo/ai/hellotax_ai/base_platform/venv/lib/python3.11/site-packages/unstructured/ingest/interfaces.pyr&r&*s"GGGGr-r&ceZdZdS) BaseConfigNr(r)r*r,r-r.r0r00Dr-r0ceZdZdS) AccessConfigNr1r,r-r.r4r45s Dr-r4c\eZdZUdZdZejeed<dZ eje ed<dS)RetryStrategyConfiga Contains all info needed for decorator to pull from `self` for backoff and retry triggered by exception. Args: max_retries: The maximum number of attempts to make before giving up. Once exhausted, the exception will be allowed to escape. The default value of None means there is no limit to the number of tries. If a callable is passed, it will be evaluated at runtime and its return value used. max_retry_time: The maximum total amount of time to try for before giving up. Once expired, the exception will be allowed to escape. If a callable is passed, it will be evaluated at runtime and its return value used. N max_retriesmax_retry_time) r(r)r*r+r7tOptionalint__annotations__r8floatr,r-r.r6r6;sK $(KC'''(,NAJu%,,,,,r-r6c.eZdZUdZeed<dZeed<dZe j e j eed<dZ e j eed<e eZeed <dZe j e j eed <e d Ze j eed <dZeed <e eZe j eed<e eZe j eed<dZe j eed<dZeed<eddZe j eed<dZe j eed<dS)PartitionConfigFpdf_infer_table_structureautostrategyN ocr_languagesencodingdefault_factoryadditional_partition_argsskip_infer_table_typesc gdS)N) element_idtexttypemetadata embeddingsr,r,r-r.zPartitionConfig.[s X X Xr-fields_includeflatten_metadatametadata_excludemetadata_includez.https://api.unstructured.io/general/v0/generalpartition_endpointpartition_by_apiTdefault sensitiveapi_keyhi_res_model_name)r(r)r*r@boolr<rBstrrCr9r:ListrDrdictrGrHrPrQlistrRrSrTrUrrYrZr,r-r.r?r?Qs',t+++Hc-1M1:afSk*111 $Hajo$$$&+eD&A&A&AtAAA6:AJqvc{3:::"'%XX###NAF3K#d"""$)E$$?$?$?afSk???$)E$$?$?$?afSk???*Z 3ZZZ"d"""-~ddKKKGQZ_KKK)-qz#-----r-r?ceZdZUdZeed<dZeed<eej dz dz dz dz Z eed<d Z eed <d Z eed <dZeed <dS)ProcessorConfigF reprocessverbosez.cache unstructuredingestpipelinework_dirzstructured-output output_dir num_processesraise_on_errorN)r(r)r*rbr[r<rcr\rhomeresolvergrhrjr;rkr,r-r.rarafsItGTCx/.@8KjXaaccddHcddd)J)))M3 ND     r-racpeZdZUeed<dZeed<dZeed<dZe j e j eed<dS)FileStorageConfig remote_urlF uncompress recursiveN file_glob) r(r)r*r\r<rqr[rrrsr9r:r]r,r-r.roropsXOOOJIt)-Iqz!&+&-----r-roceZdZUdZeed<edZeed<edZ eed<edZ eed<edZ eed<d e fd Z d ZdS) FsspecConfigN access_configF)initprotocolpath_without_protocoldir_path file_pathreturncJ|jr|jdSiS)NF)apply_name_overload)rvto_dictselfs r.get_access_configzFsspecConfig.get_access_configs,   %--%-HH HIr-cn|jd\|_|_|jtvr t d|jdtdt j|jd|j}|r|jdkrd|_d|_ dSt j|jd |j}|rC|jdkr8| d |_| d pd|_ dSt j|jd |j}|r#| d |_d|_ dSt j|jd |j}|st d|jd| d |_| d pd|_ dS)Nz://z Protocol z not supported yet, only z are supported.z ://([\s])/r# z:///([^/\s]+?)/([^\s]*)riz://([^/\s]+?)(/*)$z://([^/\s]+?)/([^\s]*)z Invalid path z6. Expected :///.) rpsplitrxry!SUPPORTED_REMOTE_FSSPEC_PROTOCOLS ValueErrorrematchrzr{group)rrs r. __post_init__zFsspecConfig.__post_init__s48O4I4I%4P4P1 t1 = A A AFDMFF4FFF  T]666HH  T]i//DMDN FT]CCCT_UU  T]i//!KKNNDM"[[^^1rDN FT]>>>PP  !KKNNDMDN FT]BBBDOTT HHHH  A Q-2r-)r(r)r*rvr4r<rrxr\ryrzr{r^rrr,r-r.ruruxs"&M<&&&Eu%%%Hc%%%!&E!2!2!23222Eu%%%Hc%%%U&&&Is&&&4 %.%.%.%.%.r-rucleZdZUdZeed<dZeed<dZeed<dZ eed<dZ e j e ed<dS) ReadConfigr download_dirF re_downloadpreserve_downloads download_onlyNmax_docs)r(r)r*rr\r<rr[rrrr9r:r;r,r-r.rrskL#K$$$$M4 $Hajo$$$$$r-rceZdZUeed<eddZejeed<dZ ejeed<de fdZ dS) EmbeddingConfigproviderNTrVrY model_namer|c i}|jr |j|d<|jr |j|d<|jdkrddlm}m}||d i|S|jdkrddlm}m}||d i|St|jd ) NrYrzlangchain-openair)OpenAiEmbeddingConfigOpenAIEmbeddingEncoder)configzlangchain-huggingface)HuggingFaceEmbeddingConfigHuggingFaceEmbeddingEncoderz not a recognized encoderr,) rYrrunstructured.embed.openairrunstructured.embed.huggingfacerrr)rkwargsrrrrs r. get_embedderzEmbeddingConfig.get_embedders < - $ F9  ? 3#'?F< =. . . _ _ _ _ _ _ _ _))1F1F1P1P1P1PQQQ Q ]5 5 5         /.6P6P6Z6ZSY6Z6Z[[[ [ HHHII Ir-) r(r)r*r\r<rrYr9r:rrrr,r-r.rrs}MMM-~ddKKKGQZ_KKK"&J 3&&&J2JJJJJJr-rceZdZUdZeed<dZeed<dZeed<dZ eed<d Z e j eed <d e j ed e j efd Zd S)ChunkingConfigFchunk_elementsTmultipage_sectionsicombine_text_under_n_charsimax_charactersNnew_after_n_charselementsr|cd|jr(t||j|j|j|jS|S)N)rrrrr)rr rrrr)rrs r.chunkzChunkingConfig.chunksF   !!#'#:+/+J#2"&"8  Or-)r(r)r*rr[r<rrr;rrr9r:r]rrr,r-r.rrs ND   ####&))))NC)-qz#--- afWo !&/      r-rceZdZUedZejeed<edZ ejeed<eddd Z ejeed <dS) PermissionsConfigpermissions_application_id) overload_nameapplication_idpermissions_tenanttenantNTpermissions_client_cred)rWrXr client_cred) r(r)r*rrr9r:r\r<rrr,r-r.rrs&4nC_&`&`&`NAJsO```,n;OPPPFAJsOPPP#1>4M$$$KCr-rglobal_write_session_handleceZdZdS) WriteConfigNr1r,r-r.rrr2r-rceZdZdZdS)BaseConnectorConfigzEAbstract definition on which to define connector-specific attributes.Nr'r,r-r.rrsOOOOr-rc"eZdZUdZejeed<dZejeed<dZ ejeed<dZ ejeed<dZ eje ed<dZ ejejejeejfed<dS)SourceMetadataN date_created date_modifiedversion source_urlexistspermissions_data)r(r)r*rr9r:r\r<rrrrr[rr]DictAnyr,r-r.rrs$(L!*S/(((%)M1:c?)))#GQZ_###"&J 3&&&#FAJt ###?CajsAEz(:!;<CCCCCr-rc eZdZdZgdZgdZdedeje fdZ dej e e ffdZ ed d d d ejed e dedeffdZxZS)IngestDocJsonMixin Inherently, DataClassJsonMixin does not add in any @property fields to the json/dict created from the dataclass. This explicitly sets properties to look for on the IngestDoc class when creating the json/dict for serialization purposes. )rrdate_processedrrrr) base_filenamefilename_output_filenamerecord_locator_source_metadata unique_idas_dictpropsc|D]f}t||}t|trt|}t|tr|d}|||<gdSNF encode_jsongetattr isinstancerr\r rrrrpropvals r. add_propszIngestDocJsonMixin.add_props#x  D$%%C#t$$ #hh#122 5kkek44GDMM   r-r|c t|fi|}|||jt|d|||j|S)Nrrr)rrproperties_to_serializermetadata_properties)rrrs r.rzIngestDocJsonMixin.to_dict,s_$))&)) wd.JKKK 4+ , , 8 NN7$2JN K K Kr-FT) infer_missingr~clskvsr~c t|||}|dx}r)t|dt||dx}rt|d||S)N)rrr~r_date_processed)super from_dictgetsetattrr)rrrr~docmetar __class__s r.rzIngestDocJsonMixin.from_dict3sgg=FY   77-.. .4 M C+^-E-Ed-K-K L L L WW%677 7> < C*N ; ; ; r-)r(r)r*r+rrr^r9r]r\rrr r classmethodTyperr[r __classcell__)rs@r.rr s   afSk    16#t)#449W[    VAY ! PT       [     r-rceZdZdZdgZdedejefdZ ddej ee ffdZ e dd d ejed e defd Zd S)BatchIngestDocJsonMixinrrrrc|D]f}t||}t|trt|}t|tr|d}|||<gdSrrrs r.rz!BatchIngestDocJsonMixin.add_propsJrr-Fr|c`t||}|||j|S)Nrr)rrr)rrrs r.rzBatchIngestDocJsonMixin.to_dictSs2$K888 wd.JKKKr-)rrrc(t|||}|SN)r )rrrrs r.rz!BatchIngestDocJsonMixin.from_dictXsS-88 r-N)F)r(r)r*r+rr^r9r]r\rrr rrrrrr,r-r.rrAs +m  afSk    AF39,= >Cqvayt[r-rcZeZdZUeed<eed<eed<eede fdZ dS) BaseIngestDocprocessor_config read_configconnector_configr|cdSrr,rs r.rzBaseIngestDoc.unique_idds  r-N) r(r)r*rar<rrpropertyrr\rr,r-r.rr^si%%%%))))  3   ^X   r-rceZdZUdZeddZejee d<eddZ eje e d<e defdZ e jd efd Z e deje fd Ze deje fd Ze deje fd Ze dejefdZe edZe deje fdZe deje fdZe edZe dejeje ejffdZe de fdZe deje fdZe deje fdZe dejejeje ejffdZ edZ!e"dZ#d!dZ$dZ%ee&j'dZ(defdZ)e*j'de+deje,fdZ-de+dejejeje ejffd Z.dS)"BaseSingleIngestDocamAn "ingest document" is specific to a connector, and provides methods to fetch a single raw document, store it locally for processing, any cleanup needed after successful processing of the doc, and the ability to write the doc's structured outputs once processed. Crucially, it is not responsible for the actual processing of the raw document. FN)rwrWrrr|cr|j||jtd|jS)Nzfailed to set source metadata)rupdate_source_metadatarrs r.source_metadataz#BaseSingleIngestDoc.source_metadataws>  (  ' ' ) ) )  (<== =$$r-valuec||_dSr)r)rrs r.rz#BaseSingleIngestDoc.source_metadatas %r-c|jjS)z7The date the document was created on the source system.)rrrs r.rz BaseSingleIngestDoc.date_createds#00r-c|jjS)z=The date the document was last modified on the source system.)rrrs r.rz!BaseSingleIngestDoc.date_modifieds#11r-c|jS)zThe date the document was last processed by Unstructured. self._date_processed is assigned internally in self.partition_file())rrs r.rz"BaseSingleIngestDoc.date_processeds ##r-c|jjS)z1Whether the document exists on the remote source.)rrrs r.rzBaseSingleIngestDoc.existss#**r-cdSzEThe local filename of the document after fetching from remote source.Nr,rs r.rzBaseSingleIngestDoc.filenamer-c|jjrk|jrdtt |jj}t|j}||d}|SdSNr)rrrr\rrmreplace)r download_path full_path base_paths r.rz!BaseSingleIngestDoc.base_filenameso   ( T] T%5%B C C K K M MNNMDM**I!))-<.wrappers$0 M))++ M&&((0   VT]VVt}VVWWWt4.t...v.. .r-) functoolswraps)r#r$s` r.skip_if_file_existsz'BaseSingleIngestDoc.skip_if_file_existss:    / / / /   /r-c ,t|_dS)z7Sets the SourceMetadata and the properties for the docN)rr)rrs r.rz*BaseSingleIngestDoc.update_source_metadatas . 0 0r-cd|_dS)zSets the _permissions_data property for the doc. This property is later used to fill the corresponding SourceMetadata.permissions_data field, and after that carries on to the permissions_data property.N)_permissions_datars r.update_permissions_dataz+BaseSingleIngestDoc.update_permissions_datas>Br-cdS)zAFetches the "remote" doc and stores it locally on the filesystem.Nr,rs r.get_filezBaseSingleIngestDoc.get_filer r-cp|jo|jjS)z;Determine if structured output for this doc already exists.)rrrr rs r. has_outputzBaseSingleIngestDoc.has_outputs.$,,..W43H3M3M3O3O3WWr-partition_configc |jsmtjdtdt |jt |j|j|j |j |j |j |j d|}nd|j}tjd|dd|D}t!dt |j|j|d|}|S) NzUsing local partition)urlrrrrrr)rdata_source_metadatazUsing remote partition ()c8i|]\}}||t|Sr)r\).0kvs r. z6BaseSingleIngestDoc.partition_file..s,,,,"a!-3q66---r-)rrYapi_urlr,)rUrr!rr\rr rrrrrrrrTitemsrrY)rr0partition_kwargsrendpointpassthrough_partition_kwargss r.partition_filez"BaseSingleIngestDoc.partition_files  0  L0 1 1 1 T]++%7 L#'#6!%!2"&"4#'#6%)%:&&&  #  HH(:H L?H??? @ @ @,,&6&<&<&>&>,,, ()T]++(0 / Hr-c tj|_|jjrdSt jd|j|j d d|i|}t|}g|_ |D]}|j r|j rtd|j r|j }|D]u}d|vrS|d}|} |ddD]} | | vr| | } |d} | | vr| | dY|d|dvnX|j rQ|j t#|dD]"} | vr|d| d#|jfd|D}|jr>d|vr:|d} |t/| dg |j ||j S) Nz Processing r0z_Arguments `--metadata-include` and `--metadata-exclude` are mutually exclusive with each other..rMc$i|] \}}|v || Sr,r,)r6r7r8in_lists r.r9z4BaseSingleIngestDoc.process_file..Ns$BBBTQQ'\\Aq\\\r-data_source_record_locator) keys_to_omitr,)rutcnow isoformatrrrrinforr?risd_elems_no_filenamerRrSrrpopr_keysrPr;rQupdaterappend)rr0r< isd_elems_raw isd_elemselemex_listex nested_fields current_elemffield_to_excluder7rMrDs @r. process_filez BaseSingleIngestDoc.process_file%sx (00::<<   ) 4 1$-11222++bb=MbQabb #M22 AC"! 4! 4D0 65E5V 6 :"2 6*;! 7 7Bbyy(* '+ !.ss!3??A L00/;A +8+<(+|;;(,,-=tDDDZ(,,R6666 7"2 6*;d:.33556666A''Z(,,Q555&5GBBBBTZZ\\BBBD0 aZ45G5G88J// LA]@^___```  & - -d 3 3 3 3))r-)r|N)/r(r)r*r+rrr9r:rr<rr\rrsetterrrrr[rrrrrrrrrrrrr]rr staticmethodr'rr+rwrapr-r/rr?rr?rXr,r-r.rrjsA495eT3R3R3Raj0RRR',u%'F'F'FOQZ_FFF %%%%X%&^&&&&1ajo111X12qz#222X2$ 3$$$X$ + 4(+++X+TT^XTqz#XajoX>>^X> 16#qu*+= >X 3X/AJsO///X/,C,,,X, 5!*QVAF3:4F-G"H555X5 ^^^^\$1111BBBPP ^PXDXXXX$)$  $$$$L1*)1* AF16#qu*-. / 1*1*1*1*1*1*r-rcxeZdZUeeZejee d<e e j dZ dS)BaseIngestDocBatchrE ingest_docscdS)zBFetches the "remote" docs and stores it locally on the filesystem.Nr,rs r. get_fileszBaseIngestDocBatch.get_files]r r-N)r(r)r*rr_r^r9r]rr<rrr[r`r,r-r.r]r]Ysg/4uT/J/J/JK+,JJJQQ ^QQQr-r]c$eZdZedZdS) BaseConnectorcdSrr,rs r.check_connectionzBaseConnector.check_connectione r-N)r(r)r*rrdr,r-r.rbrbcs-  ^   r-rbcveZdZUdZeed<eed<eed<ed dZ edZ edZ dS) BaseSourceConnectorzPAbstract Base Class for a connector to a remote source, e.g. S3 or Google Drive.rrrNcdS)zAny additional cleanup up need after processing is complete. E.g., removing temporary download dirs that are empty. By convention, documents that failed to process are typically not cleaned up.Nr,)rcur_dirs r.cleanupzBaseSourceConnector.cleanuprr r-cdS)zInitializes the connector. Should also validate the connector is properly configured: e.g., list a single a document from the source.Nr,rs r. initializezBaseSourceConnector.initializeyr r-cdS)zReturns all ingest docs (derived from BaseIngestDoc). This does not imply downloading all the raw documents themselves, rather each IngestDoc is capable of fetching its content (in another process) with IngestDoc.get_file().Nr,rs r.get_ingest_docsz#BaseSourceConnector.get_ingest_docs~r r-r) r(r)r*r+rar<rrrrjrlrnr,r-r.rgrgjsZZ%%%%))))YYY^Y GG^G&&^&&&r-rgceZdZUeed<eed<dedefdZedZede j e ddfdZ ed e j e j ee jfddfd Zd e j eddfd ZdS) BaseDestinationConnector write_configrc"||_||_dSr)rqr)rrqrs r.__init__z!BaseDestinationConnector.__init__s( 0r-cdS)z]Initializes the connector. Should also validate the connector is properly configured.Nr,rs r.rlz#BaseDestinationConnector.initializer r-docsr|NcdSrr,)rrus r.writezBaseDestinationConnector.writerer- elements_dictcdSrr,)rrxr"rs r. write_dictz#BaseDestinationConnector.write_dictrer-rc<d|D}|j|d|i|dS)Nc6g|]}|Sr,)r)r6es r. z;BaseDestinationConnector.write_elements..s 777777r-rx)rz)rrr"rrxs r.write_elementsz'BaseDestinationConnector.write_elementss777h777 E]EfEEEEEr-)r(r)r*rr<rrsrrlr9r]rrwrr\rrzrrr,r-r.rprps))))1[1DW1111^ !&!45 $   ^  qvafS!%Z6H/I X\   ^ FqvgFDFFFFFFr-rpc"eZdZUeed<ddZdS)SourceConnectorCleanupMixinrNc>|jjs |jjrdS| |jj}|!t |sdSt j|}t j||D]U}t j |r4t j |s| |Vt jdtt j|dkrt j|dSdS)z6Recursively clean up downloaded files and directories.N..r)rrrrris_diroslistdirchdirpathisdirislinkrjlenrmdir)rrisub_dirssub_dirs r.rjz#SourceConnectorCleanupMixin.cleanups   . $2B2P  F ?&3G ?$w--"6"6"8"8? F:g&&  & &Gw}}W%% &bgnnW.E.E & W%%%  rz'"" # #q ( ( HW      ) (r-r)r(r)r*rr<rjr,r-r.rrs6r-rc"eZdZUeed<ddZdS)PermissionsCleanupMixinrNc*d} |t|jjd}t|sdSt|r|}t j|dSt j|}t j||D]6}t j |s| |7t jd||rt j |dSdS)NcjfdtjD}t|dkS)Ncg|]A}tjtj|?|BSr,)rrrjoin)r6item folder_paths r.r~zWPermissionsCleanupMixin.cleanup_permissions..has_no_folders..sM7==k4!@!@AAr-r)rrr)rfolderss` r.has_no_folderszCPermissionsCleanupMixin.cleanup_permissions..has_no_folderssHJ{33G w<<1$ $r-rr) rrrhrrrremoverrrrcleanup_permissionsr)rrircur_filerrs r.rz+PermissionsCleanupMixin.cleanup_permissionss % % % E ?40;=OPPGG}}##%%  F == " " H Ih    F:g&&  2 2G7>>'** 2((111  >' " "  HW       r-r)r(r)r*rar<rr,r-r.rrs6%%%%r-rcFeZdZUeed<eedZdZdS)IngestDocCleanupMixinrcdSr r,rs r.rzIngestDocCleanupMixin.filenamer r-c|jjsW|jr@|jjs6t jd|tj|jdSdSdSdS)z?Removes the local copy of the file after successful processing.z Cleaning up N) rrrrrrr!runlinkrs r.rz"IngestDocCleanupMixin.cleanup_files 3 % %%'' %$2 % L... / / / Idm $ $ $ $ $  % % % % % %r-N) r(r)r*rr<rrrrr,r-r.rrsW TT^XT%%%%%r-rc*eZdZedefdZdS)ConfigSessionHandleMixinr|cdS)zCreates a session handle that will be assigned on each IngestDoc to share session related resources across all document handling for a given subprocess.Nr,rs r.create_session_handlez.ConfigSessionHandleMixin.create_session_handler r-N)r(r)r*rr&rr,r-r.rrsAZ'8ZZZ^ZZZr-rceZdZUeed<eddZeje ed<e dZ e j de fdZ dS) IngestDocSessionHandleMixinrNF)rWrw_session_handlecZ|j|j|_|jS)zFIf a session handle is not assigned, creates a new one and assigns it.)rrrrs r.session_handlez*IngestDocSessionHandleMixin.session_handles-   '#'#8#N#N#P#PD ##r-rc||_dSr)r)rrs r.rz*IngestDocSessionHandleMixin.session_handles-r-) r(r)r*rr<rrr9r:r&rrrYr,r-r.rrs....5:U4e5T5T5TOQZ 12TTT $$X$ .->......r-r)Nr+r%rrtypingr9abcrr dataclassesrrrpathlibrdataclasses_jsonr dataclasses_json.corer r unstructured.chunking.titler unstructured.documents.elementsr unstructured.embed.interfacesrr&unstructured.ingest.enhanced_dataclassrr+unstructured.ingest.enhanced_dataclass.corerunstructured.ingest.errorrrunstructured.ingest.loggerrunstructured.partition.apirunstructured.partition.autorunstructured.staging.baserrTypeVarrrr&r0r4r6r?rarorurrrrrr:r<rrrrrrrr]rbrgrprrrrrr,r-r.rs ########((((((((//////99999999666666>>>>>>GGGGGGGG]]]]]]]]??????KKKKKKKK------888888111111CCCCCCCC AIc-... % % %! GGGGGGG G       +S          :     -----*-- -* .....j.. .( !!!!!j!! ! ..... .. . 2.2.2.2.2.$2.2. 2.j %%%%%%% % JJJJJjJJ J6 Z (   >BQZ(9:AAA      *     PPPPP*cPP P DDDDD/DD D444443444n8:      C     k*k*k*k*k*-);Sk*k* k*\ QQQQQ(?QQ Q      .     &&&&&-&& &6 FFFFF}cFF F4,@%%%%%%%%&ZZZZZZZZ  . . . . . . .  . . .r-