o _c84@sdZddlZddlmZmZmZddlmZddlm Z ddl m Z ddl m Z er0ddlmZGd d d eZGd d d eZGd ddeZdS)zKeyboard and Mouse module.N)AnyDict TYPE_CHECKING) CDPSession)PyppeteerError)keyDefinitions) merge_dict)Setc @seZdZdZdeddfddZddeded eddfd d Z dede fd d Z dede fddZ deddfddZdeddfddZddede d eddfddZddede d eddfddZdS)KeyboardaKeyboard class provides as api for managing a virtual keyboard. The high level api is :meth:`type`, which takes raw characters and generate proper keydown, keypress/input, and keyup events on your page. For finer control, you can use :meth:`down`, :meth:`up`, and :meth:`sendCharacter` to manually fire events as if they were generated from a real keyboard. An example of holding down ``Shift`` in order to select and delete some text: .. code:: await page.keyboard.type('Hello, World!') await page.keyboard.press('ArrowLeft') await page.keyboard.down('Shift') for i in ' World': await page.keyboard.press('ArrowLeft') await page.keyboard.up('Shift') await page.keyboard.press('Backspace') # Result text will end up saying 'Hello!'. An example of pressing ``A``: .. code:: await page.keyboard.down('Shift') await page.keyboard.press('KeyA') await page.keyboard.up('Shift') clientreturnNcCs||_d|_t|_dS)Nr)_client _modifiersset _pressedKeys)selfr r:/usr/local/lib/python3.10/dist-packages/pyppeteer/input.py__init__5s zKeyboard.__init__keyoptionskwargscst||}||}|d|jv}|j|d|j||dO_|d}|dur3|d}|jd|r;dnd|j|d|d|d||||d |d d kd IdHdS) aiDispatch a ``keydown`` event with ``key``. If ``key`` is a single character and no modifier keys besides ``Shift`` are being held down, and a ``keypress``/``input`` event will also generated. The ``text`` option can be specified to force an ``input`` event to be generated. If ``key`` is a modifier key, like ``Shift``, ``Meta``, or ``Alt``, subsequent key presses will be sent with that modifier active. To release the modifier key, use :meth:`up` method. :arg str key: Name of key to press, such as ``ArrowLeft``. :arg dict options: Option can have ``text`` field, and if this option specified, generate an input event with this text. .. note:: Modifier keys DO influence :meth:`down`. Holding down ``shift`` will type the text in upper case. codertextNInput.dispatchKeyEventZkeyDownZ rawKeyDownkeyCodelocation) type modifierswindowsVirtualKeyCoderrrZunmodifiedText autoRepeatrZisKeypad) r_keyDescriptionForStringraddr _modifierBitgetr send)rrrr descriptionr!rrrrdown:s*     z Keyboard.downcCs4|dkrdS|dkr dS|dkrdS|dkrdSd S) NZAltControlZMetaZShiftrr)rrrrrr$gszKeyboard._modifierBit keyStringcCs|jd@}dddddd}t|}|std|d|vr%|d|d<|r2|dr2|d|d<d|vr<|d|d<|rI|d rI|d |d<d |vrS|d |d <d |vr]|d |d <t|dd krk|d|d <d |vru|d |d <|r|dr|d|d <|jd@rd|d <|S)Nr-r)rrrrrz Unknown key: rZshiftKeyrZ shiftKeyCoderrr)rZ shiftTexti)rrr%rlen)rr.shiftr'Z definitionrrrr"rs>            z!Keyboard._keyDescriptionForStringc s|||}|j||dM_|d|jvr"|j|d|jdd|j|d|d|d|ddIdHdS) zyDispatch a ``keyup`` event of the ``key``. :arg str key: Name of key to release, such as ``ArrowLeft``. rrrZkeyUprr)rrrr rrN)r"rr$rremover r&)rrr'rrrups z Keyboard.upcharcs|jdd|iIdHdS)aBSend character into the page. This method dispatches a ``keypress`` and ``input`` event. This does not send a ``keydown`` or ``keyup`` event. .. note:: Modifier keys DO NOT effect :meth:`sendCharacter`. Holding down ``shift`` will not type the text in upper case. zInput.insertTextrN)r r&)rr4rrr sendCharacters zKeyboard.sendCharacterrcsnt||}|dd}|D]&}|tvr ||d|iIdHn||IdH|r4t|dIdHqdS)aType characters into a focused element. This method sends ``keydown``, ``keypress``/``input``, and ``keyup`` event for each character in the ``text``. To press a special key, like ``Control`` or ``ArrowDown``, use :meth:`press` method. :arg str text: Text to type into a focused element. :arg dict options: Options can have ``delay`` (int|float) field, which specifies time to wait between key presses in milliseconds. Defaults to 0. .. note:: Modifier keys DO NOT effect :meth:`type`. Holding down ``shift`` will not type the text in upper case. delayrN)rr%rpressr5asynciosleep)rrrrr6r4rrrrs  z Keyboard.typecsRt||}|||IdHd|vrt|ddIdH||IdHdS)aPress ``key``. If ``key`` is a single character and no modifier keys besides ``Shift`` are being held down, a ``keypress``/``input`` event will also generated. The ``text`` option can be specified to force an input event to be generated. :arg str key: Name of key to press, such as ``ArrowLeft``. This method accepts the following options: * ``text`` (str): If specified, generates an input event with this text. * ``delay`` (int|float): Time to wait between ``keydown`` and ``keyup``. Defaults to 0. .. note:: Modifier keys DO effect :meth:`press`. Holding down ``Shift`` will type the text in upper case. Nr6r7)rr(r9r:r3)rrrrrrrr8s  zKeyboard.pressN)__name__ __module__ __qualname____doc__rrstrdictrr(intr$rr"r3r5rr8rrrrr s " - +  r c @seZdZdZdededdfddZdded ed ed e ddf d d Z dded ed ed e ddf ddZ dd ed e ddfddZ dd ed e ddfddZ dS)MousezMouse class. The :class:`Mouse` operates in main-frame CSS pixels relative to the top-left corner of the viewport. r keyboardr NcCs"||_||_d|_d|_d|_dS)Ngnone)r _keyboard_x_y_buttonrr rDrrrrs  zMouse.__init__xyrrc st||}|j}|j}||_||_|dd}td|dD]/}t||j|||}t||j|||}|jdd|j|||j j dIdHqdS)zMove mouse cursor (dispatches a ``mousemove`` event). Options can accepts ``steps`` (int) field. If this ``steps`` option specified, Sends intermediate ``mousemove`` events. Defaults to 1. stepsr)Input.dispatchMouseEventZ mouseMoved)rbuttonrKrLrN) rrGrHr%rangeroundr r&rIrFr) rrKrLrrZfromXZfromYrMirrrmoves$  z Mouse.movecslt||}|||IdH||IdH|r,|dr,t|dddIdH||IdHdS)aClick button at (``x``, ``y``). Shortcut to :meth:`move`, :meth:`down`, and :meth:`up`. This method accepts the following options: * ``button`` (str): ``left``, ``right``, or ``middle``, defaults to ``left``. * ``clickCount`` (int): defaults to 1. * ``delay`` (int|float): Time to wait between ``mousedown`` and ``mouseup`` in milliseconds. Defaults to 0. Nr6rr7)rrSr(r%r9r:r3)rrKrLrrrrrclicks z Mouse.clickc sTt||}|dd|_|jdd|j|j|j|jj|dp!ddIdHdS) aPress down button (dispatches ``mousedown`` event). This method accepts the following options: * ``button`` (str): ``left``, ``right``, or ``middle``, defaults to ``left``. * ``clickCount`` (int): defaults to 1. rOleftrNZ mousePressed clickCountr)rrOrKrLrrVN) rr%rIr r&rGrHrFrrrrrrrr(2s  z Mouse.downc sRt||}d|_|jdd|dd|j|j|jj|dp ddId Hd S) aRelease pressed button (dispatches ``mouseup`` event). This method accepts the following options: * ``button`` (str): ``left``, ``right``, or ``middle``, defaults to ``left``. * ``clickCount`` (int): defaults to 1. rErNZ mouseReleasedrOrUrVr)rWN) rrIr r&r%rGrHrFrrXrrrr3Fs   zMouse.upr;)r<r=r>r?rr rfloatrArrSrTr(r3rrrrrCs  rCc@s<eZdZdZdededdfddZded eddfd d ZdS) TouchscreenzTouchscreen class.r rDr NcCs||_||_dS)zMake new touchscreen object.N)r rFrJrrrr^s zTouchscreen.__init__rKrLcsZt|t|dg}|jdd||jjdIdH|jddg|jjdIdHdS)zYTap (``x``, ``y``). Dispatches a ``touchstart`` and ``touchend`` event. )rKrLzInput.dispatchTouchEventZ touchStart)r touchPointsrNZtouchEnd)rQr r&rFr)rrKrLr[rrrtapcszTouchscreen.tap) r<r=r>r?rr rrYr\rrrrrZ[srZ)r?r9typingrrrZpyppeteer.connectionrZpyppeteer.errorsrZpyppeteer.us_keyboard_layoutrZpyppeteer.utilrr objectr rCrZrrrrs     fd