[Bug 28044] New: TpConnection should have API to get/upgrade a single TpContact

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=28044

           Summary: TpConnection should have API to get/upgrade a single
                    TpContact
           Product: Telepathy
           Version: unspecified
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: tp-glib
        AssignedTo: telepathy-bugs at lists.freedesktop.org
        ReportedBy: xclaesse at gmail.com
         QAContact: telepathy-bugs at lists.freedesktop.org


I think it is very common to get/upgrade only one TpContact. In that case
current API is a pain because callback returns a global GError, plus a
hashtable/array of GError per contact... in the case of a single contact that
can be simplified.

Also we could make use GAsync API for those, since it's the prefered way now.

So I suggest deprecate current API:
tp_connection_get_contacts_by_handle
tp_connection_get_contacts_by_id
tp_connection_upgrade_contacts

and instroduce:
tp_connection_get_contacts_by_handle_async/finish
tp_connection_get_contact_by_handle_async/finish
tp_connection_get_contacts_by_id_async/finish
tp_connection_get_contact_by_id_async/finish
tp_connection_upgrade_contacts_async/finish
tp_connection_upgrade_contact_async/finish

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.