Release notes from ClearBlade-Python-SDK

v2.4.7

2025-08-04T16:37:37Z

As per suggestions from wildbiotiger:

Added public attribute to expose underlying Paho MQTT client in case needed
Added docstrings to public methods

As per this PR submitted by @swilcox:
#31

Added option to use standard Python logging

v2.4.6

2025-07-18T18:39:29Z

Fix:
IF a timeout happened when calling Messaging.connect() with use_tls (e.g. due to no network connectivity), THEN calling Messaging.connect() again resulted in an error preventing a successful reconnect. This has been fixed

Enhancement:
Inside ClearBladeCore.py, there were several direct calls to exit() on invalid authentication. These have now been replaced with cbErrors.handle() where cbErrors is an object of a new ErrorHandler class.

The generic handle() method is exit(). To override this method a user can create a more specific class and an overriding method as follows:

from clearblade.ClearBladeCore import System, cbErrors

class YourErrorHandler(cbErrors.ErrorHandler):
    def handle(self, code):
        # your custom error handling goes here. Call the super 'handle' (below) if needed
        # super().handle(code)
        print("custom error handling")

cbErrors.ERROR_HANDLER = YourErrorHandler()
...

v2.4.4

2023-09-13T11:56:53Z

This release provides an additional way to authenticate a device: using mTLS authentication.
This requires passing an x509keyPair when creating the Device object.

Definition: System.Device(name, x509keyPair={"certfile": "/path/to/your/cert.pem", "keyfile": "/path/to/your.key"})
Returns: Device object.

mTLS authentication is achieved by a POST request being sent to API {platformURL}:444/api/v/4/devices/mtls/auth with the provided x509keyPair being loaded into the SSL context's cert chain. This is handled by the SDK.

v2.4.3

2023-02-27T21:46:16Z

What's Changed

added clean_session param by @jwcrawf in #20

v2.4.2

2022-09-19T18:14:27Z

No changes to source code. Only removed a file that was inadvertently added to PyPi distribution.

v2.4.1

2022-06-27T15:54:31Z

What's Changed

Fix Code in README by @ChihweiLHBird in #15

New Contributors

@ChihweiLHBird made their first contribution in #15

Full Changelog: v2.4.0...v2.4.1

v2.4.0

2021-01-14T19:44:55Z

Version 2.3.0 -> 2.4.0

Version 2.3.1

2020-12-02T19:49:43Z

No content.

Version 2.3.0

2020-12-02T19:02:16Z

No content.

Version 2.2.5

2018-10-05T19:28:04Z

No content.