Regenerate code and docs

Author: mehaase

cdp/__init__.py

@@ -1,9 +1,7 @@
-'''
-DO NOT EDIT THIS FILE
-
-This file is generated from the CDP specification. If you need to make changes,
-edit the generator and regenerate all of the modules.
-'''
+# DO NOT EDIT THIS FILE!
+#
+# This file is generated from the CDP specification. If you need to make
+# changes, edit the generator and regenerate all of the modules.
 
 import cdp.util
 
@@ -30,7 +28,7 @@
 import cdp.heap_profiler
 import cdp.io
 import cdp.indexed_db
-import cdp.input
+import cdp.input_
 import cdp.inspector
 import cdp.layer_tree
 import cdp.log

cdp/accessibility.py

@@ -1,13 +1,11 @@
-'''
-DO NOT EDIT THIS FILE
-
-This file is generated from the CDP specification. If you need to make changes,
-edit the generator and regenerate all of the modules.
-
-Domain: Accessibility
-Experimental: True
-'''
-
+# DO NOT EDIT THIS FILE!
+#
+# This file is generated from the CDP specification. If you need to make
+# changes, edit the generator and regenerate all of the modules.
+#
+# CDP domain: Accessibility (experimental)
+
+from __future__ import annotations
 from cdp.util import event_class, T_JSON_DICT
 from dataclasses import dataclass
 import enum
@@ -25,7 +23,7 @@ def to_json(self) -> str:
         return self
 
     @classmethod
-    def from_json(cls, json: str) -> 'AXNodeId':
+    def from_json(cls, json: str) -> AXNodeId:
         return cls(json)
 
     def __repr__(self):
@@ -58,7 +56,7 @@ def to_json(self) -> str:
         return self.value
 
     @classmethod
-    def from_json(cls, json: str) -> 'AXValueType':
+    def from_json(cls, json: str) -> AXValueType:
         return cls(json)
 
 
@@ -77,7 +75,7 @@ def to_json(self) -> str:
         return self.value
 
     @classmethod
-    def from_json(cls, json: str) -> 'AXValueSourceType':
+    def from_json(cls, json: str) -> AXValueSourceType:
         return cls(json)
 
 
@@ -98,7 +96,7 @@ def to_json(self) -> str:
         return self.value
 
     @classmethod
-    def from_json(cls, json: str) -> 'AXValueNativeSourceType':
+    def from_json(cls, json: str) -> AXValueNativeSourceType:
         return cls(json)
 
 
