g f xdZdZdZdZdZdZddlZejdd dd lm Z ejd d dd lm Z ddl Z ddl Z ddl Z ddlZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZ ddl m!Z"ddZ%dZ&GddZ'y#e#$rddl$Z"YwxYw)zASuperclass of classes used to generate presentations for objects.z$Id:$z $Revision:$z$Date:$zLCopyright (c) 2009 Sun Microsystems Inc.Copyright (c) 2015-2016 Igalia, S.L.LGPLNAtspiz2.0)rAtkz1.0)r)braille)debug)messages)object_properties)settings)settings_manager) AXHypertext)AXObject)AXTable) AXUtilities)AXValuectj\}}}|j} |j}t j ||}|||fS#t$rd}Y(wxYw)Nz )sysexc_info__name__argsKeyError traceback format_tb) maxTBlevelclaexctrbkexcNameexcArgsexcTbs 0/usr/lib/python3/dist-packages/orca/generator.py_formatExceptionInfor"<sa\\^NCdllG((   j 1E We $$ s A AA _generateceZdZdZdZdZdZdZdZdZ dZ d Z dSd Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!d Z"d!Z#d"Z$d#Z%d$Z&d%Z'd&Z(d'Z)d(Z*d)Z+d*Z,d+Z-d,Z.d-Z/d.Z0d/Z1d0Z2d1Z3d2Z4d3Z5d4Z6d5Z7d6Z8d7Z9d8Z:d9Z;d:Zd=Z?d>Z@d?ZAd@ZBdAZCdBZDdCZEdDZFdEZGdFZHdGZIdHZJdIZKdJZLdKZMdLZNdTdNZOdOZPdPZQdQZRdRZSyM)U GeneratorzTakes accessible objects and generates a presentation for those objects. See the generate method, which is the primary entry point.c||_||_i|_i|_t |Dcgc]}|j t s|c}Dcgc](}t||j||j*c}Dcgc]}t|tjr| c}D]F}|jtt d}|dj|ddz}||j|<H|j!ycc}wcc}wcc}w)Nrr)_mode_script_activeProgressBars _methodsDictdir startswith METHOD_PREFIXgetattr__get__ __class__ isinstancecollections_abcCallablerlenlower_verifyFormatting)selfscriptmodexyzmethodnames r!__init__zGenerator.__init__Ts  #% /2$i"W1<< ;V1"WY!q)11$GY H1)!_-E-EF H -F??3}#5#67D7==?T!"X-D&,D  d #  -  #XY HsDD-D#D cd|d<d|d<y)zCOther things to make available from the formatting string. Nobjrole)r7 globalsDicts r! _addGlobalszGenerator._addGlobalsbs" E" Fci}|jjD]}g||< |j||jj|j D]D}dD]=} |jj|j ||}|s0 t ||?Fy#t$rot}|dd}|jdd}|jdd}||jvr#tjtjg||<Yn1t$r&tjtjYwxYw#t$rYwxYw)N)focused unfocusedrrname '' is not defined)r*keysrEr( formattingr'eval NameErrorr"replacerprintException LEVEL_SEVERE Exception)r7rDkeyroleKey evalStringinfoargs r!r6zGenerator._verifyFormattinghsd $$))+ "C!K  " %||..tzz: "G/ "" // ;GDSI &! " [9! " " )2#7#9D"&q'!*C"%++h";C"%++.@""EC"$*;*;; % 4 4U5G5G H/1K,("!001C1CD!"!s+$)E  B##A5E+EE EEc4|jdd}||d<|S)zConvenience method to allow you to temporarily override the role in the args dictionary. This changes the role in args ags returns the old role so you can pass it back to _restoreRole. rBNget)r7newRoleroldRoles r! _overrideRolezGenerator._overrideRoles" ((64(V rFc|r||d<y|d=y)zConvenience method to restore the old role back in the args dictionary. The oldRole should have been obtained from _overrideRole. If oldRole is None, then the 'role' key/value pair will be deleted from args. rBNrC)r7r^rs r! _restoreRolezGenerator._restoreRoles "DLV rFc gSNrC)r7contentsrs r!generateContentszGenerator.generateContents rFc gSrcrCr7rArs r!generateContextzGenerator.generateContextrfrFc tj|r)d}tjtj|dgSt j }g}i}j |||d< |jdtj||d< |d|d<j|d<|jd ds|jd d rd |d <nd |d <jjjd(i|} |jdd sm|jddrVjjjd(i|} jjj d(i|} | d| d| } d|d<jj#d|jd d|d|jddg}tjtj|dd jj$d<d jj$d<d jj$d<fd} | sJ t j } t'| |} t j |z d}tjtj>d!d&|jA||jd'r|r|drjC||S#t$r7}d|d|g}tjtj|d|cYd}~Sd}~wwxYw#t($r g}t+}|dd}|j-dd}|j-dd}|j.vr&tj0tj2Y7j.||fi|||<t j | z d}t5||t6rYdj9t;d t=| ||}tjtj>d!d"|d#|d$|d%YnwxYw#t$r)tj0tj2g}YwxYw))a4Returns an array of strings (and possibly voice and audio specifications) that represent the complete presentation for the object. The presentation to be generated depends highly upon the formatting strings in formatting.py. args is a dictionary that may contain any of the following: - alreadyFocused: if True, we're getting an object that previously had focus - priorObj: if set, represents the object that had focus before this object - includeContext: boolean (default=True) which says whether the context for an object should be included as a prefix and suffix - role: a role to override the object's role - formatType: the type of formatting, such as 'focused', 'basicWhereAmI', etc. - forceMnemonic: boolean (default=False) which says if we should ignore the settings.enableMnemonicSpeaking setting - forceTutorial: boolean (default=False) which says if we should force a tutorial to be spoken or not z4GENERATOR: Cannot generate presentation for dead objTrArBz+GENERATOR: Cannot generate presentation for:Nr9 formatTypealreadyFocusedFrHrI recursingincludeContextz + zGENERATOR: Startingzgeneration forz (using role:)usedDescriptionForName!usedDescriptionForUnrelatedLabelsusedDescriptionForAlertc(j|dS)NF)_resultElementToString)r:r7s r! debuginfoz%Generator.generate..debuginfos221e<z$Generator.generate..srF zGENERATION TIME: z ----> z=[]zCOMPLETION TIME: isProgressBarUpdaterC)"ris_deadr printMessage LEVEL_INFOtimerEr\get_rolerT printTokensr'r(rN getFormat getPrefix getSuffixupperpointOfReferencerOrPr"rQr*rRrSr1listjoinfiltermap LEVEL_ALL_debugResultInfo setProgressBarUpdateTimeAndValue)r7rArmsg startTimeresultrDerrortokensrNprefixsuffixrv currentTimerXrYduration stringResults` r!generatezGenerator.generates2.   C HC   u//d ;IIIK   % E "&((683D3DS3I"JK  F 'v.DL ::DL88L$/88,e4)2D&)4D&:00::BTBJ 88K/88,d3>T\\44>>FFF>T\\44>>FFF$*83zl#fX!FJ$([!jj&&(*?,AW&^TXXf=MsTF   e.. =GLDLL ) )*B CQVDLL ) )*M NGLDLL ) )*C D = :"iik c!*k:F.iikI-c2 5??xj8I(,TU f% 88) *v&)  1 1# 6 e CS#uUF   e.. =M l!cF/1Dq'!*C++h3C++&8"=C$"3"33,,U-?-?@'=t'8'8'=c'JT'JK$"&))+ ";C!@H!+c"2D9'*xx{8;I{SVGW8X1Z([ **!OO'j(9(73%rR^Q__`acc .   !3!3 4F sc/(KF9P< L P< L&,LLL A3P7P<BP74P<6P77P<<.Q.-Q.cN|st|jddSddd|dS)N z\nr{')strrQ)r7element includeAlls r!ruz Generator._resultElementToString%s1w<''e4 4H:Qwiq))rFc tjtjkryd|jj d}|dj t |j|z }tjtj|y)Nr{z GENERATOR: Results: rw) rr debugLevelr'rrrrur)r7rrXs r!rzGenerator._debugResultInfo+sm ??U-- - DJJ,,.//DE 388C ; ;VDEFG 5??D1rFc gS)aReturns the role name for the object in an array of strings, with the exception that the Atspi.Role.UNKNOWN role will yield an empty array. Note that a 'role' attribute in args will override the accessible role of the obj. rCrhs r!_generateRoleNamezGenerator._generateRoleName9s  rFc |jdtj|}|tjj k(ryy)NrBFT)r\rrrRoleLABELr7rArrBs r!_fallBackOnDescriptionForNamez'Generator._fallBackOnDescriptionForNameBs5xx 1 1# 67 5::## #rFc g}d|jjd<tj|}|j dtj |}tj |}|r|j|n|j|fi|rtj|}|r+|j|d|jjd<ned}|tjjk(r|}ntj|r|}|r*tj |d} | r|j| |sC|tjj"k(r&tj$|r|j'|S|S)a Returns an array of strings for use by speech and braille that represent the name of the object. If the object is directly displaying any text, that text will be treated as the name. Otherwise, the accessible name of the object will be used. If there is no accessible name, then the description of the object will be used. This method will return an empty array if nothing can be found. [[[WDW - I wonder if we should just have _generateName, _generateDescription, _generateDisplayedText, etc., that don't do any fallback. Then, we can allow the formatting to do the fallback (e.g., 'displayedText or name or description'). [[[JD to WDW - I needed a _generateDescription for whereAmI. :-) See below. FrqrBTN)remove_extension)r(rrget_namer\r get_parentappendrget_descriptionrrLINKris_linkr get_link_basenameICONis_panel _generateName) r7rArrr>rBparent descriptionlinkbasenames r!rzGenerator._generateNameIs8BG %%&>?  %xx 1 1# 67$$S)  MM$  /T / / rB descendant nameWords labelWordsrs r!_generateLabelAndNamezGenerator._generateLabelAndNamesS ###C040!t!!#..xx 1 1# 6745::+@+@#@//DDSIJ%%j1DK eMFF8S$q'288: VVHc584::<  y> " "3z? 3)474OQVWXQY[^_F   e.. =M d rFc V|j|fi|}|s|j|fi|}|S)zReturns the label as an array of strings for speech and braille. If the label cannot be found, the name will be used instead. If the name cannot be found, an empty array will be returned. )rrr7rArrs r!_generateLabelOrNamezGenerator._generateLabelOrNames: %$$S1D1'T''4t4F rFc |j|fi|}|rd|jjd<|S|j|fi|}|rd|jjd<|S)NFrrT)_generateUnrelatedLabelsr(r_generateDescriptionrs r!%_generateUnrelatedLabelsOrDescriptionz/Generator._generateUnrelatedLabelsOrDescriptionsj...s;d; QVDLL ) )*M NM***37$7 QUDLL ) )*M N rFc \|jjjdrgS|jjjdrgS|jjjdrgStj|xs)|jj j |xsd}|sgStj|}|jdtj|} |jj|j||jdj}d|v}d|v}d } |jj j|xsd} |rQ|jj j|| xr'|jj j| | } nS|r*| r(|jj j| | } n'|jj j|| } | sgS|gS#t$rd }d }YwxYw) zReturns an array of strings fo use by speech and braille that represent the description of the object, if that description is different from that of the name and label. rqrsrrrKrBrl labelAndName labelOrNameFT)r(rr\rrrdisplayedDescriptionrrrNr'rrTdisplayedLabelstringsAreRedundant) r7rArrr>rBrisLabelAndName isLabelOrNamecanUsers r!rzGenerator._generateDescriptions << ( ( , ,-E FI << ( ( , ,-F GI << ( ( , ,-P QI..s3F||%%::3?FCE I  %xx 1 1# 67 "\\,,TZZ8>txx ?UV\\^F+v5N)V3M  &&55c:@b //CCD+VV\!\\33GG{[[  u//CCE;WWF//CCD+VVFI}# ""N!M "s5AH H+*H+c zg}|jjj|}|r|j||S)aReturns the label for an object as an array of strings for use by speech and braille. The label is determined by the displayedLabel method of the script utility, and an empty array will be returned if no label can be found. )r(rrr)r7rArrrs r!rzGenerator._generateLabels7  &&55c:  MM%  rFc gS)z8Returns an array of strings that represent a status bar.rCrhs r!_generateStatusBarzGenerator._generateStatusBars  rFc gSrcrCrhs r!_generateTermValueCountz!Generator._generateTermValueCountrfrFc :tj|}|r|gSgS)zReturns an array of strings for use by speech and braille that represent the description of the image on the object, if it exists. Otherwise, an empty array is returned. )rget_image_descriptionr7rArrs r!_generateImageDescriptionz#Generator._generateImageDescriptions$ 44S9 =  rFc gSrcrCrhs r!_generateClickablezGenerator._generateClickablerfrFc gSrcrCrhs r!_generateHasLongDesczGenerator._generateHasLongDescrfrFc gSrcrCrhs r!_generateHasDetailszGenerator._generateHasDetailsrfrFc gSrcrCrhs r!_generateDetailsForzGenerator._generateDetailsFor"rfrFc gSrcrCrhs r!_generateAllDetailszGenerator._generateAllDetails%rfrFc gSrcrCrhs r!_generateHasPopupzGenerator._generateHasPopup(rfrFc g}|jdds|j|d<d|d<tj|s5|j |j j jdi||S)aReturns an array of strings for use by speech and braille that represent the grayed/sensitivity/availability state of the object, but only if it is insensitive (i.e., grayed out and inactive). Otherwise, and empty array will be returned. r9N insensitive stringTyperC)r\r'r is_sensitiverr(rN getStringrs r!_generateAvailabilityzGenerator._generateAvailability+sh xx%::DL*\'', MM;$,,11;;CdC D rFc |jjj|}|sgSg}|jdds|j|d<d|d<|jj j d i|}|dk(r|d}n|dk(r|d}n|d}|jjj|}|r|j|d ||S|j||S) Nr9invalidrspellingrgrammarrz: rC) r(rgetErrorr\r'rNrgetErrorMessager)r7rArrr indicators indicator errorMessages r!_generateInvalidzGenerator._generateInvalid9s &&//4Ixx%::DL&\6T\\,,66>> J "1 I i "1 I"1 I||--==cB  MMYKr,8 9  MM) $ rFc pg}|jdds|j|d<d|d<tj|}|s?tj|r*t j |}tj|}|r5|j|jjjdi||S)a*Returns an array of strings for use by speech and braille that represent the required state of the object, but only if it is required (i.e., it is in a dialog requesting input and the user must give it a value). Otherwise, and empty array will be returned. r9NrequiredrrC) r\r'r is_requiredis_radio_buttonrrrr(rNr)r7rArr isRequiredrs r!_generateRequiredzGenerator._generateRequiredSsxx%::DL'\ ,,S1 k99#>((-F$008J  MM;$,,11;;CdC D rFc 4g}|jdds|j|d<d|d<tj|s%|jj j |r5|j|jjjdi||S)zReturns an array of strings for use by speech and braille that represent the read only state of this object, but only if it is read only (i.e., it is a text area that cannot be edited). r9NreadonlyrrC) r\r'r is_read_onlyr(risReadOnlyTextArearrNrrs r!_generateReadOnlyzGenerator._generateReadOnlyfs xx%::DL'\  # #C (ll$$77< MM;$,,11;;CdC D rFc g}|jjj|r^|jtj j |}|j|j|fi||j|||S)aReturns an array of strings for use by speech and braille that represent the checked state of the object. This is typically for check boxes that are in a table. An empty array will be returned if this is not a checkable cell. ) r(rhasMeaningfulToggleActionr_rr CHECK_BOXrrrar7rArrr^s r!_generateCellCheckedStatez#Generator._generateCellCheckedStatetsn  << ! ! ; ;C @(()=)=tDG MM-$--4t4 5   gt , rFc vg}|jdds|j|d<d|d<|jjjdi|}t j |r|j|d|St j|r|j|d|S|j|d|S) Returns an array of strings for use by speech and braille that represent the checked state of the object. This is typically for check boxes. [[[WDW - should we return an empty array if we can guarantee we know this thing is not checkable?]]] r9NcheckboxrrrrrC) r\r'r(rNrr is_checkedris_indeterminater7rArrrs r!_generateCheckedStatezGenerator._generateCheckedStates xx%::DL'\6T\\,,66>>  ! !# & MM*Q- (   ) )# . MM*Q- (  MM*Q- ( rFc g}|jdds|j|d<d|d<|jjjdi|}t j |r|j|d|S|j|d|S)rr9N radiobuttonrrrrCr\r'r(rNrrrrrs r!_generateRadioStatezGenerator._generateRadioStates xx%::DL*\6T\\,,66>>  ! !# & MM*Q- (  MM*Q- ( rFc tjjtjjtjjtjj tjj tjjgfd}tjtj|r+tj||}|r|j|dSgS)Nc2tj|vSrc)rr)r: widgetRoless r!isWidgetz0Generator._generateChildWidget..isWidgets$$Q';6 6rFF)ro)rrr COMBO_BOX PUSH_BUTTON RADIO_BUTTONSLIDER TOGGLE_BUTTONr is_list_boxrrfind_descendantr)r7rArr#widgetr"s @r!_generateChildWidgetzGenerator._generateChildWidgetszz++zz++zz--zz..zz((zz// 1  7  " "8#6#6s#; <--c8>  ! !# &+*@*@*E MM*Q- (  MM*Q- ( rFc Jg}|jdds|j|d<d|d<|jjjdi|}t j |st j|r|j|d|S|j|d|S)rr9N togglebuttonrrrrCr/rs r!_generateToggleStatezGenerator._generateToggleStates xx%::DL+\6T\\,,66>>  ! !# &+*@*@*E MM*Q- (  MM*Q- ( rFc tj|stj|r|j|fi|Stj|r|j|fi|SgSrc)r is_checkableis_check_menu_itemrrrhs r! _generateCheckedStateIfCheckablez*Generator._generateCheckedStateIfCheckables`  # #C (K,J,J3,O-4--c:T: :  ! !# &-4--c:T: : rFc g}|jdds|j|d<d|d<|jjjdi|}t j |r|j|d|S)zReturns an array of strings for use by speech and braille that represent the checked state of the menu item, only if it is checked. Otherwise, and empty array will be returned. r9NrrrrCrrs r!_generateMenuItemCheckedStatez'Generator._generateMenuItemCheckedStatesp xx%::DL'\6T\\,,66>>  ! !# & MM*Q- ( rFc g}|jdds|j|d<d|d<|jjjdi|}t j |r|j|d|St j|r|j|d|St j|r|j|d|S)zReturns an array of strings for use by speech and braille that represent the expanded/collapsed state of an object, such as a tree node. If the object is not expandable, an empty array will be returned. r9N expansionrrrrC) r\r'r(rNrr is_collapsedr is_expanded is_expandablers r!_generateExpandableStatez"Generator._generateExpandableStates xx%::DL(\6T\\,,66>>  # #C ( MM*Q- (   $ $S ) MM*Q- (  & &s + MM*Q- ( rFc g}|jdds|j|d<d|d<tj|rJt j |r5|j |jjjdi||S)a Returns an array of strings (and possibly voice and audio specifications) that represent the multiselectable state of the object. This is typically for list boxes. If the object is not multiselectable, an empty array will be returned. r9N multiselectrrC) r\r'ris_multiselectablerget_child_countrr(rNrrs r!_generateMultiselectableStatez'Generator._generateMultiselectableStatesuxx%::DL*\  ) )# .83K3KC3P MM;$,,11;;CdC D rFc |jdrgSg}|jdr&tj||jd}ntj|}g}|D]Z}|jj j |}|s+|js<|j|j\|s|Sdj|}|j|tjj} |jddk(r}||r |j|jtj||fi|@|S)zReturns an array of strings for use by speech and braille for the label of a toggle in a table cell that has a special 2 child pattern that we run into. Otherwise, an empty array is returned. rFTrr rrD enumerate iter_childrenr(rrrr get_childr7rArr cellOrder hasToggleichilds r!_generateTableCell2ChildLabelz'Generator._generateTableCell2ChildLabelbs   # #C (A -II%h&<&}||s |j|jtj||fi|@|S)zReturns an array of strings for use by speech and braille for the toggle value of a toggle in a table cell that has a special 2 child pattern that we run into. Otherwise, an empty array is returned. rFTrrrhrls r!_generateTableCell2ChildTogglez(Generator._generateTableCell2ChildToggles   # #C (A -II%h&<&t j|}|r'|jtj|d|S)zIf this table cell has a "toggle" action, and doesn't have any label associated with it then also speak the table column header. See Orca bug #455230 for more details. r9rLrGFr) r\r(rrrRrrrarrr)r7rArrrrrYs r!&_generateColumnHeaderIfToggleAndNoTextz0Generator._generateColumnHeaderIfToggleAndNoTexts <8 #DHH\5,II\\++@@E  &&44Z@//II#N2237g h// ;< rFc g}|jd|}|j|j|fi||j|||S)a`Orca has a feature to automatically read an entire row of a table as the user arrows up/down the roles. This leads to complexity in the code. This method is used to return an array of strings for use by speech and braille for a single table cell itself. The string, 'blank', is added for empty cells. REAL_ROLE_TABLE_CELL)r_rrrars r!_generateRealTableCellz Generator._generateRealTableCellsM$$%;TB mdmmC0401 '4( rFc |jjj|rgS|jjj|rgSt j |}t j |}|dks|dkr'|jjj|sgS|dk(r|dk(r|j|fi|Stj||gS)zaReturns an array of strings for use by speech and braille to present the size of a table.r) r(r isLayoutOnlyisSpreadSheetTabler get_row_countget_column_countrowOrColumnCountUnknownrr tableSize)r7rArrowscolss r!_generateTablezGenerator._generateTables << ! ! . .s 3I << ! ! 4 4S 9I$$S)'', 1Hq<<))AA#FI 19)4))#66 6""4.//rFc |jdduxs\|jddk(xsF|jdk(xs5|jjj ||jd}|s|j |fi|Sd|d<g}|jjj |d}gd}|j}|D]}|j|d |D]} | |k(r|j | fi|} n|j | fi|} | rC|rA|jdk(r2|jtjtj|j| |j|j|fi||S) aOrca has a feature to automatically read an entire row of a table as the user arrows up/down the roles. This leads to complexity in the code. This method is used to return an array of strings (and possibly voice and audio specifications) for an entire row in a table if that's what the user has requested and if the row has changed. Otherwise, it will return an array for just the current cell. rGTrlrOrrI) forceFullRow) startOffset endOffsetstringN)r\r'r(rshouldReadFullRowrxgetShowingCellsInSameRowcopypoprrRegionr TABLE_CELL_DELIMITER_BRAILLEr_generatePositionInList) r7rAr presentAllrcells doNotInclude otherCellArgsrYcell cellResults r!_generateTableCellRowzGenerator._generateTableCellRowsXXl+t3Sxx %);;SzzY&S||%%77TXXj=QR  .4..s;d; ;!\ &&??RV?W>   )C   c4 ( ) &Ds{8T88FF 8T88OO fy)@ gnn->-[-[\] MM* % &  2d223?$?@ rFc gS)z>Returns the expanded embedded object characters for an object.rCrhs r!_generateExpandedEOCszGenerator._generateExpandedEOCs s rFc |jd}|jd}||gS|jd|jjj|||}|r|jj|vr|gSgS)Nrrr)r\r(r substringEMBEDDED_OBJECT_CHARACTER)r7rArstartendrs r!_generateSubstringzGenerator._generateSubstringsw'hh{# =CKIHHXt||'='='G'GUTW'XY ??yP;  rFc $|jdS)Nrr[rhs r!_generateStartOffsetzGenerator._generateStartOffsetsxx &&rFc $|jdS)Nrr[rhs r!_generateEndOffsetzGenerator._generateEndOffsetsxx $$rFc |j|fi|}|r|S|jj|\}}}|r|jj|vr|gSgS)zReturns an array of strings for use by speech and braille that represents the current line of text, if this is a text object. [[[WDW - consider returning an empty array if this is not a text object.]]] )rr(getTextLineAtCaretr)r7rArrr\ caretOffsetrs r!_generateCurrentLineTextz"Generator._generateCurrentLineText"s^ )((55 M+/<<+J+J3+O({K DLL::$F6M rFc |j|fi|}|r|S|jjj|}|sgS|gS)zReturns an array of strings for use by speech and braille that represents all the text being displayed by the object. )rr(rrR)r7rArrrRs r!_generateDisplayedTextz Generator._generateDisplayedText2sM)((55 M ..<s r!_generateApplicationNamez"Generator._generateApplicationNamevs8  !9!9#!>?  MM$  rFc d|jd}|jd}||gSg}|jdds|j|d<d|d<|jjj |}|r8|j |jj jdi||z|S)zReturns an array of strings for use by speech and braille that represent the nesting level of an object in a list. rrNr9 nestinglevelrrC)r\r'r(r nestingLevelrrNr)r7rArrrrrs r!_generateNestingLevelzGenerator._generateNestingLevels'hh{#  Ixx%::DL+\||--::3?  MM;$,,11;;CdC() * rFc tj|sgSd}tj|tj j }|r|jd}|r&|jjj|gStj|}|rWtj|stj|r|j|}|r|Stj|}|rWgS)zReturns an array of strings for use by speech and braille that represents the radio button group label for the object, or an empty array if the object has no such label. Nr)rrr get_relationr RelationType LABELLED_BY get_targetr(rrRget_parent_checkedr is_fillerr)r7rArradioGroupLabelrelationrrs r!_generateRadioButtonGroupz#Generator._generateRadioButtonGroups **3/I((e.@.@.L.LM &11!4O LL**88IJ J,,S1##F+{/D/DV/L226: L008F   rFc |jjj|}tj|rt j |s|j|fi|Stt j|Dcgc]5}|jjj|j7c}}djtd|}|s|j|fi|S|gScc}w)aNObjects, such as tables and trees, can represent individual cells via a complicated nested hierarchy. This method returns an array of strings for use by speech and braille that represents the text actually being painted in the cell, if it can be found. Otherwise, an empty array is returned. rwc|SrcrCrys r!rzzFGenerator._generateRealActiveDescendantDisplayedText..sqrF)r(rrr is_table_cellrrDrrrjrRrSrr)r7rArradr:contentrvs r!*_generateRealActiveDescendantDisplayedTextz4Generator._generateRealActiveDescendantDisplayedTextsll$$99#>))#.83K3KC3P.4..s;d; ;++C02||--;;A>DDF23 XXf['2 3.4..s;d; ;t 2s?:C4c |jjj|}tj||d<|j |fi|S)aObjects, such as tables and trees, can represent individual cells via a complicated nested hierarchy. This method returns an array of strings for use by speech and braille that represents the role of the object actually being painted in the cell. rB)r(rrrrr)r7rArrs r!%_generateRealActiveDescendantRoleNamez/Generator._generateRealActiveDescendantRoleNamesJ ll$$99#>((-V %t%%c2T22rFc g}tj|}|rTtj|r'|j |}|r|j | |Stj|}|rT|S)zReturns an array of strings for use by speech and braille that represents the nearest ancestor of an object which is a named panel. )rrrrrr)r7rArrrrs r!_generateNamedContainingPanelz'Generator._generateNamedContainingPanelso,,S1##F+226:MM%( 008F  rFc gSrcrCrhs r!_generatePageSummaryzGenerator._generatePageSummaryrfrFc gSrcrCrhs r!rz!Generator._generatePositionInListrfrFc gSrcrCrhs r!_generateProgressBarIndexz#Generator._generateProgressBarIndexrfrFc gSrcrCrhs r!_generateProgressBarValuez#Generator._generateProgressBarValuerfrFcZttjjdS)NprogressBarUpdateInterval)intr getManager getSetting)r7s r!_getProgressBarUpdateIntervalz'Generator._getProgressBarUpdateIntervals##..0;;tyy{X-.4==???rFctttj|j}|Dcic]}||jj | c}|_ycc}wrc)rrris_validr)r\)r7barsr:s r!_cleanUpCachedProgressBarsz$Generator._cleanUpCachedProgressBarssKF8,,d.F.FGHOS#T!Ad&>&>&B&B1&E$E#T #Ts#Ac|j|jjsyt|jjd}|d\}}t |jj d||fS)N)NNc |dS)NrrCrys r!rzz;Generator._getMostRecentProgressBarUpdate..s qQRtrF)rU)rr)valuessortedrrM)r7 sortedValuesprevTime prevValues r!_getMostRecentProgressBarUpdatez)Generator._getMostRecentProgressBarUpdatess '')''..0"d66==?^T *2.)D,,1134R8(IMMrFc|j||jvrd|j|<|j|}t|jj j |}|dzt |jfS)NrNr)rr)rrrindexr4)r7rA thisValuers r!getProgressBarNumberAndCountz&Generator.getProgressBarNumberAndCountsz '') d.. .,5D $ $S )99#> T--4467==iHqy#d66777rFc r||jvrd|j|<|jj|S)Nr)r)r\rhs r!rz*Generator.getProgressBarUpdateTimeAndValue s7 d.. .,5D $ $S )''++C00rFNc|xstj}|xstj|}||f|j|<yrc)rrrr))r7rArrs r!rz*Generator.setProgressBarUpdateTimeAndValues<*tyy{B!=!=c!B (0)(;  %rFc |jjj|r |jjj|ry|jjj |ry|jjj |ry|jjj |ry|jjj|ry|jjj|ry|jjj|ry|jjj|r<|jjj|rytj|ry |jjj|ry |jjj|rt j"j$S|jjj'|rt j"j(S|jjj+|rt j"j,S|jjj/|ry |jjj1|ry |jjj3|ry |jjj5|ry|jjj7|ry|jjj9|rt j"j:S|jjj=|rt j"j>S|jjjA|rt j"jBS|jjjE|ry|jjjG|ry|jjj|r@|jjjI|ryt j"jJS|jjjM|rt j"jNS|jjjQ|r/tSjT|rt j"jVS|jYdtSjZ|S)NROLE_MATH_SCRIPT_SUBSUPERROLE_MATH_SCRIPT_UNDEROVERROLE_MATH_MULTISCRIPTROLE_MATH_ENCLOSEDROLE_MATH_FENCEDROLE_MATH_TABLEROLE_MATH_TABLE_ROWROLE_DPUB_LANDMARKROLE_DPUB_SECTION ROLE_SWITCHROLE_CONTENT_DELETIONROLE_CONTENT_ERRORROLE_CONTENT_INSERTIONROLE_CONTENT_MARKROLE_CONTENT_SUGGESTIONROLE_ARTICLE_IN_FEED ROLE_FEED ROLE_REGIONrB).r(risMathisMathSubOrSuperScriptisMathUnderOrOverScriptisMathMultiScript isMathEnclose isMathFenced isMathTableisMathTableRowisDPub isLandmarkr is_sectionisSwitchisAnchorrrSTATIC isBlockquote BLOCK_QUOTE isCommentCOMMENTisContentDeletionisContentErrorisContentInsertionisContentMarkedisContentSuggestionisDescriptionListDESCRIPTION_LISTisDescriptionListTermDESCRIPTION_TERMisDescriptionListDescriptionDESCRIPTION_VALUE isFeedArticleisFeedisLandmarkRegionLANDMARKisFocusableLabel LIST_ITEM isDocumentrsupports_imageIMAGEr\rrhs r!_getAlternativeRolezGenerator._getAlternativeRoles << ! ! ( ( -||%%< >s C::// / << ! ! / / 4) << ! ! ( ( - << ! ! , ,S 1||%%66s;$::&& & << ! ! 2 23 7::'' ' << ! ! , ,S 1h6M6Mc6R::## #xx 1 1# 677rFc |jdtj|}tj|rdt j |rt jSt j|rt jSt j|rt jSt j|rt jSt j|rt jSt j |rt j"St j$|rqt j&|s|jddrJt j(|rt j"St j*|rt jS|j,j.j1|rt j2S|j,j.j5|rt j6S|j,j.j9|rt j:S|j,j.j=|rt j>S|j,j.jA|rt jBS|j,j.jE|r|j,j.jG|r|j,j.jI|rt jJS|j,j.jM|rt jNS|j,j.jQ|rt jRS|j,j.jU|rt jVS|j,j.jY|rt jZS|j,j.j]|rt j^S|j,j.ja|rt jbS|j,j.je|rt jfS|j,j.ji|rt jjS|j,j.jm|rt jnS|j,j.jq|rt jrS|j,j.ju|rt jvS|j,j.jy|rt jzS|j,j.j}|rt j~S|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|dk(r|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|r6t jS|tjjk(rj|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.jG|r|j,j.j|ry|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rt jS|j,j.j|rZtjj}n?|j,j.j|rtjj}t|tjs |jStj|}tj|}|tjjk(r3|tjjk(rtjd}tj|S#t$rYywxYw)NrBrmFrrK statusbar)r\rrsupports_valueris_horizontal_sliderr ROLE_SLIDER_HORIZONTALis_vertical_sliderROLE_SLIDER_VERTICALis_horizontal_scrollbarROLE_SCROLL_BAR_HORIZONTALis_vertical_scrollbarROLE_SCROLL_BAR_VERTICALis_horizontal_separatorROLE_SPLITTER_HORIZONTALis_vertical_separatorROLE_SPLITTER_VERTICAL is_split_paner is_horizontal is_verticalr(rr%r r-r isFigure ROLE_FIGURE isMenuButtonROLE_MENU_BUTTONrrrrisDPubAcknowledgmentsROLE_ACKNOWLEDGMENTSisDPubAfterwordROLE_AFTERWORDisDPubAppendix ROLE_APPENDIXisDPubBibliographyROLE_BIBLIOGRAPHY isDPubChapter ROLE_CHAPTERisDPubConclusionROLE_CONCLUSION isDPubCredits ROLE_CREDITSisDPubEndnotes ROLE_ENDNOTESisDPubEpilogue ROLE_EPILOGUE isDPubErrata ROLE_ERRATAisDPubForeword ROLE_FOREWORDisDPubGlossary ROLE_GLOSSARY isDPubIndex ROLE_INDEXisDPubIntroductionROLE_INTRODUCTIONisDPubPagelist ROLE_PAGELIST isDPubPart ROLE_PART isDPubPreface ROLE_PREFACEisDPubPrologue ROLE_PROLOGUE isDPubTocROLE_TOCisDPubAbstract ROLE_ABSTRACTisDPubColophon ROLE_COLOPHON isDPubCredit ROLE_CREDITisDPubDedicationROLE_DEDICATIONisDPubEpigraph ROLE_EPIGRAPH isDPubExample ROLE_EXAMPLEisDPubPullquoteROLE_PULLQUOTE isDPubQnaROLE_QNArrr1isDPubBiblioentryROLE_BIBLIOENTRY isDPubEndnote ROLE_ENDNOTE isDPubCover ROLE_COVERisDPubPagebreakROLE_PAGEBREAKisDPubSubtitle ROLE_SUBTITLEisLandmarkWithoutTypeisLandmarkBannerROLE_LANDMARK_BANNERisLandmarkComplementaryROLE_LANDMARK_COMPLEMENTARYisLandmarkContentInfoROLE_LANDMARK_CONTENTINFOisLandmarkMainROLE_LANDMARK_MAINisLandmarkNavigationROLE_LANDMARK_NAVIGATIONr.ROLE_LANDMARK_REGIONisLandmarkSearchROLE_LANDMARK_SEARCHisLandmarkFormFORMrr r1rTrT role_get_namer role_for_nameINVALID STATUS_BARrole_get_localized_name)r7rArrB nonlocalizedatkRoles r!rTzGenerator.getLocalizedRoleNameQsxx 1 1# 67  " "3 '//4(???--c2(===2237(CCC005(AAA2237(AAA005(???((-**3/488,;;;<<))88=,:::<<))<>><<))77<,999<<))::3?,<<<<<))77<,999<<))88=,:::<<))88=,:::<<))66s;,888<<))88=,:::<<))88=,:::<<))55c:,777<<))<>><<))88=,:::<<))44S9,666<<))77<,999<<))88=,:::<<))33C8,555,,<<))88=,:::<<))88=,:::<<))66s;,888<<))::3?,<<<<<))88=,:::<<))77<,999<<))99#>,;;;<<))33C8,555---<<));;C@,===<<))77<,999<<))55c:,777<<))99#>,;;;<<))88=,::: << ! ! , ,S 1||%%;;C@||%%66s;(===||%%==cB(DDD||%%;;C@(BBB||%%44S9(;;;||%%::3?(AAA||%%66s;(===||%%66s;(===||%%44S9zz \\ # # - -c 2::%%D$ + //11**40 ##L1 chh&& &45::3H3H+H'' 4G**733  sr44 s?sc |jjj|r|j|fi|S|j dt j |}|tjjk(r|j|fi|S|tjjtjjfvr|j|fi|S|tjjtjjfvr|j |fi|S|tjj"k(r|j$|fi|S|tjj&k(r|j(|fi|SgSNrB)r(rrr1r\rrrr MENU_ITEMr:r&RADIO_MENU_ITEMrrCHECK_MENU_ITEMrr(r4rrrs r!getStateIndicatorzGenerator.getStateIndicatorsB << ! ! * *3 /,4,,S9D9 9xx 1 1# 67 5::'' '5455cBTB B EJJ++UZZ-G-GH H+4++C848 8 EJJ((%***D*DE E-4--c:T: : 5::++ +,4,,S9D9 9 5::(( (1411#>> > rFc B|jdtj|}|tjj k(r|j |fi|S|tjjtjjfvr|j|fi|SgSr) r\rrrr PROGRESS_BARr SCROLL_BARr'_generatePercentagers r!getValuezGenerator.getValuesxx 1 1# 67 5::** *1411#>> > EJJ))5::+<+<= =+4++C848 8 rF)T)NN)Tr __module__ __qualname____doc__r?rEr6r_rarerirrurrrrrrrrrrrrrrrrrrrrrr rrrrr,r1r4r8r:r@rEr^rcrfrqrsrurxrrrrrrrrrrrrrrrrrrrrrrrrrrrr5rTrrrCrFr!r%r%Os !# *"X un* 2(T&!F  ,\   " 4&  &"& " ( *"HB@@( 04&\ '% ( *6&0&3 Z @UN81 < :8xN4`. rFr%))(r__id__ __version____date__ __copyright__ __license__girequire_version gi.repositoryrrrrrrrKrrr r r r ax_hypertextr ax_objectrax_tabler ax_utilitiesrax_valuercollections.abcabcr2 ImportError collectionsr"r-r%rCrFr!rs*H 7  7E"5%  %%*-%" rr-*)*sB-- B98B9