Home

Welcome to the Azure IoT for Python wiki!

This wiki will contain long-form documents related to implementation, design, and motivation surrounding the Azure IoT Python codebase written by the maintainers.

Notes for users of the library

• Correct use of X-509
• Common pitfalls and known issues

Convention Notes

• Use of callbacks
• Logging levels
• URL Encoding/Decoding Policy

Implementation Notes

• Asynchronous APIs Leveraging Synchronous Code
• Various kwargs for client creation methods

Testing Notes

• Basics of unit-testing
• Examples of different test units
• Unit-testing with asynchronous code
• Unit-testing with AbstractBaseClasses
• Advanced pattern: Shared tests via inheritance
• Advanced pattern: Mocking APIs that accept callbacks
  • Coming soon
• Manual Testing of Proxies

Maintenance Notes

• The Azure IoT Namespace Package (azure-iot-nspkg)
• Releasing packages on PyPi