rlane-libgoogle 1.0.6

libgoogle

Connect to Google Service API's.

The libgoogle package provides a function to connect to a google service (such as Calendar, Drive and Mail), and manage credentials and access tokens under the XDG schema.

function connect

connect(scope: str, version: str) -> googleapiclient.discovery.Resource

Connect to Google service identified by `scope` and `version`.

Args:
    scope:          (valid examples):
                    "https://www.googleapis.com/auth/gmail"
                    "https://www.googleapis.com/auth/gmail.readonly"
                    "gmail"
                    "gmail.readonly"
                    "drive.metadata.readonly"
                    "photoslibrary.readonly"

    version:        "v1", "v3", etc.

Files:
    credentials:    XDG_CONFIG_HOME / libgoogle / credentials.json
                    Must exist, or raises FileNotFoundError.

    token:          XDG_CACHE_HOME / libgoogle / {scope}-token.json

function set_debug

set_debug(flag: bool) -> None

Turn on/off low-level `httplib2` debugging.

Args:
    flag:   True to turn on debugging, False to turn off.