Add new attributes to Person class & Update some DocStrings

Add the following new Spark attributes to the `Person` object class:
type
nickName
invitePending
loginEnabled

Update any docstrings that don’t look right.  ;-)

Author: cmlccie

ciscosparkapi/api/people.py

@@ -35,17 +35,22 @@ class Person(SparkData):
     """Model a Spark 'person' JSON object as a native Python object."""
 
     def __init__(self, json):
-        """Init a new Person data object from a JSON dictionary or string.
+        """Initialize a Person data object from a dictionary or JSON string.
 
         Args:
-            json(dict, basestring): Input JSON object.
+            json(dict, basestring): Input dictionary or JSON string.
 
         Raises:
             TypeError: If the input object is not a dictionary or string.
 
         """
         super(Person, self).__init__(json)
 
+    @property
+    def type(self):
+        """The type of object returned by Cisco Spark (should be `person`)."""
+        return self._json.get('type')
+
     @property
     def id(self):
         """The person's unique ID."""
@@ -67,6 +72,11 @@ def displayName(self):
         """Full name of the person."""
         return self._json.get('displayName')
 
+    @property
+    def nickName(self):
+        """'Nick name' or preferred short name of the person."""
+        return self._json.get('nickName')
+
     @property
     def firstName(self):
         """First name of the person."""
@@ -112,17 +122,27 @@ def lastActivity(self):
         """The date and time of the person's last activity."""
         return self._json.get('lastActivity')
 
+    @property
+    def invitePending(self):
+        """Person has been sent an invite, but hasn't responded."""
+        return self._json.get('invitePending')
+
+    @property
+    def loginEnabled(self):
+        """Person is allowed to login."""
+        return self._json.get('loginEnabled')
+
 
 class PeopleAPI(object):
     """Cisco Spark People-API wrapper class.
 
-    Wrappers the Cisco Spark People-API and exposes the API calls as Python
-    method calls that return native Python objects.
+    Wraps the Cisco Spark People-API and exposes the APIs as native Python
+    methods that return native Python objects.
 
     """
 
     def __init__(self, session):
-        """Init a new PeopleAPI object with the provided RestSession.
+        """Initialize a new PeopleAPI object with the provided RestSession.
 
         Args:
             session(RestSession): The RESTful session object to be used for