>i.pddlmZddlmZmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZer8ddlmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#ddl$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-GddZ.y ) ) annotations) TYPE_CHECKINGOptional)Command) DispatchDragEventParamsDispatchKeyEventParamsDispatchMouseEventParamsDispatchTouchEventParams EmulateTouchFromMouseEventParamsImeSetCompositionParams InputMethodInsertTextParamsSetIgnoreInputEventsParamsSetInterceptDragsParamsSynthesizePinchGestureParamsSynthesizeScrollGestureParamsSynthesizeTapGestureParams)CancelDraggingCommandDispatchDragEventCommandDispatchKeyEventCommandDispatchMouseEventCommandDispatchTouchEventCommandDragData!EmulateTouchFromMouseEventCommandImeSetCompositionCommandInsertTextCommandSetIgnoreInputEventsCommandSetInterceptDragsCommandSynthesizePinchGestureCommandSynthesizeScrollGestureCommandSynthesizeTapGestureCommand TouchPoint) DragEventTypeGestureSourceType KeyEventType KeyLocation KeyModifier MouseButtonMouseEventType PointerTypeTouchEventTypeceZdZdZeddZe d ddZe d ddZe d ddZeddZ e d ddZ e d dd Z e d dd Z e dd Z edd Ze d dd Ze d d!dZe d" d#dZy)$ InputCommandsa A class for simulating user input events using Chrome DevTools Protocol. The Input domain provides methods for simulating user input, including: - Keyboard events (key presses, releases) - Mouse events (clicks, movements, wheel) - Touch events (taps, multi-touch gestures) - Drag and drop events - Synthetic gestures (pinch, scroll, tap) These methods allow for programmatic control of input events without requiring actual user interaction, making it useful for testing and automation. c6ttjS)a7 Generates a command to cancel any active dragging in the page. This is useful when you need to interrupt an ongoing drag operation that might have been started with dispatchDragEvent or by other means. Returns: Command: The CDP command to cancel dragging. )method)rr CANCEL_DRAGGINGd/var/www/python/tenders/Scrapper/venv/lib/python3.12/site-packages/pydoll/commands/input_commands.pycancel_draggingzInputCommands.cancel_draggingDsk99::r2Nct|}|||d<|||d<|||d<|||d<|||d<|||d<|||d<|||d <| | |d <| | |d <| | |d <| | |d <| | |d<|||d<ttj|S)a Generates a command to dispatch a key event to the page. This method can simulate various types of keyboard events such as key presses, key releases, and character inputs. Args: type: Type of the key event. Allowed values: keyDown, keyUp, rawKeyDown, char. - keyDown: Corresponds to a user pressing a key - keyUp: Corresponds to a user releasing a key - rawKeyDown: A physical key press, without the text processing - char: Generates a character without explicit key events modifiers: Bit field representing pressed modifier keys. Values: Alt=1, Ctrl=2, Meta/Command=4, Shift=8 (default: 0). For example, to simulate Ctrl+Shift, use 10. timestamp: Time at which the event occurred, in seconds since epoch. text: Text as generated by processing a virtual key code with a keyboard layout. Not needed for 'keyUp' and 'rawKeyDown' events (default: ""). unmodified_text: Text that would have been generated by the keyboard without modifiers (except for shift). Useful for shortcut key handling (default: ""). key_identifier: Unique key identifier (e.g., 'U+0041') (default: ""). code: Unique DOM defined string value for each physical key (e.g., 'KeyA') (default: ""). key: Unique DOM defined string value describing the meaning of the key in the context of active modifiers, keyboard layout, etc. (e.g., 'AltGr') (default: ""). windows_virtual_key_code: Windows virtual key code (default: 0). native_virtual_key_code: Native virtual key code (default: 0). auto_repeat: Whether the event was generated from auto repeat (default: false). is_keypad: Whether the event was generated from the keypad (default: false). is_system_key: Whether the event was a system key event (default: false). location: Whether the event was from the left or right side of the keyboard: 0=Default, 1=Left, 2=Right (default: 0). commands: Editing commands to send with the key event (e.g., 'selectAll') (default: []). These are related to but not equal to the command names used in `document.execCommand` and NSStandardKeyBindingResponding. Returns: Command: The CDP command to dispatch the key event. )type modifiers timestamptextunmodifiedText keyIdentifiercodekeywindowsVirtualKeyCodenativeVirtualKeyCode autoRepeatisKeypad isSystemKeylocationcommandsr/params)rrr DISPATCH_KEY_EVENT)r6r7r8r9unmodified_textkey_identifierr<r=windows_virtual_key_codenative_virtual_key_code auto_repeat is_keypad is_system_keyrCrDrFs r3dispatch_key_eventz InputCommands.dispatch_key_eventQst(T2  "+F;   "+F;   !F6N  &'6F# $  %&4F? #  !F6N ?F5M # /.FF* + " .-DF) *  "#.F<  !*F:   $$1F= !  !)F:   !)F: k<  "+F;   "+F;   %F8   "#.F<  #F7O  *+>F' (  $F7O  $F7O  #F7O  &F8   &F8   #$0F= !k>>vNNr2cnt||}|||d<|||d<ttj|S)ad Generates a command to dispatch a touch event to the page. This method allows simulating touch interactions on touch-enabled devices or emulated touch environments. Args: type: Type of the touch event. Allowed values: - touchStart: Touch started - at least one point must be specified - touchEnd: Touch ended - points that are no longer pressed should be removed - touchMove: Touch moved - active points should be updated - touchCancel: Touch canceled - clears all touch points Touch end and cancel events must not contain any touch points, while touch start and move must contain at least one. touch_points: list of active touch points. One event per any changed point (compared to previous event) is generated, emulating pressing/moving/releasing points one by one. Each point includes coordinates and other properties. modifiers: Bit field representing pressed modifier keys. Values: Alt=1, Ctrl=2, Meta/Command=4, Shift=8 (default: 0). timestamp: Time at which the event occurred, in seconds since epoch. Returns: Command: The CDP command to dispatch the touch event. )r6 touchPointsr7r8rE)r rr DISPATCH_TOUCH_EVENT)r6 touch_pointsr7r8rFs r3dispatch_touch_eventz"InputCommands.dispatch_touch_eventsD@*tN  "+F;   "+F; k>>vNNr2cPt|}ttj|S)a Generates a command to ignore input events (useful while auditing page). When ignore is true, all input events will be ignored, which can be useful during automated tests or when you want to prevent user interaction while performing certain operations. Args: ignore: If true, input events processing will be ignored. Returns: Command: The CDP command to set ignore input events. )ignorerE)rrr SET_IGNORE_INPUT_EVENTS)rlrFs r3set_ignore_input_eventsz%InputCommands.set_ignore_input_events)s!,6:kAA&QQr2cdt||||}|||d<ttj|S)a Generates a command to dispatch a drag event into the page. This experimental method allows simulating drag and drop operations by dispatching drag events at specific coordinates. Args: type: Type of the drag event. Allowed values: - dragEnter: Fired when a dragged item enters a valid drop target - dragOver: Fired when a dragged item is being dragged over a valid drop target - drop: Fired when an item is dropped on a valid drop target - dragCancel: Fired when a drag operation is being canceled x: X coordinate of the event relative to the main frame's viewport in CSS pixels. y: Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to the top of the viewport, and Y increases going down. data: Drag data containing items being dragged, their MIME types, and other information. modifiers: Bit field representing pressed modifier keys. Values: Alt=1, Ctrl=2, Meta/Command=4, Shift=8 (default: 0). Returns: Command: The CDP command to dispatch the drag event. )r6datarQrRr7rE)rrr DISPATCH_DRAG_EVENT)r6rQrRrpr7rFs r3dispatch_drag_eventz!InputCommands.dispatch_drag_event;s7<)daH  "+F; k==fMMr2c t||||} ||| d<||| d<||| d<||| d<||| d<ttj| S)a Generates a command to emulate touch event from the mouse event parameters. This experimental method allows converting mouse events into touch events, useful for testing touch interactions in environments where touch is not available. Args: type: Type of the mouse event to convert. Allowed values: - mousePressed: Converted to touchStart - mouseReleased: Converted to touchEnd - mouseMoved: Converted to touchMove - mouseWheel: May trigger scrolling x: X coordinate of the mouse pointer in device-independent pixels (DIP). y: Y coordinate of the mouse pointer in DIP. button: Mouse button. Only "none", "left", "right" are supported. timestamp: Time at which the event occurred, in seconds since epoch. Default is current time. delta_x: X delta in DIP for mouse wheel event (default: 0). Used for scrolling. delta_y: Y delta in DIP for mouse wheel event (default: 0). Used for scrolling. modifiers: Bit field representing pressed modifier keys. Values: Alt=1, Ctrl=2, Meta/Command=4, Shift=8 (default: 0). click_count: Number of times the mouse button was clicked (default: 0). For example, 2 for a double-click. Returns: Command: The CDP command to emulate touch from mouse event. )r6rQrRrSr8rZr[r7rTrE)r rr EMULATE_TOUCH_FROM_MOUSE_EVENT) r6rQrRrSr8rbrcr7r^rFs r3emulate_touch_from_mouse_eventz,InputCommands.emulate_touch_from_mouse_event^syN2tqAfU  "+F;   &F8   &F8   "+F;   "#.F< kHHQWXXr2cpt|||}|||d<|||d<ttj|S)a  Generates a command to set the current candidate text for IME. This experimental method sets the text for Input Method Editors (IME), which are used for entering characters in languages that require more keystrokes than the number of characters (like Chinese, Japanese, Korean). Use imeCommitComposition to commit the final text. Use imeSetComposition with empty string as text to cancel composition. Args: text: The text to insert as the IME composition. selection_start: Start position of the selection within the composition text. selection_end: End position of the selection within the composition text. replacement_start: Start position of the text to be replaced (default: same as selection_start). replacement_end: End position of the text to be replaced (default: same as selection_end). Returns: Command: The CDP command to set IME composition. )r9selectionStart selectionEndreplacementStartreplacementEndrE)r rr IME_SET_COMPOSITION)r9selection_start selection_endreplacement_startreplacement_endrFs r3ime_set_compositionz!InputCommands.ime_set_compositionsN<)*&   ():F% &  &'6F# $k==fMMr2cPt|}ttj|S)a Generates a command to emulate inserting text that doesn't come from a key press. This experimental method is useful for inserting text that would normally come from sources other than keyboard, such as emoji pickers, IMEs, or clipboard pastes. Args: text: The text to insert. Returns: Command: The CDP command to insert text. )r9rE)rrr INSERT_TEXT)r9rFs r3 insert_textzInputCommands.insert_texts!""t,k55fEEr2cPt|}ttj|S)a Generates a command to control interception of drag and drop events. This experimental method prevents default drag and drop behavior and instead emits Input.dragIntercepted events. Drag and drop behavior can then be directly controlled via Input.dispatchDragEvent. This is useful for implementing custom drag and drop logic or for testing drag and drop behavior in automated tests. Args: enabled: If true, drag events will be intercepted and reported as dragIntercepted events, preventing the default behavior. Returns: Command: The CDP command to set drag interception. )enabledrE)rrr SET_INTERCEPT_DRAGS)rrFs r3set_intercept_dragsz!InputCommands.set_intercept_dragss!&)9k==fMMr2cpt|||}|||d<|||d<ttj|S)a Generates a command to synthesize a pinch gesture over a time period. This experimental method creates a synthetic pinch gesture (zoom in/out) by issuing appropriate touch events over time. This is useful for testing pinch-to-zoom functionality in web applications. Args: x: X coordinate of the start of the gesture in CSS pixels. y: Y coordinate of the start of the gesture in CSS pixels. scale_factor: Relative scale factor after zooming: - >1.0 zooms in (fingers moving apart) - <1.0 zooms out (fingers moving together) relative_speed: Relative pointer speed in pixels per second (default: 800). Controls how fast the gesture happens. gesture_source_type: Which type of input events to be generated: - 'default': Platform's preferred input type - 'touch': Touch input - 'mouse': Mouse input Returns: Command: The CDP command to synthesize a pinch gesture. )rQrR scaleFactor relativeSpeedgestureSourceTyperE)rrr SYNTHESIZE_PINCH_GESTURE)rQrR scale_factorrelative_speedgesture_source_typerFs r3synthesize_pinch_gesturez&InputCommands.synthesize_pinch_gesturesF>.QLQ  %&4F? #  **=F& 'kBB6RRr2c t||} ||| d<||| d<||| d<||| d<||| d<||| d<||| d<| | | d <| | | d <| | | d <ttj| S) a Generates a command to synthesize a scroll gesture over a time period. This experimental method creates a synthetic scroll gesture by issuing appropriate touch events over time. This is useful for testing scrolling behavior in web applications. Args: x: X coordinate of the start of the gesture in CSS pixels. y: Y coordinate of the start of the gesture in CSS pixels. x_distance: The distance to scroll along the X axis (positive to scroll left). y_distance: The distance to scroll along the Y axis (positive to scroll up). x_overscroll: The number of additional pixels to scroll back along the X axis, in addition to the given distance. This creates an overscroll effect (rubber-banding). y_overscroll: The number of additional pixels to scroll back along the Y axis, in addition to the given distance. This creates an overscroll effect (rubber-banding). prevent_fling: Prevent fling (default: true). If false, a fling animation might continue after the gesture. speed: Swipe speed in pixels per second (default: 800). gesture_source_type: Which type of input events to be generated: - 'default': Platform's preferred input type - 'touch': Touch input - 'mouse': Mouse input repeat_count: The number of times to repeat the gesture (default: 0). repeat_delay_ms: The number of milliseconds delay between each repeat (default: 250). interaction_marker_name: The name of the interaction markers to generate, if not empty. Used for tracking gesture timing in performance measurements. Returns: Command: The CDP command to synthesize a scroll gesture. rQrR xDistance yDistance xOverscroll yOverscroll preventFlingspeedr repeatCount repeatDelayMsinteractionMarkerNamerE)rrr SYNTHESIZE_SCROLL_GESTURE) rQrR x_distance y_distance x_overscroll y_overscroll prevent_flingrr repeat_countrepeat_delay_msinteraction_marker_namerFs r3synthesize_scroll_gesturez'InputCommands.synthesize_scroll_gesture s`/a8  !",F;   !",F;   #$0F= !  #$0F= !  $%2F> "  #F7O  **=F& '  #$0F= !  &&5F? # " ..EF* +kCCFSSr2c|t||}|||d<|||d<|||d<ttj|S)a Generates a command to synthesize a tap gesture over a time period. This experimental method creates a synthetic tap gesture by issuing appropriate touch events over time. This is useful for testing touch interaction in web applications. Args: x: X coordinate of the start of the gesture in CSS pixels. y: Y coordinate of the start of the gesture in CSS pixels. duration: Duration between touchdown and touchup events in milliseconds (default: 50). Controls how long the tap gesture takes. tap_count: Number of times to perform the tap (e.g., 2 for a double tap, default: 1). gesture_source_type: Which type of input events to be generated: - 'default': Platform's preferred input type - 'touch': Touch input - 'mouse': Mouse input Returns: Command: The CDP command to synthesize a tap gesture. rdurationtapCountrrE)rrr SYNTHESIZE_TAP_GESTURE)rQrRr tap_countrrFs r3synthesize_tap_gesturez$InputCommands.synthesize_tap_gestureRsT:,a15  !)F:   !*F:   **=F& 'k@@PPr2)returnr)NNNNNNNNNNNNNN) r6r%r7Optional[KeyModifier]r8Optional[float]r9 Optional[str]rHrrIrr<rr=rrJ Optional[int]rKrrLOptional[bool]rMrrNrrCzOptional[KeyLocation]rDzOptional[list[str]]rr) NNNNNNNNNNNN) r6r)rQintrRrr7rr8rrSzOptional[MouseButton]r^rrUrr_rr`rrarrYrrbrrcrrdzOptional[PointerType]rr)NN) r6r+rizlist[TouchPoint]r7rr8rrr)rlboolrr)N) r6r#rQrrRrrprr7rrr)NNNNN)r6r)rQrrRrrSr(r8rrbrrcrr7rr^rrr) r9strr|rr}rr~rrrrr)r9rrr)rrrr) rQrrRrrfloatrrrOptional[GestureSourceType]rr) NNNNNNNNNN)rQrrRrrrrrrrrrrrrrrrrrrrrrrr )NNN) rQrrRrrrrrrrrr!)__name__ __module__ __qualname____doc__ staticmethodr4rOrerjrnrrrurrrrrrr1r2r3r-r-5s  ; ;,0%)")-(,"!2615&*$((,*.(,VMVM(VM#VM VM ' VM & VMVMVM#0VM"/VM$VM"VM&VM(VM&VM !!VMVMp ,0%)(,%)!%/3"&"&##'#'.2UOUO UO UO) UO # UO & UO#UOUO-UO UO UOUO!UO!UO,UO #!UOUOn,0%) $O$O&$O)$O# $O # $O$OLRR" ,0 N N  N  N N ) N " N ND &*#'#'+/%)1Y1Y 1Y 1Y 1Y # 1Y ! 1Y!1Y)1Y#1Y +1Y1Yf ,0)- &N&N&N&N) &N ' &N " &N&NPFF FF&NN* )-;? #S #S #S#S& #S 9 #S ' #S#SJ'+&*(,(,(,#;?&*)-15DT DT DT$DT$ DT & DT & DT&DTDT9DT$DT'DT"/DT (DTDTL#'#';? #Q #Q #Q #Q! #Q 9 #Q % #Q#Qr2r-N)/ __future__rtypingrrpydoll.protocol.baserpydoll.protocol.input.methodsrrr r r r r rrrrrrrrrrrrrrrrrrr r!r"pydoll.protocol.input.typesr#r$r%r&r'r(r)r*r+r-r1r2r3rs]"*( "   A QA Qr2