Skip to content

leancloud/python-sdk

Repository files navigation

Python-SDK

GitHub Workflow Status (branch) Codecov

LeanCloud Python SDK

Install

pip install leancloud

or

easy_install leancloud

Maybe you need the sudo prefix depends on your OS environment.

Supported Python Versions

Python 2.7.18 and Python 3.6+.

Generate API document

Install dependencies:

pip install Sphinx sphinx_rtd_theme
cd apidoc
make html

Run Tests

Configure the following environment variables:

  • APP_ID
  • APP_KEY
  • MASTER_KEY
  • USE_REGION

Make sure the following options are configured on the LeanCloud console:

  • Data Storage > Settings > Include ACL with objects being queried: checked
  • Push Notification > Push notification settings > Prevent clients from sending push notifications: unchecked
  • Settings > Security > Service switches > Push notifications: enabled
  • Settings > Security > Service switches > SMS: disabled

And there is a cloud function naming add which returns 3 for add(a=1, b=2) deployed on the LeanEngine production environment of the application. For example:

AV.Cloud.define('add', async function (request) {
    return request.params["a"] + request.params["b"]
})

Install dependencies:

pip install -e .'[test]'

Run tests:

python -m nose

Run a single test without swallowing print:

python -m nose -v --nocapture tests/test_engine.py:test_lean_engine_error

Linter and Formatter

Currently, flake8 (linter) and black (formatter) are used. But we are still exploring.

Release a New Version

  1. Edit changelog and setup.py (version).
  2. Generate API doc.
  3. Commit the changes above and send a pull request.
  4. The maintainer will review and merge the pull request, then create a new release at GitHub web UI.
  5. A new version of the package will be published to PyPI automatically (via GitHub Actions).

License

License: GNU LGPL.

Author: asaka ([email protected])