Author: Jason Giedymin <jasong _[_a-t_]_ apache [dot] org> == What is this? == Use this scaffold / template as a basis for a Subapp / Module based Flask application using subdomains and subapps content. There is also an example of using a subapp / module to extend root app space. The application relies on Fabric to start, and includes staging functionality to auto install all required dependencies. == How To Use this? == First you'll need to edit your hosts file to direct the 'dummy' subdomain to localhost. 1. Edit /etc/hosts 2. Add an entry for "127.0.0.1 dummy.localhost" Start installing dependencies and run the app: 1. Clone this repo 2. pip install fabric 3. cd Flask-Module-Scaffold/src 4. fab -l #Lists all commands 5. fab staging_local #Creates virtualenv and pip installs 6. fab start_dev_server #Starts the dev server == The app is running, now what? == Navigate to these pages: # Served from the 'frontend' subapp/module # Templates and CSS served from frontend/[static,templates] http://localhost:8080 http://localhost:8080/template # Served from the 'dummy' subbapp/module # Templates and CSS served from dummy/[static,templates] http://dummy.localhost:8080/ http://dummy.localhost:8080/template # Served from the 'root' subapp/module using the main apps static/template # directories. # Templates and CSS served from root myapp/[static,templates] # To prove this, apps/root/ is devoid of the static and templates directories. http://localhost:8080/hello http://localhost:8080/root-template == References == Flask: http://flask.pocoo.org/ "Flask is a microframework for Python based on Werkzeug, Jinja 2 and good intentions. And before you ask: It's BSD licensed!" Fabric: http://docs.fabfile.org/en/1.0.1/index.html "Fabric is a Python (2.5 or higher) library and command-line tool for streamlining the use of SSH for application deployment or systems administration tasks." == Noob? == This is a python repo using python tools and frameworks.