style: Reformat model docstrings a bit and use Attributes instead of Properties (per Sphinx guide)

Author: dbanty

end_to_end_tests/golden-record/my_test_api_client/models/a_form_data.py

@@ -10,12 +10,9 @@
 @attr.s(auto_attribs=True)
 class AFormData:
     """
-
-
-    Properties:
+    Attributes:
         an_required_field (str):
         an_optional_field (Union[Unset, str]):
-
     """
 
     an_required_field: str

end_to_end_tests/golden-record/my_test_api_client/models/a_model.py

@@ -16,39 +16,31 @@
 
 @attr.s(auto_attribs=True)
 class AModel:
-    """
-    A Model for testing all the ways custom objects can be used
-
-        Properties:
-            an_enum_value (AnEnum): For testing Enums in all the ways they can be
-    used
-            an_allof_enum_with_overridden_default (AnAllOfEnum):  Default:
-    AnAllOfEnum.OVERRIDDEN_DEFAULT.
-            a_camel_date_time (Union[datetime.date, datetime.datetime]):
-            a_date (datetime.date):
-            required_not_nullable (str):
-            one_of_models (Union[Any, FreeFormModel, ModelWithUnionProperty]):
-            model (ModelWithUnionProperty):
-            any_value (Union[Unset, Any]):
-            an_optional_allof_enum (Union[Unset, AnAllOfEnum]):
-            nested_list_of_enums (Union[Unset, List[List[DifferentEnum]]]):
-            a_nullable_date (Optional[datetime.date]):
-            a_not_required_date (Union[Unset, datetime.date]):
-            attr_1_leading_digit (Union[Unset, str]):
-            required_nullable (Optional[str]):
-            not_required_nullable (Union[Unset, None, str]):
-            not_required_not_nullable (Union[Unset, str]):
-            nullable_one_of_models (Union[FreeFormModel, ModelWithUnionProperty,
-    None]):
-            not_required_one_of_models (Union[FreeFormModel, ModelWithUnionProperty,
-    Unset]):
-            not_required_nullable_one_of_models (Union[FreeFormModel,
-    ModelWithUnionProperty, None, Unset, str]):
-            nullable_model (Optional[ModelWithUnionProperty]):
-            not_required_model (Union[Unset, ModelWithUnionProperty]):
-            not_required_nullable_model (Union[Unset, None,
-    ModelWithUnionProperty]):
-
+    """A Model for testing all the ways custom objects can be used
+
+    Attributes:
+        an_enum_value (AnEnum): For testing Enums in all the ways they can be used
+        an_allof_enum_with_overridden_default (AnAllOfEnum):  Default: AnAllOfEnum.OVERRIDDEN_DEFAULT.
+        a_camel_date_time (Union[datetime.date, datetime.datetime]):
+        a_date (datetime.date):
+        required_not_nullable (str):
+        one_of_models (Union[Any, FreeFormModel, ModelWithUnionProperty]):
+        model (ModelWithUnionProperty):
+        any_value (Union[Unset, Any]):
+        an_optional_allof_enum (Union[Unset, AnAllOfEnum]):
+        nested_list_of_enums (Union[Unset, List[List[DifferentEnum]]]):
+        a_nullable_date (Optional[datetime.date]):
+        a_not_required_date (Union[Unset, datetime.date]):
+        attr_1_leading_digit (Union[Unset, str]):
+        required_nullable (Optional[str]):
+        not_required_nullable (Union[Unset, None, str]):
+        not_required_not_nullable (Union[Unset, str]):
+        nullable_one_of_models (Union[FreeFormModel, ModelWithUnionProperty, None]):
+        not_required_one_of_models (Union[FreeFormModel, ModelWithUnionProperty, Unset]):
+        not_required_nullable_one_of_models (Union[FreeFormModel, ModelWithUnionProperty, None, Unset, str]):
+        nullable_model (Optional[ModelWithUnionProperty]):
+        not_required_model (Union[Unset, ModelWithUnionProperty]):
+        not_required_nullable_model (Union[Unset, None, ModelWithUnionProperty]):
     """
 
     an_enum_value: AnEnum

end_to_end_tests/golden-record/my_test_api_client/models/a_model_with_properties_reference_that_are_not_object.py

@@ -14,41 +14,37 @@
 @attr.s(auto_attribs=True)
 class AModelWithPropertiesReferenceThatAreNotObject:
     """
