Document parser

brian-brazil · brian-brazil · commit 60c0d7e316e1 · 2015-10-09T14:01:31.000+01:00
diff --git a/README.md b/README.md
@@ -317,3 +317,19 @@ REGISTRY.register(CustomCollector())
 
 `SummaryMetricFamily` and `HistogramMetricFamily` work similarly.
 
+
+## Parser
+
+The Python client supports parsing the Promeheus text format.
+This is intended for advanced use cases where you have servers 
+exposing Prometheus metrics and need to get them into some other
+system.
+
+```
+from prometheus_client.parser import text_string_to_metric_families
+for family in text_string_to_metric_families("my_gauge 1.0\n"):
+  for sample in family.samples:
+    print("Name: {0} Labels: {1} Value: {2}".format(*sample))
+```
+
+
