[PROTON-2555] Remove internal details from the proton/object.h API header file

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: proton-c-0.38.0
• Component/s: proton-c
• Assignee: Andrew Stitcher
• Reporter: Andrew Stitcher
• Created: 07/Jun/22 18:25
• Updated: 11/Nov/22 14:37
• Resolved: 08/Jul/22 15:31

Description

Proton has long exported the details of its internal object system in the proton/object.h header file - these details are marked as internal and many of them are unnecessary for any application to use.

Indeed exposing some of these details means that these internal details can't be compatibly changed between different Proton versions even though no applications should be using these details anyway.

However even some of our examples are using these internal details.

This is a tracking issue for several more detailed items which remove the need for nearly all of these APIs to be exported and then modifies the actual API header file so export only those APIs that are truely needed.

Sub-Tasks

• Remove all uses of pn_string and pn_list from example code: Closed
• Provide an alternative API to pn_inspect: Closed
• Provide an API to create pn_class_t instances: Closed
• Privatize most of the proton/object.h API: Closed