Standardize __repr__ docstring description

(cherry picked from commit f046f2bd98ce3bbdcdb0a3a2ffee973d0d0e7d16)

asyncpraw/exceptions.py

@@ -59,8 +59,8 @@ def __eq__(self, other: Union["RedditErrorItem", List[str]]):
             )
         return super().__eq__(other)
 
-    def __repr__(self):
-        """Return repr(self)."""
+    def __repr__(self) -> str:
+        """Return an object initialization representation of the instance."""
         return (
             f"{self.__class__.__name__}(error_type={self.error_type!r},"
             f" message={self.message!r}, field={self.field!r})"

asyncpraw/models/reddit/draft.py

@@ -108,7 +108,7 @@ def __init__(
         super().__init__(reddit, _data=_data, _fetched=fetched)
 
     def __repr__(self) -> str:
-        """Return a string representation of the :class:`.Draft` instance."""
+        """Return an object initialization representation of the instance."""
         if self._fetched:
             subreddit = (
                 f" subreddit={self.subreddit.display_name!r}" if self.subreddit else ""

asyncpraw/models/reddit/inline_media.py

@@ -27,7 +27,7 @@ def __eq__(self, other: "InlineMedia"):
         )
 
     def __repr__(self) -> str:
-        """Return a string representation of the :class:`.InlineMedia` instance."""
+        """Return an object initialization representation of the instance."""
         return f"<{self.__class__.__name__} caption={self.caption!r}>"
 
     def __str__(self):

asyncpraw/models/reddit/more.py

@@ -33,7 +33,7 @@ def __lt__(self, other: "MoreComments") -> bool:
         return self.count > other.count
 
     def __repr__(self) -> str:
-        """Return a string representation of the :class:`.MoreComments` instance."""
+        """Return an object initialization representation of the instance."""
         children = self.children[:4]
         if len(self.children) > 4:
             children[-1] = "..."

asyncpraw/models/reddit/poll.py

@@ -32,8 +32,8 @@ class PollOption(AsyncPRAWBase):
 
     """
 
-    def __repr__(self):
-        """Make a string representation of the :class:`.PollData`."""
+    def __repr__(self) -> str:
+        """Return an object initialization representation of the instance."""
         return f"PollOption(id={self.id!r})"
 
     def __str__(self) -> str:

asyncpraw/models/reddit/widgets.py

@@ -343,8 +343,8 @@ def __init__(self, subreddit):
 
         super().__init__(subreddit._reddit, {})
 
-    def __repr__(self):
-        """Return an object initialization representation of the object."""
+    def __repr__(self) -> str:
+        """Return an object initialization representation of the instance."""
         return f"SubredditWidgets(subreddit={self.subreddit!r})"
 
     async def _fetch(self):

asyncpraw/models/trophy.py

@@ -50,5 +50,5 @@ def __str__(self) -> str:
         return self.name  # pylint: disable=no-member
 
     def __repr__(self) -> str:
-        """Return the object's REPR status."""
+        """Return an object initialization representation of the instance."""
         return f"{self.__class__.__name__}(name={self.name!r})"

asyncpraw/util/cache.py

@@ -45,5 +45,5 @@ def __get__(self, obj: Optional[Any], objtype: Optional[Any] = None) -> Any:
         return value
 
     def __repr__(self) -> str:
-        """Return repr(self)."""
+        """Return an object initialization representation of the instance."""
         return f"<{self.__class__.__name__} {self.func}>"