Refactor.

Author: toddbirchard

.env.example

@@ -0,0 +1,7 @@
+FLASK_APP=wsgi.py
+FLASK_ENV=development
+SECRET_KEY=randomstringofcharacters
+LESS_BIN=/usr/local/bin/lessc
+ASSETS_DEBUG=False
+LESS_RUN_IN_DEBUG=False
+COMPRESSOR_DEBUG=True

README.md

@@ -40,15 +40,21 @@ $ pipenv update
 $ flask run
 ```
 
-## Configuration
+## Usage
 
-Configuration is handled by creating a **.env** file. This should contain the following variables (replace the values with your own):
+Replace the values in **.env.example** with your values and rename this file to **.env**:
+
+* `FLASK_APP`: Entry point of your application (should be `wsgi.py`).
+* `FLASK_ENV`: The environment to run your app in (either `development` or `production`).
+* `SECRET_KEY`: Randomly generated string of characters used to encrypt your app's data.
+* `LESS_BIN`: Path to your local LESS installation via `which lessc` (optional for static assets).
+* `ASSETS_DEBUG`: Debug asset creation and bundling in `development` (optional).
+* `LESS_RUN_IN_DEBUG`: Debug LESS while in `development` (optional).
+* `COMPRESSOR_DEBUG`: Debug asset compression while in `development` (optional).
+
+
+*Remember never to commit secrets saved in .env files to Github.*
 
-```.env
-SECRET_KEY="YOURSECRETKEY"
-FLASK_ENV="production"
-BEST_BUY_API_KEY="YOURBESTBUYAPIKEY"
-```
 -----
 
 **Hackers and Slackers** tutorials are free of charge. If you found this tutorial helpful, a [small donation](https://www.buymeacoffee.com/hackersslackers) would be greatly appreciated to keep us in business. All proceeds go towards coffee, and all coffee goes towards more content.

application/assets.py

@@ -13,6 +13,6 @@ def fetch_products(app):
         "totalPages": 1,
         "sort": "customerReviewAverage.dsc"}
     headers = {'Accept': 'application/json', 'Content-Type': 'application/json'}
-    r = requests.get(endpoint, params=params, headers=headers)
-    products = r.json()['products']
+    req = requests.get(endpoint, params=params, headers=headers)
+    products = req.json()['products']
     return products

application/home/home.py

@@ -0,0 +1,48 @@
+"""Compile static assets."""
+from flask import current_app as app
+from flask_assets import Bundle
+
+
+def compile_static_assets(assets):
+    """
+    Create stylesheet bundles.
+
+    :param assets: Flask-Assets Environment
+    :type assets: Environment
+    """
+    assets.auto_build = True
+    assets.debug = False
+    common_less_bundle = Bundle(
+        'src/less/*.less',
+        filters='less,cssmin',
+        output='dist/css/style.css',
+        extra={'rel': 'stylesheet/less'}
+    )
+    home_less_bundle = Bundle(
+        'home_bp/less/home.less',
+        filters='less,cssmin',
+        output='dist/css/home.css',
+        extra={'rel': 'stylesheet/less'}
+    )
+    profile_less_bundle = Bundle(
+        'profile_bp/less/profile.less',
+        filters='less,cssmin',
+        output='dist/css/profile.css',
+        extra={'rel': 'stylesheet/less'}
+    )
+    product_less_bundle = Bundle(
+        'products_bp/less/products.less',
+        filters='less,cssmin',
+        output='dist/css/products.css',
+        extra={'rel': 'stylesheet/less'}
+    )
+    assets.register('common_less_bundle', common_less_bundle)
+    assets.register('home_less_bundle', home_less_bundle)
+    assets.register('profile_less_bundle', profile_less_bundle)
+    assets.register('product_less_bundle', product_less_bundle)
+    if app.config['FLASK_ENV'] == 'development':  # Only rebuild in development
+        common_less_bundle.build()
+        home_less_bundle.build()
+        profile_less_bundle.build()
+        product_less_bundle.build()
+    return assets

application/static/.DS_Store

@@ -0,0 +1,47 @@
+"""General page routes."""
+from flask import Blueprint, render_template
+from flask import current_app as app
+from flask_blueprint_tutorial.api import fetch_products
+
+
+# Blueprint Configuration
+home_bp = Blueprint(
+    'home_bp', __name__,
+    template_folder='templates',
+    static_folder='static'
+)
+
+
+@home_bp.route('/', methods=['GET'])
+def home():
+    """Homepage."""
+    products = fetch_products(app)
+    return render_template(
+        'index.jinja2',
+        title='Flask Blueprint Demo',
+        subtitle='Demonstration of Flask blueprints in action.',
+        template='home-template',
+        products=products
+    )
+
+
+@home_bp.route('/about', methods=['GET'])
+def about():
+    """About page."""
+    return render_template(
+        'index.jinja2',
+        title="About",
+        subtitle='This is an example about page.',
+        template='home-template page'
+    )
+
+
+@home_bp.route('/contact', methods=['GET'])
+def contact():
+    """Contact page."""
+    return render_template(
+        'index.jinja2',
+        title="Contact",
+        subtitle='This is an example contact page.',
+        template='home-template page'
+    )