forked from orbit-oss/flask
9bf5c3b3a3
new readme readme as setup.py long_description links in changes git in authors add travis osx env break out docs build in travis remove python_requires for now
62 lines
1.5 KiB
ReStructuredText
62 lines
1.5 KiB
ReStructuredText
Flask
|
|
=====
|
|
|
|
Flask is a lightweight `WSGI`_ web application framework. It is designed
|
|
to make getting started quick and easy, with the ability to scale up to
|
|
complex applications. It began as a simple wrapper around `Werkzeug`_
|
|
and `Jinja`_ and has become one of the most popular Python web
|
|
application frameworks.
|
|
|
|
Flask offers suggestions, but doesn't enforce any dependencies or
|
|
project layout. It is up to the developer to choose the tools and
|
|
libraries they want to use. There are many extensions provided by the
|
|
community that make adding new functionality easy.
|
|
|
|
|
|
Installing
|
|
----------
|
|
|
|
Install and update using `pip`_:
|
|
|
|
.. code-block:: text
|
|
|
|
pip install -U Flask
|
|
|
|
|
|
A Simple Example
|
|
----------------
|
|
|
|
.. code-block:: python
|
|
|
|
from flask import Flask
|
|
|
|
app = Flask(__name__)
|
|
|
|
@app.route('/')
|
|
def hello():
|
|
return 'Hello, World!'
|
|
|
|
.. code-block:: none
|
|
|
|
$ FLASK_APP=hello.py flask run
|
|
* Running on http://localhost:5000/
|
|
|
|
|
|
Links
|
|
-----
|
|
|
|
* Website: https://www.palletsprojects.com/p/flask/
|
|
* Releases: https://pypi.org/project/Flask/
|
|
* Code: https://github.com/pallets/flask
|
|
* Issue tracker: https://github.com/pallets/flask/issues
|
|
* Test status:
|
|
|
|
* Linux, Mac: https://travis-ci.org/pallets/flask
|
|
* Windows: https://ci.appveyor.com/project/pallets/flask
|
|
|
|
* Test coverage: https://codecov.io/gh/pallets/flask
|
|
|
|
.. _WSGI: https://wsgi.readthedocs.io
|
|
.. _Werkzeug: https://www.palletsprojects.com/p/werkzeug/
|
|
.. _Jinja: https://www.palletsprojects.com/p/jinja/
|
|
.. _pip: https://pip.pypa.io/en/stable/quickstart/
|