docs for new classes structure

This commit is contained in:
ingvar1995 2016-10-25 00:10:11 +03:00
parent 3a90865fd0
commit e5a228906d
3 changed files with 11 additions and 9 deletions

View file

@ -10,7 +10,8 @@ class BaseContact:
"""
Class encapsulating TOX contact
Properties: name (alias of contact or name), status_message, status (connection status)
widget - widget for update
widget - widget for update, tox id (or public key)
Base class for all contacts.
"""
def __init__(self, name, status_message, widget, tox_id):

View file

@ -12,8 +12,7 @@ import file_transfers as ft
class Contact(basecontact.BaseContact):
"""
Class encapsulating TOX contact
Properties: name (alias of contact or name), status_message, status (connection status)
widget - widget for update
Properties: number, message getter, history etc. Base class for friend and gc classes
"""
def __init__(self, message_getter, number, name, status_message, widget, tox_id):
@ -59,6 +58,9 @@ class Contact(basecontact.BaseContact):
self._history_loaded = True
def load_all_corr(self):
"""
Get all chat history from db for current friend
"""
data = list(self._message_getter.get_all())
if data is not None and len(data):
data.reverse()
@ -115,6 +117,9 @@ class Contact(basecontact.BaseContact):
self._message_getter.delete_one()
def delete_old_messages(self):
"""
Delete old messages (reduces RAM if messages saving is not enabled)
"""
old = filter(lambda x: x.get_type() in (2, 3) and (x.get_status() >= 2 or x.get_status() is None),
self._corr[:-SAVE_MESSAGES])
old = list(old)
@ -182,7 +187,7 @@ class Contact(basecontact.BaseContact):
visibility = property(get_visibility, set_visibility)
# -----------------------------------------------------------------------------------------------------------------
# Unread messages from friend
# Unread messages and other actions from friend
# -----------------------------------------------------------------------------------------------------------------
def get_actions(self):

View file

@ -4,14 +4,10 @@ from messages import *
class Friend(contact.Contact):
"""
Friend in list of friends. Can be hidden, properties 'has unread messages' and 'has alias' added
Friend in list of friends.
"""
def __init__(self, message_getter, number, name, status_message, widget, tox_id):
"""
:param message_getter: gets messages from db
:param number: number of friend.
"""
super().__init__(message_getter, number, name, status_message, widget, tox_id)
self._receipts = 0