Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Django implementation for vkontakte API Groups
Python
branch: master
Failed to load latest commit information.
vkontakte_groups
.coveragerc split vkontakte_groups to 3 different apps
.gitignore initial
.travis.yml travis conf update, switch to new version vk_api
LICENSE
MANIFEST.in added ParseGroupsMixin, swit hed to new vkontakte_wall interface
README.md fixed README, settings_py
quicktest.py updated quicktest
settings_test.py fixed README, settings_py
setup.py
travis_django_version.py added travis_django_version.py

README.md

Django Vkontakte Groups

PyPI version Build Status Coverage Status

Приложение позволяет взаимодействовать с группами Вконтакте, их статистикой и пользователями групп через Вконтакте API используя стандартные модели Django

Установка

pip install django-vkontakte-groups

В settings.py необходимо добавить:

INSTALLED_APPS = (
    ...
    'oauth_tokens',
    'taggit',
    'vkontakte_api',
    'vkontakte_groups',
)

# oauth-tokens settings
OAUTH_TOKENS_HISTORY = True                                         # to keep in DB expired access tokens
OAUTH_TOKENS_VKONTAKTE_CLIENT_ID = ''                               # application ID
OAUTH_TOKENS_VKONTAKTE_CLIENT_SECRET = ''                           # application secret key
OAUTH_TOKENS_VKONTAKTE_SCOPE = ['ads,wall,photos,friends,stats']    # application scopes
OAUTH_TOKENS_VKONTAKTE_USERNAME = ''                                # user login
OAUTH_TOKENS_VKONTAKTE_PASSWORD = ''                                # user password
OAUTH_TOKENS_VKONTAKTE_PHONE_END = ''                               # last 4 digits of user mobile phone

Покрытие методов API

  • groups.getById – возвращает информацию о группах по их идентификаторам;
  • groups.search – Осуществляет поиск групп по заданной подстроке;

В планах:

  • groups.getMembers – возвращает список участников группы;

Примеры использования

Получение группы

>>> from vkontakte_groups.models import Group
>>> Group.remote.fetch(ids=[16297716])
[<Group: Coca-Cola>]

Получение дискуссий группы через метод группы

Для этого необходимо установить дополнительно приложение django-vkontakte-board и добавить его в INSTALLED_APPS

>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.fetch_topics()
[<Topic: ЭСТАФЕТА ОЛИМПИЙСКОГО ОГНЯ ► задаем вопросы в этой теме>,
 <Topic: ПРОМО-АКЦИЯ "ВСТРЕЧАЙ НОВЫЙ ГОД С ПРИЗАМИ! СОБЕРИ ТЁПЛУЮ КОМПАНИЮ МИШЕК!" ► вопросы и обсуждение>,
 '...(remaining elements truncated)...']

Дискуссии группы доступны через менеджер

>>> group.topics.count()
12

Комментарии всех дискуссий группы доступны через менеджер

>>> group.topics_comments.count()
23854

Получение сообщений со стены группы через метод группы

Для этого необходимо установить дополнительно приложение django-vkontakte-wall и добавить его в INSTALLED_APPS

>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.fetch_posts()
[<Post: Coca-Cola: ...>, <Post: Coca-Cola: ...>, '...(remaining elements truncated)...']

Сообщения группы доступны через менеджер

>>> group.wall_posts.count()
5498

Комментарии всех сообщений группы доступны через менеджер

>>> group.wall_comments.count()
73637

Получение фотоальбомов группы через метод группы

Для этого необходимо установить дополнительно приложение django-vkontakte-photos и добавить его в INSTALLED_APPS

>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.fetch_albums()
[<Album: Coca-Cola привозила кубок мира по футболу FIFA>,
 <Album: Старая реклама Coca-Cola>,
 '...(remaining elements truncated)...']

Фотоальбомы группы доступны через менеджер

>>> group.photo_albums.count()
47

Фотографии всех альбомов группы доступны через менеджер

>>> group.photos.count()
4432

Получение статистики группы

Для этого необходимо установить дополнительно приложение django-vkontakte-groups-statistic и добавить его в INSTALLED_APPS

Получение статистики группы через API

>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.fetch_statistic(api=True)

Статистика, полученная через API доступна через менеджер

>>> stat = group.statistics_api.all()[0]
>>> stat.__dict__
{'_state': <django.db.models.base.ModelState at 0xa2812ac>,
 'age_18': 240,
 'age_18_21': 86,
 'age_21_24': 75,
 'age_24_27': 59,
 'age_27_30': 31,
 'age_30_35': 23,
 'age_35_45': 9,
 'age_45': 13,
 'date': datetime.date(2012, 3, 14),
 'females': 295,
 'fetched': datetime.datetime(2012, 9, 12, 0, 50, 42, 597930),
 'group_id': 14,
 'id': 182,
 'males': 406,
 'views': 1401,
 'visitors': 702}

Получение статистики группы через парсер

>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.fetch_statistic()

Статистика, полученная через парсер доступна через менеджер

>>> stat = group.statistics.all()[0]
>>> stat.__dict__
{'_state': <django.db.models.base.ModelState at 0xa28168c>,
 'act_members': None,
 'act_visitors': None,
 'activity_photo_comments': None,
 'activity_photos': None,
 'activity_topic_comments': None,
 'activity_topics': None,
 'activity_video_comments': None,
 'activity_videos': None,
 'activity_wall': None,
 'ads_members': None,
 'ads_visitors': None,
 'age_18': None,
 'age_18_21': None,
 'age_21_24': None,
 'age_24_27': None,
 'age_27_30': None,
 'age_30_35': None,
 'age_35_45': None,
 'age_45': None,
 'comments': 298,
 'date': datetime.date(2011, 8, 25),
 'ex_members': 595,
 'females': None,
 'group_id': 14,
 'id': 2410,
 'likes': 26,
 'males': None,
 'members': 335748,
 'new_members': 143,
 'reach': None,
 'reach_age_18': None,
 'reach_age_18_21': None,
 'reach_age_21_24': None,
 'reach_age_24_27': None,
 'reach_age_27_30': None,
 'reach_age_30_35': None,
 'reach_age_35_45': None,
 'reach_age_45': None,
 'reach_females': None,
 'reach_males': None,
 'reach_subsribers': None,
 'references': None,
 'section_applications': None,
 'section_audio': None,
 'section_discussions': None,
 'section_documents': None,
 'section_photoalbums': None,
 'section_video': None,
 'shares': 4,
 'views': 1188,
 'visitors': 603,
 'widget_ex_users': None,
 'widget_members_views': None,
 'widget_new_users': None,
 'widget_users_views': None}

Получение среза подписчиков группы

Для этого необходимо установить дополнительно приложения django-vkontakte-groups-migration и добавить его в INSTALLED_APPS

>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.update_users()

Срез подписчиков доступен через менеджер

>>> migration = group.migrations.all()[0]
>>> len(migration.members_ids)
5277888
>>> migration.members_count
5277888

Подписчики доступны через менеджер. Для этого необходимо установить дополнительно приложение django-vkontakte-users и добавить его в INSTALLED_APPS

>>> group.users.count()
5277888
Something went wrong with that request. Please try again.