@@ -108,25 +106,25 @@ class AXValueSource:
     A single source for a computed AX property.
     '''
     #: What type of source this is.
-    type: 'AXValueSourceType'
+    type_: AXValueSourceType
 
     #: The value of this property source.
-    value: typing.Optional['AXValue'] = None
+    value: typing.Optional[AXValue] = None
 
     #: The name of the relevant attribute, if any.
     attribute: typing.Optional[str] = None
 
     #: The value of the relevant attribute, if any.
-    attribute_value: typing.Optional['AXValue'] = None
+    attribute_value: typing.Optional[AXValue] = None
 
     #: Whether this source is superseded by a higher priority source.
     superseded: typing.Optional[bool] = None
 
     #: The native markup source for this value, e.g. a <label> element.
-    native_source: typing.Optional['AXValueNativeSourceType'] = None
+    native_source: typing.Optional[AXValueNativeSourceType] = None
 
     #: The value, such as a node or node list, of the native source.
-    native_source_value: typing.Optional['AXValue'] = None
+    native_source_value: typing.Optional[AXValue] = None
 
     #: Whether the value for this property is invalid.
     invalid: typing.Optional[bool] = None
@@ -136,7 +134,7 @@ class AXValueSource:
 
     def to_json(self) -> T_JSON_DICT:
         json: T_JSON_DICT = dict()
-        json['type'] = self.type.to_json()
+        json['type'] = self.type_.to_json()
         if self.value is not None:
             json['value'] = self.value.to_json()
         if self.attribute is not None:
@@ -156,9 +154,9 @@ def to_json(self) -> T_JSON_DICT:
         return json
 
     @classmethod
-    def from_json(cls, json: T_JSON_DICT) -> 'AXValueSource':
+    def from_json(cls, json: T_JSON_DICT) -> AXValueSource:
         return cls(
-            type=AXValueSourceType.from_json(json['type']),
+            type_=AXValueSourceType.from_json(json['type']),
             value=AXValue.from_json(json['value']) if 'value' in json else None,
             attribute=str(json['attribute']) if 'attribute' in json else None,
             attribute_value=AXValue.from_json(json['attributeValue']) if 'attributeValue' in json else None,
@@ -173,7 +171,7 @@ def from_json(cls, json: T_JSON_DICT) -> 'AXValueSource':
 @dataclass
 class AXRelatedNode:
     #: The BackendNodeId of the related DOM node.
-    backend_dom_node_id: 'dom.BackendNodeId'
+    backend_dom_node_id: dom.BackendNodeId
 
     #: The IDRef value provided, if any.
     idref: typing.Optional[str] = None
@@ -191,7 +189,7 @@ def to_json(self) -> T_JSON_DICT:
         return json
 
     @classmethod
-    def from_json(cls, json: T_JSON_DICT) -> 'AXRelatedNode':
+    def from_json(cls, json: T_JSON_DICT) -> AXRelatedNode:
         return cls(
             backend_dom_node_id=dom.BackendNodeId.from_json(json['backendDOMNodeId']),
             idref=str(json['idref']) if 'idref' in json else None,
@@ -202,10 +200,10 @@ def from_json(cls, json: T_JSON_DICT) -> 'AXRelatedNode':
 @dataclass
 class AXProperty:
     #: The name of this property.
-    name: 'AXPropertyName'
+    name: AXPropertyName
 
     #: The value of this property.
-    value: 'AXValue'
+    value: AXValue
 
     def to_json(self) -> T_JSON_DICT:
         json: T_JSON_DICT = dict()
@@ -214,7 +212,7 @@ def to_json(self) -> T_JSON_DICT:
         return json
 
     @classmethod
-    def from_json(cls, json: T_JSON_DICT) -> 'AXProperty':
+    def from_json(cls, json: T_JSON_DICT) -> AXProperty:
         return cls(
             name=AXPropertyName.from_json(json['name']),
             value=AXValue.from_json(json['value']),
@@ -227,20 +225,20 @@ class AXValue:
     A single computed AX property.
     '''
     #: The type of this value.
-    type: 'AXValueType'
+    type_: AXValueType
 
     #: The computed value of this property.
     value: typing.Optional[typing.Any] = None
 
     #: One or more related nodes, if applicable.
-    related_nodes: typing.Optional[typing.List['AXRelatedNode']] = None
+    related_nodes: typing.Optional[typing.List[AXRelatedNode]] = None
 
     #: The sources which contributed to the computation of this property.
-    sources: typing.Optional[typing.List['AXValueSource']] = None
+    sources: typing.Optional[typing.List[AXValueSource]] = None
 
     def to_json(self) -> T_JSON_DICT:
         json: T_JSON_DICT = dict()
-        json['type'] = self.type.to_json()
+        json['type'] = self.type_.to_json()
         if self.value is not None:
             json['value'] = self.value
         if self.related_nodes is not None:
@@ -250,9 +248,9 @@ def to_json(self) -> T_JSON_DICT:
         return json
 
     @classmethod
