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

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/venv_setup/venv-linux.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+
+if [ $# -eq 0 ]
+    then
+        echo " "
+        echo "Installs virtual environment (as venv)"
+        echo " "
+        echo " IMPORTANT - Linux only, not required for docker-based projects"
+        echo " .. Windows: https://apilogicserver.github.io/Docs/Project-Env/"
+        echo " "
+        echo "Usage:"
+        echo "  cd ApiLogicProject     # your project directory"
+        echo "  sh venv_setup/venv.sh go      # for python3, or..."
+        echo "  sh venv_setup/venv.sh python  # for python"
+        echo " "
+        exit 0
+    fi
+
+if [ "$1" = "python" ]
+    then
+        python -m venv venv
+        . venv/bin/activate  # Mac uses  uses source venv/bin/activate
+        python -m pip install -r requirements.txt
+    else
+        python3 -m venv venv
+        . venv/bin/activate  # Mac uses  uses source venv/bin/activate
+        python3 -m pip install -r requirements.txt
+fi

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/venv_setup/venv.ps1

@@ -0,0 +1,21 @@
+if($args.Count -eq 0) {
+
+        Write-Output " "
+        Write-Output "Installs virtual environment (as venv)"
+        Write-Output " "
+        Write-Output " IMPORTANT - Windows only, not required for docker-based projects"
+        Write-Output " "
+        Write-Output "Usage:"
+        Write-Output "  cd ApiLogicProject  # your project directory"
+        Write-Output "  .\venv_setup\venv.ps1 go"
+        Write-Output " "
+        exit 0
+}
+
+# virtualenv venv
+# venv\Scripts\activate
+# pip install -r requirements.txt  # may require that you update pip version, as recommended
+
+python -m venv venv
+venv\Scripts\activate
+python -m pip install -r requirements.txt  # works for recent Python >= 3.9

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/venv_setup/venv.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+
+if [ $# -eq 0 ]
+    then
+        echo " "
+        echo "Installs virtual environment (as venv)"
+        echo " "
+        echo " IMPORTANT - Mac only, not required for docker-based projects"
+        echo " .. Windows: https://apilogicserver.github.io/Docs/Project-Env/"
+        echo " "
+        echo "Usage:"
+        echo "  cd ApiLogicProject     # your project directory"
+        echo "  sh bin/venv.sh go      # for python3, or..."
+        echo "  sh bin/venv.sh python  # for python"
+        echo " "
+        exit 0
+    fi
+
+if [ "$1" = "python" ]
+    then
+        python -m venv venv
+        source venv/bin/activate   # ubuntu/linux uses . venv/bin/activate
+        python -m pip install -r requirements.txt
+    else
+        python3 -m venv venv
+        source venv/bin/activate   # ubuntu/linux uses . venv/bin/activate 
+        python3 -m pip install -r requirements.txt
+fi

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/graphics_services.py

@@ -0,0 +1,41 @@
+from functools import wraps
+import logging
+from flask_jwt_extended import get_jwt, jwt_required, verify_jwt_in_request
+from config.config import Config, Args
+from security.system.authorization import Security
+import api.system.api_utils as api_utils
+from typing import List
+import safrs
+import sqlalchemy
+from flask import request, jsonify
+from safrs import jsonapi_rpc, SAFRSAPI
+from sqlalchemy.ext.hybrid import hybrid_property
+from sqlalchemy.orm import object_mapper
+from sqlalchemy import extract, func
+from database import models
+from flask_cors import cross_origin
+from logic_bank.rule_bank.rule_bank import RuleBank
+import integration.system.RowDictMapper as row_dict_mapper
+
+# Customize this file to add endpoints/services, using SQLAlchemy as required
+#     Separate from expose_api_models.py, to simplify merge if project rebuilt
+# Called by api_logic_server_run.py
+
+app_logger = logging.getLogger("api_logic_server_app")
+
+# called by api_logic_server_run.py, to customize api (new end points, services).
+# separate from expose_api_models.py, to simplify merge if project recreated
+
+def add_service(app, api, project_dir, swagger_host: str, PORT: str, method_decorators = []):
+    pass
+
+    api.expose_object(GraphicsServices)  # Swagger-visible services
+
+
+"""
+Illustrates #als: apis for graphics
+
+* Custom service - visible in swagger
+"""
+class GraphicsServices(safrs.JABase):
+    pass

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/html_template.jinja

@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Bar Chart Example</title>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+</head>
+<body>
+    <canvas id="myChart" width="400" height="200"></canvas>
+    <script>
+        // Input data
+        fetch('http://localhost:5656/api/GraphicsServices/{{ name }}', {
+            method: 'POST',
+            headers: {
+            'accept': 'application/vnd.api+json',
+            'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({}) // Add any required payload here
+        })
+            .then(response => {
+                if (!response.ok) {
+                    throw new Error(`HTTP error! status: ${response.status}`);
+                }
+                return response.json();
+            })
+            .then(result => {
+                const labels = [];
+                const data = [];
+                const type = result.meta.result.chart_type;
+                const title = result.meta.result.title;
+                const columns = result.meta.result.columns;
+                console.log(JSON.stringify(result));
+                result.meta.result.results.forEach(item => {
+                    labels.push(item[columns[0]]);
+                    data.push(parseFloat(item[columns[1]]));
+                });
+
+                // Create the bar chart
+                const ctx = document.getElementById('myChart').getContext('2d');
+                const myChart = new Chart(ctx, {
+                    type: type,
+                    data: {
+                    labels: labels,
+                    datasets: [{
+                        label: title,
+                        data: data,
+                        backgroundColor: 'rgba(75, 192, 192, 0.2)',
+                        borderColor: 'rgba(75, 192, 192, 1)',
+                        borderWidth: 1
+                    }]
+                    },
+                    options: {
+                    responsive: true,
+                    plugins: {
+                        legend: {
+                        position: 'top',
+                        },
+                        title: {
+                        display: true,
+                        text: title
+                        }
+                    },
+                    scales: {
+                        y: {
+                        beginAtZero: true
+                        }
+                    }
+                    }
+                });
+                })
+                .catch(error => console.error('Error fetching data:', error));
+
+    </script>
+</body>
+</html>

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/index.html

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html>
+
+<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>
+</head>
+<body>
+    <h1>Sales by Region</h1>
+    <p>This page displays a bar chart of sales by region.</p>
+
+    <div style="display: flex; flex-direction: row; width: 50%; height: 100vh;">
+        <iframe id="iframeTarget1" src="http://localhost:5656/sales_by_region" style="flex: 1; border: none;"></iframe>
+    </div>
+
+    
+</html>

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/sales_by_region.jinja

@@ -0,0 +1,63 @@
+<!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;
+            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: 'rgba(75, 192, 192, 0.2)',
+                    borderColor: 'rgba(75, 192, 192, 1)',
+                    borderWidth: 1
+                }]
+            },
+            options: {
+                responsive: true,
+                maintainAspectRatio: false,
+                scales: {
+                    y: {
+                        beginAtZero: true
+                    }
+                }
+            }
+        });
+    </script>
+</body>
+</html>

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/service_template_jsonapi_rpc.jinja

