Initial prototype.

1 files changed, 35 insertions, 0 deletions

diff --git a/scrape.h b/scrape.h
new file mode 100644
index 0000000..fc4e18b
--- /dev/null
+++ b/scrape.h
@@ -0,0 +1,35 @@
+#ifndef PNANOE_SCRAPE_H_
+#define PNANOE_SCRAPE_H_ 1
+
+#include <stdbool.h>
+#include <stddef.h>
+
+/** Opaque type to represent an ongoing scrape request. */
+typedef struct scrape_req scrape_req;
+
+/** Function type for a scrape server callback. */
+typedef void scrape_handler(scrape_req *req, void *ctx);
+
+/** Starts a scrape server in the given port. */
+bool scrape_serve(const char *port, scrape_handler *handler, void *handler_ctx);
+
+/**
+ * Writes a metric value as a response to a scrape.
+ *
+ * The \p labels parameter can be `NULL` if no extra labels need to be attached. If not null, it
+ * should point at the first element of an array of 2-element arrays of pointers, where the first
+ * element of each pair is the label name, and the second the label value. A pair of null pointers
+ * terminates the label array.
+ *
+ * Returns `false` if setting up the server failed, otherwise does not return.
+ */
+void scrape_write(scrape_req *req, const char *metric, const char *(*labels)[2], double value);
+
+/**
+ * Writes raw data to the scrape response.
+ *
+ * It's the callers responsibility to make sure it writes syntactically valid metric data.
+ */
+void scrape_write_raw(scrape_req *req, const void *buf, size_t len);
+
+#endif // PNANOE_SCRAPE_H_