6 ms·

One tip if you are about to write your first large (well, larger than 500 lines of code) Flask application: check some example applications for ideas of separat

by gedrap 10y ago

One tip if you are about to write your first large (well, larger than 500 lines of code) Flask application: check some example applications for ideas of separation/architecture and some popular modules. The minimalist nature of Flask, not forcing you to do things in one way and one way only, gives lots of power, but also lots of chances to mess it up and end up with a totally unmaintainable crap. Great power comes with great responsibility. Personally, I quite liked https://github.com/mattupstate/overholt https://github.com/mattupstate/overholt (although some dependencies are out dated!). Also, having some starting point with the boilerplate code already in place helps you to prototype faster, etc. Speaking of modules, the Flask modules ecosystem is pretty great and familiarizing yourself with it might save plenty of time you'd spend on re-implementing them. Some popular modules that are worth mentioning: 1) Flask-assets https://flask-assets.readthedocs.io/en/latest/ https://flask-assets.readthedocs.io/en/latest/ allows to easily integrate processing of the assets (JS minification, SASS compilation, etc) into your development pipeline; 2) Flask-login https://github.com/maxcountryman/flask-login https://github.com/maxcountryman/flask-login simple users management (roles, authentication, etc.); 3) Flask-SQLAlchemy http://flask-sqlalchemy.pocoo.org/2.1/ http://flask-sqlalchemy.pocoo.org/2.1/ simple integration with SQLAlchemy 4) Flask-Script https://flask-script.readthedocs.io/en/latest/ https://flask-script.readthedocs.io/en/latest/ makes it easy to write command line tools which run in the context of Flask application (e.g. some cron jobs).

jdnier 10y ago
From the release notes, it appears flask.cli may be intended to replace Flask-Script (4): "Added flask and the flask.cli module to start the local debug server through the click CLI system. This is recommended over the old flask.run() method as it works faster and more reliable due to a different design and also replaces Flask-Script."
- gedrap 10y ago
  Yeah, forgot to mention it when writing :)
anantzoid 10y ago
I also like https://github.com/svenstaro/flamejam/ https://github.com/svenstaro/flamejam/ as a good example of Flask architecture. It's simple and maintainable. I wrote a 4k+ loc app using a similar pattern and it still remains quite easy to handle.
- Svenstaro 10y ago
  I'm the author of that so if anyone has any questions feel free to shoot. Generally, the project is quite old but I still build flask application in quite the same manner as that. You can see the project running at https://bacongamejam.org https://bacongamejam.org
pbreit 10y ago
Is there a decent Flask bootstrap? I've never been able to get in to Flask because there's so little provide out-of-the-box. I'd be looking for user accounts, admin, form handling, basic crud, sqlite, db schema/migrations. I'd love a re-write of http://web2py.com http://web2py.com that conforms to pythonista expectations.
- jsmthrowaway 10y ago
  That's Django. You'd pick Django for those, Flask if you don't need them or want to do them yourself. Werkzeug if you want to do even more yourself, which I have found useful on a couple occasions. It's the flexibility versus batteries included tradeoff, and I don't think it's a negative that Flask doesn't ship most of that. You could probably somewhat get there with a number of third party additions (gedrap mentioned some) but you might as well use Django if you find yourself needing that stuff baked in.
- klenwell 10y ago
  There's also this skeleton for Google App Engine: https://github.com/GoogleCloudPlatform/appengine-python-flask-skeleton/ https://github.com/GoogleCloudPlatform/appengine-python-flas... This got me going with Flask. It's not quite everything you asked for but it lays a foundation upon which to build and explore the different features you've listed. And App Engine's free tier provides a nice platform for prototyping and simplifies deployment.
- ci5er 10y ago
  You appear to be asking to turn Flask into Django, but this gets you most of the way on that specific list: - https://github.com/sloria/cookiecutter-flask https://github.com/sloria/cookiecutter-flask
  - jaza 10y ago
    Big thumbs up to cookiecutter-flask. I've built several mid-size Flask apps with it over the past year or so, and I find that it lays a great foundation, for what is in my case a typical setup (e.g. Bootstrap based UI, SQLAlchemy based back-end, simple user accounts). It's well-maintained at the moment, too. When building a new app, first: cookiecutter https://github.com/sloria/cookiecutter-flask.git Then customise all you want.
kevan 10y ago
Seconded. I ended up spending several days trying to re-organize my first decent-sized Flask project when I tried to add a different config for testing. On the next project I started with a template that handled the boilerplate bits like app factories and test structure and it went much smoother.
welder 10y ago
Please don't recommend Flask-Assets, JAC is so much better: https://github.com/jaysonsantos/jinja-assets-compressor https://github.com/jaysonsantos/jinja-assets-compressor
- e12e 10y ago
  Could you expand on why you think so?
  - welder 10y ago
    Basically it's django-compressor[1] for Flask. That means automatic detection of static assets from your template files. Flask-Assets makes you list every static file in a giant config, aka registering your assets in bundles. There is no need for that mess. [1] https://django-compressor.readthedocs.io/en/latest/ https://django-compressor.readthedocs.io/en/latest/
doomrobo 10y ago
I've used some example architectures in the past while making a relatively small but very detail-oriented Flask app. I found that testing was a nightmare because my errors were only triggered on runtime. So I ended up having to manually test each code path in order to make sure I didn't have something as simple as a type error in my code. Static analysis helped a bit, but it's not as rigorous as a proper type system. Do you have any advice for this situation? It turned me off of web development in Python almost entirely.
- gedrap 10y ago
  What exactly do you mean by 'errors were only triggered on runtime'?