@@ -0,0 +1,37 @@
+
+    @classmethod
+    @jsonapi_rpc(http_methods=['POST','GET', 'OPTIONS'])
+    def {{name}}(self, *args, **kwargs):
+        """        
+        Illustrates:
+        * Complex query with multiple joins, for graphics
+        * That Thomas is a duck.
+        
+        """
+        if request.method == 'OPTIONS':
+            return jsonify({ "result": "ok" })
+            
+        from database.models import {{classes_used}}
+        db = safrs.DB
+        session = db.session    # sqlalchemy.orm.scoping.scoped_session
+        # Security.set_user_sa()  # an endpoint that requires no auth header (see also @bypass_security)
+
+        # SQLAlchemy query
+        query = {{sqlalchemy_query}} 
+        # Execute query and fetch results
+        results = query.all()
+        from decimal import Decimal
+        columns = ['RegionDescription', 'TotalSales']  # {{ xAxis }} {{ yAxis }}
+        results = [{columns[0]: row[0], columns[1]: str(Decimal(row[1]).quantize(Decimal('0.01')))} for row in results]
+        title = "Sales by Region" # {{ title }}
+        chart_type = 'bar' # {{ chart_type }}
+        json_results = {
+            "results": results,
+            "columns": columns,
+            "title": title,
+            "chart_type": "bar",
+            "xAxis": columns[0],
+            "yAxis": columns[1],
+        }
+        
+        return json_results 

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/service_template_unused.jinja