-    def from_json(cls, json: T_JSON_DICT) -> 'AXValue':
+    def from_json(cls, json: T_JSON_DICT) -> AXValue:
         return cls(
-            type=AXValueType.from_json(json['type']),
+            type_=AXValueType.from_json(json['type']),
             value=json['value'] if 'value' in json else None,
             related_nodes=[AXRelatedNode.from_json(i) for i in json['relatedNodes']] if 'relatedNodes' in json else None,
             sources=[AXValueSource.from_json(i) for i in json['sources']] if 'sources' in json else None,
@@ -312,7 +310,7 @@ def to_json(self) -> str:
         return self.value
 
     @classmethod
-    def from_json(cls, json: str) -> 'AXPropertyName':
+    def from_json(cls, json: str) -> AXPropertyName:
         return cls(json)
 
 
@@ -322,34 +320,34 @@ class AXNode:
     A node in the accessibility tree.
     '''
     #: Unique identifier for this node.
-    node_id: 'AXNodeId'
+    node_id: AXNodeId
 
     #: Whether this node is ignored for accessibility
     ignored: bool
 
     #: Collection of reasons why this node is hidden.
-    ignored_reasons: typing.Optional[typing.List['AXProperty']] = None
+    ignored_reasons: typing.Optional[typing.List[AXProperty]] = None
 
-    #: This `Node`'s role, whether explicit or implicit.
-    role: typing.Optional['AXValue'] = None
+    #: This ``Node``'s role, whether explicit or implicit.
+    role: typing.Optional[AXValue] = None
 
-    #: The accessible name for this `Node`.
-    name: typing.Optional['AXValue'] = None
+    #: The accessible name for this ``Node``.
+    name: typing.Optional[AXValue] = None
 
-    #: The accessible description for this `Node`.
-    description: typing.Optional['AXValue'] = None
+    #: The accessible description for this ``Node``.
+    description: typing.Optional[AXValue] = None
 
-    #: The value for this `Node`.
-    value: typing.Optional['AXValue'] = None
+    #: The value for this ``Node``.
+    value: typing.Optional[AXValue] = None
 
     #: All other properties
-    properties: typing.Optional[typing.List['AXProperty']] = None
+    properties: typing.Optional[typing.List[AXProperty]] = None
 
     #: IDs for each of this node's child nodes.
-    child_ids: typing.Optional[typing.List['AXNodeId']] = None
+    child_ids: typing.Optional[typing.List[AXNodeId]] = None
 
     #: The backend ID for the associated DOM node, if any.
-    backend_dom_node_id: typing.Optional['dom.BackendNodeId'] = None
+    backend_dom_node_id: typing.Optional[dom.BackendNodeId] = None
 
     def to_json(self) -> T_JSON_DICT:
         json: T_JSON_DICT = dict()
@@ -374,7 +372,7 @@ def to_json(self) -> T_JSON_DICT:
         return json
 
     @classmethod
-    def from_json(cls, json: T_JSON_DICT) -> 'AXNode':
+    def from_json(cls, json: T_JSON_DICT) -> AXNode:
         return cls(
             node_id=AXNodeId.from_json(json['nodeId']),
             ignored=bool(json['ignored']),
@@ -401,7 +399,7 @@ def disable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
 
 def enable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
     '''
-    Enables the accessibility domain which causes `AXNodeId`s to remain consistent between method calls.
+    Enables the accessibility domain which causes ``AXNodeId``'s to remain consistent between method calls.
     This turns on accessibility for the page, which can impact performance until accessibility is disabled.
     '''
     cmd_dict: T_JSON_DICT = {
@@ -411,22 +409,21 @@ def enable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
 
 
 def get_partial_ax_tree(
-        node_id: typing.Optional['dom.NodeId'] = None,
-        backend_node_id: typing.Optional['dom.BackendNodeId'] = None,
-        object_id: typing.Optional['runtime.RemoteObjectId'] = None,
+        node_id: typing.Optional[dom.NodeId] = None,
+        backend_node_id: typing.Optional[dom.BackendNodeId] = None,
+        object_id: typing.Optional[runtime.RemoteObjectId] = None,
         fetch_relatives: typing.Optional[bool] = None
-    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List['AXNode']]:
+    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[AXNode]]:
     '''
-    **EXPERIMENTAL**
-
     Fetches the accessibility node and partial accessibility tree for this DOM node, if it exists.
 
+    **EXPERIMENTAL**
+
     :param node_id: *(Optional)* Identifier of the node to get the partial accessibility tree for.
     :param backend_node_id: *(Optional)* Identifier of the backend node to get the partial accessibility tree for.
     :param object_id: *(Optional)* JavaScript object id of the node wrapper to get the partial accessibility tree for.
     :param fetch_relatives: *(Optional)* Whether to fetch this nodes ancestors, siblings and children. Defaults to true.
-    :returns: The ``Accessibility.AXNode`` for this DOM node, if it exists, plus its ancestors, siblings and
-    children, if requested.
+    :returns: The ``Accessibility.AXNode`` for this DOM node, if it exists, plus its ancestors, siblings and children, if requested.
     '''
     params: T_JSON_DICT = dict()
     if node_id is not None:
@@ -445,12 +442,12 @@ def get_partial_ax_tree(
     return [AXNode.from_json(i) for i in json['nodes']]
 
 
-def get_full_ax_tree() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List['AXNode']]:
+def get_full_ax_tree() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[AXNode]]:
     '''
-    **EXPERIMENTAL**
-
     Fetches the entire accessibility tree
 
+    **EXPERIMENTAL**
+
     :returns: 
     '''
     cmd_dict: T_JSON_DICT = {