-
-
-        Properties:
-            enum_properties_ref (List[AnEnum]):
-            str_properties_ref (List[str]):
-            date_properties_ref (List[datetime.date]):
-            datetime_properties_ref (List[datetime.datetime]):
-            int32_properties_ref (List[int]):
-            int64_properties_ref (List[int]):
-            float_properties_ref (List[float]):
-            double_properties_ref (List[float]):
-            file_properties_ref (List[File]):
-            bytestream_properties_ref (List[str]):
-            enum_properties (List[AnEnum]):
-            str_properties (List[str]):
-            date_properties (List[datetime.date]):
-            datetime_properties (List[datetime.datetime]):
-            int32_properties (List[int]):
-            int64_properties (List[int]):
-            float_properties (List[float]):
-            double_properties (List[float]):
-            file_properties (List[File]):
-            bytestream_properties (List[str]):
-            enum_property_ref (AnEnum): For testing Enums in all the ways they can
-    be used
-            str_property_ref (str):
-            date_property_ref (datetime.date):
-            datetime_property_ref (datetime.datetime):
-            int32_property_ref (int):
-            int64_property_ref (int):
-            float_property_ref (float):
-            double_property_ref (float):
-            file_property_ref (File):
-            bytestream_property_ref (str):
-
+    Attributes:
+        enum_properties_ref (List[AnEnum]):
+        str_properties_ref (List[str]):
+        date_properties_ref (List[datetime.date]):
+        datetime_properties_ref (List[datetime.datetime]):
+        int32_properties_ref (List[int]):
+        int64_properties_ref (List[int]):
+        float_properties_ref (List[float]):
+        double_properties_ref (List[float]):
+        file_properties_ref (List[File]):
+        bytestream_properties_ref (List[str]):
+        enum_properties (List[AnEnum]):
+        str_properties (List[str]):
+        date_properties (List[datetime.date]):
+        datetime_properties (List[datetime.datetime]):
+        int32_properties (List[int]):
+        int64_properties (List[int]):
+        float_properties (List[float]):
+        double_properties (List[float]):
+        file_properties (List[File]):
+        bytestream_properties (List[str]):
+        enum_property_ref (AnEnum): For testing Enums in all the ways they can be used
+        str_property_ref (str):
+        date_property_ref (datetime.date):
+        datetime_property_ref (datetime.datetime):
+        int32_property_ref (int):
+        int64_property_ref (int):
+        float_property_ref (float):
+        double_property_ref (float):
+        file_property_ref (File):
+        bytestream_property_ref (str):
     """
 
     enum_properties_ref: List[AnEnum]

end_to_end_tests/golden-record/my_test_api_client/models/all_of_sub_model.py

@@ -11,13 +11,10 @@
 @attr.s(auto_attribs=True)
 class AllOfSubModel:
     """
-
-
-    Properties:
+    Attributes:
         a_sub_property (Union[Unset, str]):
         type (Union[Unset, str]):
         type_enum (Union[Unset, AllOfSubModelTypeEnum]):
-
     """
 
     a_sub_property: Union[Unset, str] = UNSET

end_to_end_tests/golden-record/my_test_api_client/models/another_all_of_sub_model.py

@@ -12,13 +12,10 @@
 @attr.s(auto_attribs=True)
 class AnotherAllOfSubModel:
     """
-
-
-    Properties:
+    Attributes:
         another_sub_property (Union[Unset, str]):
         type (Union[Unset, AnotherAllOfSubModelType]):
         type_enum (Union[Unset, AnotherAllOfSubModelTypeEnum]):
-
     """
 
     another_sub_property: Union[Unset, str] = UNSET

end_to_end_tests/golden-record/my_test_api_client/models/body_upload_file_tests_upload_post.py

@@ -23,21 +23,16 @@
 @attr.s(auto_attribs=True)
 class BodyUploadFileTestsUploadPost:
     """
-
-
-        Properties:
-            some_file (File):
-            some_object (BodyUploadFileTestsUploadPostSomeObject):
-            some_optional_file (Union[Unset, File]):
-            some_string (Union[Unset, str]):  Default: 'some_default_string'.
-            some_number (Union[Unset, float]):
-            some_array (Union[Unset, List[float]]):
-            some_optional_object (Union[Unset,
-    BodyUploadFileTestsUploadPostSomeOptionalObject]):
-            some_nullable_object
-    (Optional[BodyUploadFileTestsUploadPostSomeNullableObject]):
-            some_enum (Union[Unset, DifferentEnum]): An enumeration.
-
+    Attributes:
+        some_file (File):
+        some_object (BodyUploadFileTestsUploadPostSomeObject):
+        some_optional_file (Union[Unset, File]):
+        some_string (Union[Unset, str]):  Default: 'some_default_string'.
+        some_number (Union[Unset, float]):
+        some_array (Union[Unset, List[float]]):
+        some_optional_object (Union[Unset, BodyUploadFileTestsUploadPostSomeOptionalObject]):
+        some_nullable_object (Optional[BodyUploadFileTestsUploadPostSomeNullableObject]):
+        some_enum (Union[Unset, DifferentEnum]): An enumeration.
     """
 
     some_file: File

end_to_end_tests/golden-record/my_test_api_client/models/body_upload_file_tests_upload_post_additional_property.py

@@ -10,11 +10,8 @@
 @attr.s(auto_attribs=True)
 class BodyUploadFileTestsUploadPostAdditionalProperty:
     """
-
-
-    Properties:
+    Attributes:
         foo (Union[Unset, str]):
