Public Member Functions | Public Attributes | Static Public Attributes | List of all members
mycroft.api.Api Class Reference
Inheritance diagram for mycroft.api.Api:
Inheritance graph
[legend]

Public Member Functions

def __init__ (self, path)
 
def add_authorization (self, headers)
 
def add_content_type (self, headers)
 
def build_data (self, params)
 
def build_headers (self, params)
 
def build_json (self, params)
 
def build_path (self, params)
 
def build_query (self, params)
 
def build_url (self, params)
 
def check_token (self)
 
def get_data (self, response)
 
def get_response (self, response, no_refresh=False)
 
def refresh_token (self)
 
def request (self, params)
 
def send (self, params, no_refresh=False)
 

Public Attributes

 identity
 
 old_params
 
 path
 
 url
 
 version
 

Static Public Attributes

dictionary etag_to_response = {}
 
dictionary params_to_etag = {}
 

Detailed Description

Generic class to wrap web APIs 

Definition at line 43 of file scripts/mycroft/api/__init__.py.

Constructor & Destructor Documentation

def mycroft.api.Api.__init__ (   self,
  path 
)

Definition at line 48 of file scripts/mycroft/api/__init__.py.

Member Function Documentation

def mycroft.api.Api.add_authorization (   self,
  headers 
)

Definition at line 190 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.add_content_type (   self,
  headers 
)

Definition at line 186 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.build_data (   self,
  params 
)

Definition at line 194 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.build_headers (   self,
  params 
)

Definition at line 179 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.build_json (   self,
  params 
)

Definition at line 197 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.build_path (   self,
  params 
)

Definition at line 209 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.build_query (   self,
  params 
)

Definition at line 206 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.build_url (   self,
  params 
)

Definition at line 214 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.check_token (   self)

Definition at line 68 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.get_data (   self,
  response 
)

Definition at line 173 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.get_response (   self,
  response,
  no_refresh = False 
)
Parse response and extract data from response.

Will try to refresh the access token if it's expired.

Arguments:
    response (requests Response object): Response to parse
    no_refresh (bool): Disable refreshing of the token
Returns:
    data fetched from server

Definition at line 151 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.refresh_token (   self)

Definition at line 79 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.request (   self,
  params 
)

Definition at line 62 of file scripts/mycroft/api/__init__.py.

def mycroft.api.Api.send (   self,
  params,
  no_refresh = False 
)
Send request to mycroft backend.
The method handles Etags and will return a cached response value
if nothing has changed on the remote.

Arguments:
    params (dict): request parameters
    no_refresh (bool): optional parameter to disable refreshs of token

Returns:
    Requests response object.

Definition at line 108 of file scripts/mycroft/api/__init__.py.

Member Data Documentation

dictionary mycroft.api.Api.etag_to_response = {}
static

Definition at line 46 of file scripts/mycroft/api/__init__.py.

mycroft.api.Api.identity

Definition at line 60 of file scripts/mycroft/api/__init__.py.

mycroft.api.Api.old_params

Definition at line 65 of file scripts/mycroft/api/__init__.py.

dictionary mycroft.api.Api.params_to_etag = {}
static

Definition at line 45 of file scripts/mycroft/api/__init__.py.

mycroft.api.Api.path

Definition at line 49 of file scripts/mycroft/api/__init__.py.

mycroft.api.Api.url

Definition at line 58 of file scripts/mycroft/api/__init__.py.

mycroft.api.Api.version

Definition at line 59 of file scripts/mycroft/api/__init__.py.


The documentation for this class was generated from the following file:


mycroft_ros
Author(s):
autogenerated on Mon Apr 26 2021 02:35:40