Added webapp/flaskwebapps/genericflaskwebapp

*  Create new section 'webapp'
*  Added 'src/webapp/flaskwebapps/genericflaskwebapp/' module / app - custom
   SQLite3 ORM equipped basic (generic) flask web app for quick development.
*  Added 'examples/webapp/flaskwebapps/genericflaskwebapp/' module / app.

Author: CXINFINITE

examples/webapp/flaskwebapps/genericflaskwebapp/__author__.py

@@ -0,0 +1,2 @@
+name = 'CXINFINITE'
+github = 'https://github.com/CXINFINITE/'

examples/webapp/flaskwebapps/genericflaskwebapp/__init__.py

@@ -0,0 +1,31 @@
+import os
+import sys
+from pathlib import Path
+
+sys.path.append(os.path.abspath(
+   Path(__file__).parent.resolve()
+))
+sys.path.append(os.path.abspath(
+   Path(__file__).parent.parent.resolve()
+))
+
+from . import (
+   __author__,
+   __version__,
+   ui,
+   ui_bridge,
+   operations,
+   backend,
+   database,
+)
+
+__all__ = [
+   '__author__',
+   '__version__',
+   
+   'ui',
+   'ui_bridge',
+   'operations',
+   'backend',
+   'database',
+]

examples/webapp/flaskwebapps/genericflaskwebapp/__main__.py

@@ -0,0 +1,15 @@
+import os
+import sys
+from pathlib import Path
+
+sys.path.append(os.path.abspath(
+   Path(__file__).parent.resolve(),
+))
+sys.path.append(os.path.abspath(
+   Path(__file__).parent.parent.resolve(),
+))
+
+from ui_bridge import execute_cli
+
+if __name__ == '__main__':
+   execute_cli()

examples/webapp/flaskwebapps/genericflaskwebapp/__version__.py

@@ -0,0 +1,24 @@
+fullappname = 'Generic Flask Web App Demo'
+appname = 'GenericFlaskWebAppDemo'
+
+major = 0
+minor = 0
+patch = 0
+
+release = 'dev'
+
+description = '{0}: v{1}.{2}.{3}-{4}'.format(
+   appname, major, minor, patch, release,
+)
+
+full = '{0}.{1}.{2}-{3}'.format(
+   major, minor, patch, release,
+)
+
+long = '{0}.{1}.{2}'.format(
+   major, minor, patch,
+)
+
+short = '{0}.{1}'.format(
+   major, minor,
+)

examples/webapp/flaskwebapps/genericflaskwebapp/backend/__init__.py

@@ -0,0 +1,25 @@
+from . import (
+   core,
+   security,
+   decorators,
+   functionality,
+   
+   routers,
+)
+
+from .api import API as api
+
+router = None
+
+__all__ = [
+   'api',
+   
+   'core',
+   'security',
+   'decorators',
+   'functionality',
+   
+   'routers',
+   
+   'router',
+]

examples/webapp/flaskwebapps/genericflaskwebapp/backend/api.py

@@ -0,0 +1,13 @@
+import genericflaskwebapp as app
+
+class API:
+   class Router:
+      RouterV1 = 1
+   
+   def router_start (router):
+      if (router == API.Router.RouterV1):
+         from .routers import routerv1
+         
+         app.backend.router = routerv1
+      
+      return True

examples/webapp/flaskwebapps/genericflaskwebapp/backend/core/__init__.py

@@ -0,0 +1,5 @@
+from .redirect_internal import Redirect_Internal as redirect_internal
+
+__all__ = [
+   'redirect_internal',
+]

examples/webapp/flaskwebapps/genericflaskwebapp/backend/core/redirect_internal.py

@@ -0,0 +1,38 @@
+import datetime
+
+from flask import (
+   redirect,
+   session,
+)
+
+class Redirect_Internal:
+   def redirect (route, expire=None, **kwargs):
+      redirectiondata = {
+         'route': route,
+         'data': kwargs,
+         'expire': (None
+            if (not expire)
+            else
+            expire
+         ),
+      }
+      session['redirect_internal'] = redirectiondata
+      
+      return redirect(route)
+   
+   def check (route):
+      if ('redirect_internal' not in session):
+         return None
+      
+      redirectiondata = session.pop('redirect_internal')
+      
+      if (redirectiondata.get('route') != route):
+         return None
+      
+      if (redirectiondata.get('expire')):
+         if (
+            datetime.datetime.now() > redirectiondata.get('expire')
+         ):
+            return None
+      
+      return (redirectiondata.get('data'))

