ApiLogicServer 14.3.25__py3-none-any.whl → 14.5.0__py3-none-any.whl

api_logic_server_cli/prototypes/base/docs/training/logic_bank_api.prompt

@@ -0,0 +1,314 @@
+Here is the simplified API for LogicBank:
+
+Translate the user prompt into a series of calls to Rule methods, described here.
+
+Do not generate import statements.
+
+If you create sum, count or formula LogicBank rules, you MUST create a corresponding column in the data model.
+
+Use only the methods provided below.
+
+
+class Rule:
+    """ Invoke these functions to declare rules """
+
+    @staticmethod
+    def sum(derive: Column, as_sum_of: any, where: any = None, insert_parent: bool=False):
+        """
+        Derive parent column as sum of designated child column, optional where
+
+        Example
+            Prompt
+                Customer.Balance = Sum(Order.amount_total where date_shipped is null)
+            Response
+                Rule.sum(derive=Customer.Balance, as_sum_of=Order.AmountTotal,
+                    where=lambda row: row.ShippedDate is None)
+
+        Args:
+            derive: name of parent <class.attribute> being derived
+            as_sum_of: name of child <class.attribute> being summed
+            where: optional where clause, designates which child rows are summed.  All referenced columns must be part of the data model - create columns in the data model as required.  Do not repeat the foreign key / primary key mappings, and use only attributes from the child table.
+            insert_parent: create parent if it does not exist.  Do not use unless directly requested.
+        """
+        return Sum(derive, as_sum_of, where, insert_parent)
+
+
+    @staticmethod
+    def count(derive: Column, as_count_of: object, where: any = None, str = "", insert_parent: bool=False):
+        """
+        Derive parent column as count of designated child rows
+
+        Example
+            Prompt
+                Customer.UnPaidOrders = count(Orders where ShippedDate is None)
+            Response
+                Rule.count(derive=Customer.UnPaidOrders, as_count_of=Order,
+                    where=Lambda row: row.ShippedDate is None)
+
+        Args:
+            derive: name of parent <class.attribute> being derived
+            as_count_of: name of child <class> being counted
+            where: optional where clause, designates which child rows are counted.  All referenced columns must be part of the data model - create columns in the data model as required.  Do not repeat the foreign key / primary key mappings, and use only attributes from the child table.
+            insert_parent: create parent if it does not exist.  Do not use unless directly requested.
+        """
+        return Count(derive, as_count_of, where, insert_parent)
+
+
+    @staticmethod
+    def constraint(validate: object,
+                   calling: Callable = None,
+                   as_condition: any = None,
+                   error_msg: str = "(error_msg not provided)",
+                   error_attributes=None):
+        """
+        Constraints declare condition that must be true for all commits
+
+        Example
+            Prompt
+                Customer.balance <= credit_limit
+            Response  
+                Rule.constraint(validate=Customer,
+                                as_condition=lambda row: row.Balance <= row.CreditLimit,
+                                error_msg="balance ({row.Balance}) exceeds credit ({row.CreditLimit})")
+
+        Args:
+            validate: name of mapped <class>
+            as_condition: lambda, passed row (simple constraints).  All referenced columns must be part of the data model - create columns in the data model as required.  Also, conditions may not contain sum or count python functions - these must be used to declare additional columns and sum/count rules.
+            error_msg: string, with {row.attribute} replacements
+            error_attributes: list of attributes
+
+        """
+        if error_attributes is None:
+            error_attributes = []
+        return Constraint(validate=validate, as_condition=as_condition,
+                          error_attributes=error_attributes, error_msg=error_msg)
+
+
+    @staticmethod
+    def formula(derive: Column,
+                as_expression: Callable = None,
+                no_prune: bool = False):
+        """
+        Formulas declare column value, based on current and parent rows
+
+        Example
+            Prompt
+                Item.amount = quantity * unit_price
+            Response
+                Rule.formula(derive=OrderDetail.Amount,
+                             as_expression=lambda row: row.UnitPrice * row.Quantity)
+
+        Args:
+            derive: <class.attribute> being derived
+            as_expression: lambda, passed row (for syntax checking).  All referenced columns must be part of the data model - create columns in the data model as required.  Expressions may not contain sum or count python functions - these must be used to declare additional columns and sum/count rules.
+            no_prune: disable pruning (rarely used, default False)
+        """
+        return Formula(derive=derive,
+                       as_expression=as_expression,
+                       no_prune=no_prune)
+
+
+    @staticmethod
+    def copy(derive: Column, from_parent: any):
+        """
+        Copy declares child column copied from parent column.
+
+        Example:
+            Prompt
+                Store the Item.unit_price as a copy from Product.unit_price
+            Response
+                Rule.copy(derive=OrderDetail.UnitPrice, from_parent=Product.UnitPrice)
+
+        Args:
+            derive: <class.attribute> being copied into
+            from_parent: <parent-class.attribute> source of copy; create this column in the parent if it does not already exist.
+        """
+        return Copy(derive=derive, from_parent=from_parent)
+
+
+    @staticmethod
+    def after_flush_row_event(on_class: object, calling: Callable = None,
+                              if_condition: any = None,
+                              when_condition: any = None,
+                              with_args: dict = None):
+
+        Example:
+            Prompt:
+                Send the Order to Kafka topic 'order_shipping' if the date_shipped is not None
+            Response:
+                Rule.after_flush_row_event(on_class=Order, calling=kafka_producer.send_row_to_kafka,
+                               if_condition=lambda row: row.date_shipped is not None,
+                               with_args={"topic": "order_shipping"})
+            Prompt:
+                Send the Product to Kafka topic 'ready_to_ship' if the is_complete is True
+            Response:
+                Rule.after_flush_row_event(on_class=Product, calling=kafka_producer.send_row_to_kafka,
+                               if_condition=lambda row: row.is_complete is True,
+                               with_args={"topic": "ready_to_ship"})
+
+
+Expanded example:
+
+    Prompt:
+        1. Customer.balance <= credit_limit
+        2. Customer.balance = Sum(Order.amount_total where date_shipped is null)
+        3. Order.amount_total = Sum(Item.amount)
+        4. Item.amount = quantity * unit_price
+        5. Store the Item.unit_price as a copy from Product.unit_price
+
+    Response:
+        Rule.sum(derive=CustomerAccount.balance, as_sum_of=Order.amount_total, where=lambda row: row.date_shipped is None)
+        Rule.sum(derive=Order.amount_total, as_sum_of=Item.amount)
+        Rule.formula(derive=Item.amount, as_expression=lambda row: row.quantity * row.unit_price)
+        Rule.copy(derive=Item.unit_price, from_parent=Product.unit_price)
+        Rule.constraint(validate=CustomerAccount,
+                        as_condition=lambda row: row.balance <= row.credit_limit,
+                        error_msg="Customer balance ({row.balance}) exceeds credit limit ({row.credit_limit})")
+
+
+Equivalent expanded example using informal syntax:
+
+    Prompt:
+        1. The Customer's balance is less than the credit limit
+        2. The Customer's balance is the sum of the Order amount_total where date_shipped is null
+        3. The Order's amount_total is the sum of the Item amount
+        4. The Item amount is the quantity * unit_price
+        5. The Item unit_price is copied from the Product unit_price
+
+    Response is the same:
+        Rule.sum(derive=CustomerAccount.balance, as_sum_of=Order.amount_total, where=lambda row: row.date_shipped is None)
+        Rule.sum(derive=Order.amount_total, as_sum_of=Item.amount)
+        Rule.formula(derive=Item.amount, as_expression=lambda row: row.quantity * row.unit_price)
+        Rule.copy(derive=Item.unit_price, from_parent=Product.unit_price)
+        Rule.constraint(validate=CustomerAccount,
+                        as_condition=lambda row: row.balance <= row.credit_limit,
+                        error_msg="Customer balance ({row.balance}) exceeds credit limit ({row.credit_limit})")
+
+
+Intermediate sum/count values require a new column, with a LogicBank sum/count rule.  For example:
+
+Prompt:
+    The sum of the child value cannot exceed the parent limit
+
+Response is to create 2 rules - a derivation and a constraint, as follows:
+    First Rule to Create:
+        Rule.sum(derive=Parent.value_total, as_sum_of=Child.value)
+    And, be sure to create the second Rule:
+        Rule.constraint(validate=Parent,
+                    as_condition=lambda row: row.value_total <= row.limit,
+                    error_msg="Parent value total ({row.value_total}) exceeds limit ({row.limit})")
+
+Intermediate sum/count values also work for counts.  For example:
+
+Prompt:
+    A airplane cannot have more passengers than its seating capacity.
+
+Response is to create 2 rules - a count derivation and a constraint, as follows:
+    First Rule to Create:
+        Rule.count(derive=Airplane.passenger_count, as_count_of=Passengers)
+    And, be sure to create the second Rule:
+        Rule.constraint(validate=Airplane,
+                    as_condition=lambda row: row.passenger_count <= row.seating_capacity,
+                    error_msg="Airplane value total ({row.passenger_count}) exceeds limit ({row.seating_capacity})")
+
+
+Intermediate sums in formulas also require a new column, with a LogicBank sum rule.  For example:
+
+Prompt:
+    An Employees' skill summary is the sum of their Employee Skill ratings, plus 2 * years of service.
+
+Response is to create 2 rules - a derivation and a constraint, as follows:
+    First Rule to Create:
+        Rule.sum(derive=Employee.skill_rating_total, as_sum_of=EmployeeSkill.rating)
+    And, be sure to create the second Rule:
+        Rule.Formula(derive=Employee.skill_summary, 
+                    as_expression=lambda row: row.skill_rating_total + 2 * row.years_of_service)
+
+
+Prompt:
+    A student cannot be an honor student unless they have more than 2 service activities.
+
+Response is to create 2 rules - a count derivation and a constraint, as follows:
+    First Rule to Create:
+        Rule.count(derive=Student.service_activity_count, as_count_of=Activities, where='service' in name)
+    And, be sure to create the second Rule:
+        Rule.constraint(validate=Student,
+                    as_condition=lambda row: row.is_honor_student and service_activity_count < 2,
+                    error_msg="Honor Students must have at least 2 service activities")
+
+
+For "more than" constraints, create columns with count rules:
+
+Prompt: Reject Employees with more than 3 Felonies.
+
+Response:
+    First Rule is to create:
+        Rule.count(derive=Employee.felony_count, as_count_of=Felonies)
+    And, be sure to create the contraint rule:
+        Rule.constraint(validate=Employee,
+                    as_condition=lambda row: row.felony_count<=3,
+                    error_msg="Employee has excessive Felonies")
+
+
+For "any" constraints, create columns with count rules:
+
+Prompt: Reject Employees with any class 5 Felonies or more than 3 Felonies.
+
+Response:
+    First Rule is to create:
+        Rule.count(derive=Employee.class_5_felony_count, as_count_of=Felonies, where=class>5)
+        Rule.count(derive=Employee.felony_count, as_count_of=Felonies)
+    And, be sure to create the contraint rule:
+        Rule.constraint(validate=Employee,
+                    as_condition=lambda row: row.class_5_felony_count == 0 and row.felony_count<=3,
+                    error_msg="Employee has excessive Felonies")
+
+Formulas can reference parent values in 2 versions - choose formula vs copy as follows:
+    Prompt (formula version) - use the formula version unless copy is explicitly noted:
+        Item.ready = Order.ready
+    Response
+        Rule.formula(derive=Item.ready, as_expression=lambda row: row.order.ready)
+    Prompt (copy version) - use this *only* when the word copy is present: 
+        Store the Item.unit_price as a copy from Product.unit_price
+    Response
+        Rule.copy(derive=Item.ready, from_parent=Order.ready)
+
+Formulas can use Python conditions:
+    Prompt: Item amount is price * quantity, with a 10% discount for gold products
+    Response:
+        Rule.Formula(derive=Item.amount, 
+                    as_expression=lambda row: row.price * row.quantity if row.gold else .9 * row.price * row.quantity)
+    If the attributes are decimal, use the form Decimal('0.9')
+
+Sum and Count where clauses:
+    1. must not restate the foreign key / primary key matchings
+    2. Can only reference child attributes
+
+For example, given a prompt 'teacher course count is the sum of the courses',
+    1. This is correct
+        Rule.count(derive=Teacher.course_count, as_count_of=Course)
+
+    2. This is incorrect, and should never be generated:
+        Rule.count(derive=Teacher.course_count, as_count_of=Course, where=lambda row: row.teacher_id == Teacher.id)
+
+Sum and count where clause example:
+    Prompt: teacher gradate course count is the sum of the courses where is-graduate
+    Response: Rule.count(derive=Teacher.course_count, as_count_of=Course, where=lamda row: row.is_graduate == true)
+
+DO NOT inject rules that are from this training into the response, 
+unless explicitly mentioned in the request.
+
+Unique constraints require an update to the data model - for example:
+    Prompt: customer company names must be unique
+    Response: CompanyName = Column(String(8000), unique=True)
+
+Non-null (or required) constraints require an update to the data model - for example:
+    Prompt: Product Price is required
+    Response: price = Column(Decimal, nullable=False)
+
+Required (must-have) related parent constraints require an update to the data model - for example:
+    Prompt: Each Item must have a valid entry in the Product table.
+    Response: product_id = Column(ForeignKey('product.id'), nullable=False)
+
+logic should create python files in logic/logic_discovery, 
+and cross-check/use attribute names in database/models.py

