https://github.com/microsoft/python-sample-vscode-flask-tutorial
Sample code for the Flask tutorial in the VS Code documentation
https://github.com/microsoft/python-sample-vscode-flask-tutorial
Last synced: 1 day ago
JSON representation
Sample code for the Flask tutorial in the VS Code documentation
- Host: GitHub
- URL: https://github.com/microsoft/python-sample-vscode-flask-tutorial
- Owner: microsoft
- License: mit
- Created: 2018-05-14T17:35:19.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2024-08-20T06:37:50.000Z (8 months ago)
- Last Synced: 2025-04-06T10:01:48.193Z (8 days ago)
- Language: HTML
- Homepage: https://code.visualstudio.com/docs/python/tutorial-flask
- Size: 50.8 KB
- Stars: 359
- Watchers: 30
- Forks: 5,637
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- jimsghstars - microsoft/python-sample-vscode-flask-tutorial - Sample code for the Flask tutorial in the VS Code documentation (HTML)
README
# Python/Flask Tutorial for Visual Studio Code
* This sample contains the completed program from the tutorial, make sure to visit the link: [Using Flask in Visual Studio Code](https://code.visualstudio.com/docs/python/tutorial-flask). Intermediate steps are not included.
* It also contains the *Dockerfile* and *uwsgi.ini* files necessary to build a container with a production server. The resulting image works both locally and when deployed to Azure App Service. See [Deploy Python using Docker containers](https://code.visualstudio.com/docs/python/tutorial-deploy-containers).
* To run the app locally:
1. Run the command `cd hello_app`, to change into the folder that contains the Flask app.
1. Run the command `set FLASK_APP=webapp` (Windows cmd) or `FLASK_APP=webapp` (macOS/Linux) to point to the app module.
1. Start the Flask server with `flask run`.
## The startup.py file
In the root folder, the `startup.py` file is specifically for deploying to Azure App Service on Linux without using a containerized version of the app (that is, deploying the code directly, not as a container).
Because the app code is in its own *module* in the `hello_app` folder (which has an `__init__.py`), trying to start the Gunicorn server within App Service on Linux produces an "Attempted relative import in non-package" error.
The `startup.py` file, therefore, is a shim to import the app object from the `hello_app` module, which then allows you to use startup:app in the Gunicorn command line (see `startup.txt`).
## Contributing
Contributions to the sample are welcome. When submitting changes, also consider submitting matching changes to the tutorial, the source file for which is [tutorial-flask.md](https://github.com/Microsoft/vscode-docs/blob/master/docs/python/tutorial-flask.md).
Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot automatically determines whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
## Additional details
* This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
* For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
* Contact [[email protected]](mailto:[email protected]) with any additional questions or comments.