[PROTON-2402] Clarify proton python documentation on thread-safety and when certain callbacks are called

• Type: Improvement
• Status: Open
• Priority: Minor
• Resolution: Unresolved
• Affects Version/s: proton-c-0.34.0
• Component/s: python-binding
• Assignee: Unassigned
• Reporter: NS-SlaFleur
• Created: 25/Jun/21 13:27
• Updated: 11/Apr/23 18:47

Description

The Python documentation does not state the following explicitely which caused some confusion on my end:

• on_settled is triggered on the disposition settled on remote side
• Container & other proton datastructures are NOT thread safe, use injector for external thread communication
• on_sendable is called on each received flow event & after send if there are still credits available.

 

PR: https://github.com/apache/qpid-proton/pull/324