Provide APIs to help application developers test their Histogram-using code

I have an application that uses Histogram. I want to write some tests that assert that my application is putting values into the right buckets of that histogram.

To read values out of the Histogram it seems that need to either:

• look at the Histogram's private _buckets attribute, or
• call Histogram.collectand look at the resulting Metric objects which are documented as "intended only for internal use" and then look at its Samples which aren't documented at all.

Neither of these seems particularly satisfactory. It would be very helpful if client_python provided some way to read bucket counts and the total sum from a Histogram, using documented APIs clearly marked as intended for external use (perhaps only in test suites).

首先检查 Python 客户端的 Histogram 实现，尤其是其 _buckets 属性和 collect 方法，以及它返回的 Metric 和 Samples 对象。定义并测试一个有文档说明的外部 API，用于读取 bucket 计数和总和，并添加覆盖率以表明应用程序测试可以在不使用私有对象或仅供内部使用的对象的情况下断言值。