Python → Плагин Vkontakte.ru для Gwibber

Вступление

Не так давно решил вплотную познакомиться со всей кухней OpenSource со стороны разработчика и в качестве первой пробы решил написать плагин к Gwibber для поддержки Вконтакте. Надо сказать, что тикет на Launchpad на эту тему висит с середины 2010 года (датирован 2010-05-01) с довольно длинным обсуждением, было несколько попыток реализовать поддержку, но готового решения никто не предложил. Помимо Launchpad, появился топик на форуме Ubuntu.ru, в котором топикстартер сообщил, что реализовал поддержку ВК, но код так никому и не показал.

Так что в начале декабря взялся за работу и через 2 месяца рабочая протестированная версия плагина была готова. На данный момент я уже отправил запрос о включении плагина в официальную ветку Gwibber и буквально сегодня разработчики отметили его для включения в релиз 2.91.5.
Описание функционала, инструкция для желающих протестировать плагин в работе уже сейчас под катом...

Доступный функционал

На данный момент работает:

• Загрузка текстовых постов из новостей
• Загрузка видео - постов
• Загрузка постов - ссылок
• Загрузка постов с фото и граффити
• Отправка сообщений на свою стену
• Комментирование постов
• "Мне нравится" (сердечко)
• Удаление моих постов

Хочется добавить:

• Поддержку "ретвитов" ("Мне нравится"+"Рассказать друзьям") Пока архитектура Gwibber не позволяет это сделать
• Поддержку mentions (упоминание). Вконтакте выглядит как ссылка "ответить на моей странице". В Gwibber сейчас отображается как "[id535397|Сергей Прохоров], ". Примитивную поддержку сейчас добавить ничего не мешает.
• Поддержку личных сообщений (Пока что в сомнениях нужно ли это. В любом случае будет отдельная галочка в настройках аккаунта)

Известные проблемы:

• После смены IP адреса появляется сообщение об ошибке "Unknown method passed". Дело в том, что авторизационный "токен" API вконтакте привязан к IP адресу (видимо для защиты от взлома аккаунта) и после каждой смены IP его нужно обновлять. Делать это в фоновом режиме в текущей реализации самого Gwibber сейчас нельзя. Особенно доставляет тот факт, что сообщение об ошибке ни о чем не говорит... Так что нажимаем "редактировать" и заново проходим процедуру авторизации, жмем F5 для получения последних сообщений.

Инструкция по установке

Прежде всего хочу отметить, что пользоваться этой инструкцией стоит только если очень хочется протестировать плагин прямо сейчас, т.к. скорее всего через месяцок-другой, надеюсь, плагин войдет в официальный релиз. Итак, от слов перейдем к делу.

Подготовка

UPD: для natty этот пункт можно пропустить, т.к. там установлена новая версия Gwibber.

Важно! Не пропустите! Т.к. поддержка плагинов появилась только в ветке 2.91.x, а в Ubuntu Maverick установлена версия 2.32.x, то необходимо сперва установить последнюю версию из девелоперского PPA "deb http://ppa.launchpad.net/gwibber-daily/ppa/ubuntu maverick main #Gwibber-Daily PPA" командами

sudo add-apt-repository ppa:gwibber-daily/ppa
sudo apt-get update
sudo apt-get upgrade

Эти команды обновят основные модули Gwibber. Важно! Т.к. все протоколы теперь поставляются в виде отдельных пакетов, нужные протоколы необходимо устанавливать самостоятельно. Если этого не сделать, то Gwibber не запустится, а при запуске gwibber из консоли увидим

Traceback (most recent call last):
  File "/usr/bin/gwibber", line 87, in
    client.Client()
  File "/usr/lib/python2.6/dist-packages/gwibber/client.py", line 621, in __init__
    self.w = GwibberClient()
.........
  File "/usr/lib/pymodules/python2.6/mako/runtime.py", line 278, in
    return lambda *args, **kwargs:callable_(self.context, *args, **kwargs)
  File "base_mako", line 251, in render_image
  File "base_mako", line 192, in profile_url
  File "base_mako", line 829, in render_profile_url
KeyError: u'twitter'

Посмотреть список протоколов можно командой

aptitude search gwibber-service-+

Установим минимум - протоколы facebook и twitter:

sudo aptitude install gwibber-service-{twitter,facebook}

После этого можете попробовать запустить Gwibber и убедиться что версия обновилась.

Установка плагина Vkontakte.ru

UPD 2011-05-22: Вариант номер ноль. Используйте его! - установка из PPA

Для поддержки плагина создан PPA на Launchpad. Можно установить плагин, подключив этот PPA:

sudo apt-add-repository ppa:gwibber-vkontakte-plugin/ppa
sudo apt-get update
sudo aptitude install gwibber-service-vkontakte

Обновляться теперь будет автоматически!

Вариант номер раз - установка из DEB пакета

Добрый товарищ ZwS (Антон Судак?) с форума Ubuntu.ru собрал .DEB пакет, многие уже писали что установили этот пакет и у них все успешно заработало. Вот ссылки для скачивания DEB пакета для установки плагина
( оригинальная), ( мое зеркало) md5 e3ce23c5328fec6b54c2d549a4870812
UPD: новая версия ( оригинальная), ( мое зеркало) md5 d9cdb8299eebf8d7145dd219a3f75219

