docs(recipes): add text/plain media handler recipe

examples/recipes/plain_text_main.py

@@ -0,0 +1,21 @@
+import cgi
+import functools
+
+import falcon
+
+
+class TextHandler(falcon.media.BaseHandler):
+    DEFAULT_CHARSET = 'utf-8'
+
+    @classmethod
+    @functools.lru_cache
+    def _get_charset(cls, content_type):
+        _, params = cgi.parse_header(content_type)
+        return params.get('charset') or cls.DEFAULT_CHARSET
+
+    def deserialize(self, stream, content_type, content_length):
+        data = stream.read()
+        return data.decode(self._get_charset(content_type))
+
+    def serialize(self, media, content_type):
+        return media.encode(self._get_charset(content_type))

tests/test_recipes.py

@@ -141,3 +141,28 @@ def test_raw_path(self, asgi, app_kind, util):
         )
         assert result2.status_code == 200
         assert result2.json == {'cached': True}
+
+
+class TestTextPlainHandler:
+    class MediaEcho:
+        def on_post(self, req, resp):
+            resp.content_type = req.content_type
+            resp.media = req.get_media()
+
+    def test_text_plain_basic(self, util):
+        recipe = util.load_module('examples/recipes/plain_text_main.py')
+
+        app = falcon.App()
+        app.req_options.media_handlers['text/plain'] = recipe.TextHandler()
+        app.resp_options.media_handlers['text/plain'] = recipe.TextHandler()
+
+        app.add_route('/media', self.MediaEcho())
+
+        client = falcon.testing.TestClient(app)
+        payload = 'Hello, Falcon!'
+        headers = {'Content-Type': 'text/plain'}
+        response = client.simulate_post('/media', body=payload, headers=headers)
+
+        assert response.status_code == 200
+        assert response.content_type == 'text/plain'
+        assert response.text == payload