@@ -0,0 +1,38 @@
+from flask import request, jsonify
+import logging
+import safrs
+from sqlalchemy.orm import aliased
+from sqlalchemy import extract, func
+from database.models import {{classes_used}}
+
+app_logger = logging.getLogger("api_logic_server_app")
+
+def add_service(app, api, project_dir, swagger_host: str, PORT: str, method_decorators = []):
+    pass
+
+    @app.route('/{{name}}, methods=["GET","OPTIONS"]')
+    def {{name}}():
+        """        
+        Illustrates:
+        * Complex query with multiple joins
+
+        Test it with:
+        
+                curl -X GET "http://localhost:5656/{{name}}"
+        
+        """
+        if request.method == 'OPTIONS':
+            return jsonify({ "result": "ok" })
+            
+        from api.api_discovery.graphics_services import GraphicsServices 
+        results = GraphicsServices.{{ name }}()
+        # Render the HTML template with the results
+        # Ensure the template is located in the "templates" directory relative to the project root.
+        from jinja2 import Environment, FileSystemLoader
+        from flask import Response
+        env = Environment(loader = FileSystemLoader('templates')) # create a templates folder in root path and add jinja files
+        template = env.get_template('{{ name }}.jinja')
+        output = template.render(result=results)
+        print(output)
+    
+        return output

api_logic_server_cli/prototypes/manager/system/genai/learning_requests/logic_bank_api.prompt

@@ -10,7 +10,7 @@ Use only the methods provided below.
 
 
 class Rule:
-    """Invoke these functions to declare rules in the created declare_logic function.  """
+    """ Invoke these functions to declare rules """
 
     @staticmethod
     def sum(derive: Column, as_sum_of: any, where: any = None, insert_parent: bool=False):
@@ -149,50 +149,40 @@ class Rule:
 
 Expanded example:
 
-Prompt:
-
-    Use Logic Bank to enforce the Check Credit requirement (do not generate check constraints):
+    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:
-
-def declare_logic():  # created by Web/GenAI for ApiLogicServer, LogicBank
-    
-    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})")
+    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:
-
-    Use Logic Bank to enforce the Check Credit requirement (do not generate check constraints):
+    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:
-
-def declare_logic():  # created by Web/GenAI for ApiLogicServer, LogicBank
-    
-    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})")
+    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:
@@ -246,19 +236,6 @@ Response is to create 2 rules - a count derivation and a constraint, as follows:
                     as_condition=lambda row: row.is_honor_student and service_activity_count < 2,
                     error_msg="Honor Students must have at least 2 service activities")
 
-Here is an equivalent request:
-
-Prompt:
-    A airplane's passengers must be less 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})")
-
 
 For "more than" constraints, create columns with count rules:
 

api_logic_server_cli/prototypes/manager/system/genai/prompt_inserts/graphics.prompt

