msgraph2 0.3

A Pythonic interface to Microsoft's Graph API

msgraph

This is a small(-ish) Python library for wrapping interactions with Microsoft's Graph API, specifically with respect to populating and interrogating SharePoint sites safely.

Examples

import msgraph

sp = msgraph.SafeSharePoint(
  host='yours.sharepoint.com',
  site='SITE-NAME',
  library='A Document Library',
  token=msgraph.file_token('path/to/token.json')
)

sp.mkdir("/Incoming/Uploaded Documents", make_parents=True)

Where /path/to/token.json looks something like this:

{
  "access_token": "... your access token ..."
}

The msgraph.file_token function causes the token to be re-read from the file every time it is needed. Other keys in the token JSON file will be explicitly ignored, so if you have a system of refreshing access tokens that rewrites the on-disk file every refresh, everything Just Works(TM).

If you are running a copy of Oauth-Taker, you can point msgraph there with the msgraph.oauth_taker_token() helper instead:

import msgraph

sp = msgraph.SafeSharePoint(
  host='yours.sharepoint.com',
  site='SITE-NAME',
  library='A Document Library',
  token=msgraph.oauth_taker_token(
    endpoint='https://ot.example.com/t/handler/t0',
    shared_key='my-sekrit-key-for-getting-tokens'
  )
)

sp.mkdir("/Incoming/Uploaded Documents", make_parents=True)