doc: split after_request in flask integration

Author: azmeuk

doc/guides/_examples/flask_example.py

@@ -38,14 +38,9 @@
 
 
 @bp.after_request
-def scim_after_request(response):
-    """Set the SCIM media type, extract ETag, and handle conditional responses."""
+def set_scim_content_type(response):
+    """Expose every endpoint with the SCIM media type."""
     response.headers["Content-Type"] = "application/scim+json"
-    data = response.get_json(silent=True)
-    if meta := (data or {}).get("meta"):
-        if version := meta.get("version"):
-            response.headers["ETag"] = version
-    response.make_conditional(request)
     return response
 
 
@@ -56,6 +51,17 @@ def resource_location(app_record):
 
 
 # -- etag-start --
+@bp.after_request
+def set_etag_header(response):
+    """Extract ``ETag`` from ``meta.version`` and handle conditional responses."""
+    data = response.get_json(silent=True)
+    if meta := (data or {}).get("meta"):
+        if version := meta.get("version"):
+            response.headers["ETag"] = version
+    response.make_conditional(request)
+    return response
+
+
 @bp.before_request
 def check_etag():
     """Verify ``If-Match`` on write operations.

doc/guides/flask.rst

@@ -23,9 +23,8 @@ The complete runnable file is available in the `Complete example`_ section.
 Blueprint setup
 ===============
 
-Start with a Flask blueprint.
-The SCIM specifications indicates that the responses content type must be ``application/scim+json``,
-so lets enforce this on all the blueprint views with :meth:`~flask.Blueprint.after_request`.
+Start with a Flask blueprint and an :meth:`~flask.Blueprint.after_request` hook that
+sets the ``application/scim+json`` content type on every response.
 
 .. literalinclude:: _examples/flask_example.py
    :language: python