Add plugin prof_get_nick_from_roster function

apidocs/c/profapi.h

@@ -138,6 +138,12 @@ Retrieve the users nickname in a chat room, when in a chat room window.
 */
 char* prof_get_current_nick(void);
 
+/**
+Retrieve the nickname for a given barejid if it is in the roster.
+@return the users nickname e.g. "eddie", or NULLL if the barejid is not in the roster.
+*/
+char* prof_get_nick_from_roster(const char *barejid);
+
 /**
 Retrieve nicknames of all occupants in a chat room, when in a chat room window.
 @return nicknames of all occupants in the current room or an empty list if not in a chat room window.

apidocs/python/src/prof.py

@@ -253,6 +253,15 @@ def get_current_nick():
     pass
 
 
+def get_nick_from_roster(barejid):
+    """Retrieve a nickname from a barejid if it is in the roster.
+
+    :return: the users nickname e.g. ``"eddie"``, or ``None`` if the barejid is not in the roster.
+    :rtype: str
+    """
+    pass
+
+
 def get_current_occupants(): 
     """Retrieve nicknames of all occupants in a chat room, when in a chat room window.