prometheus
diff --git a/‎prometheus_client/openmetrics/exposition.py
Lines changed: 7 additions & 0 deletions b/‎prometheus_client/openmetrics/exposition.py
Lines changed: 7 additions & 0 deletions
diff --git a/‎prometheus_client/parser.py
Lines changed: 1 addition & 1 deletion b/‎prometheus_client/parser.py
Lines changed: 1 addition & 1 deletion
diff --git a/‎prometheus_client/validation.py
Lines changed: 20 additions & 1 deletion b/‎prometheus_client/validation.py
Lines changed: 20 additions & 1 deletion
@@ -93,16 +93,23 @@ def generate_latest(registry):
 
 
 def escape_metric_name(s: str) -> str:
+    """Escapes the metric name and puts it in quotes iff the name does not
+    conform to the legacy Prometheus character set.
+    """
     if _is_valid_legacy_metric_name(s):
         return s
     return '"{}"'.format(_escape(s))
 
 
 def escape_label_name(s: str) -> str:
+    """Escapes the label name and puts it in quotes iff the name does not
+    conform to the legacy Prometheus character set.
+    """
     if _is_valid_legacy_labelname(s):
         return s
     return '"{}"'.format(_escape(s))
 
 
 def _escape(s: str) -> str:
+    """Performs backslash escaping on \, \n, and " characters."""
     return s.replace('\\', r'\\').replace('\n', r'\n').replace('"', r'\"')
@@ -199,7 +199,7 @@ def _split_quoted(text, separator, maxsplit=0):
 
 
 def _unquote_unescape(text):
-    """Returns the string, and true if it was quoted"""
+    """Returns the string, and true if it was quoted."""
     if not text:
         return text, False
     quoted = False
 
@@ -15,6 +15,7 @@ def _init_legacy_validation() -> bool:
 
 
 def get_legacy_validation() -> bool:
+    """Return the current status of the legacy validation setting."""
     global _legacy_validation
     return _legacy_validation
 
@@ -32,6 +33,10 @@ def enable_legacy_validation():
 
 
 def _validate_metric_name(name: str) -> None:
+    """Raises ValueError if the provided name is not a valid metric name.
+    
+    This check uses the global legacy validation setting to determine the validation scheme.
+    """
     if not name:
         raise ValueError("metric name cannot be empty")
     global _legacy_validation
@@ -45,11 +50,15 @@ def _validate_metric_name(name: str) -> None:
 
 
 def _is_valid_legacy_metric_name(name: str) -> bool:
+    """Returns true if the provided metric name conforms to the legacy validation scheme."""
     return METRIC_NAME_RE.match(name) is not None
 
 
 def _validate_metric_label_name_token(tok: str) -> None:
-    """Check validity of a parsed label name token. UTF-8 names must be quoted."""
+    """Raises ValueError if a parsed label name token is invalid. 
+    
+    UTF-8 names must be quoted.
+    """
     if not tok:
         raise ValueError("invalid label name token " + tok)
     global _legacy_validation
@@ -65,6 +74,10 @@ def _validate_metric_label_name_token(tok: str) -> None:
 
 
 def _validate_labelname(l):
+    """Raises ValueError if the provided name is not a valid label name.
+    
+    This check uses the global legacy validation setting to determine the validation scheme.
+    """
     if get_legacy_validation():
         if not METRIC_LABEL_NAME_RE.match(l):
             raise ValueError('Invalid label metric name: ' + l)
@@ -80,12 +93,17 @@ def _validate_labelname(l):
 
 
 def _is_valid_legacy_labelname(l: str) -> bool:
+    """Returns true if the provided label name conforms to the legacy validation scheme."""
     if METRIC_LABEL_NAME_RE.match(l) is None:
         return False
     return RESERVED_METRIC_LABEL_NAME_RE.match(l) is None
 
 
 def _validate_labelnames(cls, labelnames):
+    """Raises ValueError if any of the provided names is not a valid label name.
+    
+    This check uses the global legacy validation setting to determine the validation scheme.
+    """
     labelnames = tuple(labelnames)
     for l in labelnames:
         _validate_labelname(l)
@@ -95,6 +113,7 @@ def _validate_labelnames(cls, labelnames):
 
 
 def _validate_exemplar(exemplar):
+    """Raises ValueError if the exemplar is invalid."""
     runes = 0
     for k, v in exemplar.items():
         _validate_labelname(k)