Open abitrolly opened 6 years ago
This is good - http://exploreflask.com/en/latest/organizing.html - start with simple project and upgrade to modular later. The bad thing is that config is potentially executable .py
file.
Having just single app.wsgi
is more simple than calculating repository name. Maybe the "standard layout" is better be replaced with detection algorithm.
FT-01-A: Use app.wsgi
no matter what is present.
FT-01-B: Just use any .wsgi
is there is one file.
The standard layout, it appears, only makes sense if there are multiple .wsgi
files. Also if .wsgi
doesn't work out of the box and it is useless to run/detect it automatically. Therefore, use app.wsgi
when application can be run from repository, and choose package name when complicated setup is still required.
How many hours did you spend trying to figure out how your new open source project works? Looking through Vagrant and Docker files, learning Ansible and
setup.py
... What if there was a single entrypoint and a set of conventions, so that your editor can detect and quickly give you all clues that are necessary to run and debug your project as if it was in production? Let's try to define some of those yak shaving conventions..wsgi
file with entrypoint to your web application should be at the top.wsgi
is named after your app/project (fedora-packages.wsgi
)static
directory with static resources (images
,css
, ...) andREADME.md
explaining how they are mapped (URL on the webserver) and deployed (CDN, webserver config)requirements.txt
file orrequirements/
dir for automated dependency analysis