From 6e109a964383bfe5e2be04f65fa7cc1356a97cbe Mon Sep 17 00:00:00 2001 From: adamw Date: Tue, 17 Oct 2017 17:28:50 +0200 Subject: More docs --- docs/backends/tagging.rst | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 docs/backends/tagging.rst (limited to 'docs/backends/tagging.rst') diff --git a/docs/backends/tagging.rst b/docs/backends/tagging.rst new file mode 100644 index 0000000..15773ff --- /dev/null +++ b/docs/backends/tagging.rst @@ -0,0 +1,9 @@ +Request tagging +=============== + +Each request contains a ``tags: Map[String, Any]`` map. This map can be used to tag the request with any backend-specific information, and isn't used in any way by sttp itself. + +Tags can be added to a request using the ``def tag(k: String, v: Any)`` method, and read using the ``def tag(k: String): Option[Any]`` method. + +Backends, or :ref:`backend wrappers ` can use tags e.g. for logging, passing a metric name, using different connection pools, or even different delegate backends. + -- cgit v1.2.3