examples/webapp/flaskwebapps/genericflaskwebapp/backend/decorators/__init__.py

@@ -0,0 +1,11 @@
+from .csrf import CSRF as csrf
+from .redirect_internal import Redirect_Internal as redirect_internal
+
+from .authentication import Authentication as authentication
+
+__all__ = [
+   'csrf',
+   'redirect_internal',
+   
+   'authentication',
+]

examples/webapp/flaskwebapps/genericflaskwebapp/backend/decorators/authentication.py

@@ -0,0 +1,57 @@
+from functools import wraps
+
+from flask import (
+   redirect,
+)
+
+import genericflaskwebapp as app
+
+class Authentication:
+   def login_required (
+      redirectionroute,
+      internalredirect=False,
+      invert=False,
+      **internalredirectiondata,
+   ):
+      def Inner (api_function):
+         @wraps(api_function)
+         def wrapper (*args, **kwargs):
+            logged_in = (
+               app.backend.functionality.Authentication.state_logged_in_check()
+            )
+            
+            logged_in = (
+               bool(logged_in[0])
+               if (not invert)
+               else
+               bool(not logged_in[0])
+            )
+            
+            if (not logged_in):
+               if (internalredirect):
+                  return app.backend.core.redirect_internal.redirect(
+                     redirectionroute,
+                     **internalredirectiondata,
+                  )
+               
+               return redirect(redirectionroute)
+            
+            return api_function(*args, **kwargs)
+         
+         return wrapper
+      return Inner
+   
+   def get_logged_in_user ():
+      def Inner (api_function):
+         @wraps(api_function)
+         def wrapper (*args, **kwargs):
+            return api_function(
+               *args,
+               user=(
+                  app.backend.functionality.Authentication.get_logged_in_user()
+               ),
+               **kwargs,
+            )
+         
+         return wrapper
+      return Inner

examples/webapp/flaskwebapps/genericflaskwebapp/backend/decorators/csrf.py

@@ -0,0 +1,49 @@
+from functools import wraps
+
+import genericflaskwebapp as app
+
+class CSRF:
+   def csrf_protect (
+      embedd=True,
+      check=True, form=None,
+      ontrap=None, ontrapcallable=False, ontrapembedd=False,
+   ):
+      if (not (embedd or check)):
+         raise Exception(
+            'backend.decorators.csrf:csrf_protect:: csrf protection used but '
+            + 'not enabled !'
+         )
+      
+      def Inner (api_function):
+         @wraps(api_function)
+         def wrapper (*args, **kwargs):
+            if (check
+               and (not app.backend.security.csrf.check_csrf_token(form=form))
+            ):
+               if (ontrap):
+                  if (ontrapembedd):
+                     return app.backend.security.csrf.embedd_token((
+                        ontrap()
+                        if (callable(ontrap) and ontrapcallable)
+                        else
+                        ontrap
+                     ))
+                  
+                  return (
+                     ontrap()
+                     if (callable(ontrap) and ontrapcallable)
+                     else
+                     ontrap
+                  )
+               
+               return 'Request blocked !'
+            
+            if (embedd):
+               return app.backend.security.csrf.embedd_token(
+                  api_function(*args, **kwargs),
+               )
+            
+            return api_function(*args, **kwargs)
+         
+         return wrapper
+      return Inner

examples/webapp/flaskwebapps/genericflaskwebapp/backend/decorators/redirect_internal.py

@@ -0,0 +1,21 @@
+from functools import wraps
+
+import genericflaskwebapp as app
+
+class Redirect_Internal:
+   def check (
+      redirectionroute,
+   ):
+      def Inner (api_function):
+         @wraps(api_function)
+         def wrapper (*args, **kwargs):
+            return api_function(
+               *args,
+               redirectiondata=(app.backend.core.redirect_internal.check(
+                  redirectionroute,
+               ) or dict()),
+               **kwargs,
+            )
+         
+         return wrapper
+      return Inner

examples/webapp/flaskwebapps/genericflaskwebapp/backend/functionality/__init__.py

@@ -0,0 +1,9 @@
+from .authentication import Authentication
+from .user import User
+from .todo import ToDo
+
+__all__ = [
+   'Authentication',
+   'User',
+   'ToDo',
+]