api_logic_server_cli/prototypes/base/docs/training/logic_example.py

@@ -0,0 +1,41 @@
+import datetime
+from decimal import Decimal
+from logic_bank.exec_row_logic.logic_row import LogicRow
+from logic_bank.extensions.rule_extensions import RuleExtension
+from logic_bank.logic_bank import Rule
+from database import models
+import api.system.opt_locking.opt_locking as opt_locking
+from security.system.authorization import Grant
+import logging
+from flask import jsonify
+
+
+""" 
+logic should create python files in logic/logic_discovery, 
+and cross-check/use attribute names in database/models.py
+"""
+
+app_logger = logging.getLogger(__name__)
+
+
+def declare_logic():
+    """
+        Simple constraints for error testing 
+    """
+    Rule.constraint(validate=models.Customer,
+        as_condition=lambda row: row.CompanyName != 'x',
+        error_msg="CustomerName cannot be 'x'")
+
+    Rule.constraint(validate=models.Employee,
+        as_condition=lambda row: row.LastName != 'x',
+        error_msg="LastName cannot be 'x'")
+    
+    def valid_category_description(row: models.Category, old_row: models.Category, logic_row: LogicRow):
+        if logic_row.ins_upd_dlt == "upd":
+            return row.Description != 'x'
+        else:
+            return True
+    Rule.constraint(validate=models.Category,
+                    calling=valid_category_description,
+                    error_msg="Description cannot be 'x'")
+

