semvec/pypi-packages huggingface dataset:
vkontakte2 1.3.4
vk.com (vkontakte.ru) API wrapper
License: MIT license

=========
vkontakte
=========

.. image:: https://travis-ci.org/kmike/vkontakte.png?branch=master
   :target: https://travis-ci.org/kmike/vkontakte
.. image:: https://coveralls.io/repos/kmike/vkontakte/badge.png?branch=master
   :target: https://coveralls.io/r/kmike/vkontakte

This is a vk.com (aka vkontakte.ru, largest Russian social network)
python API wrapper. The goal is to support all API methods (current and future)
that can be accessed from server.

Installation
============

::

    $ pip install vkontakte2

Usage
=====

::

    >>> import vkontakte
    >>> vk = vkontakte.API('my_api_id', 'my_api_secret')
    >>> print vk.getServerTime()
    1282689362

    >>> vk = vkontakte.API(token='my_access_token')
    >>> print vk.getServerTime()
    1282689362

    >>> profiles = vk.getProfiles(uids='1,2', fields='education')
    >>> pavel = profiles[0]
    >>> print pavel['last_name'], pavel['university_name']
    Дуров СПбГУ

    >>> # alternative syntax
    >>> profiles = vk.get('getProfiles', uids='1,2', fields='education')
    >>> pavel = profiles[0]
    >>> print pavel['last_name'], pavel['university_name']
    Дуров СПбГУ

    >>> # custom timeout example (default timeout = 1s)
    >>> vk = vkontakte.API('my_api_id', 'my_api_secret', timeout=5)
    >>> print vk.getServerTime()
    1282689362

    >>> # syntax sugar for 'secure.*' methods
    >>> print vk.secure.getSMSHistory()
    None

All API methods that can be called from server should be supported.

See http://bit.ly/9Nzc8h for detailed API help.

OAuth2 access_token is supported (docs are here http://vkontakte.ru/developers.php?oid=-1&p=Авторизация)

Changes
=======

dev (TBA)
---------

* bugfix for breaking vkontakte API updates.

``simplejson`` is now required under python 2.6 (it was previously
required only under python 2.5).

1.3.2 (2012-05-19)
------------------

* more COMPLEX_METHODS are suported.

1.3.1 (2012-04-09)
------------------

* don't raise an exception on json with control characters from vkontakte;
* properly encode request parameters after dumping them to json format.

1.3 (2012-03-27)
----------------

* dict, list and tuple arguments are now properly serialized;
* more info is preserved in VKError.

1.2.1 (2012-02-15)
------------------

* properly encode unicode for API calls;
* tox test running.

1.2 (2012-01-20)
----------------

* 'get' API calls are fixed;
* tests are added.

1.1.0 (2012-01-11)
------------------

* more magic methods are supported;
* proper timestamp calculation.

1.0.0 (2011-12-29)
------------------

* OAuth2 support;
* api.ads support;


0.9.5 (2010-10-30)
------------------

* syntax sugar for 'secure' methods;
* make vkontakte.signature public;
* unicode param names are fixed;

0.9.3 (2010-09-02)
------------------

* timeout support

0.9.1 (2010-08-25)
------------------
Initial release.