Explain how OpenWhisk API can be used from Python (#7)

* Explain how OpenWhisk API can be used from Python

Inspired by https://stackoverflow.com/questions/44626886/invoking-openwhisk-actions-from-a-python-app by @jthomas

* typo

* fixed links and wording in README.md
1 file changed
tree: e568b070a3469a39ecff43c6285e669216bc592b
  1. tools/
  2. .travis.yml
  3. CONTRIBUTING.md
  4. LICENSE.txt
  5. README.md
README.md

incubator-openwhisk-client-python

Build Status

There is no official Python client for Apache OpenWhisk at the moment. However, the REST API of OpenWhisk can be used directly from Python. Here is an example of Python code using the requests library to invoke echo action in OpenWhisk (in Bluemix):

import subprocess
import requests

APIHOST = 'https://openwhisk.ng.bluemix.net'
AUTH_KEY = subprocess.check_output("wsk property get --auth", shell=True).split()[2] 
NAMESPACE = 'whisk.system'
ACTION = 'utils/echo'
PARAMS = {'myKey':'myValue'}
BLOCKING = 'true'
RESULT = 'true'

url = APIHOST + '/api/v1/namespaces/' + NAMESPACE + '/actions/' + ACTION
user_pass = AUTH_KEY.split(':')
response = requests.post(url, json=PARAMS, params={'blocking': BLOCKING, 'result': RESULT}, auth=(user_pass[0], user_pass[1]))
print(response.text)

Swagger documentation for full API is available here.

There is an open issue to create a Python client library to make this easier.

NOTE: This repository used to comprise an OpenWhisk CLI written in Python. The CLI has been superseded by a version written in Go.