Difference between revisions of "Flask"
m (→Basics) |
|||
(16 intermediate revisions by the same user not shown) | |||
Line 37: | Line 37: | ||
Mayor part is from this site [https://vladikk.com/2013/09/12/serving-flask-with-nginx-on-ubuntu/]. | Mayor part is from this site [https://vladikk.com/2013/09/12/serving-flask-with-nginx-on-ubuntu/]. | ||
− | + | * Install [[uwsgi]]. | |
− | * | + | * Create a virtual webserver (port 80 is save enough if you have a secure front-end server) |
+ | |||
+ | <syntaxhighlight lang="nginx"> | ||
+ | server { | ||
+ | listen 80 ; | ||
+ | listen [::]:80; | ||
+ | |||
+ | root /var/www/flask; | ||
+ | server_name <fqdn>; | ||
+ | |||
+ | location /app1 { | ||
+ | include uwsgi_params; | ||
+ | uwsgi_param SCRIPT_NAME /app1; | ||
+ | uwsgi_modifier1 30; | ||
+ | uwsgi_pass unix://tmp/app1.sock; | ||
+ | } | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | ===Super simple app=== | ||
+ | In /var/www/flask/app1/app1.py | ||
+ | <syntaxhighlight lang=python> | ||
+ | #!/usr/bin/env python3 | ||
+ | |||
+ | from flask import Flask | ||
+ | import os | ||
− | + | application = Flask(__name__) | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | @application.route('/app1') | |
+ | def app1(): | ||
+ | return "App 1 live and kicking" | ||
− | + | if __name__ == '__main__': | |
− | + | application.run(host='0.0.0.0', port=8080,debug=True) | |
− | + | </syntaxhighlight> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | That's it. Point your webbrowser to http://<your webserver fdqn>/app1</code> and it will show you: "App 1 live and kicking" | |
− | + | ||
+ | =Running applications= | ||
+ | You can make any number of applications by adding more apps to [[uwsgi]] and a location in [[nginx]]. You can also run any number of programs by adding routes to an app or with just a few routes like this: | ||
+ | <syntaxhighlight lang=python> | ||
+ | #!/usr/bin/env python3 | ||
− | + | from flask import Flask, render_template | |
− | + | import os | |
− | + | import subprocess | |
− | |||
− | + | ### Application whitelist | |
+ | whitelist = { | ||
+ | 'script as in URL' :'<scriptlocation>', | ||
+ | 'script as in URL' :'<another scriptlocation>', | ||
+ | } | ||
+ | |||
+ | application = Flask(__name__) | ||
− | + | @application.route('/app1/<script>/<path:arguments>') | |
+ | def func1(script,arguments): | ||
+ | if script in whitelist: | ||
+ | arglist = arguments.split('/') | ||
+ | result = subprocess.run([whitelist[script]]+arglist, stdout=subprocess.PIPE) | ||
+ | output = result.stdout | ||
+ | else: | ||
+ | output = '{} does not exist in whitelist'.format(script) | ||
+ | return output | ||
+ | |||
+ | @application.route('/app1/<script>') | ||
+ | def func2(script): | ||
+ | if script in whitelist: | ||
+ | result = subprocess.run([whitelist[script]], stdout=subprocess.PIPE) | ||
+ | output = result.stdout | ||
+ | else: | ||
+ | output = '{} does not exist in whitelist'.format(script) | ||
+ | return output | ||
− | + | if __name__ == '__main__': | |
− | + | application.run(host='0.0.0.0', port=8080,debug=True) | |
− | |||
− | |||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
− | = | + | The route is the request URI as passed by the webserver. In this case 'app1' is the location. The things in <> are converted to python variables. <path:arguments> will put everything, including the '/'-es into 1 variable (arguments). So you can have a variable number of arguments that all will be passed to the pythonscript called by subprocess. |
− | https://flask.palletsprojects.com/en/ | + | |
+ | The whitelist is there for security to avoid one can run any script is knows the location for. | ||
+ | |||
+ | =Generate web pages= | ||
+ | |||
+ | Flask is by default using the [https://jinja.palletsprojects.com jinja] template engine. They have a nice tutorial for this too[https://flask.palletsprojects.com/en/2.0.x/tutorial/]. | ||
+ | |||
+ | Very simple example is to put a index.html in <code><app-base>/templates/</code> | ||
+ | |||
+ | <syntaxhighlight lang=python> | ||
+ | #!/usr/bin/env python3 | ||
+ | |||
+ | from flask import Flask, render_template | ||
+ | |||
+ | print(__name__) | ||
+ | app = Flask(__name__) | ||
+ | |||
+ | @app.route('/app1/html') | ||
+ | def static_page(): | ||
+ | return render_template('index.html') | ||
+ | |||
+ | if __name__ == '__main__': | ||
+ | app.run(host='0.0.0.0',port=5000,debug=True) | ||
+ | |||
+ | </syntaxhighlight> |
Latest revision as of 08:56, 21 July 2021
Basics
Check this[1]
Hello world app:
#!/usr/bin/env python3
from flask import Flask
print(__name__)
app = Flask(__name__)
@app.route('/')
def welcome():
return 'Welcome'
if __name__ == '__main__': # When executed on the commandline (build in webserver)
app.run(host='0.0.0.0',port=5000) # Listen to localhost port 5000, you can also use flask run for options
#app.run(host='0.0.0.0',port=8080,Debug=True) # Run in debug mode, listen to all hosts on port 8080
Run the build-in server listening to all
export FLASK_APP=welcome_app.py
flask run --host=0.0.0.0
welcome_app * Serving Flask app "welcome_app" * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
Now you can browse to <serverIP>:5000
Integrate with nginx
Mayor part is from this site [2].
- Install uwsgi.
- Create a virtual webserver (port 80 is save enough if you have a secure front-end server)
server {
listen 80 ;
listen [::]:80;
root /var/www/flask;
server_name <fqdn>;
location /app1 {
include uwsgi_params;
uwsgi_param SCRIPT_NAME /app1;
uwsgi_modifier1 30;
uwsgi_pass unix://tmp/app1.sock;
}
}
Super simple app
In /var/www/flask/app1/app1.py
#!/usr/bin/env python3
from flask import Flask
import os
application = Flask(__name__)
@application.route('/app1')
def app1():
return "App 1 live and kicking"
if __name__ == '__main__':
application.run(host='0.0.0.0', port=8080,debug=True)
That's it. Point your webbrowser to http://<your webserver fdqn>/app1 and it will show you: "App 1 live and kicking"
Running applications
You can make any number of applications by adding more apps to uwsgi and a location in nginx. You can also run any number of programs by adding routes to an app or with just a few routes like this:
#!/usr/bin/env python3
from flask import Flask, render_template
import os
import subprocess
### Application whitelist
whitelist = {
'script as in URL' :'<scriptlocation>',
'script as in URL' :'<another scriptlocation>',
}
application = Flask(__name__)
@application.route('/app1/<script>/<path:arguments>')
def func1(script,arguments):
if script in whitelist:
arglist = arguments.split('/')
result = subprocess.run([whitelist[script]]+arglist, stdout=subprocess.PIPE)
output = result.stdout
else:
output = '{} does not exist in whitelist'.format(script)
return output
@application.route('/app1/<script>')
def func2(script):
if script in whitelist:
result = subprocess.run([whitelist[script]], stdout=subprocess.PIPE)
output = result.stdout
else:
output = '{} does not exist in whitelist'.format(script)
return output
if __name__ == '__main__':
application.run(host='0.0.0.0', port=8080,debug=True)
The route is the request URI as passed by the webserver. In this case 'app1' is the location. The things in <> are converted to python variables. <path:arguments> will put everything, including the '/'-es into 1 variable (arguments). So you can have a variable number of arguments that all will be passed to the pythonscript called by subprocess.
The whitelist is there for security to avoid one can run any script is knows the location for.
Generate web pages
Flask is by default using the jinja template engine. They have a nice tutorial for this too[3].
Very simple example is to put a index.html in <app-base>/templates/
#!/usr/bin/env python3
from flask import Flask, render_template
print(__name__)
app = Flask(__name__)
@app.route('/app1/html')
def static_page():
return render_template('index.html')
if __name__ == '__main__':
app.run(host='0.0.0.0',port=5000,debug=True)