=====================
[](http://badge.fury.io/py/django-vkontakte-wall) [](https://travis-ci.org/ramusus/django-vkontakte-wall) [](https://coveralls.io/r/ramusus/django-vkontakte-wall)
Приложение позволяет взаимодействовать со стенами Вконтакте, сообщениями и комментариями на них через Вконтакте API и парсер используя стандартные модели Django
Установка
---------
pip install django-vkontakte-wall
В `settings.py` необходимо добавить:
INSTALLED_APPS = (
...
'oauth_tokens',
'taggit',
'vkontakte_api',
'vkontakte_places',
'vkontakte_users',
'vkontakte_groups',
'vkontakte_wall',
'm2m_history',
)
# 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
--------------------
* [wall.get](http://vk.com/dev/wall.get) – возвращает список записей со стены;
* [wall.getById](http://vk.com/dev/wall.getById) – получает записи со стен пользователей по их идентификаторам;
* [wall.getLikes](http://vk.com/dev/wall.getLikes) – получает информацию о пользователях которым нравится данная запись;
* [wall.post](http://vk.com/dev/wall.post) – публикует новую запись на своей или чужой стене;
* [wall.edit](http://vk.com/dev/wall.edit) – редактирует запись на стене;
* [wall.delete](http://vk.com/dev/wall.delete) – удаляет запись со стены;
* [wall.restore](http://vk.com/dev/wall.restore) – восстанавливает удаленную запись на стене пользователя;
* [wall.getComments](http://vk.com/dev/wall.getComments) – получает комментарии к записи на стене пользователя;
* [wall.addComment](http://vk.com/dev/wall.addComment) – добавляет комментарий к записи на стене пользователя или сообщества;
* [wall.editComment](http://vk.com/dev/wall.editComment) – редактирует комментарий на стене пользователя или сообщества;
* [wall.deleteComment](http://vk.com/dev/wall.deleteComment) – удаляет комментарий текущего пользователя к записи на своей или чужой стене;
* [wall.restoreComment](http://vk.com/dev/wall.restoreComment) – восстанавливает комментарий текущего пользователя к записи на своей или чужой стене;
Использование парсера
---------------------
* Получение сообщений со стены группы; *
* Получение комментариев сообщения со стены группы; *
* Получение лайков сообщения; *
* Получение перепостов сообщения.
(*) Дублирование функционала API
Примеры использования
---------------------
### Получение сообщений по их идентификаторам
>>> from vkontakte_wall.models import Post
>>> Post.remote.fetch(ids=['5223304_130', '-16297716_126261'])
[<Post: ...>, <Post: ...>]
### Получение сообщений со стены пользователя через метод пользователя
>>> from vkontakte_users.models import User
>>> user = User.remote.fetch(ids=[1])[0]
>>> user.fetch_posts()
[<Post: ...>, <Post: ...>, <Post: ...>, '...(remaining elements truncated)...']
Сообщения пользователя доступны через менеджер
>>> user.wall_posts.count()
432
Комментарии всех сообщений пользователя доступны через менеджер
>>> user.wall_comments.count()
73637
### Получение сообщений со стены пользователя через менеджер
>>> from vkontakte_users.models import User
>>> user = User.remote.fetch(ids=[1])[0]
>>> Post.remote.fetch_user_wall(user=user)
[<Post: ...>, <Post: ...>, <Post: ...>, '...(remaining elements truncated)...']
### Получение сообщений со стены группы через метод группы
>>> 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
### Получение сообщений со стены группы через менеджер
>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> Post.remote.fetch_group_wall(group=group)
[<Post: ...>, <Post: ...>, <Post: ...>, '...(remaining elements truncated)...']
### Получение комментариев сообщения со стены группы через менеджер
>>> from vkontakte_users.models import User
>>> user = User.remote.fetch(ids=[1])[0]
>>> post = user.wall_posts.all()[0]
>>> Comment.remote.fetch_user_post(post=post)
[<Comment: ...>, <Comment: ...>, <Comment: ...>, '...(remaining elements truncated)...']
### Публикация записи на стене
>>> post = Post.objects.create(**param)
>>> print post.text
'message'
или
>>> post = Post()
>>> post.text = 'message'
....
>>> post.save()
>>> post.text
'message'
### Редактирование опубликованной записи
>>> post = Post.objects.get(remote_id='5223304_130')
>>> post.text = 'Edited message'
>>> post.save()
>>> post.text
'Edited message'
### Удаление опупбликованной записи
>>> post.delete() # Запись не удаляется из БД,
>>> post.archived
True # вместо этого аттрибуту archived присваивается True
### Востановление удаленной записи
>>> post.restore() # Запись не создается заново
>>> post.archived
False # вместо этого аттрибуту archived присваивается False
### Публикация коментария к записи на стене
>>> test_comment = Comment.objects.create(**compent_param)
>>> test_comment
<Comment:...>
или
>>> comment = Comment()
>>> comment.text = 'text'
....
>>> comment.save()
>>> comment.remote_id
'123123_123'
>>> comment.text
'text'
### Редактирование опубликованного комментария
>>> edited_message = 'Edited comment message'
>>> comment = Comment.objects.get(...)
>>> comment.text = 'Edited comment message'
>>> comment.save()
>>> comment.text
'Edited comment message'
### Удаление опупбликованного комментария
>>> test_comment.delete() # Запись не удаляется из БД,
>>> test_comment.archived
True # вместо этого аттрибуту archived присваивается True
### Востановление удаленного комментария
>>> test_comment.restore() # Запись не создается заново
>>> test_comment.archived
False # вместо этого аттрибуту archived присваивается False
Metadata
Release files for django-vkontakte-wall 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| django-vkontakte-wall-0.8.1.tar.gz | 62.1 kB | Without provenance | Details for django-vkontakte-wall-0.8.1.tar.gz |
Release files / django-vkontakte-wall-0.8.1.tar.gz
| Download URL | django-vkontakte-wall-0.8.1.tar.gz |
|---|---|
| Size | 62.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fec223531b1a9fde4e08cd286fc6ba8e698dd13193fc808dc607f5638648e44f
|
|
BLAKE2b-256 checksum How to use checksums |
939d42c45d1d429f89079a85f44c6c36c2bce40c36685e91e394534e1d564a31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for django-vkontakte-wall 0.8.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.