Revert a few docstring fixes and allow mcs over cls for metaclases in Entities

Author: induane

common/entities/component_meta.py

@@ -18,7 +18,7 @@ class SimpleComponentMeta(ModelBase):
     is identified. This value gets stored at the `type` field of the Component entity.
     """
 
-    def __new__(cls, name: str, bases: tuple[type, ...], attrs: dict[str, object]) -> type[BaseModel]:
+    def __new__(mcs, name: str, bases: tuple[type, ...], attrs: dict[str, object]) -> type[BaseModel]:
         try:
             component_type: str = str(attrs["component_type"])
         except KeyError as e:
@@ -45,7 +45,7 @@ def __new__(cls, name: str, bases: tuple[type, ...], attrs: dict[str, object]) -
         new_component_type_field.default = component_type
         attrs["type"] = new_component_type_field
 
-        entity_class: type[BaseModel] = super().__new__(cls, name, bases, attrs)
+        entity_class: type[BaseModel] = super().__new__(mcs, name, bases, attrs)
 
         def select(cls: type[BaseModel], *fields: object) -> ModelSelect:
             # The join is useful to allow using the Component entity fields in WHERE clauses, regardless of

event_api/endpoints/v1/dataset_operation.py

@@ -20,9 +20,7 @@ def post(self) -> Response:
         description: Event reports that a read or write operation has occurred for the specified dataset.
         security:
             - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
            - in: header
              name: EVENT-SOURCE
              description: Set the source of the event. If unset, the Event Ingestion API will assume the source of the

event_api/endpoints/v1/message_log.py

@@ -24,9 +24,7 @@ def post(self) -> Response:
                      scripts.
         security:
             - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
            - in: header
              name: EVENT-SOURCE
              description: Set the source of the event. If unset, the Event Ingestion API will assume the source of the

event_api/endpoints/v1/metric_log.py

@@ -25,9 +25,7 @@ def post(self) -> Response:
                      the metric across multiple runs.
         security:
             - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
            - in: header
              name: EVENT-SOURCE
              description: Set the source of the event. If unset, the Event Ingestion API will assume the source of the

event_api/endpoints/v1/run_status.py

@@ -22,9 +22,7 @@ def post(self) -> Response:
                      a task has started and ended with a certain status.
         security:
             - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
            - in: header
              name: EVENT-SOURCE
              description: Set the source of the event. If unset, the Event Ingestion API will assume the source of the

event_api/endpoints/v1/test_outcomes.py

@@ -26,9 +26,7 @@ def post(self) -> Response:
                     track and report on runs and outcomes.
         security:
             - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
            - in: header
              name: EVENT-SOURCE
              description: Set the source of the event. If unset, the Event Ingestion API will assume the source of the

observability_api/endpoints/v1/agents.py

@@ -29,9 +29,7 @@ def get(self, project_id: UUID) -> Response:
         operationId: ListAgents
         security:
           - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
           - in: path
             name: project_id
             description: the ID of the project being queried.

observability_api/endpoints/v1/alerts.py

@@ -29,9 +29,7 @@ def get(self, project_id: UUID) -> Response:
         operationId: ProjectAlerts
         security:
           - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
           - in: path
             name: project_id
             schema:

observability_api/endpoints/v1/components.py

@@ -31,9 +31,7 @@ def get(self, project_id: UUID) -> Response:
         operationId: ListComponents
         security:
           - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
           - in: path
             name: project_id
             description: the ID of the project being queried.
@@ -135,9 +133,7 @@ def get(self, component_id: UUID) -> Response:
         description: Retrieves a single component by its ID.
         security:
           - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
           - in: path
             name: component_id
             schema:
@@ -179,9 +175,7 @@ def delete(self, component_id: UUID) -> Response:
         description: Permanently deletes a single component by its ID including all the associated runs and stored events.
         security:
           - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
           - in: path
             name: component_id
             schema:
@@ -222,9 +216,7 @@ def get(self, journey_id: UUID) -> Response:
         operationId: ListComponentsByJourney
         security:
           - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
           - in: path
             name: journey_id
             description: the ID of the journey being queried.

observability_api/endpoints/v1/instance_rules.py

@@ -27,9 +27,7 @@ def post(self, journey_id: UUID) -> Response:
         description: Creates a new instance rule in a journey.
         security:
           - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
           - in: path
             name: journey_id
             description: The ID of the journey that the instance rule will be created under.
@@ -102,9 +100,7 @@ def delete(self, *, instance_rule_id: UUID) -> Response:
         description: Permanently deletes a single instance rule by its ID.
         security:
           - SAKey: []
-
-        Parameters
-        ----------
+        parameters:
           - in: path
             name: instance_rule_id
             schema: