tina4-python 0.2.122__py3-none-any.whl

tina4_python/DatabaseTypes.py

@@ -0,0 +1,15 @@
+#
+# Tina4 - This is not a 4ramework.
+# Copy-right 2007 - current Tina4
+# License: MIT https://opensource.org/licenses/MIT
+#
+# flake8: noqa: E501
+SQLITE = "sqlite3"
+FIREBIRD = "firebird.driver"
+FIREBIRD_INSTALL = "pip install firebird-driver or poetry add firebird-driver"
+MYSQL = "mysql.connector"
+MYSQL_INSTALL = "pip install mysql-connector-python or poetry add mysql-connector-python"
+POSTGRES = "psycopg2"
+POSTGRES_INSTALL = "pip install psycopg2-binary or poetry add psycopg2-binary"
+MSSQL = "pymssql"
+MSSQL_INSTALL = "pip install pymssql or poetry add pymssql"

tina4_python/Debug.py

@@ -0,0 +1,126 @@
+#
+# Tina4 - This is not a 4ramework.
+# Copy-right 2007 - current Tina4
+# License: MIT https://opensource.org/licenses/MIT
+#
+# flake8: noqa: E501
+import os
+import sys
+import logging
+import logging.config
+from logging.handlers import RotatingFileHandler
+import tina4_python.Constant as Constant
+from tina4_python.ShellColors import ShellColors
+from datetime import datetime
+
+
+LOGGING_CONFIG = {
+    'version': 1,
+    'disable_existing_loggers': False,
+    'formatters': {
+        'default': {
+            'format': '%(levelname)s: %(asctime)s: %(message)s',
+        },
+    },
+    'handlers': {
+        'stdout': {
+            'level': 'DEBUG',
+            'class': 'logging.StreamHandler',
+            'formatter': 'default',
+        },
+    },
+    'loggers': {
+        'TINA4': {
+            'handlers': ['stdout'],
+            'level': 'DEBUG',
+            'propagate': True,
+        },
+    },
+}
+
+class Debug:
+
+    @staticmethod
+    def info(*args, **kwargs):
+        args += (Constant.TINA4_LOG_INFO,)
+        Debug(*args, **kwargs)
+
+    @staticmethod
+    def error(*args, **kwargs):
+        args += (Constant.TINA4_LOG_ERROR,)
+        Debug(*args, **kwargs)
+
+    @staticmethod
+    def debug(*args, **kwargs):
+        args += (Constant.TINA4_LOG_DEBUG,)
+        Debug(*args, **kwargs)
+
+    @staticmethod
+    def warning(*args, **kwargs):
+        args += (Constant.TINA4_LOG_WARNING,)
+        Debug(*args, **kwargs)
+
+    def __init__(self, *args, **kwargs):
+        now = datetime.now()
+        debug_level = os.getenv("TINA4_DEBUG_LEVEL", Constant.TINA4_LOG_INFO)
+
+        logging.config.dictConfig(LOGGING_CONFIG)
+        if debug_level == Constant.TINA4_LOG_ALL or debug_level == Constant.TINA4_LOG_DEBUG:
+            logging.basicConfig(stream=sys.stdout, level=logging.DEBUG)
+        elif debug_level == Constant.TINA4_LOG_INFO:
+            logging.basicConfig(stream=sys.stdout, level=logging.INFO)
+        elif debug_level == Constant.TINA4_LOG_ERROR:
+            logging.basicConfig(stream=sys.stdout, level=logging.ERROR)
+        elif debug_level == Constant.TINA4_LOG_WARNING:
+            logging.basicConfig(stream=sys.stdout, level=logging.WARNING)
+
+        params = [now.strftime("%Y-%m-%d %H:%M:%S") + ":"]
+        for value in args:
+            if value in [Constant.TINA4_LOG_ALL, Constant.TINA4_LOG_DEBUG, Constant.TINA4_LOG_INFO,
+                         Constant.TINA4_LOG_ERROR, Constant.TINA4_LOG_WARNING]:
+                debug_level = value
+            else:
+                params.append(value)
+
+        file_name = "debug.log"
+        if "file_name" in kwargs:
+            file_name = kwargs["file_name"]
+
+        formatter = logging.Formatter("%(levelname)s: %(asctime)s: %(message)s")
+        logger = logging.getLogger('TINA4')
+        logger.setLevel(logging.DEBUG)
+
+        handler = RotatingFileHandler("."+os.sep+"logs"+os.sep+file_name, maxBytes=1024*1024, backupCount=5, encoding="utf-8")
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+        if (os.getenv("TINA4_DEBUG_LEVEL", [Constant.TINA4_LOG_ALL]) == "[TINA4_LOG_ALL]"
+                or debug_level in os.getenv("TINA4_DEBUG_LEVEL", [Constant.TINA4_LOG_ALL])):
+
+            log_level = 0
+            # choose the color
+            color = ShellColors.bright_blue
+
+            if debug_level == Constant.TINA4_LOG_INFO:
+                color = ShellColors.cyan
+                log_level = 20
+
+            elif debug_level == Constant.TINA4_LOG_DEBUG:
+                color = ShellColors.bright_magenta
+                log_level = 10
+
+            elif debug_level == Constant.TINA4_LOG_ERROR:
+                color = ShellColors.bright_red
+                log_level = 40
+
+            elif debug_level == Constant.TINA4_LOG_WARNING:
+                color = ShellColors.bright_yellow
+                log_level = 30
+
+            end = ShellColors.end
+
+            logger.log(log_level, f"{color} ".join(str(param) for param in params[1:]).strip()+f"{end} ")
+
+        handler.flush()
+        logger.removeHandler(handler)
+        handler.close()

tina4_python/Env.py

@@ -0,0 +1,37 @@
+#
+# Tina4 - This is not a 4ramework.
+# Copy-right 2007 - current Tina4
+# License: MIT https://opensource.org/licenses/MIT
+#
+import os
+import hashlib
+from datetime import datetime
+from dotenv import load_dotenv
+
+
+# check .env for information
+def load_env(path: str = '.env'):
+    if not os.path.isfile(path):
+        current_time = datetime.now()
+        result = hashlib.md5(current_time.strftime("%A,%d %B %Y").encode())
+        with open(path, 'w') as f:
+            f.write("# Project Settings\n")
+            f.write("PROJECT_NAME=\"My Project\"\n")
+            f.write("VERSION=1.0.0\n")
+            f.write("TINA4_LANGUAGE=en\n")
+            f.write("API_KEY="+result.hexdigest()+"\n")
+            f.write("TINA4_DEBUG_LEVEL=[TINA4_LOG_ALL]\n")
+    # Load the .env
+    load_dotenv(path)
+    # check for defaults we need
+    if "TINA4_LANGUAGE" not in os.environ:
+        with open(path, 'a') as f:
+            f.write("TINA4_LANGUAGE=en\n")
+    if "TINA4_DEBUG_LEVEL" not in os.environ:
+        with open(path, 'a') as f:
+            f.write("TINA4_DEBUG_LEVEL=[\"ALL\"]\n")
+    if "API_KEY" not in os.environ:
+        current_time = datetime.now()
+        result = hashlib.md5(current_time.strftime("%A,%d %B %Y").encode())
+        with open(path, 'a') as f:
+            f.write("API_KEY="+result.hexdigest()+"\n")

tina4_python/Localization.py

@@ -0,0 +1,42 @@
+#
+# Tina4 - This is not a 4ramework.
+# Copy-right 2007 - current Tina4
+# License: MIT https://opensource.org/licenses/MIT
+#
+# flake8: noqa: E501
+import gettext
+import os
+import sys
+from tina4_python.Debug import Debug
+from tina4_python import Constant
+
+
+# load environment variables from .env file
+# check .env for information
+
+def localize():
+    translation_path = os.path.join(os.path.dirname(__file__), 'translations')
+    available_languages = ['en', 'fr', 'af']
+
+    # get user language from environment variable
+    # default to English
+    if "TINA4_LANGUAGE" in os.environ:
+        user_language = os.environ.get('TINA4_LANGUAGE', 'en')
+    else:
+        user_language = "en"
+
+    # check if an argument is a language
+    if len(sys.argv) > 1:
+        try:
+            int(sys.argv[1])
+        except ValueError:
+            if sys.argv[1] in available_languages:
+                user_language = sys.argv[1]
+
+    if len(sys.argv) > 2 and sys.argv[2] in available_languages:
+        user_language = sys.argv[2]
+
+    Debug("Language: " + user_language, Constant.TINA4_LOG_INFO)
+    # Initialize the translation system
+    translation = gettext.translation('messages', translation_path, languages=[user_language])
+    translation.install()

tina4_python/Messages.py