- RussianCow 10y ago
  I'm not sure I really understand what you're saying, but in any case, this is a problem with any dynamically typed language, and isn't in any way specific to Flask or even Python. If writing applications without the guarantees of a "proper type system" is painful for you, then Python is probably the wrong language. That said, you shouldn't have to manually test anything—that's what automated tests are for. With regard to testing Flask applications specifically, there is a guide[0] in the docs that covers everything you need to get started. [0]: http://flask.pocoo.org/docs/0.11/testing/ http://flask.pocoo.org/docs/0.11/testing/
- kerkeslager 10y ago
  Are you unit testing?
  - doomrobo 10y ago
    I wasn't, but I guess this is the only solution. The biggest reason I didn't unit test was that most of my functions were dependent on a significant amount of internal state. I suppose I should have spent more time coming up with mock models to use during unit tests. Also separating functionality would have made things easier.
    - 10y ago

by gedrap 10y ago

jdnier 10y ago

From the release notes, it appears flask.cli may be intended to replace Flask-Script (4): "Added flask and the flask.cli module to start the local debug server through the click CLI system. This is recommended over the old flask.run() method as it works faster and more reliable due to a different design and also replaces Flask-Script."

gedrap 10y ago
Yeah, forgot to mention it when writing :)

anantzoid 10y ago

I also like https://github.com/svenstaro/flamejam/ https://github.com/svenstaro/flamejam/ as a good example of Flask architecture. It's simple and maintainable. I wrote a 4k+ loc app using a similar pattern and it still remains quite easy to handle.

Svenstaro 10y ago
I'm the author of that so if anyone has any questions feel free to shoot. Generally, the project is quite old but I still build flask application in quite the same manner as that. You can see the project running at https://bacongamejam.org https://bacongamejam.org

pbreit 10y ago

Is there a decent Flask bootstrap? I've never been able to get in to Flask because there's so little provide out-of-the-box. I'd be looking for user accounts, admin, form handling, basic crud, sqlite, db schema/migrations. I'd love a re-write of http://web2py.com http://web2py.com that conforms to pythonista expectations.

jsmthrowaway 10y ago
That's Django. You'd pick Django for those, Flask if you don't need them or want to do them yourself. Werkzeug if you want to do even more yourself, which I have found useful on a couple occasions. It's the flexibility versus batteries included tradeoff, and I don't think it's a negative that Flask doesn't ship most of that. You could probably somewhat get there with a number of third party additions (gedrap mentioned some) but you might as well use Django if you find yourself needing that stuff baked in.
klenwell 10y ago
There's also this skeleton for Google App Engine: https://github.com/GoogleCloudPlatform/appengine-python-flask-skeleton/ https://github.com/GoogleCloudPlatform/appengine-python-flas... This got me going with Flask. It's not quite everything you asked for but it lays a foundation upon which to build and explore the different features you've listed. And App Engine's free tier provides a nice platform for prototyping and simplifies deployment.
ci5er 10y ago
You appear to be asking to turn Flask into Django, but this gets you most of the way on that specific list: - https://github.com/sloria/cookiecutter-flask https://github.com/sloria/cookiecutter-flask
- jaza 10y ago
  Big thumbs up to cookiecutter-flask. I've built several mid-size Flask apps with it over the past year or so, and I find that it lays a great foundation, for what is in my case a typical setup (e.g. Bootstrap based UI, SQLAlchemy based back-end, simple user accounts). It's well-maintained at the moment, too. When building a new app, first: cookiecutter https://github.com/sloria/cookiecutter-flask.git Then customise all you want.

kevan 10y ago

Seconded. I ended up spending several days trying to re-organize my first decent-sized Flask project when I tried to add a different config for testing. On the next project I started with a template that handled the boilerplate bits like app factories and test structure and it went much smoother.

welder 10y ago

Please don't recommend Flask-Assets, JAC is so much better: https://github.com/jaysonsantos/jinja-assets-compressor https://github.com/jaysonsantos/jinja-assets-compressor

e12e 10y ago
Could you expand on why you think so?
- welder 10y ago
  Basically it's django-compressor[1] for Flask. That means automatic detection of static assets from your template files. Flask-Assets makes you list every static file in a giant config, aka registering your assets in bundles. There is no need for that mess. [1] https://django-compressor.readthedocs.io/en/latest/ https://django-compressor.readthedocs.io/en/latest/

doomrobo 10y ago

I've used some example architectures in the past while making a relatively small but very detail-oriented Flask app. I found that testing was a nightmare because my errors were only triggered on runtime. So I ended up having to manually test each code path in order to make sure I didn't have something as simple as a type error in my code. Static analysis helped a bit, but it's not as rigorous as a proper type system. Do you have any advice for this situation? It turned me off of web development in Python almost entirely.

gedrap 10y ago
What exactly do you mean by 'errors were only triggered on runtime'?
RussianCow 10y ago
I'm not sure I really understand what you're saying, but in any case, this is a problem with any dynamically typed language, and isn't in any way specific to Flask or even Python. If writing applications without the guarantees of a "proper type system" is painful for you, then Python is probably the wrong language. That said, you shouldn't have to manually test anything—that's what automated tests are for. With regard to testing Flask applications specifically, there is a guide[0] in the docs that covers everything you need to get started. [0]: http://flask.pocoo.org/docs/0.11/testing/ http://flask.pocoo.org/docs/0.11/testing/
kerkeslager 10y ago
Are you unit testing?
- doomrobo 10y ago
  I wasn't, but I guess this is the only solution. The biggest reason I didn't unit test was that most of my functions were dependent on a significant amount of internal state. I suppose I should have spent more time coming up with mock models to use during unit tests. Also separating functionality would have made things easier.
  - 10y ago