Vizydrop’s applications gallery - codenamed Hermione - is written using the same SDK library provided here. The Python SDK is the preferred platform for developing your third-party applications as a result of this.
- Python 3 (Python 2 is not supported)
Installing the SDK
The Vizydrop Python SDK is available on GitHub and can be easily installed via PyPi:
pip install vizydrop-sdk or
easy_install vizydrop-sdk. This will download all required dependencies, such as Tornado, automatically for you.
Using the SDK
The Vizydrop Python SDK is very easy to use and you can have your custom application running in a matter of a few minutes. The package provides a series of base classes that you can easily extend to provide your custom datasource.
The Vizydrop Python SDK comes with some example applications that can provide a great boilerplate for starting your own integrations. These examples include integrations that both read information from flat files as well as pull information from external API’s. An advanced example of performing concurrent API calls on a paginated API is also included. Check out the examples in the Vizydrop Python SDK repository.
Running your app
Running your Vizydrop third-party application is easy once all required subclasses have been written. To start our third-party application, simply run
python -m vizydrop.tpa <module> <port> where module is the name of the Python module that contains your subclass of the
Application class. Suppose our
Trello application class exists in a file called
trelloapp.py, we can run our application by simply running
python -m vizydrop.tpa trelloapp. The port argument is optional and allows you to specify on which port the asynchronous HTTP server should listen on (the default is port 8080). Once your application is running, you may register it on the Vizydrop site as a custom data source!
All public app connectors included in Vizydrop that utilize the official Python SDK are available open-source under the BSD License and can be viewed on GitHub. Interested in contributing? We’re more than happy to accept pull requests for both the SDK and for our existing applications.