@@ -0,0 +1,30 @@
+#
+# Tina4 - This is not a 4ramework.
+# Copy-right 2007 - current Tina4
+# License: MIT https://opensource.org/licenses/MIT
+#
+# flake8: noqa: E501
+import gettext
+
+_ = gettext.gettext
+
+MSG_DEBUG = _('Debug: {message}')
+MSG_WARNING = _('Warning: {message}')
+MSG_ERROR = _('Error: {message}')
+MSG_INFO = _('Info: {message}')
+
+# Router messages
+MSG_ROUTER_MATCHING = _('Matching: {matching}')
+MSG_ROUTER_VARIABLES = _('Variables: {variables}')
+MSG_ROUTER_ROOT_PATH = _('Root Path {root_path} {url}')
+MSG_ROUTER_STATIC_FILE = _('Attempting to serve static file: {static_file}')
+MSG_ROUTER_CSS_FILE = _('Attempting to serve CSS file: {css_file}')
+MSG_ROUTER_IMAGE_FILE = _('Attempting to serve image file: {image_file}')
+
+# Server messages
+MSG_ASSUMING_ROOT_PATH = _('Assuming root path: {root_path}, library path: {library_path}')
+MSG_LOAD_ALL_THINGS = _('Load all things')
+MSG_SERVER_STARTED = _('Server started http://{host_name}:{port}')
+MSG_SERVER_STOPPED = _('Server stopped.')
+MSG_STARTING_WEBSERVER = _('Starting webserver on {port}')
+MSG_ENTRY_POINT_NAME = _('Entry point name ... {name}')

tina4_python/MiddleWare.py

@@ -0,0 +1,90 @@
+#
+# Tina4 - This is not a 4ramework.
+# Copy-right 2007 - current Tina4
+# License: MIT https://opensource.org/licenses/MIT
+#
+# flake8: noqa: E501
+import asyncio
+
+class MiddleWare:
+    def __init__(self, middleware_class):
+        """
+
+        :param middleware_class:
+        """
+        self.before_methods = []
+        self.after_methods = []
+        self.any_methods = []
+        self.middleware_class = middleware_class
+
+        self.methods_list = [method for method in vars(middleware_class) if callable(
+            getattr(middleware_class, method)) and not method.startswith("__")]
+
+        for method in self.methods_list:
+            if method.startswith("before"):
+                self.before_methods.append(method)
+            elif method.startswith("after"):
+                self.after_methods.append(method)
+            else:
+                self.any_methods.append(method)
+
+    async def call_before_methods(self, request, response):
+        """
+        Call before methods
+        :param request:
+        :param response:
+        :return:
+        """
+        for method in self.before_methods:
+            method = getattr(self.middleware_class, method)
+            result = method(request, response)
+            if asyncio.iscoroutine(result):
+                request, response = await result
+            else:
+                request, response = result
+
+        return request, response
+
+    async def call_after_methods(self, request, response):
+        """
+        Call after methods
+        :param request:
+        :param response:
+        :return:
+        """
+        for method in self.after_methods:
+            method = getattr(self.middleware_class, method)
+            result = method(request, response)
+            if asyncio.iscoroutine(result):
+                request, response = await result
+            else:
+                request, response = result
+        return request, response
+
+    async def call_any_methods(self, request, response):
+        """
+        Call any methods
+        :param request:
+        :param response:
+        :return:
+        """
+        for method in self.any_methods:
+            method = getattr(self.middleware_class, method)
+            result = method(request, response)
+            if asyncio.iscoroutine(result):
+                request, response = await result
+            else:
+                request, response = result
+        return request, response
+
+    def call_direct_method(self, request, response, method_name):
+        """
+        Call direct methods
+        :param request:
+        :param response:
+        :param method_name:
+        :return:
+        """
+        method = getattr(self.middleware_class, method_name)
+        request, response = method(request, response)
+        return request, response

tina4_python/Migration.py

