generate code and docs for CPD r953906

Author: eNcacz

tests/test_trio_cdp.py

@@ -47,6 +47,7 @@ async def handler(request):
                         'title': 'New Tab',
                         'url': 'about:newtab',
                         'attached': False,
+                        'canAccessOpener': False,
                     }],
                 }
             }

trio_cdp/generated/__init__.py

@@ -5,7 +5,6 @@
 
 from . import accessibility
 from . import animation
-from . import application_cache
 from . import audits
 from . import background_service
 from . import browser
@@ -21,6 +20,7 @@
 from . import dom_snapshot
 from . import dom_storage
 from . import emulation
+from . import event_breakpoints
 from . import fetch
 from . import headless_experimental
 from . import heap_profiler
@@ -30,11 +30,13 @@
 from . import io
 from . import layer_tree
 from . import log
+from . import media
 from . import memory
 from . import network
 from . import overlay
 from . import page
 from . import performance
+from . import performance_timeline
 from . import profiler
 from . import runtime
 from . import schema

trio_cdp/generated/accessibility.py

@@ -19,7 +19,9 @@
     AXValueNativeSourceType,
     AXValueSource,
     AXValueSourceType,
-    AXValueType
+    AXValueType,
+    LoadComplete,
+    NodesUpdated
 )
 
 
@@ -40,16 +42,61 @@ async def enable() -> None:
     return await session.execute(cdp.accessibility.enable())
 
 
-async def get_full_ax_tree() -> typing.List[AXNode]:
+async def get_ax_node_and_ancestors(
+        node_id: typing.Optional[cdp.dom.NodeId] = None,
+        backend_node_id: typing.Optional[cdp.dom.BackendNodeId] = None,
+        object_id: typing.Optional[cdp.runtime.RemoteObjectId] = None
+    ) -> typing.List[AXNode]:
+    '''
+    Fetches a node and all ancestors up to and including the root.
+    Requires ``enable()`` to have been called previously.
+
+    **EXPERIMENTAL**
+
+    :param node_id: *(Optional)* Identifier of the node to get.
+    :param backend_node_id: *(Optional)* Identifier of the backend node to get.
+    :param object_id: *(Optional)* JavaScript object id of the node wrapper to get.
+    :returns: 
+    '''
+    session = get_session_context('accessibility.get_ax_node_and_ancestors')
+    return await session.execute(cdp.accessibility.get_ax_node_and_ancestors(node_id, backend_node_id, object_id))
+
+
+async def get_child_ax_nodes(
+        id_: AXNodeId,
+        frame_id: typing.Optional[cdp.page.FrameId] = None
+    ) -> typing.List[AXNode]:
+    '''
+    Fetches a particular accessibility node by AXNodeId.
+    Requires ``enable()`` to have been called previously.
+
+    **EXPERIMENTAL**
+
+    :param id_:
+    :param frame_id: *(Optional)* The frame in whose document the node resides. If omitted, the root frame is used.
+    :returns: 
+    '''
+    session = get_session_context('accessibility.get_child_ax_nodes')
+    return await session.execute(cdp.accessibility.get_child_ax_nodes(id_, frame_id))
+
+
+async def get_full_ax_tree(
+        depth: typing.Optional[int] = None,
+        max_depth: typing.Optional[int] = None,
+        frame_id: typing.Optional[cdp.page.FrameId] = None
+    ) -> typing.List[AXNode]:
     '''
-    Fetches the entire accessibility tree
+    Fetches the entire accessibility tree for the root Document
 
     **EXPERIMENTAL**
 
+    :param depth: *(Optional)* The maximum depth at which descendants of the root node should be retrieved. If omitted, the full tree is returned.
+    :param max_depth: **(DEPRECATED)** *(Optional)* Deprecated. This parameter has been renamed to ```depth```. If depth is not provided, max_depth will be used.
+    :param frame_id: *(Optional)* The frame for whose document the AX tree should be retrieved. If omited, the root frame is used.
     :returns: 
     '''
     session = get_session_context('accessibility.get_full_ax_tree')
