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

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()
...

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.

What's Changed

• added clean_session param by @jwcrawf in #20

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

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

Allow setting clientid in messaging object.