@@ -0,0 +1,107 @@
+#
+# Tina4 - This is not a 4ramework.
+# Copy-right 2007 - current Tina4
+# License: MIT https://opensource.org/licenses/MIT
+#
+# flake8: noqa: E501
+import os
+import sys
+
+from tina4_python import ShellColors
+from tina4_python import Constant
+from tina4_python.Debug import Debug
+from tina4_python.Database import MSSQL, POSTGRES, FIREBIRD, MYSQL
+import tina4_python
+
+
+def migrate(dba, delimiter=";", migration_folder="migrations"):
+    """
+    Migrates the database from the migrate folder
+    :param delimiter: SQL delimiter
+    :param dba: Database connection
+    :param migration_folder: Alternative folder for migrations
+    :return:
+    """
+    if dba.database_engine == MSSQL:
+        if not dba.table_exists("tina4_migration"):
+            dba.execute("create table tina4_migration(id integer identity(1,1) not null, description varchar(200) default '', content nvarchar(max), error_message nvarchar(max), passed integer default 0, primary key(id))")
+        dba.execute("SET IDENTITY_INSERT tina4_migration ON")
+    elif dba.database_engine == POSTGRES:
+        dba.execute(
+            "create table if not exists tina4_migration(id serial primary key, description varchar(200) default '', content text, error_message text, passed integer default 0)")
+    elif dba.database_engine == MYSQL:
+        dba.execute(
+            "create table if not exists tina4_migration(id integer not null auto_increment, description varchar(200) default '', content text, error_message text, passed integer default 0, primary key(id))")
+    elif dba.database_engine == FIREBIRD:
+        if not dba.table_exists("tina4_migration"):
+            dba.execute(
+                "create table tina4_migration(id integer not null, description varchar(200) default '', content blob sub_type text, error_message blob sub_type text, passed integer default 0, primary key(id))")
+    else:
+        dba.execute(
+            "create table if not exists tina4_migration(id integer not null, description varchar(200) default '', content blob, error_message blob, passed integer default 0, primary key(id))")
+
+    Debug(ShellColors.bright_yellow, "Migration:  Found ", tina4_python.root_path + os.sep + migration_folder, ShellColors.end, Constant.TINA4_LOG_INFO)
+    dir_list = os.listdir(tina4_python.root_path + os.sep + migration_folder)
+    dir_list.sort()
+
+    for file in dir_list:
+        if '.sql' in file:
+            Debug(ShellColors.bright_yellow, "Migration:  Checking file", file, ShellColors.end, Constant.TINA4_LOG_INFO)
+            sql_file = open(tina4_python.root_path + os.sep + migration_folder + os.sep + file)
+            file_contents = sql_file.read()
+            sql_file.close()
+            try:
+                dba.execute("delete from tina4_migration where description = ? and passed = ?", [file, 0])
+                dba.commit()
+                # check if migration exists in the database and has passed - no need to run the scripts below
+
+                sql_check = "select * from tina4_migration where description = ? and passed = ?"
+                record = dba.fetch(sql_check, [file, 1])
+
+                if record.count == 0:
+                    Debug(ShellColors.bright_yellow, "Migration:  Running migration for", file, ShellColors.end, Constant.TINA4_LOG_INFO)
+                    # get each migration
+                    script_content = file_contents.split(";")
+
+                    # all scripts need to pass
+                    error = False
+                    error_message = ""
+                    for script in script_content:
+                        if script.strip() != "":
+                            result = dba.execute(script)
+                            if result.error is not None:
+                                error = True
+                                error_message = result.error
+                                break
+
+                    if not error:
+                        # passed print(color + f"{debug_level:5}:"+ShellColors.end, "", end="")
+                        Debug(ShellColors.bright_yellow,"Migration:", ShellColors.end, ShellColors.bright_green+"PASSED running migration for", file, ShellColors.end, Constant.TINA4_LOG_INFO)
+                        dba.commit()
+                        next_id = dba.get_next_id("tina4_migration")
+                        dba.execute("insert into tina4_migration (id, description, content, passed) values (?, ?, ?, 1) ",
+                                    [next_id, file, file_contents])
+                        dba.commit()
+                    else:
+                        # did not pass
+                        Debug(ShellColors.bright_yellow, "Migration:", ShellColors.end, ShellColors.bright_red+"FAILED running migration for", file, error_message, ShellColors.end, Constant.TINA4_LOG_ERROR)
+                        dba.rollback()
+                        next_id = dba.get_next_id("tina4_migration")
+                        dba.execute(
+                            "insert into tina4_migration (id, description, content, passed, error_message) values (?, ?, ?, 0, ?) ",
+                            [next_id, file, file_contents, str(error_message)])
+                        dba.commit()
+                        sys.exit(1)
+            except Exception as e:
+                next_id = dba.get_next_id("tina4_migration")
+                dba.execute(
+                    "insert into tina4_migration (id, description, content, passed, error_message) values (?, ?, ?, 0, ?) ",
+                    [next_id, file, file_contents, str(e)])
+                dba.commit()
+
+                Debug("Migration: Failed to run", file, e, Constant.TINA4_LOG_ERROR)
+                sys.exit(1)
+
+    if dba.database_engine == MSSQL:
+        dba.execute("SET IDENTITY_INSERT tina4_migration OFF")
+