docs(views): fix flake8 warnings

Author: yt-ms

src/structurizr/view/relationship_style.py

@@ -30,12 +30,7 @@
 
 
 class RelationshipStyleIO(BaseModel):
-    """
-    Represent a relationship's style.
-
-    Attributes:
-
-    """
+    """Represent a relationship's style."""
 
     tag: str
     thickness: Optional[int]
@@ -49,12 +44,7 @@ class RelationshipStyleIO(BaseModel):
 
 
 class RelationshipStyle(AbstractBase):
-    """
-    Define an relationship's style.
-
-    Attributes:
-
-    """
+    """Define an relationship's style."""
 
     START_OF_LINE = 0
     END_OF_LINE = 100
@@ -87,7 +77,7 @@ def __init__(
 
     @classmethod
     def hydrate(cls, relationship_style_io: RelationshipStyleIO) -> "RelationshipStyle":
-        """"""
+        """Hydrate a new RelationshipStyle instance from its IO."""
         return cls(
             tag=relationship_style_io.tag,
             thickness=relationship_style_io.thickness,

src/structurizr/view/relationship_view.py

@@ -34,12 +34,7 @@
 
 
 class RelationshipViewIO(BaseModel):
-    """
-    Represent an instance of a relationship in a view.
-
-    Attributes:
-
-    """
+    """Represent an instance of a relationship in a view."""
 
     id: Optional[str]
     order: Optional[str]
@@ -51,12 +46,7 @@ class RelationshipViewIO(BaseModel):
 
 
 class RelationshipView(AbstractBase):
-    """
-    Represent an instance of a relationship in a view.
-
-    Attributes:
-
-    """
+    """Represent an instance of a relationship in a view."""
 
     def __init__(
         self,
@@ -81,6 +71,7 @@ def __init__(
         self.position = position
 
     def __repr__(self) -> str:
+        """Return repr(self)."""
         return (
             f"{type(self).__name__}("
             f"id={self.id}, "
@@ -91,7 +82,7 @@ def __repr__(self) -> str:
 
     @classmethod
     def hydrate(cls, relationship_view_io: RelationshipViewIO) -> "RelationshipView":
-        """"""
+        """Hydrate a new RelationshipView instance from its IO."""
         return cls(
             id=relationship_view_io.id,
             description=relationship_view_io.description,
@@ -102,6 +93,7 @@ def hydrate(cls, relationship_view_io: RelationshipViewIO) -> "RelationshipView"
         )
 
     def copy_layout_information_from(self, source: "RelationshipView") -> None:
+        """Copy the layout information from another RelationshipView."""
         self.vertices = source.vertices
         self.routing = source.routing
         self.position = source.position

src/structurizr/view/static_view.py

@@ -63,6 +63,7 @@ def __init__(
 
     @classmethod
     def hydrate_arguments(cls, static_view_io: StaticViewIO) -> Dict:
+        """Hydrate a StaticViewIO into the constructor arguments for StaticView."""
         return {
             **super().hydrate_arguments(static_view_io),
             "animations": map(Animation.hydrate, static_view_io.animations),

src/structurizr/view/styles.py

@@ -30,24 +30,14 @@
 
 
 class StylesIO(BaseModel):
-    """
-    Represent a collection of styles.
-
-    Attributes:
-
-    """
+    """Represent a collection of styles."""
 
     elements: List[ElementStyleIO] = Field(default=())
     relationships: List[RelationshipStyleIO] = Field(default=())
 
 
 class Styles(AbstractBase):
-    """
-    Represent a collection of styles.
-
-    Attributes:
-
-    """
+    """Represent a collection of styles."""
 
     def __init__(
         self,
@@ -62,7 +52,7 @@ def __init__(
         self.relationships = list(relationships)
 
     def add(self, style: Union[ElementStyle, RelationshipStyle]) -> None:
-        """"""
+        """Add a new ElementStyle or RelationshipStyle."""
         if isinstance(style, ElementStyle):
             self.elements.append(style)
         elif isinstance(style, RelationshipStyle):
@@ -73,24 +63,32 @@ def add(self, style: Union[ElementStyle, RelationshipStyle]) -> None:
             )
 
     def add_element_style(self, **kwargs) -> None:
-        """"""
+        """
+        Add a new element style.
+
+        See `ElementStyle` for arguments.
+        """
         self.elements.append(ElementStyle(**kwargs))
 
     def clear_element_styles(self) -> None:
-        """"""
+        """Remove all element styles."""
         self.elements.clear()
 
     def add_relationship_style(self, **kwargs) -> None:
-        """"""
+        """
+        Add a new relationship style.
+
+        See `RelationshipStyle` for arguments.
+        """
         self.relationships.append(RelationshipStyle(**kwargs))
 
     def clear_relationships_styles(self) -> None:
-        """"""
+        """Remove all relationship styles."""
         self.relationships.clear()
 
     @classmethod
     def hydrate(cls, styles_io: StylesIO) -> "Styles":
-        """"""
+        """Hydrate a new Styles instance from its IO."""
         return cls(
             elements=map(ElementStyle.hydrate, styles_io.elements),
             relationships=map(RelationshipStyle.hydrate, styles_io.relationships),

src/structurizr/view/system_context_view.py

@@ -63,6 +63,7 @@ def add_all_elements(self) -> None:
         self.add_all_people()
 
     def add_nearest_neighbours(self, element: Element):
+        """Add all softare systems and people directly connected to the element."""
         super().add_nearest_neighbours(element, SoftwareSystem)
         super().add_nearest_neighbours(element, Person)
 
@@ -72,7 +73,7 @@ def hydrate(
         system_context_view_io: SystemContextViewIO,
         software_system: SoftwareSystem,
     ) -> "SystemContextView":
-        """"""
+        """Hydrate a new SystemContextView instance from its IO."""
         return cls(
             **cls.hydrate_arguments(system_context_view_io),
             software_system=software_system,

src/structurizr/view/system_landscape_view.py

@@ -74,7 +74,7 @@ def hydrate(
         system_landscape_view_io: SystemLandscapeViewIO,
         model: Model,
     ) -> "SystemLandscapeView":
-        """"""
+        """Hydrate a new SystemLandscapeView instance from its IO."""
         return cls(
             **cls.hydrate_arguments(system_landscape_view_io),
             model=model,

src/structurizr/view/terminology.py

@@ -28,12 +28,7 @@
 
 
 class TerminologyIO(BaseModel):
-    """
-    Represent an instance of an element in a view.
-
-    Attributes:
-
-    """
+    """Represent a way for the terminology on diagrams, etc. to be modified."""
 
     enterprise: Optional[str]
     person: Optional[str]
@@ -46,12 +41,7 @@ class TerminologyIO(BaseModel):
 
 
 class Terminology(AbstractBase):
-    """
-    Provide a way for the terminology on diagrams, etc. to be modified.
-
-    Attributes:
-
-    """
+    """Provide a way for the terminology on diagrams, etc. to be modified."""
 
     def __init__(
         self,