@@ -0,0 +1,18 @@
+
+Create WGResult Graphics for prompts like 'graph sales by region'.
+    * use 'sales by region' to create a WGResult Graphic.sqlalchemy_query
+    * Be sure to use class names, not table names
+    * for example, using Northwind:
+        # SQLAlchemy query for Sales by Category
+        sales_by_category = (
+            session.query(
+                Category.CategoryName,
+                func.sum(OrderDetail.Quantity * OrderDetail.UnitPrice * (1 - OrderDetail.Discount)).label("TotalSales")
+            )
+            .join(Product, category.Id == Product.CategoryId)
+            .join(OrderDetail, Product.Id == OrderDetail.ProductId)
+            .join(Order, OrderDetail.OrderId == Order.Id)
+            .filter(Order.ShippedDate.isnot(None))  # Consider only shipped orders
+            .group_by(Category.CategoryName)
+            .order_by(func.sum(OrderDetail.Quantity * OrderDetail.UnitPrice * (1 - OrderDetail.Discount)).desc())
+        )

api_logic_server_cli/prototypes/manager/system/genai/prompt_inserts/graphics_request.prompt

@@ -0,0 +1,5 @@
+You are a data modelling expert and python software architect who expands on user input ideas. 
+
+{{% include 'response_format.prompt' % }}
+
+{{% include 'graphics.prompt' % }}

api_logic_server_cli/prototypes/manager/system/genai/prompt_inserts/response_format.prompt

@@ -17,10 +17,18 @@ class TestDataRow(BaseModel):
     test_data_row_variable: str  # the Python test data row variable
     code: str  # Python code to create a test data row instance
 
+class Graphic(BaseModel):
+    sqlalchemy_query: str  # sqlalchemy query using group by, returns result = { "result": [ ("name", "value")  ] }
+    sql_query: str  # sql query using group by, returns result = { "result": [ ("name", "value")  ] }
+    classes_used: str # comma-delimited list of classes used in sqlalchemy_query
+    name: str  # suggested Python name for sqlalchemy_query
+    html_code: str # create a java script app to show a bar chart from sqlalchemy_query result
+
 class WGResult(BaseModel):  # must match system/genai/prompt_inserts/response_format.prompt
     # response: str # result
     models : List[Model] # list of sqlalchemy classes in the response
     rules : List[Rule] # list rule declarations
+    graphics: List[Graphic] # list of Graphic objects
     test_data: str
     test_data_rows: List[TestDataRow]  # list of test data rows
     test_data_sqlite: str # test data as sqlite INSERT statements

api_logic_server_cli/prototypes/manager/system/genai/prompt_inserts/sqlite_inserts.prompt

@@ -6,4 +6,6 @@ Requirements:
 
 {{% include 'sqlite_inserts_model_test_hints.prompt' % }}
 
+{{% include 'graphics.prompt' % }}
+
 {{% include 'response_format.prompt' % }}

api_logic_server_cli/prototypes/manager/webgenai/docker-compose.yml

@@ -0,0 +1,27 @@
+# Run WebGenAI locally from docker container
+
+# cd webgenai
+
+# docker compose up
+# docker compose down
+
+name: webgenai
+services:
+    web_genai:
+        stdin_open: true
+        tty: true
+        container_name: webgenai
+        ports:
+            - 8282:80
+        volumes:
+            - ./webg_temp:/tmp
+            - ./webg_config:/config
+            - ./webg_projects:/opt/projects
+        image: apilogicserver/web_genai 
+        user: root
+        environment:
+            - APILOGICPROJECT_EXTERNAL_PORT=8282
+            - APILOGICPROJECT_PORT=5657
+            - APILOGICPROJECT_EXTERNAL_HOST=localhost
+            - GENAI_LOGIC_APIKEY=<paste license here from registration email>
+            - APILOGICSERVER_CHATGPT_APIKEY=<sk-proj-your-openai-key-here>    

api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category.py