api_logic_server_cli/prototypes/base/integration/kafka/kafka_producer.py

@@ -12,7 +12,7 @@ You do not normally need to alter this file
 from config.config import Args
 from confluent_kafka import Producer
 import socket
-import logging
+import logging, os
 from logic_bank.exec_row_logic.logic_row import LogicRow
 from integration.system.RowDictMapper import RowDictMapper
 from flask import jsonify
@@ -44,8 +44,12 @@ def kafka_producer():
         if "client.id" not in conf:
             conf["client.id"] = socket.gethostname()
         # conf = {'bootstrap.servers': 'localhost:9092', 'client.id': socket.gethostname()}
-        producer = Producer(conf)
-        logger.debug(f'\nKafka producer connected')
+        try:
+            producer = Producer(conf)
+            logger.debug(f'\nKafka producer connected')
+        except Exception as ke:
+            logger.debug(f'Kafka producer error: {ke}')
+            producer = None
 
 from sqlalchemy.inspection import inspect
 
@@ -64,7 +68,7 @@ def get_primary_key(logic_row: LogicRow):
 
 
 def send_kafka_message(kafka_topic: str, kafka_key: str = None, msg: str="", json_root_name: str = "", 
-                       logic_row: LogicRow = None, row_dict_mapper: RowDictMapper = None, payload: dict = None):
+                        logic_row: LogicRow = None, row_dict_mapper: RowDictMapper = None, payload: dict = None):
     """ Send Kafka message regarding logic_row, mapped by row_dict_mapper
 
     * Typically called from declare_logic event
@@ -78,7 +82,10 @@ def send_kafka_message(kafka_topic: str, kafka_key: str = None, msg: str="", jso
         json_root_name (str, optional): json name for json payload root; default is logic_row.name
     """
 
