Add __repr__ for box objects.

Box objects will now be repr'd including the object type and
either the object's name or its Box id.

Also, add support for dir() and vars() being called on Box
objects. Those builtin functions will now include API response fields
as attributes of the object.

Author: Jeff-Meadows

HISTORY.rst

@@ -6,6 +6,10 @@ Release History
 Upcoming
 ++++++++
 
+- Box objects have an improved ``__repr__``, making them easier to identify during debugging sessions.
+- Box objects now implement ``__dir__``, making them easier to explore. When created with a Box API response,
+  these objects will now include the API response fields as attributes.
+
 
 1.5.0 (2016-03-02)
 ++++++++++++++++++

boxsdk/object/base_object.py

@@ -49,15 +49,17 @@ def __init__(self, session, object_id, response_object=None):
         super(BaseObject, self).__init__(session)
         self._object_id = object_id
         self._response_object = response_object or {}
-
-    def __getattr__(self, item):
-        """Base class override. Try to get the attribute from the API response object."""
-        return self._response_object[item]
+        self.__dict__.update(self._response_object)
 
     def __getitem__(self, item):
         """Base class override. Try to get the attribute from the API response object."""
         return self._response_object[item]
 
+    def __repr__(self):
+        """Base class override. Return a human-readable representation using the Box ID or name of the object."""
+        description = self.name if 'name' in self._response_object else self.object_id
+        return '<Box {0} ({1})>'.format(self.__class__.__name__, description)
+
     def get_url(self, *args):
         """
         Base class override.