chore: add pprint() and pformat() methods to RESTObject

JohnVillalovos · JohnVillalovos · commit 5c708fb7d9ad · 2022-01-07T11:55:41.000-08:00
This is useful in debugging and testing. As can easily print out the
values from an instance in a more human-readable form.
diff --git a/docs/api-usage.rst b/docs/api-usage.rst
@@ -179,6 +179,17 @@ resources. For example:
    project = gl.projects.get(1)
    project.star()
 
+You can print a Gitlab Object. For example:
+
+.. code-block:: python
+
+   project = gl.projects.get(1)
+   print(project)
+   # Or in a prettier format. These two are equivalent.
+   print(project.pformat())
+   project.pprint()
+
+
 Base types
 ==========
 
diff --git a/gitlab/base.py b/gitlab/base.py
@@ -16,6 +16,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 import importlib
+import pprint
 import textwrap
 from types import ModuleType
 from typing import Any, Dict, Iterable, NamedTuple, Optional, Tuple, Type
@@ -147,6 +148,14 @@ def __str__(self) -> str:
         data.update(self._updated_attrs)
         return f"{type(self)} => {data}"
 
+    def pformat(self) -> str:
+        data = self._attrs.copy()
+        data.update(self._updated_attrs)
+        return f"{type(self)} => \n{pprint.pformat(data)}"
+
+    def pprint(self) -> None:
+        print(self.pformat())
+
     def __repr__(self) -> str:
         if self._id_attr:
             return f"<{self.__class__.__name__} {self._id_attr}:{self.get_id()}>"