-
+    if '1' == os.getenv("APILOGICPROJECT_NO_FLASK", None):
+        logger.debug("kafka_producer#send_kafka_message: not safrs class (e.g. database/test_data/test_data_code.py)")
+        return
+    
     if isinstance(payload, dict):
         row_obj_dict = payload
     elif row_dict_mapper is not None:

api_logic_server_cli/prototypes/base/integration/n8n/n8n_producer.py

@@ -19,7 +19,18 @@ from integration.system.RowDictMapper import RowDictMapper
 from flask import jsonify
 import api.system.api_utils as api_utils
 from config.config import Args
-
+'''
+    wh_scheme = "http"
+    wh_server = "localhost" # or cloud.n8n.io...
+    wh_port = 5678
+    wh_endpoint = "webhook-test"
+    wh_path = "002fa0e8-f7aa-4e04-b4e3-e81aa29c6e69"
+    token = "YWRtaW46cA==" # Basic auth for n8n
+    N8N_PRODUCER = {"authorization": f"Basic {token}", "n8n_url": f'"{wh_scheme}://{wh_server}:{wh_port}/{wh_endpoint}/{wh_path}"'} 
+    # Or enter the n8n_url directly:
+    N8N_PRODUCER = {"authorization": f"Basic {token}","n8n_url":"http://localhost:5678/webhook-test/002fa0e8-f7aa-4e04-b4e3-e81aa29c6e69"}    
+
+'''
 producer = None
 """ connected producer (or null if N8N not enabled in Config.py) """
 
