From a7affe5939e4d2e219988600291482a5f50e68a0 Mon Sep 17 00:00:00 2001
From: jaydenelliott <jayden.elliott@outlook.com>
Date: Tue, 14 Mar 2023 11:56:02 +1100
Subject: [PATCH] Add .get() to Family hashmap wrapper

Signed-off-by: jaydenelliott <jayden.elliott@outlook.com>
---
 src/metrics/family.rs | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/metrics/family.rs b/src/metrics/family.rs
index 3b70eeb9..066ecacf 100644
--- a/src/metrics/family.rs
+++ b/src/metrics/family.rs
@@ -248,6 +248,23 @@ impl<S: Clone + std::hash::Hash + Eq, M, C: MetricConstructor<M>> Family<S, M, C
         })
     }
 
+    /// Access a metric with the given label set, returning None if one
+    /// does not yet exist.
+    ///
+    /// ```
+    /// # use prometheus_client::metrics::counter::{Atomic, Counter};
+    /// # use prometheus_client::metrics::family::Family;
+    /// #
+    /// let family = Family::<Vec<(String, String)>, Counter>::default();
+    ///
+    /// if let Some(metric) = family.get(&vec![("method".to_owned(), "GET".to_owned())]) {
+    ///     metric.inc();
+    /// };
+    /// ```
+    pub fn get(&self, label_set: &S) -> Option<MappedRwLockReadGuard<M>> {
+        RwLockReadGuard::try_map(self.metrics.read(), |metrics| metrics.get(label_set)).ok()
+    }
+
     /// Remove a label set from the metric family.
     ///
     /// Returns a bool indicating if a label set was removed or not.