Set docstyle convention to google in ruff (#148142)

homeassistant/components/habitica/util.py

@@ -95,18 +95,13 @@ def get_recurrence_rule(recurrence: rrule) -> str:
 
     'DTSTART:YYYYMMDDTHHMMSS\nRRULE:FREQ=YEARLY;INTERVAL=2'
 
-    Parameters
+    Args:
-    ----------
+        recurrence: An RRULE object.
-    recurrence : rrule
-        An RRULE object.
 
-    Returns
+    Returns:
-    -------
-    str
         The recurrence rule portion of the RRULE string, starting with 'FREQ='.
 
-    Example
+    Example:
-    -------
         >>> rule = get_recurrence_rule(task)
         >>> print(rule)
         'FREQ=YEARLY;INTERVAL=2'

homeassistant/helpers/event.py

@@ -866,17 +866,15 @@ def async_track_state_change_filtered(
 ) -> _TrackStateChangeFiltered:
     """Track state changes with a TrackStates filter that can be updated.
 
-    Parameters
+    Args:
-    ----------
+        hass:
-    hass
             Home assistant object.
-    track_states
+        track_states:
             A TrackStates data class.
-    action
+        action:
             Callable to call with results.
 
-    Returns
+    Returns:
-    -------
         Object used to update the listeners (async_update_listeners) with a new
         TrackStates or cancel the tracking (async_remove).
 
@@ -907,28 +905,25 @@ def async_track_template(
     exception, the listener will still be registered but will only
     fire if the template result becomes true without an exception.
 
-    Action arguments
+    Action args:
-    ----------------
+        entity_id:
-    entity_id
             ID of the entity that triggered the state change.
-    old_state
+        old_state:
             The old state of the entity that changed.
-    new_state
+        new_state:
             New state of the entity that changed.
 
-    Parameters
+    Args:
-    ----------
+        hass:
-    hass
             Home assistant object.
-    template
+        template:
             The template to calculate.
-    action
+        action:
             Callable to call with results. See above for arguments.
-    variables
+        variables:
             Variables to pass to the template.
 
-    Returns
+    Returns:
-    -------
         Callable to unregister the listener.
 
     """
@@ -1361,25 +1356,23 @@ def async_track_template_result(
     Once the template returns to a non-error condition the result is sent
     to the action as usual.
 
-    Parameters
+    Args:
-    ----------
+        hass:
-    hass
             Home assistant object.
-    track_templates
+        track_templates:
             An iterable of TrackTemplate.
-    action
+        action:
             Callable to call with results.
-    strict
+        strict:
             When set to True, raise on undefined variables.
-    log_fn
+        log_fn:
             If not None, template error messages will logging by calling log_fn
             instead of the normal logging facility.
-    has_super_template
+        has_super_template:
             When set to True, the first template will block rendering of other
             templates if it doesn't render as True.
 
-    Returns
+    Returns:
-    -------
         Info object used to unregister the listener, and refresh the template.
 
     """

pyproject.toml

@@ -913,4 +913,5 @@ split-on-trailing-comma = false
 max-complexity = 25
 
 [tool.ruff.lint.pydocstyle]
+convention = "google"
 property-decorators = ["propcache.api.cached_property"]

tests/conftest.py

@@ -1724,7 +1724,7 @@ async def async_test_recorder(
             wait_recorder: bool = True,
             wait_recorder_setup: bool = True,
         ) -> AsyncGenerator[recorder.Recorder]:
-            """Setup and return recorder instance."""  # noqa: D401
+            """Setup and return recorder instance."""
             await _async_init_recorder_component(
                 hass,
                 config,