PyVk

###Python wrapper for VK API

####Usage example:

from VkApi import VkApi
api = VkApi(client_id=3869166, scope=['offline', 'audio'], console_auth=True, keep_token=True)
api.request('audio.get')

####Constructor arguments:

• client_id=0: VK API app identifier.
• scope=[]: API methods groups app can call
• access_token=str(): API session identifier
• console_auth=False: if is True, console auth will be performed (see Authorization flow)
• keep_token=False: save the access_token into auth.json for later use
• try_loading_token=False: if is True, tries to load the token from auth.json

Authorization flow:

1. If try_loading_token=True is provided, constructor will try to load saved token from auth.json
2. If access_token argument is provided, it will be saved, no additional auth is required.
3. If client_id and scope are provided, they will be saved and used for manual auth.
   • Create instance with these arguments provided to constructor
   • Call get_auth_url() method
   • Open the given URL and authorize user
   • Call set_token(access_token) to save token.
4. If console_auth=True is provided in addition to client_id and scope the console auth will be performed: just follow the instructions

Public methods:

• set_token(access_token): sets the provided token for using in requests
• get_token(): returns access_token
• is_authorized(): returns True, if authorized, else returns False
• get_auth_url(): return URL for manual authorization (see Authorization flow)
• request(api_method, data={}): processes request to API

Error handling:

• Constructor raises IncorrectAuthInfoException, if not enough arguments were provided
• request(api_method, data={}) raises NotAuthorizedException, if not authorized
• request(api_method, data={}) raises RequestErrorException with error_msg, if request somewhy fails