ch22: new README.md and minor edits

22-async/mojifinder/README.md

@@ -0,0 +1,41 @@
+# Mojifinder: Unicode character search examples
+
+Examples from _Fluent Python, Second Edition_—Chapter 22, _Asynchronous Programming_.
+
+## How to run `web_mojifinder.py`
+
+`web_mojifinder.py` is a Web application built with _[FastAPI](https://fastapi.tiangolo.com/)_.
+To run it, first install _FastAPI_ and an ASGI server.
+The application was tested with _[Uvicorn](https://www.uvicorn.org/)_.
+
+```
+$ pip install fastapi uvicorn
+```
+
+Now you can use `uvicorn` to run the app.
+
+```
+$ uvicorn web_mojifinder:app
+```
+
+Finally, visit http://127.0.0.1:8000/ with your browser to see the search form.
+
+
+## Directory contents
+
+These files can be run as scripts directly from the command line:
+
+- `charindex.py`: libray used by the Mojifinder examples. Also works as CLI search script.
+- `tcp_mojifinder.py`: TCP/IP Unicode search server. Depends only on the Python 3.9 standard library. Use a telnet application as client.
+- `web_mojifinder_bottle.py`: Unicode Web service. Depends on `bottle.py` and `static/form.html`. Use an HTTP browser as client.
+
+This program requires an ASGI server to run it:
+
+- `web_mojifinder.py`: Unicode Web service. Depends on _[FastAPI](https://fastapi.tiangolo.com/)_ and `static/form.html`.
+
+Support files:
+
+- `bottle.py`: local copy of the single-file _[Bottle](https://bottlepy.org/)_ Web framework.
+- `requirements.txt`: list of dependencies for `web_mojifinder.py`.
+- `static/form.html`: HTML form used by the `web_*` examples.
+- `README.md`: this file!

22-async/mojifinder/bottle.py

@@ -16,7 +16,7 @@ License: MIT (see LICENSE for details)
 from __future__ import with_statement
 
 __author__ = 'Marcel Hellkamp'
-__version__ = '0.12.18'
+__version__ = '0.12.19'
 __license__ = 'MIT'
 
 # The gevent server adapter needs to patch some modules before they are imported
@@ -440,7 +440,7 @@ class Router(object):
         nocheck = set(methods)
         for method in set(self.static) - nocheck:
             if path in self.static[method]:
-                allowed.add(verb)
+                allowed.add(method)
         for method in set(self.dyna_regexes) - allowed - nocheck:
             for combined, rules in self.dyna_regexes[method]:
                 match = combined(path)
@@ -2585,7 +2585,7 @@ def parse_range_header(header, maxlen=0):
 
 def _parse_qsl(qs):
     r = []
-    for pair in qs.replace(';','&').split('&'):
+    for pair in qs.split('&'):
         if not pair: continue
         nv = pair.split('=', 1)
         if len(nv) != 2: nv.append('')

22-async/mojifinder/requirements.txt

@@ -1,6 +1,7 @@
 click==7.1.2
 fastapi==0.63.0
 h11==0.12.0
-pydantic==1.7.3
+pydantic==1.8.1
 starlette==0.13.6
+typing-extensions==3.7.4.3
 uvicorn==0.13.4

22-async/mojifinder/web_mojifinder.py

@@ -1,4 +1,4 @@
-import pathlib
+from pathlib import Path
 from unicodedata import name
 
 from fastapi import FastAPI
@@ -18,9 +18,8 @@ class CharName(BaseModel):  # <2>
 
 def init(app):  # <3>
     app.state.index = InvertedIndex()
-    static = pathlib.Path(__file__).parent.absolute() / 'static'  # <4>
-    with open(static / 'form.html') as fp:
-        app.state.form = fp.read()
+    static = Path(__file__).parent.absolute() / 'static'  # <4>
+    app.state.form = (static / 'form.html').read_text()
 
 init(app)  # <5>
 
@@ -33,4 +32,4 @@ async def search(q: str):  # <7>
 def form():  # <9>
     return app.state.form
 
-# no main funcion  # <10>
+# no main funcion  # <10>

22-async/mojifinder/web_mojifinder_bottle.py

@@ -11,7 +11,7 @@ index = {}
 
 @route('/')
 def form():
-    return static_file('form.html', root = 'static/')
+    return static_file('form.html', root='static/')
 
 
 @route('/search')
@@ -28,10 +28,8 @@ def search():
 def main(port):
     global index
     index = InvertedIndex()
-    host = 'localhost'
     run(host='localhost', port=port, debug=True)
 
 
 if __name__ == '__main__':
     main(8000)
-