@@ -0,0 +1,50 @@
+from flask import request, jsonify
+import logging
+import safrs
+from sqlalchemy.orm import aliased
+from sqlalchemy import func
+from database.models import Category, Product, OrderDetail, Order
+
+app_logger = logging.getLogger("api_logic_server_app")
+
+def add_service(app, api, project_dir, swagger_host: str, PORT: str, method_decorators = []):
+    pass
+
+    @app.route('/sales_by_category')
+    def sales_by_category():
+        """        
+        Illustrates:
+        * Complex query with multiple joins
+
+        Test it with:
+        
+                curl -X GET "http://localhost:5656/sales_by_category"
+        
+        """
+        db = safrs.DB           # Use the safrs.DB, not db!
+        session = db.session    # sqlalchemy.orm.scoping.scoped_session
+        # Security.set_user_sa()  # an endpoint that requires no auth header (see also @bypass_security)
+
+        # Alias tables for better readability
+        category = aliased(Category)
+        product = aliased(Product)
+        order_detail = aliased(OrderDetail)
+        order = aliased(Order)
+
+        # SQLAlchemy query for Sales by Category
+        sales_by_category = (
+            session.query(
+                category.CategoryName,
+                func.sum(order_detail.Quantity * order_detail.UnitPrice * (1 - order_detail.Discount)).label("TotalSales")
+            )
+            .join(product, category.Id == product.CategoryId)
+            .join(order_detail, product.Id == order_detail.ProductId)
+            .join(order, order_detail.OrderId == order.Id)
+            .filter(order.ShippedDate.isnot(None))  # Consider only shipped orders
+            .group_by(category.CategoryName)
+            .order_by(func.sum(order_detail.Quantity * order_detail.UnitPrice * (1 - order_detail.Discount)).desc())
+        )
+
+        # Execute query and fetch results
+        results = sales_by_category.all()
+        return jsonify( { "result": results } )

api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category_bar_chart.html

@@ -0,0 +1,61 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Bar Chart Example</title>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+</head>
+<body>
+    <canvas id="myChart" width="400" height="200"></canvas>
+    <script>
+        // Input data
+        const result = {
+            "result": [
+                "('Beverages', Decimal('262288.9800000000'))",
+                "('Dairy Products', Decimal('230535.1650000000'))",
+                "('Confections', Decimal('164672.0520000000'))",
+                "('Meat/Poultry', Decimal('162132.2095000000'))",
+                "('Seafood', Decimal('129548.6375000000'))",
+                "('Condiments', Decimal('105047.1850000000'))",
+                "('Produce', Decimal('93117.7975000000'))",
+                "('Grains/Cereals', Decimal('90779.5825000000'))"
+            ]
+        };
+
+        // Parse the input data
+        const labels = [];
+        const data = [];
+        result.result.forEach(item => {
+            const match = item.match(/\('(.+)', Decimal\('([\d.]+)'\)\)/);
+            if (match) {
+                labels.push(match[1]);
+                data.push(parseFloat(match[2]));
+            }
+        });
+
+        // Create the bar chart
+        const ctx = document.getElementById('myChart').getContext('2d');
+        const myChart = new Chart(ctx, {
+            type: 'bar',
+            data: {
+                labels: labels,
+                datasets: [{
+                    label: 'Sales',
+                    data: data,
+                    backgroundColor: 'rgba(75, 192, 192, 0.2)',
+                    borderColor: 'rgba(75, 192, 192, 1)',
+                    borderWidth: 1
+                }]
+            },
+            options: {
+                scales: {
+                    y: {
+                        beginAtZero: true
+                    }
+                }
+            }
+        });
+    </script>
+</body>
+</html>

api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category_bar_chart_app.request

@@ -0,0 +1 @@
+create a java script app to show a bar chart from this input: result = { "result": [ "('Beverages', Decimal('262288.9800000000'))", "('Dairy Products', Decimal('230535.1650000000'))", "('Confections', Decimal('164672.0520000000'))", "('Meat/Poultry', Decimal('162132.2095000000'))", "('Seafood', Decimal('129548.6375000000'))", "('Condiments', Decimal('105047.1850000000'))", "('Produce', Decimal('93117.7975000000'))", "('Grains/Cereals', Decimal('90779.5825000000'))" ] }

api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category_bar_chart_query.request

@@ -0,0 +1,3 @@
+Northwind Sales by Category as a SQLAlchemy qry
+
+-- see api/api_discovery/sales_by_category.py