Package: github.com/prometheus/client_golang/prometheus/internal

package internal Import Path github.com/prometheus/client_golang/prometheus/internal (on go.dev) Dependency Relation imports 13 packages, and imported by one package

Involved Source Files d almost_equal.go Copyright (c) 2015 Björn Rabenstein Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. The code in this package is copy/paste to avoid a dependency. Hence this file carries the copyright of the original repo. https://github.com/beorn7/floats d difflib.go Copyright 2022 The Prometheus Authors Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. It provides tools to compare sequences of strings and generate textual diffs. Maintaining `GetUnifiedDiffString` here because original repository (https://github.com/pmezard/go-difflib) is no longer maintained. go_collector_options.go go_runtime_metrics.go metric.go

Package-Level Functions (total 10)

func AlmostEqualFloat64(a, b, epsilon float64) bool AlmostEqualFloat64 returns true if a and b are equal within a relative error of epsilon. See http://floating-point-gui.de/errors/comparison/ for the details of the applied method.

func AlmostEqualFloat64s(a, b []float64, epsilon float64) bool AlmostEqualFloat64s is the slice form of AlmostEqualFloat64.

func GetUnifiedDiffString(diff UnifiedDiff) (string, error) Like WriteUnifiedDiff but returns the diff a string.

func NewMatcher(a, b []string) *SequenceMatcher

func NewMatcherWithJunk(a, b []string, autoJunk bool, isJunk func(string) bool) *SequenceMatcher

func NormalizeMetricFamilies(metricFamiliesByName map[string]*dto.MetricFamily) []*dto.MetricFamily NormalizeMetricFamilies returns a MetricFamily slice with empty MetricFamilies pruned and the remaining MetricFamilies sorted by name within the slice, with the contained Metrics sorted within each MetricFamily.

func RuntimeMetricsBucketsForUnit(buckets []float64, unit string) []float64 RuntimeMetricsBucketsForUnit takes a set of buckets obtained for a runtime/metrics histogram type (so, lower-bound inclusive) and a unit from a runtime/metrics name, and produces a reduced set of buckets. This function always removes any -Inf bucket as it's represented as the bottom-most upper-bound inclusive bucket in Prometheus.

func RuntimeMetricsToProm(d *metrics.Description) (string, string, string, bool) RuntimeMetricsToProm produces a Prometheus metric name from a runtime/metrics metric description and validates whether the metric is suitable for integration with Prometheus. Returns false if a name could not be produced, or if Prometheus does not understand the runtime/metrics Kind. Note that the main reason a name couldn't be produced is if the runtime/metrics package exports a name with characters outside the valid Prometheus metric name character set. This is theoretically possible, but should never happen in practice. Still, don't rely on it.

func SplitLines(s string) []string Split a string on "\n" while preserving them. The output can be used as input for UnifiedDiff and ContextDiff structures.

func WriteUnifiedDiff(writer io.Writer, diff UnifiedDiff) error Compare two sequences of lines; generate the delta as a unified diff. Unified diffs are a compact way of showing line changes and a few lines of context. The number of context lines is set by 'n' which defaults to three. By default, the diff control lines (those with ---, +++, or @@) are created with a trailing newline. This is helpful so that inputs created from file.readlines() result in diffs that are suitable for file.writelines() since both the inputs and outputs have trailing newlines. For inputs that do not have trailing newlines, set the lineterm argument to "" so that the output will be uniformly newline free. The unidiff format normally has a header for filenames and modification times. Any or all of these may be specified using strings for 'fromfile', 'tofile', 'fromfiledate', and 'tofiledate'. The modification times are normally expressed in the ISO 8601 format.

Package-Level Variables (only one)

var GoCollectorDefaultRuntimeMetrics *regexp.Regexp