Fix for method parameter description in generated docs.

Newlines were breaking parameter description in generated docs, causing them to render incorrectly. This fixes it.

Author: domderen

cdp/browser.py

@@ -302,9 +302,7 @@ def get_histograms(
     '''
     Get Chrome histograms.
 
-    :param query: Requested substring in name. Only histograms which have query as a
-    substring in their name are extracted. An empty or absent query returns
-    all histograms.
+    :param query: Requested substring in name. Only histograms which have query as a substring in their name are extracted. An empty or absent query returns all histograms.
     :param delta: If true, retrieve delta since last call.
     :returns: Histograms.
     '''
@@ -398,8 +396,7 @@ def set_window_bounds(
     Set position and/or size of the browser window.
 
     :param window_id: Browser window id.
-    :param bounds: New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined
-    with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
+    :param bounds: New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
     '''
     params: T_JSON_DICT = dict()
     params['windowId'] = window_id.to_json()

cdp/debugger.py

@@ -297,8 +297,7 @@ def enable(
     Enables debugger for the given page. Clients should not assume that the debugging has been
     enabled until the result for this command is received.
 
-    :param max_scripts_cache_size: The maximum size in bytes of collected scripts (not referenced by other heap objects)
-    the debugger can hold. Puts no limit if paramter is omitted.
+    :param max_scripts_cache_size: The maximum size in bytes of collected scripts (not referenced by other heap objects) the debugger can hold. Puts no limit if paramter is omitted.
     :returns: Unique identifier of the debugger.
     '''
     params: T_JSON_DICT = dict()
@@ -328,12 +327,9 @@ def evaluate_on_call_frame(
 
     :param call_frame_id: Call frame identifier to evaluate on.
     :param expression: Expression to evaluate.
-    :param object_group: String object group name to put result into (allows rapid releasing resulting object handles
-    using ``releaseObjectGroup``).
-    :param include_command_line_api: Specifies whether command line API should be available to the evaluated expression, defaults
-    to false.
-    :param silent: In silent mode exceptions thrown during evaluation are not reported and do not pause
-    execution. Overrides ``setPauseOnException`` state.
+    :param object_group: String object group name to put result into (allows rapid releasing resulting object handles using ``releaseObjectGroup``).
+    :param include_command_line_api: Specifies whether command line API should be available to the evaluated expression, defaults to false.
+    :param silent: In silent mode exceptions thrown during evaluation are not reported and do not pause execution. Overrides ``setPauseOnException`` state.
     :param return_by_value: Whether the result is expected to be a JSON object that should be sent by value.
     :param generate_preview: Whether preview should be generated for the result.
     :param throw_on_side_effect: Whether to throw an exception if side effect cannot be ruled out during evaluation.
@@ -380,8 +376,7 @@ def get_possible_breakpoints(
     the same.
 
     :param start: Start of range to search possible breakpoint locations in.
-    :param end: End of range to search possible breakpoint locations in (excluding). When not specified, end
-    of scripts is used as end of range.
+    :param end: End of range to search possible breakpoint locations in (excluding). When not specified, end of scripts is used as end of range.
     :param restrict_to_function: Only consider locations which are in the same (non-nested) function as start.
     :returns: List of the possible breakpoint locations.
     '''
@@ -551,8 +546,7 @@ def set_async_call_stack_depth(
     '''
     Enables or disables async call stacks tracking.
 
-    :param max_depth: Maximum depth of async call stacks. Setting to ``0`` will effectively disable collecting async
-    call stacks (default).
+    :param max_depth: Maximum depth of async call stacks. Setting to ``0`` will effectively disable collecting async call stacks (default).
     '''
     params: T_JSON_DICT = dict()
     params['maxDepth'] = max_depth
@@ -613,8 +607,7 @@ def set_breakpoint(
     Sets JavaScript breakpoint at a given location.
 
     :param location: Location to set breakpoint in.
-    :param condition: Expression to use as a breakpoint condition. When specified, debugger will only stop on the
-    breakpoint if this expression evaluates to true.
+    :param condition: Expression to use as a breakpoint condition. When specified, debugger will only stop on the breakpoint if this expression evaluates to true.
     :returns: a tuple with the following items:
         0. breakpointId: Id of the created breakpoint for further reference.
         1. actualLocation: Location this breakpoint resolved into.
@@ -669,12 +662,10 @@ def set_breakpoint_by_url(
 
     :param line_number: Line number to set breakpoint at.
     :param url: URL of the resources to set breakpoint on.
-    :param url_regex: Regex pattern for the URLs of the resources to set breakpoints on. Either ``url`` or
-    ``urlRegex`` must be specified.
+    :param url_regex: Regex pattern for the URLs of the resources to set breakpoints on. Either ``url`` or ``urlRegex`` must be specified.
     :param script_hash: Script hash of the resources to set breakpoint on.
     :param column_number: Offset in the line to set breakpoint at.
-    :param condition: Expression to use as a breakpoint condition. When specified, debugger will only stop on the
-    breakpoint if this expression evaluates to true.
+    :param condition: Expression to use as a breakpoint condition. When specified, debugger will only stop on the breakpoint if this expression evaluates to true.
     :returns: a tuple with the following items:
         0. breakpointId: Id of the created breakpoint for further reference.
         1. locations: List of the locations this breakpoint resolved into upon addition.
@@ -712,8 +703,7 @@ def set_breakpoint_on_function_call(
     calling it will also trigger the breakpoint.
 
     :param object_id: Function object id.
-    :param condition: Expression to use as a breakpoint condition. When specified, debugger will
-    stop on the breakpoint if this expression evaluates to true.
+    :param condition: Expression to use as a breakpoint condition. When specified, debugger will stop on the breakpoint if this expression evaluates to true.
     :returns: Id of the created breakpoint for further reference.
     '''
     params: T_JSON_DICT = dict()
@@ -790,8 +780,7 @@ def set_script_source(
 
     :param script_id: Id of the script to edit.
     :param script_source: New content of the script.
-    :param dry_run: If true the change will not actually be applied. Dry run may be used to get result
-    description without actually modifying the code.
+    :param dry_run: If true the change will not actually be applied. Dry run may be used to get result description without actually modifying the code.
     :returns: a tuple with the following items:
         0. callFrames: (Optional) New stack trace in case editing has happened while VM was stopped.
         1. stackChanged: (Optional) Whether current call stack  was modified after applying the changes.
@@ -845,8 +834,7 @@ def set_variable_value(
     Changes value of variable in a callframe. Object-based scopes are not supported and must be
     mutated manually.
 
-    :param scope_number: 0-based number of scope as was listed in scope chain. Only 'local', 'closure' and 'catch'
-    scope types are allowed. Other scopes could be manipulated manually.
+    :param scope_number: 0-based number of scope as was listed in scope chain. Only 'local', 'closure' and 'catch' scope types are allowed. Other scopes could be manipulated manually.
     :param variable_name: Variable name.
     :param new_value: New variable value.
     :param call_frame_id: Id of callframe that holds variable.
@@ -869,8 +857,7 @@ def step_into(
     '''
     Steps into the function call.
 
-    :param break_on_async_call: Debugger will issue additional Debugger.paused notification if any async task is scheduled
-    before next pause.
+    :param break_on_async_call: Debugger will issue additional Debugger.paused notification if any async task is scheduled before next pause.
     '''
     params: T_JSON_DICT = dict()
     if break_on_async_call is not None:

cdp/dom.py

@@ -498,8 +498,7 @@ def copy_to(
 
     :param node_id: Id of the node to copy.
     :param target_node_id: Id of the element to drop the copy into.
-    :param insert_before_node_id: Drop the copy before this node (if absent, the copy becomes the last child of
-    ``targetNodeId``).
+    :param insert_before_node_id: Drop the copy before this node (if absent, the copy becomes the last child of ``targetNodeId``).
     :returns: Id of the node clone.
     '''
     params: T_JSON_DICT = dict()
@@ -529,10 +528,8 @@ def describe_node(
     :param node_id: Identifier of the node.
     :param backend_node_id: Identifier of the backend node.
     :param object_id: JavaScript object id of the node wrapper.
-    :param depth: The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
-    entire subtree or provide an integer larger than 0.
-    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the subtree
-    (default is false).
+    :param depth: The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.
+    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the subtree (default is false).
     :returns: Node description.
     '''
     params: T_JSON_DICT = dict()
@@ -701,10 +698,8 @@ def get_document(
     '''
     Returns the root DOM node (and optionally the subtree) to the caller.
 
-    :param depth: The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
-    entire subtree or provide an integer larger than 0.
-    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the subtree
-    (default is false).
+    :param depth: The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.
+    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the subtree (default is false).
     :returns: Resulting node.
     '''
     params: T_JSON_DICT = dict()
@@ -727,10 +722,8 @@ def get_flattened_document(
     '''
     Returns the root DOM node (and optionally the subtree) to the caller.
 
-    :param depth: The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
-    entire subtree or provide an integer larger than 0.
-    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the subtree
-    (default is false).
+    :param depth: The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.
+    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the subtree (default is false).
     :returns: Resulting node.
     '''
     params: T_JSON_DICT = dict()
@@ -901,8 +894,7 @@ def move_to(
 
     :param node_id: Id of the node to move.
     :param target_node_id: Id of the element to drop the moved node into.
-    :param insert_before_node_id: Drop node before this one (if absent, the moved node becomes the last child of
-    ``targetNodeId``).
+    :param insert_before_node_id: Drop node before this one (if absent, the moved node becomes the last child of ``targetNodeId``).
     :returns: New id of the moved node.
     '''
     params: T_JSON_DICT = dict()
@@ -1088,10 +1080,8 @@ def request_child_nodes(
     the specified depth.
 
     :param node_id: Id of the node to get children for.
-    :param depth: The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
-    entire subtree or provide an integer larger than 0.
-    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the sub-tree
-    (default is false).
+    :param depth: The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.
+    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the sub-tree (default is false).
     '''
     params: T_JSON_DICT = dict()
     params['nodeId'] = node_id.to_json()
@@ -1193,8 +1183,7 @@ def set_attributes_as_text(
 
     :param node_id: Id of the element to set attributes for.
     :param text: Text with a number of attributes. Will parse this text using HTML parser.
-    :param name: Attribute name to replace with new attributes derived from text in case text parsed
-    successfully.
+    :param name: Attribute name to replace with new attributes derived from text in case text parsed successfully.
     '''
     params: T_JSON_DICT = dict()
     params['nodeId'] = node_id.to_json()

cdp/dom_debugger.py

@@ -110,10 +110,8 @@ def get_event_listeners(
     Returns event listeners of the given object.
 
     :param object_id: Identifier of the object to return listeners for.
-    :param depth: The maximum depth at which Node children should be retrieved, defaults to 1. Use -1 for the
-    entire subtree or provide an integer larger than 0.
-    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the subtree
-    (default is false). Reports listeners for all contexts if pierce is enabled.
+    :param depth: The maximum depth at which Node children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.
+    :param pierce: Whether or not iframes and shadow roots should be traversed when returning the subtree (default is false). Reports listeners for all contexts if pierce is enabled.
     :returns: Array of relevant listeners.
     '''
     params: T_JSON_DICT = dict()
@@ -233,8 +231,7 @@ def set_event_listener_breakpoint(
     Sets breakpoint on particular DOM event.
 
     :param event_name: DOM Event name to stop on (any DOM event will do).
-    :param target_name: EventTarget interface name to stop on. If equal to ``"*"`` or not provided, will stop on any
-    EventTarget.
+    :param target_name: EventTarget interface name to stop on. If equal to ``"*"`` or not provided, will stop on any EventTarget.
     '''
     params: T_JSON_DICT = dict()
     params['eventName'] = event_name

cdp/emulation.py

@@ -146,8 +146,7 @@ def set_default_background_color_override(
     Sets or clears an override of the default background color of the frame. This override is used
     if the content does not specify one.
 
-    :param color: RGBA of the default background color. If not specified, any existing override will be
-    cleared.
+    :param color: RGBA of the default background color. If not specified, any existing override will be cleared.
     '''
     params: T_JSON_DICT = dict()
     if color is not None:
@@ -181,17 +180,15 @@ def set_device_metrics_override(
     :param width: Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
     :param height: Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.
     :param device_scale_factor: Overriding device scale factor value. 0 disables the override.
-    :param mobile: Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text
-    autosizing and more.
+    :param mobile: Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text autosizing and more.
     :param scale: Scale to apply to resulting view image.
     :param screen_width: Overriding screen width value in pixels (minimum 0, maximum 10000000).
     :param screen_height: Overriding screen height value in pixels (minimum 0, maximum 10000000).
     :param position_x: Overriding view X position on screen in pixels (minimum 0, maximum 10000000).
     :param position_y: Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).
     :param dont_set_visible_size: Do not set visible view size, rely upon explicit setVisibleSize call.
     :param screen_orientation: Screen orientation override.
-    :param viewport: If set, the visible area of the page will be overridden to this viewport. This viewport
-    change is not observed by the page, e.g. viewport-relative elements do not change positions.
+    :param viewport: If set, the visible area of the page will be overridden to this viewport. This viewport change is not observed by the page, e.g. viewport-relative elements do not change positions.
     '''
     params: T_JSON_DICT = dict()
     params['width'] = width
@@ -398,12 +395,9 @@ def set_virtual_time_policy(
     the current virtual time policy.  Note this supersedes any previous time budget.
 
     :param policy:
-    :param budget: If set, after this many virtual milliseconds have elapsed virtual time will be paused and a
-    virtualTimeBudgetExpired event is sent.
-    :param max_virtual_time_task_starvation_count: If set this specifies the maximum number of tasks that can be run before virtual is forced
-    forwards to prevent deadlock.
-    :param wait_for_navigation: If set the virtual time policy change should be deferred until any frame starts navigating.
-    Note any previous deferred policy change is superseded.
+    :param budget: If set, after this many virtual milliseconds have elapsed virtual time will be paused and a virtualTimeBudgetExpired event is sent.
+    :param max_virtual_time_task_starvation_count: If set this specifies the maximum number of tasks that can be run before virtual is forced forwards to prevent deadlock.
+    :param wait_for_navigation: If set the virtual time policy change should be deferred until any frame starts navigating. Note any previous deferred policy change is superseded.
     :param initial_virtual_time: If set, base::Time::Now will be overriden to initially return this value.
     :returns: Absolute timestamp at which virtual time was first enabled (up time in milliseconds).
     '''
@@ -431,8 +425,7 @@ def set_timezone_override(
     '''
     Overrides default host system timezone with the specified one.
 
-    :param timezone_id: The timezone identifier. If empty, disables the override and
-    restores default host system timezone.
+    :param timezone_id: The timezone identifier. If empty, disables the override and restores default host system timezone.
     '''
     params: T_JSON_DICT = dict()
     params['timezoneId'] = timezone_id

cdp/fetch.py

@@ -194,11 +194,8 @@ def enable(
     Enables issuing of requestPaused events. A request will be paused until client
     calls one of failRequest, fulfillRequest or continueRequest/continueWithAuth.
 
-    :param patterns: If specified, only requests matching any of these patterns will produce
-    fetchRequested event and will be paused until clients response. If not set,
-    all requests will be affected.
-    :param handle_auth_requests: If true, authRequired events will be issued and requests will be paused
-    expecting a call to continueWithAuth.
+    :param patterns: If specified, only requests matching any of these patterns will produce fetchRequested event and will be paused until clients response. If not set, all requests will be affected.
+    :param handle_auth_requests: If true, authRequired events will be issued and requests will be paused expecting a call to continueWithAuth.
     '''
     params: T_JSON_DICT = dict()
     if patterns is not None:
@@ -246,8 +243,7 @@ def fulfill_request(
     :param response_code: An HTTP response code.
     :param response_headers: Response headers.
     :param body: A response body.
-    :param response_phrase: A textual representation of responseCode.
-    If absent, a standard phrase mathcing responseCode is used.
+    :param response_phrase: A textual representation of responseCode. If absent, a standard phrase mathcing responseCode is used.
     '''
     params: T_JSON_DICT = dict()
     params['requestId'] = request_id.to_json()