Document for the pulsar.Result enum

[BewareMyPower]

The pulsar.Result enum is just imported from the C extension. See

pulsar-client-python/pulsar/__init__.py

Line 50 in daabc67

from _pulsar import Result, CompressionType, ConsumerType, InitialPosition, PartitionsRoutingMode, BatchingType, \

Running help(pulsar.Result) could only show the underlying C error codes like

 |
 |  AlreadyClosed = <Result.AlreadyClosed: 15>
 |
 |  AuthenticationError = <Result.AuthenticationError: 7>
 |
 |  AuthorizationError = <Result.AuthorizationError: 8>
 |
 |  BrokerMetadataError = <Result.BrokerMetadataError: 10>
 |
 |  BrokerPersistenceError = <Result.BrokerPersistenceError: 11>

The error code should be well documented. Otherwise users might not know how to handle these error codes.

For now, users can refer https://github.com/apache/pulsar-client-cpp/blob/main/include/pulsar/Result.h for the meaning of error codes.