Release v1.0.8

Author: app-generator

.env

@@ -1,7 +1,7 @@
 DEBUG=True
 
 FLASK_APP=run.py
-FLASK_ENV=development
+FLASK_DEBUG=1
 
 ASSETS_ROOT=/static/assets
 

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Change Log
 
+## [1.0.8] 2023-10-07
+### Changes
+
+- Update Dependencies
+- Silent fallback to SQLite
+- CI/CD for Render
+
 ## [1.0.7] 2022-06-01
 ### Improvements
 

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.9
+FROM python:3.10
 
 # set environment variables
 ENV PYTHONDONTWRITEBYTECODE 1

README.md

@@ -4,33 +4,23 @@ Open-source **[Flask Dashboard](https://appseed.us/admin-dashboards/flask/)** ge
 
 - 👉 [CoreUI Flask](https://appseed.us/product/coreui/flask/) - product page
 - 👉 [CoreUI Flask](https://flask-coreui.appseed-srv1.com/) - LIVE Deployment
-- 👉 [Complete documentation](https://docs.appseed.us/products/flask-dashboards/coreui) - `Learn how to use and update the product`
 
 <br />
 
-## [Black Friday](https://appseed.us/discounts/) - `75%OFF`
+## ✅ Features 
 
-> The campaign is active until `30.NOV` and applies to all products and licenses.
-
-[![AppSeed - Black Friday 2022 Campaign, 75% OFF Discount (all products).](https://user-images.githubusercontent.com/51070104/201829599-9fe6bdd7-3f19-46f3-9115-962eeb13bf29.jpg)](https://appseed.us/discounts/)
-
-<br />
-
-> 🚀 Built with [App Generator](https://appseed.us/generator/), Timestamp: `2022-06-01 09:08`
-
-- ✅ `Up-to-date dependencies`
-- ✅ Database: `sqlite`
-- ✅ `DB Tools`: SQLAlchemy ORM, Flask-Migrate (schema migrations)
-- ✅ Session-Based authentication (via **flask_login**), Forms validation
-- ✅ `Docker`
-
-<br />
+- `Up-to-date dependencies`
+- Database: `sqlite`
+- `DB Tools`: SQLAlchemy ORM, Flask-Migrate (schema migrations)
+- Session-Based authentication (via **flask_login**), Forms validation
+- `Docker`
+- CI/CD Flow via Render
 
 ![CoreUI Dashboard - Starter generated by AppSeed.](https://user-images.githubusercontent.com/51070104/171336361-b125ca1d-8936-4f4a-b662-9e45ee25f404.png)
 
 <br /> 
 
-## ✨ Start the app in Docker
+## ✅ Start in `Docker`
 
 > 👉 **Step 1** - Download the code from the GH repository (using `GIT`) 
 
@@ -49,9 +39,8 @@ $ docker-compose up --build
 
 Visit `http://localhost:5085` in your browser. The app should be up & running.
 
-<br /> 
 
-## ✨ How to use it
+## ✅ Manual Build
 
 > Download the code 
 
@@ -141,7 +130,7 @@ By default, the app redirects guest users to authenticate. In order to access th
 
 <br />
 
-## ✨ Code-base structure
+## ✅ Codebase
 
 The project is coded using blueprints, app factory pattern, dual configuration profile (development and production) and an intuitive structure presented bellow:
 
@@ -194,7 +183,7 @@ The project is coded using blueprints, app factory pattern, dual configuration p
 
 <br />
 
-## ✨ PRO Version
+## ✅ PRO Version
 
 > For more components, pages and priority on support, feel free to take a look at this amazing starter:
 
@@ -203,8 +192,6 @@ Soft UI Dashboard is a premium Bootstrap 5 Design now available for download in
 - 👉 [Soft UI Dashboard PRO Flask](https://appseed.us/product/soft-ui-dashboard-pro/flask/) - Product Page
 - 👉 [Soft UI Dashboard PRO Flask](https://flask-soft-ui-dashboard-pro.appseed-srv1.com/) - LIVE Demo 
 
-<br >
-
 ![Soft UI Dashboard PRO - Starter generated by AppSeed.](https://user-images.githubusercontent.com/51070104/170829870-8acde5af-849a-4878-b833-3be7e67cff2d.png)
 
 <br />

apps/__init__.py

@@ -3,6 +3,8 @@
 Copyright (c) 2019 - present AppSeed.us
 """
 
+import os
+
 from flask import Flask
 from flask_login import LoginManager
 from flask_sqlalchemy import SQLAlchemy
@@ -28,7 +30,18 @@ def configure_database(app):
 
     @app.before_first_request
     def initialize_database():
-        db.create_all()
+        try:
+            db.create_all()
+        except Exception as e:
+
+            print('> Error: DBMS Exception: ' + str(e) )
+
+            # fallback to SQLite
+            basedir = os.path.abspath(os.path.dirname(__file__))
+            app.config['SQLALCHEMY_DATABASE_URI'] = SQLALCHEMY_DATABASE_URI = 'sqlite:///' + os.path.join(basedir, 'db.sqlite3')
+
+            print('> Fallback to SQLite ')
+            db.create_all()
 
     @app.teardown_request
     def shutdown_session(exception=None):

apps/config.py

@@ -3,22 +3,57 @@
 Copyright (c) 2019 - present AppSeed.us
 """
 
-import os
+import os, random, string
 
 class Config(object):
 
     basedir = os.path.abspath(os.path.dirname(__file__))
 
+    # Assets Management
+    ASSETS_ROOT = os.getenv('ASSETS_ROOT', '/static/assets')
+
     # Set up the App SECRET_KEY
-    # SECRET_KEY = config('SECRET_KEY'  , default='S#perS3crEt_007')
-    SECRET_KEY = os.getenv('SECRET_KEY', 'S#perS3crEt_007')
+    SECRET_KEY  = os.getenv('SECRET_KEY', None)
+    if not SECRET_KEY:
+        SECRET_KEY = ''.join(random.choice( string.ascii_lowercase  ) for i in range( 32 ))    
 
-    # This will create a file in <app> FOLDER
-    SQLALCHEMY_DATABASE_URI = 'sqlite:///' + os.path.join(basedir, 'db.sqlite3')
-    SQLALCHEMY_TRACK_MODIFICATIONS = False 
+    SQLALCHEMY_TRACK_MODIFICATIONS = False
 
-    # Assets Management
-    ASSETS_ROOT = os.getenv('ASSETS_ROOT', '/static/assets')    
+    DB_ENGINE   = os.getenv('DB_ENGINE'   , None)
+    DB_USERNAME = os.getenv('DB_USERNAME' , None)
+    DB_PASS     = os.getenv('DB_PASS'     , None)
+    DB_HOST     = os.getenv('DB_HOST'     , None)
+    DB_PORT     = os.getenv('DB_PORT'     , None)
+    DB_NAME     = os.getenv('DB_NAME'     , None)
+
+    USE_SQLITE  = True 
+
+    # try to set up a Relational DBMS
+    if DB_ENGINE and DB_NAME and DB_USERNAME:
+
+        try:
+            
+            # Relational DBMS: PSQL, MySql
+            SQLALCHEMY_DATABASE_URI = '{}://{}:{}@{}:{}/{}'.format(
+                DB_ENGINE,
+                DB_USERNAME,
+                DB_PASS,
+                DB_HOST,
+                DB_PORT,
+                DB_NAME
+            ) 
+
+            USE_SQLITE  = False
+
+        except Exception as e:
+
+            print('> Error: DBMS Exception: ' + str(e) )
+            print('> Fallback to SQLite ')    
+
+    if USE_SQLITE:
+
+        # This will create a file in <app> FOLDER
+        SQLALCHEMY_DATABASE_URI = 'sqlite:///' + os.path.join(basedir, 'db.sqlite3') 
 
 class ProductionConfig(Config):
     DEBUG = False
@@ -28,16 +63,6 @@ class ProductionConfig(Config):
     REMEMBER_COOKIE_HTTPONLY = True
     REMEMBER_COOKIE_DURATION = 3600
 
-    # PostgreSQL database
-    SQLALCHEMY_DATABASE_URI = '{}://{}:{}@{}:{}/{}'.format(
-        os.getenv('DB_ENGINE'   , 'mysql'),
-        os.getenv('DB_USERNAME' , 'appseed_db_usr'),
-        os.getenv('DB_PASS'     , 'pass'),
-        os.getenv('DB_HOST'     , 'localhost'),
-        os.getenv('DB_PORT'     , 3306),
-        os.getenv('DB_NAME'     , 'appseed_db')
-    )
-
 
 class DebugConfig(Config):
     DEBUG = True

build.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# exit on error
+set -o errexit
+
+python -m pip install --upgrade pip
+
+pip install -r requirements.txt

env.sample

@@ -3,13 +3,13 @@ DEBUG=True
 
 # Flask ENV
 FLASK_APP=run.py
-FLASK_ENV=development
+FLASK_DEBUG=1
 SECRET_KEY=YOUR_SUPER_KEY
 
 # If DEBUG=False (production mode)
-DB_ENGINE=mysql
-DB_NAME=appseed_db
-DB_HOST=localhost
-DB_PORT=3306
-DB_USERNAME=appseed_db_usr
-DB_PASS=<STRONG_PASS>
+# DB_ENGINE=mysql
+# DB_NAME=appseed_db
+# DB_HOST=localhost
+# DB_PORT=3306
+# DB_USERNAME=appseed_db_usr
+# DB_PASS=<STRONG_PASS>