Skip to content

README.md

Latest commit

History

History
142 lines (110 loc) · 4.1 KB

README.md

File metadata and controls

142 lines (110 loc) · 4.1 KB
Raw

Summary and Example

The SDK is an importable Python module that facilitates API and event bus actions on EXP.

importexpexp.runtime.start(
username="joe@exp.com",
password="joesmoe25",
host="http://localhost",
port=9000,
organization="exp")
devices=exp.api.get_devices()
devices[0].document.name="My Device"devices[0].save()
exp.channels.organization.broadcast(name="I changed a device!")
response=exp.channels.experience.request(name="sendMeMoney", target={ "device": devices[0].document["uuid"] })
printresponseexp.runtime.stop()

exp.runtime

exp.runtime.start()

The SDK must be initialized by calling exp.runtime.start() and passing in configuration options. This starts the event bus and automatically authenticates API calls. The start command will block until a connection is first established.

# Authenticate with username and password.exp.runtime.start(
username="joe@exp.com",
password="joesmoe25",
organization="exp")
# Authenticate with device uuid and secret.exp.runtime.start(uuid="[uuid]", secret="[secret]")

exp.runtime.stop()

A socket connection is made to EXP that is non-blocking. To end the connection and to stop threads spawned by the SDK call exp.runtime.stop().

exp.runtime.on()

Can listen for when the event bus is online/offline. Triggers an asynchronous callback.

defon_online():
print"Online!"defon_offline():
print"Offline!"exp.runtime.on("online", callback=on_online)
exp.runtime.on("offline", callback=on_offline)

exp.api

API abstraction layer.

Example

devices=exp.api.find_devices(**params) # Query for device objects (url params).device=exp.api.get_device(uuid) # Get device by UUID.device=exp.api.create_device(document) # Create a device from a dictionary

Other available namespaces: experiences, locations, content, data. contents do not currently support queries or creation, only "get_content(uuid)".

API Resources

Each resource object contains a "document" field which is a dictionary representation of the raw resource, along with "save" and "delete" methods.

device=exp.api.create_device({ "field": value })
device.document["field"] =123device.save()
printdevice.document["field"]
device.delete()
data=exp.api.get_data("key1", "group0")
printdata.valuedata.value= { "generic": 1111 }
data.save()
data.delete()
data=exp.api.create_data(key="4", group="cats", { "name": "fluffy" })

The "content" resource has a get_children() method that returns the content's children (a list of content objects). Every content object also has a get_url() and get_variant_url(name) method that returns a delivery url for the content.

exp.channels

Parent namespace for interaction with the event bus. Available channels are:

exp.channels.system# Calls to and from the systemexp.channels.experienceexp.channels.locationexp.channels.organization

exp.channels.[channel].fling

Fling content on a channel.

uuid='4abd....'exp.channels.organization.fling(uuid)

exp.channels.[channel].request

Send a request on this channel.

response=exp.channels.location.request(
name="getSomething", target= { "device" : "[uuid]"}, payload= { "info": 123 })

exp.channels.[channel].respond

Attach a callback to handle requests to this device. Return value of callback is response content. Must be JSON serializable.

defget_something(payload=None):
return"Something"exp.channels.location.respond(name="getSomething", callback=get_something_callback)

exp.channels.[channel].broadcast

Sends a broadcast message on the channel.

exp.channels.experience.broadcast(name="Hi!", payload={})

exp.channels.[channel].listen

Listens for broadcasts on the channel. Non-blocking, callback is spawned in new thread.

defmy_method(payload=None):
printpayloadexp.channels.experience.listen(name="Hi!", callback=my_method)