docs: add recipe for stderr

Fixes #551
hynek · Oct 9, 2023 · c172022 · c172022
1 parent 37f663e
commit c172022
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/docs/recipes.md b/docs/recipes.md
@@ -186,3 +186,12 @@ def manager(request_id: str):
 ```
 
 See the [issue 425](https://github.com/hynek/structlog/issues/425) for a more complete example.
+
+
+## Switching Console Output to Standard Error
+
+When using structlog without standard library integration and want the log output to go to standard error (*stderr*) instead of standard out (*stdout*), you can switch with a single line of configuration:
+
+```python
+structlog.configure(logger_factory=structlog.PrintLoggerFactory(sys.stderr))
+```