[PROTON-1175] Document BlockingConnection resource cleanup

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: proton-0.12.0
• Fix Version/s: proton-c-0.18.0
• Component/s: python-binding
• Labels: docs
• Assignee: Justin Ross
• Reporter: Clifford Jansen
• Created: 12/Apr/16 22:28
• Updated: 24/Oct/17 08:45
• Resolved: 17/Aug/17 23:47

Description

The documentation is silent on resource cleanup for BlockingConnections. Currently if the BlockingConnection is not closed, the file descriptors and other reactor machinery are leaked.

Standard Python techniques should be used to ensure resource clean up (try..finally blocks etc.)

Only the sync_client example hints this might be desirable, let alone necessary.