* Remove `-a/--app` from Quickstart documentation
As mentioned in #2009, simplifying the CLI saw the removal of the `-a/--app` flag. Therefore, the only way to specify the module to import is by setting `FLASK_APP`.
* Remove misleading `either` from CLI help
The CLI help details how to run the application, but still uses the phrasing "either through the `FLASK_APP`...". This likely is an artifact from when `-a/--app` was still present in the CLI.
* Distinguish between directories and files
* Convert larger apps to make use of setup.py
- replaces runserver.py with setup.py
- example now runs with recommended structure
* Fixes a typo and formats the added paragraph
* Clean up tutorial docs for installable app pattern
- reading sequentially through the tutorial works.
- fixes references to `export FLASK_APP=flaskr.flaskr`
* Fixes titles for each section of flaskr tutorial
* Revert grammar
* Emphasize the Packaging Guide
- adds more general packaging resource
- removes the emphasis put on setuptools
* rephrase and remove note admonitions
- expanded on few points
- removed note blocks, they are unneccessary
* Remove note about reinstalling to update cli
- I had mistakenly thought it was necessary to
re-install the app to update the cli.
- the `--editable` flag detects the change and
the cli updates without issue.
* Converts example/flaskr to have a setup.py
Makes the flaskr app easier to run, ex. workflow:
- pip install --editable .
- export FLASK_APP=flaskr.flaskr
- flask initdb
- flask run
Testing is also easier now:
- python setup.py test
* Fixed an import error in flaskr/tests
- the statement `import flaskr` caused errors in python3
- `from . import flaskr` fixes the issue in 2.7.11 and 3.5.1
* Better project structure and updates the docs
- Re-factors *flaskr*'s project structure a bit
- Updates docs to make sense with the new structure
- Adds a new step about installing Flask apps with setuptools
- Switches first-person style writing to second-person (reads better IMO)
- Adds segments in *testing.rst* for running tests with setuptools
* Remove __init__.py from tests
- py.test recommends not using __init__.py
* Fix testing import errors
* Clarify instructions about changing row_factory
When I was working through the tutorial, this was very confusing to me; so, I've added the code and clarification that would have helped me get through it faster.
* Clarify the nature of Row objects
* Rewrite code example for further clarity.