-    return await session.execute(cdp.accessibility.get_full_ax_tree())
+    return await session.execute(cdp.accessibility.get_full_ax_tree(depth, max_depth, frame_id))
 
 
 async def get_partial_ax_tree(
@@ -71,3 +118,46 @@ async def get_partial_ax_tree(
     '''
     session = get_session_context('accessibility.get_partial_ax_tree')
     return await session.execute(cdp.accessibility.get_partial_ax_tree(node_id, backend_node_id, object_id, fetch_relatives))
+
+
+async def get_root_ax_node(
+        frame_id: typing.Optional[cdp.page.FrameId] = None
+    ) -> AXNode:
+    '''
+    Fetches the root node.
+    Requires ``enable()`` to have been called previously.
+
+    **EXPERIMENTAL**
+
+    :param frame_id: *(Optional)* The frame in whose document the node resides. If omitted, the root frame is used.
+    :returns: 
+    '''
+    session = get_session_context('accessibility.get_root_ax_node')
+    return await session.execute(cdp.accessibility.get_root_ax_node(frame_id))
+
+
+async def query_ax_tree(
+        node_id: typing.Optional[cdp.dom.NodeId] = None,
+        backend_node_id: typing.Optional[cdp.dom.BackendNodeId] = None,
+        object_id: typing.Optional[cdp.runtime.RemoteObjectId] = None,
+        accessible_name: typing.Optional[str] = None,
+        role: typing.Optional[str] = None
+    ) -> typing.List[AXNode]:
+    '''
+    Query a DOM node's accessibility subtree for accessible name and role.
+    This command computes the name and role for all nodes in the subtree, including those that are
+    ignored for accessibility, and returns those that mactch the specified name and role. If no DOM
+    node is specified, or the DOM node does not exist, the command returns an error. If neither
+    ``accessibleName`` or ``role`` is specified, it returns all the accessibility nodes in the subtree.
+
+    **EXPERIMENTAL**
+
+    :param node_id: *(Optional)* Identifier of the node for the root to query.
+    :param backend_node_id: *(Optional)* Identifier of the backend node for the root to query.
+    :param object_id: *(Optional)* JavaScript object id of the node wrapper for the root to query.
+    :param accessible_name: *(Optional)* Find nodes with this computed name.
+    :param role: *(Optional)* Find nodes with this computed role.
+    :returns: A list of ``Accessibility.AXNode`` matching the specified attributes, including nodes that are ignored for accessibility.
+    '''
+    session = get_session_context('accessibility.query_ax_tree')
+    return await session.execute(cdp.accessibility.query_ax_tree(node_id, backend_node_id, object_id, accessible_name, role))

trio_cdp/generated/application_cache.py

@@ -9,6 +9,78 @@
 from ..context import get_connection_context, get_session_context
 
 import cdp.audits
+from cdp.audits import (
+    AffectedCookie,
+    AffectedFrame,
+    AffectedRequest,
+    AttributionReportingIssueDetails,
+    AttributionReportingIssueType,
+    BlockedByResponseIssueDetails,
+    BlockedByResponseReason,
+    ClientHintIssueDetails,
+    ClientHintIssueReason,
+    ContentSecurityPolicyIssueDetails,
+    ContentSecurityPolicyViolationType,
+    CorsIssueDetails,
+    DeprecationIssueDetails,
+    GenericIssueDetails,
+    GenericIssueErrorType,
+    HeavyAdIssueDetails,
+    HeavyAdReason,
+    HeavyAdResolutionStatus,
+    InspectorIssue,
+    InspectorIssueCode,
+    InspectorIssueDetails,
+    IssueAdded,
+    IssueId,
+    LowTextContrastIssueDetails,
+    MixedContentIssueDetails,
+    MixedContentResolutionStatus,
+    MixedContentResourceType,
+    NavigatorUserAgentIssueDetails,
+    QuirksModeIssueDetails,
+    SameSiteCookieExclusionReason,
+    SameSiteCookieIssueDetails,
+    SameSiteCookieOperation,
+    SameSiteCookieWarningReason,
+    SharedArrayBufferIssueDetails,
+    SharedArrayBufferIssueType,
+    SourceCodeLocation,
+    TrustedWebActivityIssueDetails,
+    TwaQualityEnforcementViolationType,
+    WasmCrossOriginModuleSharingIssueDetails
+)
+
+
+async def check_contrast(
+        report_aaa: typing.Optional[bool] = None
+    ) -> None:
+    '''
+    Runs the contrast check for the target page. Found issues are reported
+    using Audits.issueAdded event.
+
+    :param report_aaa: *(Optional)* Whether to report WCAG AAA level issues. Default is false.
+    '''
+    session = get_session_context('audits.check_contrast')
+    return await session.execute(cdp.audits.check_contrast(report_aaa))
+
+
+async def disable() -> None:
+    '''
+    Disables issues domain, prevents further issues from being reported to the client.
+    '''
+    session = get_session_context('audits.disable')
+    return await session.execute(cdp.audits.disable())
+
+
+async def enable() -> None:
+    '''
+    Enables issues domain, sends the issues collected so far to the client by means of the
+    ``issueAdded`` event.
+    '''
+    session = get_session_context('audits.enable')
+    return await session.execute(cdp.audits.enable())
+
 
 async def get_encoded_response(
         request_id: cdp.network.RequestId,
@@ -26,9 +98,9 @@ async def get_encoded_response(
     :param size_only: *(Optional)* Whether to only return the size information (defaults to false).
     :returns: A tuple with the following items:
 
-        0. **body** – *(Optional)* The encoded body as a base64 string. Omitted if sizeOnly is true.
-        1. **originalSize** – Size before re-encoding.
-        2. **encodedSize** – Size after re-encoding.
+        0. **body** - *(Optional)* The encoded body as a base64 string. Omitted if sizeOnly is true. (Encoded as a base64 string when passed over JSON)
+        1. **originalSize** - Size before re-encoding.
+        2. **encodedSize** - Size after re-encoding.
     '''
     session = get_session_context('audits.get_encoded_response')
     return await session.execute(cdp.audits.get_encoded_response(request_id, encoding, quality, size_only))