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).

Bắt đầu bằng cách kiểm tra triển khai Histogram của client Python, đặc biệt là thuộc tính _buckets và phương thức collect, cùng với các đối tượng Metric và Samples mà nó trả về. Xác định và kiểm thử một API bên ngoài có tài liệu để đọc số lượng của các bucket và tổng tổng, với độ bao phủ cho thấy các bài kiểm thử của ứng dụng có thể khẳng định các giá trị mà không sử dụng các đối tượng riêng tư hoặc chỉ dành cho việc sử dụng nội bộ.