Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

StackHut client-side Python library

Project description

StackHut Client Library

https://img.shields.io/travis/stackhut/client-python.svg https://img.shields.io/pypi/v/stackhut-client.svg

StackHut client library to call dev, local, and hosted StackHut services dynamically and asynchronously from your Python code as if it were a local function.

Description

There are 3 main objects in the library,

SHService

This is the main library you create per service to communicate with it. It takes several parameters on construction, where those in square brackets are optional,

import stackhut_client as client
client.SHService(author, service_name, [service_version], [auth], [host])
  • author - The author of the service
  • service_name - The service name
  • version - The specific verion of the service (is latest if left blank)
  • auth - An SHAuth object used to authenticate requests for private services
  • host - URL for the StackHut API server, can be set to point to local servers during development, is https://api.stackhut.com if left blank

To make a remote call, just call the interface and method name on the service object, e.g.,

result = service.Interface.method(params, ...)

SHAuth

An optional object used to authenticate requests to a service,

client.SHAuth(user, [hash], [token])
  • user - Username of a registered StackHut user
  • hash - Hash of the user’s password (you can find this in ~/.stackhut.cfg). Be careful not to use in public-facing code.
  • token - A valid API token created for the user

One of hash or token must be present in the auth object to authorise a request by the given user.

SHError

Returned in the event of a remote service error in the catch block of a rejected promise.

The object has 3 parameters,

  • code - The RPC error code
  • message - A string describing the error
  • data - An optional object that may contain additional structured data for handling the error

Example

Using the existing service called demo-nodejs by user stackhut, we create the main service object,

import stackhut_client as client
service = client.SHService('stackhut', 'web-tools')

From here we can call any functions on any interfaces exposed by the hosted stackhut/demo-nodejs service, as follows,

result = service.Default.renderWebpage("http://www.stackhut.com", 1024, 768)
print("Page render at {}".format(result))

Notes

  • Python 3+ only currently (built on 3.4), looking into python-future for 2.x compatibility.
  • Calls are currently synchronous but we will switch to an async-based solution following the release of Python 3.5.

Credits

Development Leads

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for stackhut-client, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size stackhut_client-0.1.1-py3-none-any.whl (7.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page