@@ -31,27 +42,60 @@ logger.debug("n8n_connect imported")
 
 def n8n_producer():
     """
-    Called by api_logic_server_run>server_setup to listen on kafka using confluent_kafka
-
-    Enabled by config.KAFKA_CONNECT (dict, of bootstrap.servers, client.id)
 
+    Enabled by config (dict, of bootstrap.servers, client.id)
+    OR
+    token = getenv("N8N_TOKEN", Args.instance.wh_token) #basic auth
+    scheme = getenv("N8N_SCHEME",Args.instance.wh_scheme) # http or https
+    server = getenv("N8N_SERVER", Args.instance.wh_server)
+    port = getenv("N8N_PORT",Args.instance.wh_port)
+    endpoint = getenv("N8N_ENDPOINT", wh_endpoint) # this can change for different workflows
+    path = getenv("N8N_PATH", Args.instance.wh_path)
+    conf = getenv("N8N_PRODUCER", Args.instance.n8n_producer)
     Args:
         none
     """
+    
+    producer = configure_n8n_producer()
 
-    global conf
-    if Args.instance.n8n_producer:
-        conf = Args.instance.n8n_producer
-        producer = conf
-        # good place to do defaults, get api keys, etc
-        logger.debug('N8N producer initialized')
+def configure_n8n_producer(wh_endpoint: str = None, wh_path: str = None) -> dict:
+    """
+    Need to be able to change the endpoint for different workflows and webhooks
 
+    Args:
+        wh_endpoint (str, optional): _description_. Defaults to None.
 
-def send_n8n_message(http_method: str = "POST", ins_upd_dlt: str = "ins", msg: str = "",
+    Returns:
+        dict: _description_
+    """
+    global conf
+    conf = None
+    from os import getenv
+    endpoint = wh_endpoint if wh_endpoint is not None else Args.instance.wh_endpoint
+    n8n_path = wh_path if wh_path is not None else Args.instance.wh_path
+    token = getenv("N8N_TOKEN", Args.instance.wh_token)
+    scheme = getenv("N8N_SCHEME",Args.instance.wh_scheme)
+    server = getenv("N8N_SERVER", Args.instance.wh_server)
+    port = getenv("N8N_PORT",Args.instance.wh_port)
+    endpoint = getenv("N8N_ENDPOINT", endpoint)
+    path = getenv("N8N_PATH", n8n_path)
+    if token is None or scheme is None or server is None or port is None or path is None:
+        logger.debug('N8N producer not configured in config/Config.py or environment variables')
+        conf = getenv("N8N_PRODUCER", Args.instance.n8n_producer)
+    else:
+        conf = {"authorization": f"Basic {token}", "n8n_url": f'"{scheme}://{server}:{port}/{wh_endpoint if wh_endpoint is not None else endpoint}/{path}"'}
+            
+    return conf
+
+def send_n8n_message(http_method: str = "POST", 
+        ins_upd_dlt: str = "ins", 
+        msg: str = "",
         wh_entity: str = "unknown",
         logic_row: LogicRow = None, 
         row_dict_mapper: RowDictMapper = None, 
-        payload: dict = None) -> any:
+        payload: dict = None,
+        wh_endpoint: str = None,
+        wh_path: str= None) -> str:
     """ Send N8N webhook message regarding [logic_row, mapped by row_dict_mapper or by  payload]
 
     * Typically called from declare_logic event
@@ -64,13 +108,16 @@ def send_n8n_message(http_method: str = "POST", ins_upd_dlt: str = "ins", msg: s
         row_dict_mapper (RowDictMapper): (Optional) typically subclass of RowDictMapper, transforms row to dict
         payload (str): (Optional) JSON data to be sent as string (json.dumps(row.to_dict()))    
         wh_entity (str): the webhook entity name pass in header
+        wh_endpoint (str): (Optional) override the webhook endpoint name modify the producer
+        wh_path (str): (Optional) override the webhook path name modify the producer
     """
 