-
     """
 
     foo: Union[Unset, str] = UNSET

end_to_end_tests/golden-record/my_test_api_client/models/body_upload_file_tests_upload_post_some_nullable_object.py

@@ -10,11 +10,8 @@
 @attr.s(auto_attribs=True)
 class BodyUploadFileTestsUploadPostSomeNullableObject:
     """
-
-
-    Properties:
+    Attributes:
         bar (Union[Unset, str]):
-
     """
 
     bar: Union[Unset, str] = UNSET

end_to_end_tests/golden-record/my_test_api_client/models/body_upload_file_tests_upload_post_some_object.py

@@ -8,12 +8,9 @@
 @attr.s(auto_attribs=True)
 class BodyUploadFileTestsUploadPostSomeObject:
     """
-
-
-    Properties:
+    Attributes:
         num (float):
         text (str):
-
     """
 
     num: float

end_to_end_tests/golden-record/my_test_api_client/models/body_upload_file_tests_upload_post_some_optional_object.py

@@ -8,11 +8,8 @@
 @attr.s(auto_attribs=True)
 class BodyUploadFileTestsUploadPostSomeOptionalObject:
     """
-
-
-    Properties:
+    Attributes:
         foo (str):
-
     """
 
     foo: str

end_to_end_tests/golden-record/my_test_api_client/models/free_form_model.py

@@ -7,12 +7,7 @@
 
 @attr.s(auto_attribs=True)
 class FreeFormModel:
-    """
-
-
-    Properties:
-
-    """
+    """ """
 
     additional_properties: Dict[str, Any] = attr.ib(init=False, factory=dict)
 

end_to_end_tests/golden-record/my_test_api_client/models/http_validation_error.py

@@ -11,11 +11,8 @@
 @attr.s(auto_attribs=True)
 class HTTPValidationError:
     """
-
-
-    Properties:
+    Attributes:
         detail (Union[Unset, List[ValidationError]]):
-
     """
 
     detail: Union[Unset, List[ValidationError]] = UNSET

end_to_end_tests/golden-record/my_test_api_client/models/import_.py

@@ -7,12 +7,7 @@
 
 @attr.s(auto_attribs=True)
 class Import:
-    """
-
-
-    Properties:
-
-    """
+    """ """
 
     additional_properties: Dict[str, Any] = attr.ib(init=False, factory=dict)
 

end_to_end_tests/golden-record/my_test_api_client/models/model_from_all_of.py

@@ -12,14 +12,11 @@
 @attr.s(auto_attribs=True)
 class ModelFromAllOf:
     """
-
-
-    Properties:
+    Attributes:
         a_sub_property (Union[Unset, str]):
         type (Union[Unset, AnotherAllOfSubModelType]):
         type_enum (Union[Unset, AnotherAllOfSubModelTypeEnum]):
         another_sub_property (Union[Unset, str]):
-
     """
 
     a_sub_property: Union[Unset, str] = UNSET

end_to_end_tests/golden-record/my_test_api_client/models/model_name.py

@@ -7,12 +7,7 @@
 
 @attr.s(auto_attribs=True)
 class ModelName:
-    """
-
-
-    Properties:
-
-    """
+    """ """
 
     additional_properties: Dict[str, Any] = attr.ib(init=False, factory=dict)
 

end_to_end_tests/golden-record/my_test_api_client/models/model_with_additional_properties_inlined.py

@@ -13,11 +13,8 @@
 @attr.s(auto_attribs=True)
 class ModelWithAdditionalPropertiesInlined:
     """
-
-
-    Properties:
+    Attributes:
         a_number (Union[Unset, float]):
-
     """
 
     a_number: Union[Unset, float] = UNSET

end_to_end_tests/golden-record/my_test_api_client/models/model_with_additional_properties_inlined_additional_property.py

@@ -10,11 +10,8 @@
 @attr.s(auto_attribs=True)
 class ModelWithAdditionalPropertiesInlinedAdditionalProperty:
     """
-
-
-    Properties:
+    Attributes:
         extra_props_prop (Union[Unset, str]):
-
     """
 
     extra_props_prop: Union[Unset, str] = UNSET

end_to_end_tests/golden-record/my_test_api_client/models/model_with_additional_properties_refed.py

@@ -9,12 +9,7 @@
 
 @attr.s(auto_attribs=True)
 class ModelWithAdditionalPropertiesRefed:
-    """
-
-
-    Properties:
-
-    """
+    """ """
 
     additional_properties: Dict[str, AnEnum] = attr.ib(init=False, factory=dict)
 

end_to_end_tests/golden-record/my_test_api_client/models/model_with_any_json_properties.py

@@ -11,12 +11,7 @@
 
 @attr.s(auto_attribs=True)
 class ModelWithAnyJsonProperties:
-    """
-
-
-    Properties:
-
-    """
+    """ """
 
     additional_properties: Dict[
         str, Union[List[str], ModelWithAnyJsonPropertiesAdditionalPropertyType0, bool, float, int, str]