Просто скачиваете файл, запускаете, все подтверждаете, перезапускаете Gwibber, готово. Преимущества такого подхода - легко удалить если что-то сломается ( sudo aptitude remove gwibber-service-vkontakte) и если выйдет официальная версия плагина, то она без проблем установится поверх этой.

Вариант номер два (им пользуюсь я) - установка симлинков из bzr исходного кода

Пользуюсь потому что так можно запускать код написанный прямо сейчас, но просто так им пользоваться не советую.

Устанавливаем bazaar

sudo aptitude install bzr

Загружаем исходники Gwibber из моего репозитория Launchpad

bzr branch lp:~seriy-pr/gwibber/vkontakte-ru-plugin

После этого главная магия - делаем симлинки на некоторые кукски моего кода в директории откуда Gwibber их подхватит:

sudo ln -s /home/$USER/vkontakte-ru-plugin/gwibber/microblog/plugins/vkontakte/ /usr/share/gwibber/plugins/
sudo ln -s /home/$USER/vkontakte-ru-plugin/ui/icons/breakdance/16x16/vkontakte.* /usr/share/gwibber/ui/icons/breakdance/16x16/
sudo ln -s /home/$USER/vkontakte-ru-plugin/ui/icons/breakdance/22x22/vkontakte.* /usr/share/gwibber/ui/icons/breakdance/22x22/
sudo ln -s /home/$USER/vkontakte-ru-plugin/ui/icons/breakdance/scalable/vkontakte.* /usr/share/gwibber/ui/icons/breakdance/scalable/

И тогда должно заработать (только это небезопасно т.к. содержимое /home/$USER/vkontakte-ru-plugin доступно для записи). Если удалить директорию vkontakte-ru-plugin из домашней папки то работать перестанет. Чтобы этого избежать можно в предыдущем списке команд заменить команды "ln -s" на "cp"
Преимущества - для НЕразработчика - вам будет доступна самая последняя-распоследняя версия плагина. Недостатки - относительно сложно, небезопасно, могут возникнуть проблемы при обновлении.
Если после этого у вас Gwibber вдруг перестанет стартовать, можно подчистить следы деятельности командами

sudo rm -r /usr/share/gwibber/plugins/vkontakte
sudo rm -r /usr/share/gwibber/ui/icons/breakdance/*/vkontakte*

Способ номер три (я не проверял, но есть люди у которых он работает) - установка из "исходного кода" с помощью setup.py

Gwibber поддерживает distutils, соответственно его можно установить непосредственно из исходного кода с помощью файла setup.py. Преимущества и недостатки у этого метода примерно такие - же как у второго, но в случае неудачи подчистить следы будет сложнее. Сам я этот метод не проверял, поэтому скопирую краткое резюме из инструкции, приведенной товарищем M.CoRN в его блоге (мои благодарности ему):

bzr branch lp:~seriy-pr/gwibber/vkontakte-ru-plugin
sudo apt-get install python-dbus python-gtk2 python-gconf python-notify python-simplejson python-egenix-mxdatetime python-distutils-extra python-feedparser
cd vkontakte-ru-plugin
sudo python setup.py install

Если решите воспользоваться этой инструкцией, настоятельно рекомендую воспользоваться ее оригиналом, там есть дополнительные комментарии и рекомендации на случай появления ошибок.

Настройка учетной записи вконтакте в Gwibber

Ну тут как обычно все. Редактировать -> Учетные записи (или запустить приложение "gwibber-accounts") -> Добавить -> в выпадающем списке выбрать " Vkontakte" -> Добавить -> Выставьте галочки ("Получать сообщения" - чтобы получать сообщения вообще, "Посылать сообщения" - чтобы можно было отправлять сообщения и комментарии, "Receive groups" - это уже моя самодеятельность, если отмечено, будет загружать новости от групп, помимо новостей от друзей) -> Авторизовать -> Вводим логин-пароль, выставляем все галочки, жмем "Разрешить". Если все прошло успешно, закрываем окно, жмем F5 для обновления и пользуемся!

Что дальше?

Если есть какие-то пожелания/советы/отчеты об ошибках милости прошу в комментарии. Если хотите помочь и у вас есть аккаунт на Launchpad, отпишитесь тут  https://bugs.launchpad.net/gwibber/+bug/572753 и тут https://code.launchpad.net/~seriy-pr/gwibber/vkontakte-ru-plugin/+merge/47651 что у вас все работает или наоборот ничего не работает, так этот плагин быстрее попадет в официальную поставку.

Как водится, выражаю благодарность Stanislav Hanzhin, sergeyreym за активное участие, советы и багрепорты, Nazar Vinnichuk и остальным разработчикам Rhythmbox's plugin for Vkontakte.ru - их наработки послужили основой для плагина, ZwS (Антон Судак?) за .DEB пакет,ну и всем остальным кто принимал и принимает посильное участие.