Unexport Format strings #576
Conversation
With the addition of the escaping term, format strings now have many permutations and doing direct string comparisons of formats is not reliable. Instead, users should call FormatType and compare the result against the possible enum values. Signed-off-by: Owen Williams <owen.williams@grafana.com>
ywwg
force-pushed
the
owilliams/unexport
branch
from
37e1e12
to
05d7387
Compare
|
can you do a new library release with this change? |
|
Ack, will do it ASAP. |
|
This change breaks an existing workflow: |
|
This breaks a lot of things for us... is there an example porting guide? |
We're currently in the process of cutting a new client_golang release. Client_golang 1.19 should work with common 0.48 |
| return fmtProtoText | ||
| case TypeTextPlain: | ||
| return fmtText | ||
| case TypeOpenMetrics: |
There was a problem hiding this comment.
Is there a way to generate a fmtOpenMetrics_0_0_1?
There was a problem hiding this comment.
There was a problem hiding this comment.
yes, the new functions in expfmt.go can create these for you: https://github.com/prometheus/common/blob/main/expfmt/expfmt.go#L77
The story is, because the exposition formats are getting more complex, simple string comparison is no longer safe. There are too many equivalent permutations, and therefore things were moved to functions. If the available NewFormat function is not sufficient for your needs, please @ me or file an issue and I can fix it up
There was a problem hiding this comment.
Right now TypeOpenMetrics only generates fmtOpenMetrics_1_0_0
If for some reason you need fmtOpenMetrics_0_0_1 there's no way to generate it.
We probably need a TypeOpenMetrics_0_0_1 or an optional version argument for the NewFormat func
There was a problem hiding this comment.
I see -- yup I can prep a PR
There was a problem hiding this comment.
it looks like I should also increase the test coverage -- I'll get to this next week. sorry for the breakage in the meantime!
These were removed upstream in prometheus/common#576
These were removed upstream in prometheus/common#576
The previous exposed constants are no longer exposed and we can use expfmt.Format instead. prometheus/common#576
* helper/metricsutil: Update usage of expfmt The previous exposed constants are no longer exposed and we can use expfmt.Format instead. prometheus/common#576 * reodered imports --------- Co-authored-by: Matthias Loibl <mail@matthiasloibl.com>
With the addition of the escaping term, format strings now have many permutations and doing direct string comparisons of formats is not reliable. Instead, users should call FormatType and compare the result against the possible enum values.
I am making this change after breaking a test in prometheus that relied on string matching of formats.