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
diff --git a/README.md b/README.md
index 4381174..04b77e5 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,27 @@
-# openwhisk-python-cli
-## OpenWhisk Command Line Interface (CLI) written in Python.
-[](https://travis-ci.org/openwhisk/openwhisk-client-python)
+# incubator-openwhisk-client-python
+[](https://api.travis-ci.org/apache/incubator-openwhisk-client-python)
-NOTE: This CLI is no longer used in production as it has been [superseded by a version written in Go](https://github.com/openwhisk/openwhisk/tree/master/tools/cli).
+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):
+
+``` python
+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](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/apache/incubator-openwhisk/master/core/controller/src/main/resources/apiv1swagger.json).
+
+There is an [open issue](apache/incubator-openwhisk#450) 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](https://github.com/apache/incubator-openwhisk-cli).