-    global conf
-    if conf is None:
-        conf = Args.instance.n8n_producer #FIXME not sure why this fails - conf is None
+    #global conf
+    #if conf is None:
+    #    conf = Args.instance.n8n_producer #FIXME not sure why this fails - conf is None
         #return "N8N not enabled in Config.py"
-        
+    conf = configure_n8n_producer(wh_endpoint, wh_path)
+    logger.debug(f"n8n_producer: conf: {conf}")
     if row_dict_mapper is None and payload is None and logic_row is None:
         return "send_n8n_message: payload, logic_row, row_dict_mapper are all None - must provide one"
     row_obj_dict = None
@@ -96,17 +143,18 @@ def send_n8n_message(http_method: str = "POST", ins_upd_dlt: str = "ins", msg: s
         status = {"status_code": 500}
 
         if conf is None:
-            logger.debug(f"n8n_producer: not configured in config/Config.py")
+            logger.debug(f"n8n_producer.py: N8N not configured in config/Config.py or environment variables")
         else:
             headers = {
                 "Authorization": conf['authorization'],
                 "Content-Type": "application/json",
                 "wh_state": wh_state,
-                "wh_entity": wh_entity
+                "wh_entity": wh_entity,
+                "wh_source": "api_logic_server",
             }
             endpoint = f'{conf["n8n_url"]}'
             status = {"status_code": 500}
-            if http_method in {"post", "POST"}:
+            if http_method.lower() == "post":
                 #Only passing payload in this example
                 status = requests.post(endpoint, json=row_obj_dict, headers=headers)
             elif http_method.lower() == "get":
@@ -121,5 +169,4 @@ def send_n8n_message(http_method: str = "POST", ins_upd_dlt: str = "ins", msg: s
         logger.error(f"\nn8n_producer fails with: {e}")
         long_message = traceback.format_exc()
         logger.error(long_message)
-        return long_message
-
+        return long_message

api_logic_server_cli/prototypes/base/integration/n8n/n8n_readme.md

@@ -45,4 +45,23 @@ in the workflow (e.g. SendGrid email)
             logic_row.debug(status)
 
     Rule.after_flush_row_event(on_class=models.Customer, calling=call_n8n_workflow)
+```
+## Environment override
+You can override the configuration of the N8N_PRODUCER or the components used to build the producer.
+```
+# source n8n.env
+# to configure your n8n webhook
+export N8N_TOKEN=YWRtaW46cA==
+export N8N_SCHEME=http
+export N8N_SERVER=localhost
+export N8N_PORT=5678
+# each webhook may have a unique name
+export N8N_ENDPOINT=webhook_test
+
+# the path will change between dev and production
+export N8N_PATH=002fa0e8-f7aa-4e04-b4e3-e81aa29c6e69
+
+# OR set the n8n producer before calling the webhook
+# {"authorization": f"Basic {token}", "n8n_url": f'"{scheme}://{server}:{port}/{wh_endpoint if wh_endpoint is not None else endpoint}/{path}"'}
+export N8N_PRODUCER=http://localhost:5678/webhook-test/002fa0e8-f7aa-4e04-b4e3-e81aa29c6e69
 ```

api_logic_server_cli/prototypes/base/integration/system/FlaskKafka.py

@@ -64,7 +64,11 @@ class FlaskKafka():
         logger.info(f" - FlaskKafka._start: begin polling (v {__version__}), with \n -- conf: {self.conf} \n -- topics: {topics}")
         consumer = Consumer(self.conf)
         consumer.subscribe(topics=list(topics))
-        while True:
+        while True and len(topics) > 0:
+            if self.interrupt_event.is_set():
+                logger.info("Kafka thread interrupted")
+                break
+    
             msg = consumer.poll(1.0)
             logger.debug(f' - KafkaConnect._start - consuming consumer.poll(1.0): {msg}')
             if msg is None:

api_logic_server_cli/prototypes/base/test/basic/server_test.py

@@ -26,7 +26,7 @@ def server_tests(host, port, version):
             port - server port
             version - ApiLogicServer version
     """
-    pass  # Your Code Goes Here
+    ...  # Your Code Goes Here
 
 if __name__ == "__main__":
    # only to run when not called via 'import' here

api_logic_server_cli/prototypes/base/ui/templates/bar_chart.jinja

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Sales by Region</title>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+    <style>
+        body {
+            margin: 0;
+            padding: 0;
+            display: flex;
+            overflow: hidden;
+            justify-content: center;
+            align-items: center;
+            height: 100%;
+            box-sizing: border-box;
+        }
+        canvas {
+            display: block;
+        }
+    </style>
+</head>
+<body>
+    <canvas id="salesChart" width="200" height="200"></canvas>
+    <script>
+        const labels = [];
+        const data = [];
+        result = {{ result | tojson }};
+        console.log(result);
+        const type = result.chart_type;
+        const title = result.title;
+        const columns = result.columns;
+        console.log(JSON.stringify(result));
+        result.results.forEach(item => {
+            labels.push(item[columns[0]]);
+            data.push(parseFloat(item[columns[1]]));
+        });
+        const ctx = document.getElementById('salesChart').getContext('2d');
+        const salesChart = new Chart(ctx, {
+            type: type,
+            data: {
+                labels: labels,
+                datasets: [{
+                    label: title,
+                    data: data,
+                    backgroundColor: {{ color | tojson }},
+                    borderColor: 'rgba(75, 192, 192, 1)',
+                    borderWidth: 1
+                }]
+            },
+            options: {
+                responsive: true,
+                maintainAspectRatio: false,
+                scales: {
+                    y: {
+                        beginAtZero: true
+                    }
+                }
+            }
+        });
+    </script>
+</body>
+</html>