def xsearch(self, query, access_token=None, per_page=10, page=1):
"""
Search an Evis/Post/Article
Usage: Evis.search('bon jovi OR metallica')
Returns: generator object containing evis
Eviscape API Method: evis.search
"""
method = "evis.search"
if access_token is None:
data = request_get(method, q=query, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, q=query,\
per_page=per_page, page=page)
if FORMATTER == 'json':
if isinstance(data.get('objects', None), list):
for evi in data['objects']:
yield _parse_evis(evi)
else:
if data.rsp.objects.__dict__.has_key('evis'):
if isinstance(data.rsp.objects.evis, list):
for evi in data.rsp.objects.evis:
yield _parse_evis(evi)
else:
yield _parse_evis(data.rsp.objects.evis)
def xreceived(self, member, node, access_token=None, per_page=10, page=1):
"""
Get all received Evis/Post/Article of a Node/Profile/Evisite
Usage: Evis.xreceived(Member(id=13), Nodes(id=17))
Returns: A Generator with Evis Object
Eviscape API Method: evis.received
"""
method = "evis.received"
if access_token is None:
data = request_get(method, mem_id=member.id, nod_id=node.id, per_page=per_page, page=page)
else:
data = request_protected_get(
method, access_token, mem_id=member.id, nod_id=node.id, per_page=per_page, page=page
)
if FORMATTER == "json":
if isinstance(data.get("objects", None), list):
for evi in data["objects"]:
yield _parse_evis(evi)
else:
if data.rsp.objects.__dict__.has_key("evis"):
if isinstance(data.rsp.objects.evis, list):
for evi in data.rsp.objects.evis:
yield _parse_evis(evi)
else:
yield _parse_evis(data.rsp.objects.evis)
def get_by_token(self, access_token, per_page=10, page=1):
"""
Get member via access_token
Usage: Member.get_by_token(access_token)
Returns: Member Object
Eviscape API Method: member.token
"""
method = "member.token"
data = request_protected_get(method, access_token, per_page=per_page, page=page)
if FORMATTER == 'json':
return _handle_member_json(data)[0]
else:
return _handle_member_xml(data)[0]
def timeline(self, member, node, access_token, per_page=10, page=1):
"""
Get timeline for a member
Usage: Evis.timeline(memberobj, nodeobj, 'token')
Returns: List of evis
Eviscape API method: evis.timeline
"""
method = "evis.timeline"
data = request_protected_get(method, access_token, mem_id=member.id,\
nod_id=node.id, per_page=per_page, page=page)
if FORMATTER == 'json':
return _handle_evis_json(data)
else:
return _handle_evis_xml(data)
def sent(self, node, access_token=None, per_page=100, page=1):
"""
Get all posted Evis/Post/Article of a Node/Profile/Evisite
Usage: Evis.sent(Nodes(id=17))
Returns: A list of Evis Object
Eviscape API Method: evis.sent
"""
method = "evis.sent"
if access_token is None:
data = request_get(method, nod_id=node.id, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, nod_id=node.id, per_page=per_page, page=page)
if FORMATTER == "json":
return _handle_evis_json(data)
else:
return _handle_evis_xml(data)
def created_by_member(self, member_name, access_token=None, per_page=10, page=1):
"""
Get Node/Profile/Evisite which was created by User/Member
Usage: Nodes.created_by_member("iapain")
Returns: List of Nodes object
Eviscape API Method: nodes.get
"""
method = "nodes.get"
if access_token is None:
data = request_get(method, mem_name=member_name, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, mem_name=member_name, per_page=per_page, page=page)
if FORMATTER == "json":
return _handle_node_json(data)
else:
return _handle_node_xml(data)
def latest(self, access_token=None, per_page=10, page=1):
"""
Get all latest Evis/Post/Article
Usage: Evis.latest()
Returns: A list with Evis Object
Eviscape API Method: evis.latest
"""
method = "evis.latest"
if access_token is None:
data = request_get(method, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, per_page=per_page, page=page)
if FORMATTER == "json":
return _handle_evis_json(data)
else:
return _handle_evis_xml(data)
def get(self, access_token=None, per_page=10, page=1):
"""
Get details of a Node/Profile/Evisite
Usage: Nodes(id=17).get()
Returns: Nodes object
Eviscape API Method: node.get
"""
method = "node.get"
if access_token is None:
data = request_get(method, nod_id=self.id, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, nod_id=self.id, per_page=per_page, page=page)
if FORMATTER == "json":
return _handle_node_json(data)[0]
else:
return _handle_node_xml(data)[0]
def speakers(self, access_token=None, per_page=10, page=1):
"""
Get Nodes/Profile/Evisite which base node is Followering
Usage: Nodes(id=17).speakers()
Returns: List of Nodes object
Eviscape API Method: nodes.speakers
"""
method = "nodes.speakers"
if access_token is None:
data = request_get(method, nod_id=self.id, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, nod_id=self.id, per_page=per_page, page=page)
if FORMATTER == "json":
return _handle_node_json(data)
else:
return _handle_node_xml(data)
def get_for_member(self, member_name, perms='write', access_token=None, per_page=10, page=1):
"""
Get Node/Profile/Evisite of a User/Member
Usage: Nodes.get_for_memnber("iapain")
Returns: List of Nodes object
Eviscape API Method: nodes.get
"""
method = "nodes.member"
if access_token is None:
data = request_get(method, mem_name=member_name, perms=perms, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, mem_name=member_name,\
perms=perms, per_page=per_page, page=page)
if FORMATTER == 'json':
return _handle_node_json(data)
else:
return _handle_node_xml(data)
def received(self, member, node, access_token=None, per_page=10, page=1):
"""
Get all received Evis/Post/Article of a Node/Profile/Evisite
Usage: Evis.received(Member(id=13), Nodes(id=17))
Returns: A list with Evis Object
Eviscape API Method: evis.received
"""
method = "evis.received"
if access_token is None:
data = request_get(method, mem_id=member.id, nod_id=node.id, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, mem_id=member.id, nod_id=node.id,\
per_page=per_page, page=page)
if FORMATTER == 'json':
return _handle_evis_json(data)
else:
return _handle_evis_xml(data)
def search(self, query, access_token=None, per_page=10, page=1):
"""
Search an Evis/Post/Article
Usage: Evis.search('bon jovi OR metallica')
Returns: List of evis
Eviscape API Method: evis.search
"""
method = "evis.search"
if access_token is None:
data = request_get(method, q=query, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, q=query, per_page=per_page, page=page)
if FORMATTER == "json":
return _handle_evis_json(data)
else:
return _handle_evis_xml(data)
def listeners(self, access_token=None, per_page=10, page=1):
"""
Get Listeners/Followers of a Node/Profile/Evisite
Usage: Nodes(id=17).listeners()
Returns: List of Nodes object
Eviscape API Method: nodes.listeners
"""
method = "nodes.listeners"
if access_token is None:
data = request_get(method, nod_id=self.id, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, nod_id=self.id,\
per_page=per_page, page=page)
if FORMATTER == 'json':
return _handle_node_json(data)
else:
return _handle_node_xml(data)
def get(self, node, evis, access_token=None, per_page=10, page=1):
"""
Gets comments for an evis (optionally required access_token)
Usage: Comments.get(Nodes(id=17), Evis(id=6259, Nodes(id=17))
Returns: List of Comments object
Eviscape API Method: comments.get
"""
method = "comments.get"
if access_token is None:
data = request_get(method, nod_id=node.id, evi_id=evis.id,\
per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, nod_id=node.id,\
evi_id=evis.id, per_page=per_page, page=page)
if FORMATTER == 'json':
return _handle_comment_json(data)
else:
return _handle_comment_xml(data)
def get(self, access_token=None, per_page=10, page=1):
"""
Get an Evis/Post/Article
Usage: Evis(id=6369).get()
Returns: An Evis Object
Eviscape API Method: evis.get
"""
method = "evis.get"
if access_token is None:
data = request_get(method, evi_id=self.id, nod_id=self.node.id,\
per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, evi_id=self.id,\
nod_id=self.node.id, per_page=per_page, page=page)
if FORMATTER == 'json':
return _handle_evis_json(data)[0]
else:
return _handle_evis_xml(data)[0]
def get_files(self, access_token=None, per_page=10, page=1):
"""
Get Files belongs to an Evis/Post/Article
Usage: Evis(id=6369).get_files()
Returns: A list of Files Object
Eviscape API Method: evis.get_files
"""
method = "evis.get_files"
if access_token is None:
data = request_get(method, evi_id=self.id, nod_id=self.node.id,\
per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, evi_id=self.id,\
nod_id=self.node.id, per_page=per_page, page=page)
if FORMATTER == 'json':
self.files = _handle_file_json(data)
else:
self.files = _handle_file_xml(data)
return self.files
def xlatest(self, access_token=None, per_page=10, page=1):
"""
Get all latest evis
Usage: Evis.xlatest()
Returns: A Generator with Evis Object
Eviscape API Method: evis.latest
"""
method = "evis.latest"
if access_token is None:
data = request_get(method, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, per_page=per_page, page=page)
if FORMATTER == "json":
if isinstance(data.get("objects", None), list):
for evi in data["objects"]:
yield _parse_evis(evi)
else:
if data.rsp.objects.__dict__.has_key("evis"):
if isinstance(data.rsp.objects.evis, list):
for evi in data.rsp.objects.evis:
yield _parse_evis(evi)
else:
yield _parse_evis(data.rsp.objects.evis)
def xsent(self, node, access_token=None, per_page=10, page=1):
"""
Get all posted Evis/Post/Article of a Node/Profile/Evisite
Usage: Evis.xsent(Nodes(id=17))
Returns: A Generator with Evis Object
Eviscape API Method: evis.sent
"""
method = "evis.sent"
if access_token is None:
data = request_get(method, nod_id=node.id, per_page=per_page, page=page)
else:
data = request_protected_get(method, access_token, nod_id=node.id,\
per_page=per_page, page=page)
if FORMATTER == 'json':
if isinstance(data.get('objects', None), list):
for evi in data['objects']:
yield _parse_evis(evi)
else:
if data.rsp.objects.__dict__.has_key('evis'):
if isinstance(data.rsp.objects.evis, list):
for evi in data.rsp.objects.evis:
yield _parse_evis(evi)
else:
yield _parse_evis(data.rsp.objects.evis)
