Document how to install prerequisites in examples READMEs

[chrisinmtown]

Add server url /openapi to JWT example
Add TODO to SQLAlchemy example, does not work with current versions
Correct name of module in v3 instructions

Fixes #1987

[chrisinmtown]

Please review this draft, if you like this approach I will extend to other README.rst files.

If it's not obvious, I'm trying to figure out how to work with you all. Baby steps :)

[RobbeSneyders]

Thanks @chrisinmtown, this looks good to me. Would be great to extend it to the other examples.

[chrisinmtown]

I am extending the changes to all the examples. Please check example sqlalchemy which has become a bit stale. I dropped the convert_unicode parameter in the create_engine function and then it started, but the first GET attempt yields this:

sqlite3.ProgrammingError: SQLite objects created in a thread can only be used in that same thread. The object was created in thread id 123145410666496 and this is thread id 140704480263680.

Do you have time for this?

[RobbeSneyders]

Let's leave that example as is for now then. Would be great if you could add a notice that it is outdated to the README.

For the other examples, the flask extra is not needed for most of them.

[chrisinmtown]

Let's leave that example as is for now then. Would be great if you could add a notice that it is outdated to the README.

I will ask the cloud a few questions and see if I can figure it out :)

For the other examples, the flask extra is not needed for most of them.

I see that Flask is not needed for enforcedefaults, frameworks and hello_async. I copy-pasted those a little too quickly, will adjust.

[chrisinmtown]

This PR has primarily documentation changes. I tweaked one API spec and one requirements file to make the examples work. Please consider.

[chrisinmtown]

Would you please give me an opinion here? It's a real challenge to contribute when people go silent for a full week at a time.

[coveralls]

coverage: 94.408%. remained the same
when pulling 98f0e3c on chrisinmtown:1987-doc-examples
into 58c8bb6 on spec-first:main.

[RobbeSneyders]

Sorry for the delay @chrisinmtown

Two small comments, then it's good to go for me.

[RobbeSneyders]

Suggested change

Flask>=0.10.1

[chrisinmtown]

Ok, dropped the Flask line from requirements.txt

[RobbeSneyders]

We should remove the flask and connexio dependencies from requirements.txt if we install them directly on the command line.

[chrisinmtown]

Ok, dropped the connexion and Flask lines from requirements.txt

[RobbeSneyders]

Thanks @chrisinmtown!

[chrisinmtown]

Thanks @chrisinmtown!

You're very welcome