Python plugin runtime for Skygear

When the Skygear Server calls your plugin, py-skygear will take the plugin message and calls the appropriate function automatically.

Python Cloud Functions

py-skygear is useful for running Python Cloud Functions to work with skygear-server; skygear-node is the counter part of py-skygear but for Javascript.

You can read more about how to write Skygear Cloud Functions in Skygear Guides. You don't need py-skygear if you're using skygear.io and don't plan to deploy it on your own.

Install py-skygear

You may want to read Setup Skygear Development Server Locally before installing py-skygear (and understand why you might or might not need py-skygear)

Install skygear by using pip. py-skygear requires Python 3.

$ pip3 install skygear

Alternatively, you can install py-skygear from source by cloning py-skygear from this official repository.

Development

Skygear support two kind of protocol for different use case, make sure you add support to all of them or raise appropriate exception.

Supported protocols: http and zmq

If you want to use zmq, you need to install pyzmq, and respective cbinding. You can install via homebrew in OSX brew install zeromq

You may run a long running process that hook with your own skygear-server instance.

DATABASE_URL=postgresql://localhost/skygear?sslmode=disable \
py-skygear sample.py \
--skygear-address tcp://127.0.0.1:5555 \
--skygear-endpoint http://127.0.0.1:3000 \
--apikey=API_KEY

Support

For implementation related questions or technical support, please find us on the official forum or community chat.

If you believe you've found an issue with the Skygear Python cloud function SDK, please feel free to report an issue.

How to contribute

Pull Requests Welcome!

We really want to see Skygear grows and thrives in the open source community. If you have any fixes or suggestions, simply send us a pull request!

License & Copyright

Copyright (c) 2015-present, Oursky Ltd.
All rights reserved.

This source code is licensed under the Apache License version 2.0 
found in the LICENSE file in the root directory of this source tree. 
An additional grant of patent rights can be found in the PATENTS 
file in the same directory.