Removed unused import

Author: MrMatAP

README.md

@@ -17,21 +17,56 @@ Features:
 
 ## How to run this
 
-Start with `mrmat-python-api-flask`. You can specify `--host 0.0.0.0` to listen on a specific API and `--port PORT` to
-override the default 8080.
+You have the choice of running this directly or within a container image. To run this directly:
 
-Once started, you can do curl towards the greeting API at `/api/greeting/v1/` and `/api/greeting/v1/?name=Custom`.
-Note that omitting the last slash will cause a redirect that you can follow using curls -L option. We can probably
-get rid of that by using a more clever versioning scheme that doesn't make the root resource listen on / (e.g. `/greeting`).
+```
+$ python ./setup.py install
+$ mrmat-python-api-flask -h
+usage: mrmat-python-api-flask [-h] [-d] [--host HOST] [--port PORT]
 
-## How to test this
+mrmat-python-api-flask - 0.0.1
+
+optional arguments:
+  -h, --help   show this help message and exit
+  -d, --debug  Debug
+  --host HOST  Host interface to bind to
+  --port PORT  Port to bind to
+
+$ mrmat-python-api-flask --host 0.0.0.0 --port 8080
+ * Serving Flask app "mrmat_python_api_flask.app" (lazy loading)
+ * Environment: production
+   WARNING: This is a development server. Do not use it in a production deployment.
+   Use a production WSGI server instead.
+ * Debug mode: off
+ * Running on http://0.0.0.0:8080/ (Press CTRL+C to quit)
+ 
+<Ctrl-C>
+```
+
+To run within a container, first build that container:
 
-Pycharm built-in. If you do it on the CLI, you do need `python -m pytest`, otherwise it'll get confused about loading
-its modules. Also note that the API spec yaml must be added once more when testing in `conftest.py`. The obvious attempt
-to have that done straight within `mrmat_python_api_flask/app.py` outside main doesn't work (and I don't know why).
+```
+$ python ./setup.py sdist
+$ docker build -t mrmat-python-api-flask:0.0.1 -f var/docker/Dockerfile .
+...
+$ docker run --rm mrmat-python-api-flask:0.0.1
+...
+```
 
-## How to build this
+## How to use this
+
+Once started, you can curl towards the APIs mounted at various places. See the invocation of `app.register_blueprint`
+within `app/app.py` to find out where. 
+
+>Note that omitting the last slash will cause a redirect that you can follow using curls -L option. We can probably
+>get rid of that by using a more clever versioning scheme that doesn't make the root resource listen on / (e.g. `/greeting`).
+
+## How to test this
 
-See the provided Dockerfile in `var/docker`. This requires that you have run `python ./setup.py sdist` as a prerequisite
-and will create a container image in which the application is run within a production-ready WSGI server.
+Unit tests are within the `tests` directory. You can use the built-in Pycharm test configuration or do it on the CLI.
 
+```
+$ python ./setup.py install
+$ python -m flake8
+$ python -m pytest
+```