This document describes how to prepare your development environment to work with the Microsoft Azure IoT Device SDK for Python
If you are simply using the Microsoft Azure IoT SDK for Python as an end user and do not need to modify the code itself, you can simply install the package via pip as follows:
pip install azure-iot-device
If you are going to be modifying the codebase (likely because you are working as a developer on the Microsoft Azure IoT Device SDK for Python) you will need a few extras. Thankfully, you can prepare your development environment simply by running the following command from the root:
python scripts/env_setup.py
This will install not only relevant development and test dependencies, but also an editable install of the source code, which can then have any code changes immediately reflected in the install.
It is recommended to use virtualenvwrapper for Unix-based platforms or virtualenvwrapper-win for Windows, in order to easily manage custom environments and switch Python versions, however this is optional.
If you wish to follow the samples exactly as written, you will need to set some environment variables on your system. These are not required however - if you wish to use different environment variables, or no environment variables at all, simply change the samples to retrieve these values from elsewhere. Additionally, different samples use different variables, so you would only need the ones relevant to samples you intend to use.
- IOTHUB_DEVICE_CONNECTION_STRING: The connection string for your IoTHub Device, which can be found in the Azure Portal
- X509_CERT_FILE: The path to the X509 certificate
- X509_KEY_FILE: The path to the X509 key
- X509_PASS_PHRASE: The pass phrase for the X509 key (Only necessary if cert has a password)
This is an incomplete list of environment variables