~@;j *ddlmZddlmZddlmZddlmZddlmZddl m Z ddl Z ddl m Z mZmZmZmZmZdd lmZdd lmZmZmZmZdd lmZmZdd lmZdd lm Z ddl!m"Z"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/Gdde0Z1dS)) annotations)time)Logger)Role)States) TextReaderN)ArraybyrefCDLLc_charc_longcreate_string_buffer)HWND)Any GeneratorOptionalUnion)Image ImageGrab)By) JABException)jint JOBJECT64) Win32Utils) XpathParser)AccessibleActionsAccessibleActionsToDoAccessibleContextInfoAccessibleTableCellInfoAccessibleTableInfoAccessibleTextInfoVisibleChildrenInfoc(eZdZdZeZeZ ddd Ze ddZ e j ddZ e ddZ e j ddZ e ddZ e j ddZ e ddZej ddZe ddZe ddZe ddZe ddZe ddZe ddZe ddZe ddZe dd Ze dd"Ze dd$Ze dd%Ze dd&Ze dd'Ze dd(Ze dd)Ze dd*Z ddd/Z ddd0Z!ddd1Z"ddd2Z# ddd3Z$ ddd5Z%dd6Z&dd9Z'ddd:Z( ddd;Z) ddd=Z*ddd>Z+ ddd@Z, dddFZ- dddHZ. dddIZ/ dddJZ0 dddKZ1 dddLZ2 dddPZ3dddQZ4 dddSZ5dddUZ6dddWZ7dddZZ8ddd^Z9ddd`Z:dddcZ;dddZdddhZ?dddiZ@dddjZAdddkZB dddmZCdddnZDdddqZEddrZFddsZGddtZHdduZIddvZJddwZKdddxZL dddyZMdddzZNddd|ZO ddd}ZP ddd~ZQ dddZReSddZTeSddZUeSddZVeSddZWeSddZXeSddZYeSddZZddZ[dddZ\ dddZ]dddZ^e_j`dd+fddZa dddZb dddZc dddZd dddZe dddZf dddZg dddZh dddZidddZj dddZk dddZle_j`dd+fddZmeSddZne ddZoe ddZpddZqddZre dZsdddZtddZueS dddZveS dddZwdS) JABElementz"Java Access Bridge func '{}' errorNbridger hwndrvmidr accessible_contextrreturnNonec~td|_||_||_||_||_|j|_dS)Npyjab)rlogger_bridge_hwnd_vmid_accessible_context_get_accessible_context_info _acc_info)selfr%r&r'r(s ^C:\Users\Administrator\AppData\Local\Temp\2\pip-target-b0z114gj\lib\python\pyjab/jabelement.py__init__zJABElement.__init__#s<Woo    #5 :c|jSNr.r4s r5r%zJABElement.bridge2s |r7c||_dSr9r:)r4r%s r5r%zJABElement.bridge6s  r7c|jSr9r/r;s r5r&zJABElement.hwnd: zr7c||_dSr9r>)r4r&s r5r&zJABElement.hwnd>  r7c|jSr9r0r;s r5r'zJABElement.vmidBr?r7c||_dSr9rC)r4r's r5r'zJABElement.vmidFrAr7c|jSr9r1r;s r5r(zJABElement.accessible_contextJs ''r7c||_dSr9rFr4r(s r5r(zJABElement.accessible_contextNs#5   r7strc4|jSr9)r3namer;s r5rKzJABElement.nameR~~$$r7c4|jSr9)r3 descriptionr;s r5rNzJABElement.descriptionVs~~++r7c4|jSr9)r3roler;s r5rPzJABElement.roleZrLr7c4|jSr9)r3 role_en_USr;s r5 role_en_uszJABElement.role_en_us^s~~**r7cZ|jdSN,)r3statessplitr;s r5rWzJABElement.statesbs#~~&,,S111r7cZ|jdSrU)r3 states_en_USrXr;s r5 states_en_uszJABElement.states_en_usfs#~~,223777r7intc*|Sr9)_get_object_depthr;s r5 object_depthzJABElement.object_depthjs%%'''r7c4|jSr9)r3 indexInParentr;s r5index_in_parentzJABElement.index_in_parentn~~--r7c4|jSr9)r3 childrenCountr;s r5children_countzJABElement.children_countrrcr7dictc|j|j|j|jdS)N)xyheightwidth)r3rirjrkrlr;s r5boundszJABElement.boundsvsS!!#!!#nn&&-^^%%+    r7boolcNt|jSr9)rnr3accessibleComponentr;s r5accessible_componentzJABElement.accessible_componentDNN$$8999r7cNt|jSr9)rnr3accessibleActionr;s r5accessible_actionzJABElement.accessible_actionsDNN$$5666r7cNt|jSr9)rnr3accessibleSelectionr;s r5accessible_selectionzJABElement.accessible_selectionrrr7cNt|jSr9)rnr3accessibleTextr;s r5accessible_textzJABElement.accessible_textsDNN$$3444r7cdSNFr;s r5accessible_interfacesz JABElement.accessible_interfacess ur7c:|jry|}d}|jdz }|dz|z }t|dzdz}|||||t ||dS|jddS)Nrutf_16)buffer chars_lenencodingz3current JABElement does not support Accessible Text) r{_get_accessible_text_info charCountr_get_accessible_text_rangerget_text_from_raw_bytesr-warning)r4txt_info chars_start chars_endrrs r5textzJABElement.texts   W5577HK *Q.I!A 3I)9q=A*=>>F  + +KFI V V V<<77X8  K   U V V V V Vr7c|jtjkr|}|j|jd}|}|j|jd|d<|}|j|jd|d<|}| }||d|d<|S|j ddS)N) row_count column_count row_headerscolumn_headersselectedz,current JABElement does not Accessible Table) rSrTABLE_get_accessible_table_inforowCount columnCount _get_accessible_table_row_header#_get_accessible_table_column_header)_get_accessible_table_row_selection_count,_get_accessible_table_column_selection_countr-r)r4infotbrrs r5tablezJABElement.tables ?dj ( (2244D!] $ 0B88::D!] $ 0!!B} ;;==D!] $ 0$$B FFHHILLNNL& ,BzNI K   N O O O O Or7F jabelementvisibleGenerator[JABElement]c#K|p%t|j|j|j|j}|||D]*}|jr|||Ed{V|V+dS)agenerate all child jab elements from a jab element. Args: jabelement (JABElement, optional): The parent jab element to generate child jab elements. Defaults to None use current element. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Yields: Generator: Generator of all child jab elements from this parent jab element. rrN)r$r%r&r'r(_generate_childs_from_elementrf_generate_all_childs)r4rr _jabelements r5rzJABElement._generate_all_childss  : KDIt/F$ $  ==%w>    K) 44*G5      r7c# K|p%t|j|j|j|j}|rv||j}||j}t|D]0}t|j|j|j|j|V1dSt|j D]K}|j |j|j|}t|j|j|j|VLdS)agenerate child jab elements from a jab element. Args: jabelement (JABElement, optional): The parent jab element to generate child jab elements. Defaults to None use current element. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Yields: Generator: Generator of child jab elements from this parent jab element. N) r$r%r&r'r(_get_visible_children_count_get_visible_childrenrangechildrenrfgetAccessibleChildFromContext)r4rrrfrindex child_accs r5rz(JABElement._generate_childs_from_elementsF  : KDIt/F$ $   !==-N--j.KLLD~..   %OOM%(   z899  &-KKOZ%BE !%z    r7cf|r|jn|j}|j|j|dS)acRelease the memory used by the Java object object, where object is an object returned to you by Java Access Bridge. Java Access Bridge automatically maintains a reference to all Java objects that it returns to you in the JVM so they are not garbage collected. To prevent memory leaks, you must call ReleaseJavaObject on all Java objects returned to you by Java Access Bridge once you are finished with them. See JavaFerret.c for an illustration of how to do this. Args: jabelement (JABElement): The JABElement need to release N)r(r%releaseJavaObjectr')r4rr(s r5release_jabelementzJABElement.release_jabelements?.8 TJ ) )T=T  %%di1CDDDDDr7cX|p|j}|j|j|dS)z:Request focus for a component. Returns whether successful.N)r(r% requestFocusr'rHs r5_request_focuszJABElement._request_focuss1/J43J   ,>?????r7cV|p|j}|j|j|dS)Nr)r(r%!getAccessibleSelectionFromContextr'rHs r5&_get_accessible_selection_from_contextz1JABElement._get_accessible_selection_from_contexts60J43J{<< I)1   r7rcZ|p|j}|j|j||dSr9)r(r%!addAccessibleSelectionFromContextr')r4rr(s r5&_add_accessible_selection_from_contextz1JABElement._add_accessible_selection_from_context"s@0J43J 55 I)5     r7cX|p|j}|j|j|dSr9)r(r%#clearAccessibleSelectionFromContextr'rHs r5(_clear_accessible_selection_from_contextz3JABElement._clear_accessible_selection_from_context*s30J43J 77 CUVVVVVr7obj1obj2c^t|j|j||S)zReturns whether two object references are for the same object. Args: obj1 (JOBJECT64): Object 1. obj2 (JOBJECT64): Object 2. Returns: bool: Rerturns whether two object is same or not. )rnr% isSameObjectr')r4rrs r5_is_same_objectzJABElement._is_same_object0s(DK,,TYdCCDDDr7c|p|j}|j|j|}|dkr't |jd|S)aReturns the AccessibleContext for the top level object in a Java window. This is same AccessibleContext that is obtained from GetAccessibleContextFromHWND for that window. Returns (AccessibleContext)0 on error. Args: accessible_context (JOBJECT64, optional): Accessible Context. Defaults to None. Raises: JABException: Get top level object error. Returns: JOBJECT64: Top level object. rgetTopLevelObject)r(r%rr'rint_func_err_msgformat)r4r( top_objects r5_get_top_level_objectz JABElement._get_top_level_object<s[0J43J[2249>PQQ ??t4;;> I)   r7cT|p|j}|j|j|S)zReturns how many columns in the table are selected. Args: accessible_context (JOBJECT64, optional): Accessible Context. Defaults to None. Returns: int: Accessible table column selection count. )r(r%&getAccessibleTableColumnSelectionCountr'rHs r5rz7JABElement._get_accessible_table_column_selection_counts40J43J{AA I)   r7rowcolumnrc t}|p|j}|j|j|||t |}|s't |jd|S)aReturns information about the specified table cell. The row and column specifiers are zero-based. Args: row (int): Row index in table. column (int): Column index in table. accessible_context (JOBJECT64, optional): Accessible Context. Defaults to None. Raises: JABException: Get Accesible Table Cell Info error. Returns: AccessibleTableCellInfo: Accessible Table Cell Info. getAccessibleTableCellInfo) rr(r%rr'r rrr)r4rrr(rrs r5_get_accessible_table_cell_infoz*JABElement._get_accessible_table_cell_infos '((/J43J77 I)3d    %,,-IJJ  r7c|p|j}|j|j|}|dkr't |jd|S)zReturns the number of visible children of a component. Returns -1 on error. Args: accessible_context (JOBJECT64, optional): Accessible Context. Defaults to None. Returns: int: [description] rgetVisibleChildrenCount)r(r%rr'rrr)r4r(rs r5rz&JABElement._get_visible_children_count)sZ0J43J44TY@RSS R<<t4;;>E?##S&#S#S#STTT Q  '4Q'7'|jd|jD]}|jdn|dd|r|jtj krdS| d|jd dS) auClear existing text from JABElement. Default will use JAB Accessible Action. Set parameter 'simulate' to True if internal action does not work. Args: simulate (bool, optional): Simulate user input action by keyboard event. Defaults to False. wait_for_text_update (bool, optional): Waits for the text attribute to be empty. Defaults to True. Use this to send simple key events or to fill out form fields:: form_textfield = driver.find_element_by_name('username') form_textfield.clear() from_textfield.send_text(simulate=True) rr backspaceFvaluerNz clear texterror_msg_function) rrr&rr{r _press_key send_textrPrTEXT_wait_for_value_to_be)r4rr _s r5clearzJABElement.clears  5   3 3 3 C C C    ! ! !# =  = ++E222==A$// <<<< NNeN 4 4 4# tyDI'='= F ""4|"TTTTTr7r to_bottomholdc|jtjkrtdd|jv}|jd}|jd}|jd}|jd}|j|j|r|r||z|z dz }||d z z}n9|r||d z z}||z|z dz }n#|r||zdz}||d z z}n||d z z}||zdz}|j t|t|| d S) aScroll a scoll bar to top or to bottom. Need improvement for scroll to specific position. Args: to_bottom (bool, optional): Scroll to bottom or not, otherwise scroll to top. Defaults to True. hold (int, optional): Mouse hold time to scroll to bar. Default to 2. Raises: JABException: Raise a JABException when JABElement role is not a scroll bar. zJABElement is not 'scroll bar' horizontalrirjrkrlrrrirjrN) rSr SCROLL_BARrr[rmrrr&r r\r4rr is_horizontalrirjrkrls r5scrollzJABElement.scrollsD ?do - -?@@ @$(99 K  K X& G$ //TY/???   E F"Q&AFQJAA  EAI AF U"Q&AA  F QAFQJAAEAI AE A A %%A#a&&t%DDDDDr7rc|jdkrtdd|jv}|jd}|jd}|jd}|jd}|j|j|r|r||zd z }||d z z}n&|r||d z z}||zd z }n|r ||d z z}n||d z z}|jt|t|| d S) aSlide a slider to top or to bottom. Need improvement for slide to specific position. Args: to_bottom (bool, optional): Slide to bottom or not, otherwise slide to top. Defaults to True. hold (int, optional): Mouse hold time to slide. Default to 2. Raises: JABException: Raise a JABException when JABElement role is not a slider. sliderzJABElement is not 'slider'rrirjrkrlrrrr N) rSrr[rmrrr&r r\r"s r5slidezJABElement.slides ?h & &;<< <$(99 K  K X& G$ //TY/???   E A AFQJAA  EAI AF QAA  FQJAAEAI A %%A#a&&t%DDDDDr7optionwait_for_selectionc|j|j|j|jd|j||}|rF|t jt jg| |j dSdS)aSelect an item from JABElement selector. Support select action from combo box, page tab list, list and menu. Args: option (str): Item selection from selector. simulate (bool, optional): Simulate user input action by mouse event. Defaults to False. wait_for_selection (bool, optional): Waits for selection equal to the option value. Defaults to True. ) combo box page tab listlistmenu)r(rN) _select_from_combobox_select_from_page_tab_list_select_from_list_select_from_menurS_wait_for_value_to_containrSELECTEDCHECKEDfind_element_by_namer[)r4r(rr)rs r5selectzJABElement.selects 3!<**   /   #)8  = = =  \  + +V_fn,M,0,E,Ef,M,M,Z \ \ \ \ \ \ \r7cz||j}t|j|j|j|S)zGet selected JABElement from selection. Support get selection from combo box, list and page tab list. Returns: JABElement: The selected JABElement r%r&r'r()rr(r$r%r&r')r4 selected_accs r5get_selected_elementzJABElement.get_selected_elementsJBB  #  ;+     r7parentc ||}n-#t$r }t|jd|d|d}~wwxYw||j|jdS)Nrz option 'z ' not found)r6rrSrrbr()r4r<r(itemes r5&_add_selection_from_accessible_contextz1JABElement._add_selection_from_accessible_context s ..V.<Ac|jdkrtd||r |j|j||dS)Nz check boxzJABElement is not 'check box'rr)rSrrrrr&rr4rs r5_select_from_checkboxz JABElement._select_from_checkboxso ?k ) )>?? ?   D   3 3 3 C C C H %%%%%r7c|jdkrtd||r||j|j|d||d||j ddS| |j |||dS) Nr+zJABElement is not 'combo box'r togglepopuprr-)r<r(enter) rSrrrrr&rrAfind_element_by_rolerrr(r4r(rs r5r/z JABElement._select_from_combobox#s ?k ) )>?? ?      3 3 3 C C C  & &m & < < <  7 70088 8      ' ' 0 0 0 F 55d6MNNN 3343OOOOOr7c|jdkrtd|rK|j|j||ddS|||dS)Nr,z!JABElement is not 'page tab list'rTrC)r()rSrrrr&r6rrArJs r5r0z%JABElement._select_from_page_tab_list2s ?o - -BCC C     3 3 3 C C C  % %f - - 3 3T 3 B B B F 33D3HHHHHr7c|jtjkrtd|r |j|j|||dS)NzJABElement is not 'list'rr>rC) rSrLISTrrrr&r6rrJs r5r1zJABElement._select_from_list;ss ?di ' '9:: :  D   3 3 3 C C C !!!//55x5HHHHHr7c|jdkrtd|r|j|j|d||jdzD]L}|js |j d|j |kr|j ddSMdS| | d dS) Nr.zJABElement is not 'menu'rTrCr down_arrowrHr>F) rSrrrr&rfind_elements_by_object_depthr_rurrKr6)r4r(rr?s r5r2zJABElement._select_from_menuBs  ?f $ $9:: :  J   3 3 3 C C C JJJ % % %::4;Lq;PQQ  - ++L9999&&$//888EE'     % %F % 3 3 9 95 9 I I I I Ir7increasecf|jdkrtd|rR |d}n"#t$r}td|d}~wwxYw|||dS|rd}d}nd}d }|r|jd }|jd } |jd } |jd } |j|j|| zd z }| | dz z|z} |jt|t| dS| |dS)NspinboxzJABElement is not 'spinbox'rzBCurrent spinbox does not support set 'option', try with 'increase'r increment decrementrrirjrkrlrrrr) rSrrIrrmrrr&r r\r) r4r(rQrrr@roffset_y_positionrirjrkrls r5spinzJABElement.spinRsu ?i ' '<== =   0088   "X  NN(N ; ; ; F  " F "   F !    C A C A[*FK(E   3 3 3 C C CE A AFQJ!22A   ) )CFFc!ff ) = = = F ""&"11111s4 AAAcd|jvrtd|r.|d|ddS|ddS)N expandablez$JABElement does not support 'expand'TrC toggleexpand)r[rrrrDs r5expandzJABElement.expandtsn t0 0 0EFF F   JJJ % % % JJJ % % % F "">22222r7rUnion[str, int]ct|}|r1|d||j|nV|j|j|j|}|dkr*t|j ddz|r|j tj krdS|||jd|ddS) aType into the JABElement. Default will use JAB Accessible Action. Set parameter 'simulate' to True if internal action does not work. :Args: value (str, int): A string for typing. simulate (bool, optional): Simulate user input action by keyboard event. Defaults to False. wait_for_text_update (bool, optional): Waits for the text attribute to be equal to the input value. Defaults to True. Use this to send simple key events or to fill out form fields:: form_textfield = driver.find_element_by_name('username') form_textfield.send_text("admin") from_textfield.send_text("admin", simulate=True) TrsetTextContentsz(, try set parameter 'simulate' with TrueNzupdate text attribute to 'rr)rIrr _send_keysr%r_r'r(rrrrPrrrr)r4rrr rs r5rzJABElement.send_text}s"E    JJt1 2 2 2   ' ' . . . .[00 42EF{{")001BCC@A$ tyDI'='= F ""5$)HmejHmHmHm"nnnnnr7c(tj|jvS)z{Returns whether the JABElement is checked. Can be used to check if a checkbox or radio button is checked. )rr5r[r;s r5 is_checkedzJABElement.is_checkeds ~!222r7c(tj|jvS)z*Returns whether the JABElement is enabled.)rENABLEDr[r;s r5 is_enabledzJABElement.is_enabled~!222r7c(tj|jvS)z*Returns whether the JABElement is visible.)rVISIBLEr[r;s r5 is_visiblezJABElement.is_visiblerfr7c(tj|jvS)z*Returns whether the JABElement is showing.)rSHOWINGr[r;s r5 is_showingzJABElement.is_showingrfr7c(tj|jvS)z+Returns whether the JABElement is selected.)rr4r[r;s r5 is_selectedzJABElement.is_selected$"333r7c(tj|jvS)z+Returns whether the JABElement is editable.)rEDITABLEr[r;s r5 is_editablezJABElement.is_editableror7cF|tj||S)a[find child JABElement by name Args: value (str): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Returns: JABElement: The JABElement find by locator byrr) find_elementrNAMEr4rrs r5r6zJABElement.find_element_by_name!  BG5' JJJr7cF|tj||S)abfind child JABElement by description Args: value (str): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Returns: JABElement: The JABElement find by locator rt)rvr DESCRIPTIONrxs r5find_element_by_descriptionz&JABElement.find_element_by_descriptions!  BN% QQQr7cF|tj||S)a[find child JABElement by role Args: value (str): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Returns: JABElement: The JABElement find by locator rt)rvrROLErxs r5rIzJABElement.find_element_by_roleryr7Union[list, str]cF|tj||S)a^find child JABElement by states Args: value (list): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Returns: JABElement: The JABElement find by locator rt)rvrSTATESrxs r5find_element_by_statesz!JABElement.find_element_by_statess!  BIUG LLLr7cF|tj||S)acfind child JABElement by object depth Args: value (int): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Returns: JABElement: The JABElement find by locator rt)rvr OBJECT_DEPTHrxs r5find_element_by_object_depthz'JABElement.find_element_by_object_depths!  BO5' RRRr7cF|tj||S)aefind child JABElement by children count Args: value (int): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Returns: JABElement: The JABElement find by locator rt)rvrCHILDREN_COUNTrxs r5find_element_by_children_countz)JABElement.find_element_by_children_counts"  B$5UG TTTr7cF|tj||S)affind child JABElement by index in parent Args: value (int): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Returns: JABElement: The JABElement find by locator rt)rvrINDEX_IN_PARENTrxs r5find_element_by_index_in_parentz*JABElement.find_element_by_index_in_parents"  B$6eW UUUr7attr_valc|ddvr|ddvr |dd}tjd}||x}r|d|jvS||jkS)zReturn the attribute value is matched or not by name. Args: attr_val (str): Attribute name value jabelement (JABElement): The JABElement Returns: bool: True for attribute matched False for not rr"rr^contains\(["'](.*?)["']\))recompilefindallrKrrpatterncontents r5_is_match_attr_namezJABElement._is_match_attr_nameu A;* $ $")C)C"~H*;<<ooh// /7 /1:0 0z. .r7c|ddvr|ddvr |dd}tjd}||x}r|d|jvS||jkS)a Return the attribute value is matched or not by description. Args: attr_val (str): Attribute description value jabelement (JABElement): The JABElement Returns: bool: True for attribute matched False for not rrrrr)rrrrNrs r5_is_match_attr_descriptionz%JABElement._is_match_attr_description0sw A;* $ $")C)C"~H*;<<ooh// /7 61:!77 7z55 5r7c|ddvr|ddvr |dd}tjd}||x}r|d|jvS||jkS)aReturn the attribute value is matched or not by role. Args: attr_val (str): Attribute description value jabelement (JABElement): The JABElement Returns: bool: True for attribute matched False for not rrrrr)rrrrPrs r5_is_match_attr_rolezJABElement._is_match_attr_roleCrr7cn|ddvr|ddvr |dd}tjd}||x}r4tfd|ddDSt |dt jkS)aReturn the attribute value is matched or not by states. Args: attr_val (str): Attribute states value jabelement (JABElement): The JABElement Returns: bool: True for attribute matched False for not rrrrrc3*K|] }|jvVdSr9)r[).0statrs r5 z3JABElement._is_match_attr_states..es+YY4tz66YYYYYYr7rV)rrrallrXsetr[rs ` r5_is_match_attr_statesz JABElement._is_match_attr_statesVs A;* $ $")C)C"~H*;<<ooh// /7 LYYYY71:CSCSTWCXCXYYYYY Yx~~c**++s:3J/K/KK Kr7c2t||jkS)aReturn the attribute value is matched or not by object depth. Args: attr_val (str): Attribute object depth value jabelement (JABElement): The JABElement Returns: bool: True for attribute matched False for not )r\r_rrs r5_is_match_attr_objectdepthz%JABElement._is_match_attr_objectdepthis8}} 777r7c2t||jkS)aReturn the attribute value is matched or not by children count. Args: attr_val (str): Attribute children count value jabelement (JABElement): The JABElement Returns: bool: True for attribute matched False for not )r\rfrs r5_is_match_attr_childrencountz'JABElement._is_match_attr_childrencountvs8}} 999r7c2t||jkS)aReturn the attribute value is matched or not by index in parent. Args: attr_val (str): Attribute index in parent value jabelement (JABElement): The JABElement Returns: bool: True for attribute matched False for not )r\rbrs r5_is_match_attr_indexinparentz'JABElement._is_match_attr_indexinparents8}} :::r7 attributes list[dict]ctj|jtj|jtj|jtj|jtj |j tj |j tj |ji}|D]j}|d}|d}||vrt#d|d||||sdSkdS)aReturn the node attributes is matched or not with specific JABElement. Args: attributes (list[dict]): List of attribute contains "name" of attribute and "value" of attribute conditions jabelement (JABElement): The JABElement Raises: JABException: Incorrect attribute name found Returns: bool: True for attributes matched False for not rKrzincorrect attribute name 'rFT)rrwrr~rr{rrrrrrrrrrkeysr)r4rrdict_attribute attributerKrs r5_is_match_attributeszJABElement._is_match_attributess$ GT- GT- ND; It1 OT<  t@   A $  I==((DMM'**E>..0000"#G#G#G#GHHH'>$'z:: uu tr7c|p%t|j|j|j|j}||j|j}|s|S||j}||j|}|r|n|jS)zGet node JABElement. Args: jabelement (JABElement, optional): The JABElement. Defaults to None. Returns: JABElement: Node JABElement )r$r%r&r'r(rrr<)r4ris_samer is_top_levels r5_get_node_elementzJABElement._get_node_elements i:dk49diQUQh#i#i &&  #Z%B    //0GHH ++D,CZPP ):zzt{:r7rootnodelevelc|||\}}||||D]x}|dd|jfvr||6||d|r|cS||yt d|d|d)aGet child JABElement by specific node. Args: node (str): Node content for every single content in xpath. level (str, optional): Level for node, two options: "root" and "child". Defaults to "root". jabelement (JABElement, optional): The parent JABElement. Defaults to None. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Raises: ValueError: Incorrect level set JABException: No JABElement found with specific node Returns: JABElement: The child JABElement rrP*rzno JABElement found in level z with node 'r)_get_node_info_get_children_by_levelrrSrrr)r4rrrr node_element node_infors r5_get_element_by_nodezJABElement._get_element_by_nodes4#'"5"5dJ"G"G i=466u==_fggg 1 1K}}V$$S+2H,III'' 444((|)D)DkRR #""""  # #K 0 0 0 0 FE F Ft F F F   r7c|j|}d}|D]8}||dkrdnd}|||||}9|S)asFind child JABElement by xpath Args: value (str): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Example: find_element_by_xpath("//internal frame/panel") find_element_by_xpath("//*/panel") find_element_by_xpath("//internal frame[@name='FRM-999']") find_element_by_xpath("//internal frame[@name=contains('FRM-999')]") find_element_by_xpath("//internal frame[@states='enable,focusable,visible,showing']") find_element_by_xpath("//internal frame[@states=contains('enable,focusable')]") find_element_by_xpath("//internal frame[@objectdepth=7]") find_element_by_xpath("//internal frame[@childrencount=2]") find_element_by_xpath("//internal frame[@indexinparent=3]") find_element_by_xpath("//internal frame[@name=contains('FRM-999') and @objectdepth=7]") Returns: JABElement: The JABElement find by locator Nrrchildrrrr) xpath_parser split_nodesrr)r4rrnodesrrrs r5find_element_by_xpathz JABElement.find_element_by_xpathsz.!--e44   D#kk$//144FF'E22:w3JJr7rurc |tjtjtjtjtjtjtjtjfvrtd|d|tjkr| ||S| |D]3}| |||r|cS| |4td|d|d)aFind a jab element given a By strategy and locator. Args: by (str, optional): By strategy of element need to find. Defaults to By.NAME. value (Any, optional): Locator of element need to find. Defaults to None will select the first child jab element. visible (bool, optional): The switch for find only visible child jab element or not. Defaults to False to find available child element. Returns: JABElement: The element find by locator incorrect by strategy 'rrrrrurrzjab element not found by '' with locator ')rrwr{r~rrrrXPATHrrr_is_element_matchedr)r4rurrrs r5rvzJABElement.find_elements  G N G I O     H  >>>>?? ? >>--E7-KK K33G3DD 0 0J''2Uz'RR "!!!!  # #J / / / / E E EU E E E   r7list[JABElement]cF|tj||S)anFind list of child JABElement by name Args: value (str): Locator of list JABElement need to find. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list[JABElement]: List of JABElement find by locator rt) find_elementsrrwrxs r5find_elements_by_namez JABElement.find_elements_by_name4!!!RWE7!KKKr7cF|tj||S)auFind list of child JABElement by description Args: value (str): Locator of list JABElement need to find. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list[JABElement]: List of JABElement find by locator rt)rrr{rxs r5find_elements_by_descriptionz'JABElement.find_elements_by_descriptionCs!!!R^5'!RRRr7cF|tj||S)anFind list of child JABElement by role Args: value (str): Locator of list JABElement need to find. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list[JABElement]: List of JABElement find by locator rt)rrr~rxs r5find_elements_by_rolez JABElement.find_elements_by_roleRrr7cF|tj||S)apFind list of child JABElement by states Args: value (str): Locator of list JABElement need to find. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list[JABElement]: List of JABElement find by locator rt)rrrrxs r5find_elements_by_statesz"JABElement.find_elements_by_statesas!!!RYeW!MMMr7cF|tj||S)avFind list of child JABElement by object depth Args: value (str): Locator of list JABElement need to find. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list[JABElement]: List of JABElement find by locator rt)rrrrxs r5rPz(JABElement.find_elements_by_object_depthps!!!R_E7!SSSr7cF|tj||S)axFind list of child JABElement by children count Args: value (str): Locator of list JABElement need to find. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list[JABElement]: List of JABElement find by locator rt)rrrrxs r5find_elements_by_children_countz*JABElement.find_elements_by_children_counts"!!R%6eW!UUUr7cF|tj||S)axFind list of child JABElement by index inparent Args: value (str): Locator of list JABElement need to find. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list[JABElement]: List of JABElement find by locator rt)rrrrxs r5 find_elements_by_index_in_parentz+JABElement.find_elements_by_index_in_parents"!!R%7ug!VVVr7c|||\}}g}||||D]}|dd|jfvr||6||d|r||u|||S)apGet list of child JABElement by specific node Args: node (str): Node content for every single content in xpath. level (str, optional): Level for node, two options: "root" and "child". Defaults to "root". jabelement (JABElement, optional): The parent JABElement. Defaults to None. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Raises: ValueError: Incorrect level set Returns: list[JABElement]: list of the JABElement rrPrr)rrrrSrrappend) r4rrrrrr jabelementsrs r5_get_elements_by_nodez JABElement._get_elements_by_nodes2#'"5"5dJ"G"G i =466u==_fggg 1 1K}}V$$S+2H,III'' 444((|)D)DkRR "";///  # #K 0 0 0 0r7cP|dvr|dkr|jn|jStd)N>rrrz$level should be in 'root' or 'child')rrr)r4rs r5rz!JABElement._get_children_by_levels6 % % %054,,TEg gCDD Dr7ch|j|}||}||fSr9)rget_node_informationr)r4rrrrs r5rzJABElement._get_node_infos8%::4@@ --j99 Y&&r7cdd} ddfd }j|}tjjjjg}||D]%\}}|std|||||}&|S)ajFind list of child JABElement by xpath Args: value (str): Locator of JABElement need to find. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list[JABElement]: List of JABElement find by locator _nodes list[str]r)rc3TKt|D]\}}|dkrdnd}||fVdS)Nrrr) enumerate)rr_node_levels r5 generate_nodez8JABElement.find_elements_by_xpath..generate_nodesO )& 1 1 $ $ u#(A::7Vm#### $ $r7FrrIr_parent_jabelementsr_visiblernc ng}|D].}|||||/|S)Nr)extendr)rrrrchild_jabelements_parent_jabelementr4s r5get_child_jabelementsz@JABElement.find_elements_by_xpath..get_child_jabelementssd !# &9  "!((.."$#5 ( /% $r7zno JABElement found)rrrr)rrr)rF) rrIrrIrrrrnr)r)rrr$r%r&r'r(r) r4rrrrr _jabelementsrrs ` r5find_elements_by_xpathz!JABElement.find_elements_by_xpaths $ $ $ $"'  % % % % % % %$!--e44 t{DIty$:Q R R )=//  KD% :"#8999005lU\LLr7Union[list, str, int]c |tjtjtjtjtjtjtjtjfvrtd|d|tjkr| ||Sg}| |D]E}| |||r| |0||F|std|d|d|S)aFind list of JABElement given a By strategy and locator. Args: by (str, optional): By strategy of element need to find. Defaults to By.NAME. value (Any, optional): Locator of element need to find. Defaults to None will select the first child jab element. visible (bool, optional): The switch for find only visible child jab elements or not. Defaults to False to find all child elements. Returns: list: List of JABElement find by locator rrrrrzno JABElement found by 'r)rrwr{r~rrrrrrrrrrr)r4rurrrrs r5rzJABElement.find_elementss(  G N G I O     H  >>>>?? ? >>..UG.LL L 33G3DD 0 0J''2Uz'RR "":...  # #J / / / / G2GGuGGG r7 Optional[str]c t|du|tjko |j|k|tjko |j|k|tjko |j|k|tjko$t|j t|k|tj ko|j t|k|tjko|jt|k|tjko|jt|kgSr9)anyrrwrKr~rPr{rNrrr[rr_r\rrfrrb)rrurs r5rzJABElement._is_element_matched)s bg :*/U":bg :*/U":bn$H)?5)HbiNC (?$@$@CJJ$Nbo%:+s5zz9b''<-U;b((=.#e**<    r7ct|jd|jdS)zThe size of the element.rkrl)rkrlrgrmrr;s r5sizezJABElement.size;s34;??844DKOOG==?? ;)     r7c|jdkrtd|||}|j}|j}|r!|}|j|}t|j|j |j |S)aGet cell JABElement from table Args: row (int): Row index of cell, start from 0. column (int): Column index of cell, start from 0. visible (bool, optional): The switch for find only visible cell element or not. Defaults to False to find available cell element. Raises: JABException: Raise JABException if JAB internal function error Returns: JABElement: Return specific cell JABElement rz3JABElement is not table, does not support this func) rSrrraccessibleContextrrr$r%r&r')r4rrrrrr(s r5get_cellzJABElement.get_cellws ?g % %TUU U33C@@ !3  6--//D!%u!5 $+ty$)=OPPPr7c|j|j|j|j|j|j|j|j|j|j |j |j |j |j d}|j r |j|d<|jtjkr |j|d<|S)zGet dict information of current JABElement. Notice: This dict of component value will NOT update after property changes. Returns: dict: Dict information of current JABElement )rKrNrPrSrWr[rmr_rbrfrqrurxr{rr)rKrNrPrSrWr[rmr_rbrfrqrurxr{rrrr)r4rs r5get_element_informationz"JABElement.get_element_informationsI+I/k -k -#3"1$($=!%!7$($=#3     %9DL ?dj ( ( JDM r7expected_valuetimeoutrct} |r||ks|s|sdSt}t||z }||kr$|r d|d|d}n d|d|d}t|Y)NT Failed to  in ' ' secondsz#Failed to wait for expected value '' in ')rr  TimeoutError)r actual_valuerrrcurrentelapsed _error_msgs r5rz JABElement._wait_for_value_to_bes /" $66)7(7ffGGeO,,G'!!%p!Y.@!Y!Yw!Y!Y!YJJ!o~!o!o]d!o!o!oJ":... /r7expected_valuesUnion[str, list[str]]ct} tfd|DrdSt}t||z }||kr9|r d|d|d}nd}d|d|d}t |}) NTc3 K|]}|vV dSr9r~)rvr!s r5rz8JABElement._wait_for_value_to_contain..s(??A1'??????r7rrrz, z$Failed to wait for expected values 'r)rrr joinr) r! actual_valuesrrrrrr _expected_valuess ` r5r3z%JABElement._wait_for_value_to_contains /????????? ffGGeO,,G'!!%s!Y.@!Y!Yw!Y!Y!YJJ'+yy'A'A$!rHX!r!r`g!r!r!rJ":... /r7)NNNN) r%r r&rr'r r(rr)r*)r)r )r%r r)r*)r)r)r&rr)r*)r)r )r'r r)r*)r)r)r(rr)r*)r)rI)r)r\)r)rg)r)rnr})rr$rrnr)rr9)rr$r)r*)r(rr)r)rr\r(rr)r*)rrrrr)rn)r(rr)r)r(rr)r\)r(rr)r!) rr\rr\rrrr\r(rr)r*)r(rr)r )rr\rr\r(rr)r)r(rr)r")rrIr)r*r)rrnr)r*)FT)rrnr rnr)r*)Tr)rrnrr\r)r*)Tr)r(rIrrnr)rnr)r*)r)r$)r<r$r(rIr)r*)r(rIrrnr)r*)NTF)r(rIrQrnrrnr)r*)rr]rrnr rnr)r*)rrIrrnr)r$)rrrrnr)r$)rr\rrnr)r$)rrIrr$r)rn)rrrr$r)rn)rr$r)r$)rNF) rrIrrIrr$rrnr)r$)rurIrrrrnr)r$)rrIrrnr)r)rrrrnr)r)rr\rrnr)r) rrIrrIrr$rrnr)r)r)rrI)rrIrr$)rurIrrrrnr)r)rr$rurIrr)rrIr)r*)r)r)rr\rr\rrnr)r$)rN)rrrr\rrI)r!r"rr\rrI)x__name__ __module__ __qualname__rrrrrr6propertyr%setterr&r'r(rKrNrPrSrWr[r_rbrfrmrqrurxr{rrrrrrrrrrrrrr2r^rrrrrrrrrrrrrr$r'r7r;rArEr/r0r1r2rXr\rrbrerirlrnrrr6r|rIrrrr staticmethodrrrrrrrrrrrrrwrvrrrrrPrrrrrrrrrrrrr<rrrr3r~r7r5r$r$sw ;*,,K;==L ,0 ; ; ; ; ;X ]]X [[X [[(((X(6666%%%X%,,,X,%%%X%+++X+222X2888X8(((X(...X....X.   X :::X:777X7:::X:555X5X W W WX WPPPXP:BG8BG%%%%%PEEEEE$@@@@@ 37     ?C     WWWW E E E E*37 Y Y Y Y Y37.*37     $-1 W W W W W 37237437437     "37     "JN6      37     " " " " " H77777@UUUUU:!E!E!E!E!EFEEEEEB\\\\\&    "     &&&&& P P P P PIIIIIIIIIIJJJJJ"OT 2 2 2 2 2D33333 o o o o oD333333333333333344444444 K K K K K/4 R R R R R K K K K K M M M M M/4 S S S S S /4 U U U U U /4 V V V V V///\/$666\6$///\/$LLL\L$ 8 8 8\ 8 : : :\ : ; ; ;\ ;!!!!F;;;;;, %)! $ $ $ $ $ LBG$" " " " " J/4 L L L L L /4 S S S S S /4 L L L L L Z[8<////\/(ij=A////\///r7r$)2 __future__rrpyjab.common.loggerrpyjab.common.rolerpyjab.common.statesrpyjab.common.textreaderrrctypesr r r r r rctypes.wintypesrtypingrrrrPILrrpyjab.common.byrpyjab.common.exceptionsrpyjab.common.typesrrpyjab.common.win32utilsrpyjab.common.xpathparserrpyjab.accessibleinforrrrr r!r"objectr$r~r7r5r?s""""""&&&&&&""""""&&&&&&...... KKKKKKKKKKKKKKKK 222222222222 000000..............000000u/u/u/u/u/u/u/u/u/u/r7