PyPI - ApiLogicServer - Versions diffs - 14.5.16__py3-none-any.whl → 15.0.0__py3-none-any.whl - Mend

ApiLogicServer 14.5.16py3-none-any.whl → 15.0.0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

api_logic_server_cli/api_logic_server.py CHANGED Viewed

@@ -12,10 +12,10 @@ ApiLogicServer CLI: given a database url, create [and run] customizable ApiLogic
 Called from api_logic_server_cli.py, by instantiating the ProjectRun object.
 '''
-__version__ = "14.05.16"  # last public release: 14.05.00
+__version__ = "15.00.00"  # last public release: 15.00.00 (14.05.04)
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
-    "\t05/28/2024 - 14.05.16: tour - re-factored default mcp req with generic Post, email stub, use basic_demo custs for genai_demo \n"\
+    "\t05/28/2024 - 15.00.00: MCP \n"\
     "\t05/16/2024 - 14.05.00: safrs 3.1.7, running mcp preview \n"\
     "\t04/27/2024 - 14.04.00: Graphics preview, Vibe install fix, Improved IDE Chat Logic, MCP Exploration \n"\
     "\t03/30/2024 - 14.03.25: WebGenAI fixes for Kafka and Keycloak \n"\

api_logic_server_cli/api_logic_server_info.yaml CHANGED Viewed

@@ -1,3 +1,3 @@
-last_created_date: May 27, 2025 20:52:10
-last_created_project_name: samples/nw_sample_nocust
-last_created_version: 14.05.12
+last_created_date: May 28, 2025 12:08:45
+last_created_project_name: /Users/val/dev/ApiLogicServer/ApiLogicServer-dev/servers/basic_demo
+last_created_version: 14.05.16

api_logic_server_cli/create_from_model/__pycache__/dbml.cpython-312.pyc CHANGED Viewed

Binary file

api_logic_server_cli/create_from_model/dbml.py CHANGED Viewed

@@ -242,6 +242,9 @@ def create(model_creation_services: create_from_model.ModelCreationServices):
     """ called by ApiLogicServer CLI -- creates ui/admin application (ui/admin folder, admin.yaml)
     """
     dbml_creator = DBMLCreator(model_creation_services)
-    dbml_creator.create_docs_dbml_file()
-    dbml_creator.create_docs_mcp()
+    if dbml_creator.mod_gen.project.add_auth_in_progress == False:
+        dbml_creator.create_docs_dbml_file()
+        dbml_creator.create_docs_mcp()
+    else:
+        pass  #

api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/email_request.py CHANGED Viewed

@@ -16,9 +16,11 @@ def declare_logic():
         This illustrates the request pattern.
         The request pattern is a common pattern in API Logic Server,
-        where an insert triggers service invocation, such as sending email.
+        where an insert into SysEmail triggers service invocation, such as sending email.
+        See https://apilogicserver.github.io/Docs/Integration-MCP/.
-        The Email table includes the columns for the email (e,g, recipient, subject, message).
+        The SysEmail table includes the columns for the email (e,g, recipient, subject, message).
         Using a request object enables you to wrap the service call with logic, eg:

api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/mcp_client_executor_request.py CHANGED Viewed

@@ -281,13 +281,9 @@ def declare_logic():
         This illustrates the request pattern.
         The request pattern is a common pattern in API Logic Server,
-        where an insert triggers service invocation, such as sending email.
+        where an insert triggers service invocation, such as sending email or issue mcp requests.
-        The Email table includes the columns for the email (e,g, recipient, subject, message).
-        Using a request object enables you to wrap the service call with logic, eg:
-        * *email requirement: do not send mail if customer has opted out*
+        The SysMCP table captures the prompt (in the row); this logic executes the MCP processing.
         See: https://apilogicserver.github.io/Docs/Integration-MCP/#3a-logic-request-pattern
     """
@@ -296,9 +292,11 @@ def declare_logic():
     def mcp_client_executor(row: models.SysMcp, old_row: models.SysMcp, logic_row: LogicRow):
         """
-        #als: create an MCP request
+        #als: create an MCP request.  See https://apilogicserver.github.io/Docs/Integration-MCP/
-        curl -X 'POST' 'http://localhost:5656/api/SysMcp/' -H 'accept: application/vnd.api+json' -H 'Content-Type: application/json' -d '{ "data": { "attributes": {"request": "List the orders date_shipped is null and CreatedOn before 2023-07-14, and send a discount email (subject: '\''Discount Offer'\'') to the customer for each one."}, "type": "SysMcp"}}'
+        Test:
+        * `curl -X 'POST' 'http://localhost:5656/api/SysMcp/' -H 'accept: application/vnd.api+json' -H 'Content-Type: application/json' -d '{ "data": { "attributes": {"request": "List the orders date_shipped is null and CreatedOn before 2023-07-14, and send a discount email (subject: '\''Discount Offer'\'') to the customer for each one."}, "type": "SysMcp"}}'`
+        * Or, use the Admin App and insert a row into SysMCP (see `query_example`, below)
         Args:
             row (Mcp): inserted MCP with prompt
@@ -311,7 +309,7 @@ def declare_logic():
         query = row.request
         prompt = get_user_nl_query_and_training(query)
-        tool_context = query_llm_with_nl(schema_text, prompt)    # see: 2-tool-context-from-LLM
+        tool_context = query_llm_with_nl(schema_text, prompt)   # see: 2-tool-context-from-LLM
         mcp_response = process_tool_context(tool_context)       # see: 3-MCP-server response

api_logic_server_cli/prototypes/manager/{REAMDE.md → README.md} RENAMED Viewed

@@ -1,7 +1,7 @@
 ---
 title: Welcome
 Description: Instant mcp-enabled microservices, standard projects, declarative business logic
-version info: 2.0 (05/24/2025)
+version info: 2.0 (05/24/2025) from install
 ---
 <style>
   .md-typeset h1,
@@ -250,7 +250,9 @@ Observe the rules firing in the console log - see Logic In Action, below.
 <summary>See Logic In Action </summary>
-<br>
+<br>[Declare logic](Logic.md#declaring-rules){:target="_blank" rel="noopener"} with WebGenAI, or in your IDE using code completion or Natural Language:
+![Nat Lang Logic](images/sample-ai/copilot/copilot-logic-chat.png)
 **a. Chaining**
@@ -263,6 +265,9 @@ Note that it's a `Multi-Table Transaction`, as indicated by the indentation.  Th
 **b. 40X More Concise**
 The 5 spreadsheet-like rules represent the same logic as 200 lines of code, [shown here](https://github.com/valhuber/LogicBank/wiki/by-code).  That's a remarkable 40X decrease in the backend half of the system.
+> 💡 No FrankenCode<br>Note the rules look like syntactically correct requirements.  They are not turned into piles of unmanageable "frankencode" - see [models not frankencode](https://www.genai-logic.com/faqs#h.3fe4qv21qtbs){:target="_blank" rel="noopener"}.
 <br><br>
 **c. Automatic Re-use**
@@ -285,6 +290,29 @@ Optionally, you can use the Behave TDD approach to define tests, and the Rules R
 &nbsp;
+### Logic-Enabled MCP
+Logic is automatically executed in your MCP-enabled API.  For example, consider the following MCP orchestration:
+```
+List the orders date_shipped is null and CreatedOn before 2023-07-14,
+and send a discount email (subject: 'Discount Offer') to the customer for each one.
+```
+When sending email, we require a business rules to ensure it respects the opt-out policy:
+![email request](images/integration/mcp/3a-email-logic.png)
+With the server running, test it by posting to `SysMCP` like this:
+```bash
+curl -X 'POST' 'http://localhost:5656/api/SysMcp/' -H 'accept: application/vnd.api+json' -H 'Content-Type: application/json' -d '{ "data": { "attributes": {"request": "List the orders date_shipped is null and CreatedOn before 2023-07-14, and send a discount email (subject: '\''Discount Offer'\'') to the customer for each one."}, "type": "SysMcp"}}'
+```
+For more on MCP, [click here](Integration-MCP.md){:target="_blank" rel="noopener"}.
+&nbsp;
 ## 4. Iterate with Rules and Python
 Not only are spreadsheet-like rules 40X more concise, they meaningfully simplify maintenance.  Let's take an example:

{apilogicserver-14.5.16.dist-info → apilogicserver-15.0.0.dist-info}/METADATA RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ApiLogicServer
-Version: 14.5.16
+Version: 15.0.0
 Author-email: Val Huber <apilogicserver@gmail.com>
 License: BSD-3-Clause
 Project-URL: Homepage, https://www.genai-logic.com
@@ -84,7 +84,7 @@ Dynamic: license-file
 # TL;DR
-Create an executable project (API and Admin App) from a database or natural language prompt with 1 command, customize with declarative rules and Python in your IDE, containerize and deploy.
+Create an executable project (MCP-enabled API and Admin App) from a database or natural language prompt with 1 command; customize with declarative rules and Python in your IDE, containerize and deploy.
 &nbsp;
@@ -136,7 +136,7 @@ For Developers and their organizations seeking to **increase business agility,**
 API Logic Server provides ***Microservice Automation:*** create executable projects with 1 command:
-1. ***API Automation:*** crud for each table, with pagination, optimistic locking, filtering and sorting, and
+1. ***MCP-enabled API Automation:*** crud for each table, with pagination, optimistic locking, filtering and sorting, and
 2. ***App Automation:*** a multi-page, multi-table Admin App.  <br>

{apilogicserver-14.5.16.dist-info → apilogicserver-15.0.0.dist-info}/RECORD RENAMED Viewed

@@ -1,6 +1,6 @@
 api_logic_server_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-api_logic_server_cli/api_logic_server.py,sha256=wdAMi8pOS75vfxEjbqZFlmyDDRJARIKhtyBzSUNrwmQ,96180
-api_logic_server_cli/api_logic_server_info.yaml,sha256=fc8tW0mwphoVmben9kMc1cAI3Yp_J1CdY8ZVcp9ulYg,124
+api_logic_server_cli/api_logic_server.py,sha256=JGttj16Oh5RYnnl5vT6AFWZDa3JQJAAZWrzXW0jK0Lc,96093
+api_logic_server_cli/api_logic_server_info.yaml,sha256=gry1dTWvFjC4Uj6p2hm6zI9z1_MGnigzFXxFj-QFO40,167
 api_logic_server_cli/cli.py,sha256=AT1cWszOygHWIbpxDoXFhaTeSai3Tf5SbGoXvN4h510,83134
 api_logic_server_cli/cli_args_base.py,sha256=lr27KkOB7_WpZwTs7LgiK8LKDIHMKQkoZCTnE99BFxw,3280
 api_logic_server_cli/cli_args_project.py,sha256=I5no_fGRV_ZsK3SuttVDAaQYI4Q5zCjx6LojGkM024w,4645
@@ -13,7 +13,7 @@ api_logic_server_cli/create_from_model/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JC
 api_logic_server_cli/create_from_model/api_expose_api_models_creator.py,sha256=V-u3Hm404doztw66YuD2A043RCFmtw5QF5tMioC_1b0,7900
 api_logic_server_cli/create_from_model/api_logic_server_utils.py,sha256=G5ifhuR8OIujUHoklZ-XZyowCpUGKJrkLuyB9sSEf34,26728
 api_logic_server_cli/create_from_model/create_db_from_model.py,sha256=2H7slGnk39XOSnvL7vxrg6Ewx4bxeBJBgLo8fcXHTB4,4382
-api_logic_server_cli/create_from_model/dbml.py,sha256=1MeLhdIo7cS40ddxnRk7_tqs5gxYfFwO-QlgvRpb9I0,11387
+api_logic_server_cli/create_from_model/dbml.py,sha256=Ef23JIB4IuPsef-QrJ2LTfiKBGRr2ddNSS6RWEh7sKs,11489
 api_logic_server_cli/create_from_model/meta_model.py,sha256=ERf7tSgnSJSeRMVyggkdg-lvORQZSbfK0KMpL63qSEY,5837
 api_logic_server_cli/create_from_model/model_creation_services.py,sha256=B86ljgUR98H_dCaxqiw-flrbvc05-XXtkC5It2BSezs,41479
 api_logic_server_cli/create_from_model/ont_build.py,sha256=5BcmM0xW-0vjr9J_u1o0_3joLfKhcLeDWP31dcy5dzI,67028
@@ -24,7 +24,7 @@ api_logic_server_cli/create_from_model/__pycache__/__init__.cpython-312.pyc,sha2
 api_logic_server_cli/create_from_model/__pycache__/api_expose_api_models_creator.cpython-312.pyc,sha256=3wtCiVHOjOgIonZOgnCsF2p01zcXIapx1_Tq2LwzY6Q,6989
 api_logic_server_cli/create_from_model/__pycache__/api_logic_server_utils.cpython-312.pyc,sha256=Qa-lL19TM5dAwMgVmT6ld7iB_Bb7RR0oYpEzlC2UmHM,27403
 api_logic_server_cli/create_from_model/__pycache__/create_db_from_model.cpython-312.pyc,sha256=5eE8pIEa-OoUOk0xn_b78cCc9dSmxjTMn3HGJbxbFY4,4799
-api_logic_server_cli/create_from_model/__pycache__/dbml.cpython-312.pyc,sha256=a0T97WPNlfceDcpi7VQfXlIPCgn36aXxmtnMJ-cVSfQ,12537
+api_logic_server_cli/create_from_model/__pycache__/dbml.cpython-312.pyc,sha256=TK55yhQ53rEetYDm89ztvEIDPLnjMuYQ5_kJqaCio9I,12671
 api_logic_server_cli/create_from_model/__pycache__/meta_model.cpython-312.pyc,sha256=BH5Cflj8YKf0CVkHpIZ_3eBbHXhwIWbwsrzM7DsEikE,7098
 api_logic_server_cli/create_from_model/__pycache__/model_creation_services.cpython-312.pyc,sha256=_pJPTvkJL22Eu1BWM48VfXcyapD366OnXBqHGn-wtO0,36462
 api_logic_server_cli/create_from_model/__pycache__/ont_build.cpython-312.pyc,sha256=Hni6k7GidAkkz-YO2kvmQOMYdCdCWvGWxX3HIPjj1eE,75285
@@ -715,8 +715,8 @@ api_logic_server_cli/prototypes/basic_demo/customizations/integration/mcp/mcp_to
 api_logic_server_cli/prototypes/basic_demo/customizations/integration/mcp/test_notes.txt,sha256=71Qqw7FRVGtEoHCxlGRPpaizvBh1L-X-MTOwkZ6CY3A,11126
 api_logic_server_cli/prototypes/basic_demo/customizations/logic/cocktail-napkin.jpg,sha256=5rNSy6wvcWSHPJQZqkf2DHs19QLWiyqMBNwxGqjstZU,133075
 api_logic_server_cli/prototypes/basic_demo/customizations/logic/declare_logic.py,sha256=Yk-X017gZM1egx4MXSx_FGURj4KDqJfpq1NWVFrwfEY,4612
-api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/email_request.py,sha256=_ky4ZAggiH3-V1-_V4j7pBZ0gWju8cDCZP48d_Y-otw,1765
-api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/mcp_client_executor_request.py,sha256=vwdEZqsiOwxA-loFvjFetGi9zBnOnoPvrwm3PQhtAQA,14226
+api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/email_request.py,sha256=3UnBUBpHSThHHRLLJuV-sgRAs6sS-UCzsTjBzf0onns,1851
+api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/mcp_client_executor_request.py,sha256=4v1HOZQRPZCMUeb5_QmMfqMvDr-pmcPfgalWsS1KSQg,14243
 api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/simple_constraints.py,sha256=4HRLOXuLJP1eOosONeEtpA9DehxiZME0-FBKuG1RaI0,760
 api_logic_server_cli/prototypes/basic_demo/customizations/security/declare_security.py,sha256=gbdH29cPY656lgROPm_w20Q-g6AhlIMES3wiIrqBTdk,2439
 api_logic_server_cli/prototypes/basic_demo/customizations/ui/admin/admin.yaml,sha256=y3goVMcxMN4wNLQh4kNJvYuSzpntECeDjwLQF2c1YI4,3494
@@ -762,8 +762,7 @@ api_logic_server_cli/prototypes/genai_demo/logic/readme_declare_logic.md,sha256=
 api_logic_server_cli/prototypes/genai_demo/security/declare_security.py,sha256=L3AL1bgdqIWQxdkJZcFVDOQ0XRpmeLAKqwlAYChFWKo,2108
 api_logic_server_cli/prototypes/genai_demo/ui/admin/admin.yaml,sha256=vMpr6to6g-h9gSuhxfpTeDMw5_R_eUKbV7qXzMEvIyk,3446
 api_logic_server_cli/prototypes/manager/.gitignore,sha256=xfAjNQHokbo6GuN1ghx-eml8tQIzwUczLC_YVzElndI,195
-api_logic_server_cli/prototypes/manager/READMEz.md,sha256=zOnEDVApxPEivo0oZ316eWkr8y0me7wie1An3oJmn9c,23312
-api_logic_server_cli/prototypes/manager/REAMDE.md,sha256=mxcXCV8lx7LcqJO6zL7IveRjDJRrR4VJjoXNW_BGA60,36074
+api_logic_server_cli/prototypes/manager/README.md,sha256=Kx8b1c0tKUbUSmCXtg418Kjc0dHxXavX-xY2zAwB7vM,37543
 api_logic_server_cli/prototypes/manager/run_sample.sh,sha256=eRA-p_Snr7Pwk14wUw5mja2usEcjAKisHVhHMeSaQ68,781
 api_logic_server_cli/prototypes/manager/run_web_genai.sh,sha256=sgjB3vKhkao93Ny3VN0AQ-wonvdBcBIT3rTbyNTMoG8,136
 api_logic_server_cli/prototypes/manager/settings.txt,sha256=_jjL30jomIMxG21edDfrXYRT9Zfgr_0EdUWvcEUOnFQ,368
@@ -6096,9 +6095,9 @@ api_logic_server_cli/tools/mini_skel/database/system/SAFRSBaseX.py,sha256=p8C7AF
 api_logic_server_cli/tools/mini_skel/database/system/TestDataBase.py,sha256=U02SYqThsbY5g3DX7XGaiMxjZBuOpzvtPS6RfI1WQFg,371
 api_logic_server_cli/tools/mini_skel/logic/declare_logic.py,sha256=fTrlHyqMeZsw_TyEXFa1VlYBL7fzjZab5ONSXO7aApo,175
 api_logic_server_cli/tools/mini_skel/logic/load_verify_rules.py,sha256=Rr5bySJpYCZmNPF2h-phcPJ53nAOPcT_ohZpCD93-a0,7530
-apilogicserver-14.5.16.dist-info/licenses/LICENSE,sha256=67BS7VC-Z8GpaR3wijngQJkHWV04qJrwQArVgn9ldoI,1485
-apilogicserver-14.5.16.dist-info/METADATA,sha256=rbwLoeylKyqOeVOChnV4k3Nob77roXRlexs6sXhwwdQ,6525
-apilogicserver-14.5.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-apilogicserver-14.5.16.dist-info/entry_points.txt,sha256=KiLloZJ3c_RW-nIDqBtoE0WEsQTnZ3dELwHLWi23LMA,103
-apilogicserver-14.5.16.dist-info/top_level.txt,sha256=-r0AT_GEApleihg-jIh0OMvzzc0BO1RuhhOpE91H5qI,21
-apilogicserver-14.5.16.dist-info/RECORD,,
+apilogicserver-15.0.0.dist-info/licenses/LICENSE,sha256=67BS7VC-Z8GpaR3wijngQJkHWV04qJrwQArVgn9ldoI,1485
+apilogicserver-15.0.0.dist-info/METADATA,sha256=bWhoBYs468qQj04sZak-1god1nik6X2Gvbo5RJAN2uI,6548
+apilogicserver-15.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+apilogicserver-15.0.0.dist-info/entry_points.txt,sha256=KiLloZJ3c_RW-nIDqBtoE0WEsQTnZ3dELwHLWi23LMA,103
+apilogicserver-15.0.0.dist-info/top_level.txt,sha256=-r0AT_GEApleihg-jIh0OMvzzc0BO1RuhhOpE91H5qI,21
+apilogicserver-15.0.0.dist-info/RECORD,,

api_logic_server_cli/prototypes/manager/READMEz.md DELETED Viewed

@@ -1,667 +0,0 @@
----
-version info: 2.0 (05/24/2025)
----
-## Welcome to GenAI-Logic
-1. ***Instant microservices*** (APIs and Admin Apps) from a database or **GenAI prompt** -- 1 command
-2. ***Customize*** with **Rules** and Python in your IDE: created projects use standard Python libraries (Flask, SQLAlchemy)
-</br>
-You are in the [API Logic Server Manager](https://apilogicserver.github.io/Docs/Manager/).  This is a good place to manage projects, create notes and resources, etc.
-<details markdown>
-<summary>How to Run Projects from the Manager </summary>
-<br>You typically run projects by opening an IDE on the project folder, using provided Run Configurations.
-For a quick preview, you can also run from the Manager; there are 2 ways:
-1. Use ***another instance of VSCode.***  You can *examine* them in this current instance, but *run* them in their own instance.
-    * To do so, you probably want to acquire this extension: `Open Folder Context Menus for VS Code`. It will enable you to open the sample, tutorial or your own projects in another instance of VSCode.
-    * This option provides more Run/Debug options (e.g., run without security, etc),
-2. Or, use the Run/Debug Entry: `API Logic Server Run (run project from manager)`
-</details>
-</br>
-<details markdown>
-<summary>How API Logic Server provides GenAI Microservice Automation </summary>
-&nbsp;
-## Using GenAI Microservice Automation
-Use the CLI (Command Language Interface, in your IDE) to create projects from either existing databases, or GenAI prompts.  This creates a project you can open, run and customize in your IDE.
-[![GenAI Automation](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/sample-ai/copilot/genai-automation-video.png?raw=true)](https://www.youtube.com/watch?v=LSh7mqGiT0k&t=5s "Microservice Automation")
-&nbsp;
-## What Is API Logic Server
-It's an open source Python project consisting of a CLI to create projects, and runtime libraries to execute them.
-[![Architecture](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/Architecture-What-Is.png?raw=true)](https://apilogicserver.github.io/Docs/Architecture-What-Is/#runtimes-and-cli)
-&nbsp;
-## Modern Scalable Runtime Architecture
-Created projects use standard Flask and SQLAlchemy; automation is provided by Logic Bank (the rule engine) and SAFRS (JSON:APIs).  Scripts are provided to containerize projects, and deploy to Azure.
-[![Architecture - Runtime](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/Architecture-Runtime-Stack.png?raw=true)](https://apilogicserver.github.io/Docs/Architecture-What-Is/#key-runtime-components)
-&nbsp;
-</details>
-&nbsp;
-##  Explore Creating Projects
-**Evaluation Guide:** click on the disclosure buttons, below.  Important: look for **readme files.**
-</br>
-<details markdown>
-<summary> 1. Existing Database - pre-installed sample databases </summary>
-<br>For a self-demo, use the CLI (**Terminal > New Terminal**), and try the pre-installed [**Basic Demo**](https://apilogicserver.github.io/Docs/Sample-Basic-Demo/):
-```
-als create --project-name=basic_demo --db-url=basic_demo
-```
-<br>The basic_demo project provides:
-1. A quick look at logic, security and integration
-2. Integration includes Kafka and MCP (**[Model Context Protocol](https://apilogicserver.github.io/Docs/Integration-MCP/)**)
-<br>To create a larger project, try the pre-installed [**northwind database**](https://apilogicserver.github.io/Docs/Tutorial/) (imagine your own database here):
-```
-als create --project-name=nw_sample_nocust --db-url=sqlite:///nw.sqlite
-```
-<br>See **with customizations** in the [pre-created sample apps](#explore-pre-created-samples).  This is an **important learning resource**.
-Then, try your own databases [(db-url examples here)](https://apilogicserver.github.io/Docs/Database-Connectivity/), or experiment with [these Docker databases](https://apilogicserver.github.io/Docs/Database-Docker/).
-</details>
-</br>
-<details markdown>
-<summary> 2. New Database - using GenAI Microservice Automation (Experiment with AI - Signup optional)</summary>
-<br>You can do this with or without signup:
-1. If you have signed up (see *To obtain a ChatGPT API Key*, below), this will create a new database and project called `genai_demo`, and open the project.  It's created using `genai_demo.prompt`, visible in left Explorer pane:
-```bash
-als genai --using=system/genai/examples/genai_demo/genai_demo.prompt --project-name=genai_demo
-```
-2. ***Or,*** you can simulate the process (no signup) using:
-```bash
-als genai --repaired-response=system/genai/examples/genai_demo/genai_demo.response_example --project-name=genai_demo
-```
-Verify it's operating properly:
-1. Run Configurations are provided to start the server
-2. Verify the logic by navigating to a Customer with an unshipped order, and altering one of the items to have a very large quantity
-3. Observe the constraint operating on the rollup of order amount_totals.
-    * View the logic in `logic/declare_logic.py`
-    * Put a breakpoint on the `as_condition`.  Observe the console log to see rule execution for this multi-table transaction.
-</br>
-<details markdown>
-<summary> To obtain a ChatGPT API Key</summary>
-<br>GenAI-Logic uses OpenAI, which requires an Open API Key:
-1. Obtain one from [here](https://platform.openai.com/account/api-keys) or [here](https://platform.openai.com/api-keys)
-2. Authorize payments [here](https://platform.openai.com/settings/organization/billing/overview)
-</details>
-</br>
-<details markdown>
-<summary> What Just Happened? &nbsp;&nbsp;&nbsp;Next Steps...</summary>
-<br>`genai` processing is shown below (internal steps denoted in grey):
-1. You create your.prompt file, and invoke `als genai --using=your.prompt`.  genai then creates your project as follows:
-    a. Submits your prompt to the `ChatGPT API`
-    b. Writes the response to file, so you can correct and retry if anything goes wrong
-    c. Extracts model.py from the response
-    d. Invokes `als create-from-model`, which creates the database and your project
-2. Your created project is opened in your IDE, ready to execute and customize.
-    a. Review `Tutorial.md`, Explore Customizations.
-![GenAI Automation](system/images/genai.png)
-</details>
-</br>
-<details markdown>
-<summary> You can iterate the logic and data model</summary>
-<br>The approach for an iteration is to create a new project from an existing one:
-1. add another prompt to an existing projects `docs` directory, specifying your changes
-2. use `als genai`, specifying
-    * `--using` existing projects `docs` directory, and
-    * `--project-name` as the output project
- **Logic iterations** are particuarly useful.  For example, here we take the basic check-credit logic, and add:
-> Provide a 10% discount when buying more than 10 carbon neutral products.<br><br>The Item carbon neutral is copied from the Product carbon neutral
-Explore [genai_demo_iteration_discount](system/genai/examples/genai_demo/genai_demo_iteration_discount).  It's an iteration of basic_demo (see system/genai/examples/genai_demo/genai_demo_iteration_discount/002_create_db_models.prompt).  This will add carbon_neutral to the data model, and update the logic to provide the discount:
-```bash title='Iterate Business Logic'
-# Iterate with data model and logic
-als genai --project-name='genai_demo_with_discount' --using=system/genai/examples/genai_demo/genai_demo_iteration_discount
-# open Docs/db.dbml
-```
-<br>
-You can perform **model iterations:** add new columns/tables, while keeping the prior model intact.  First, we create a project with no logic, perhaps just to see the screens (this step is optional, provided just to illustrate that iterations create new projects from existing ones):
-```bash title='Iterate Without Logic'
-# Step 1 - create without logic
-als genai --project-name='genai_demo_no_logic' --using=system/genai/examples/genai_demo/genai_demo_no_logic.prompt
-# open Docs/db.dbml
-```
-Then, we would create another prompt in the docs directory with our model changes. We've already created these for you in `system/genai/examples/genai_demo/genai_demo_iteration` - we use that to alter the data model (see `system/genai/examples/genai_demo/genai_demo_iteration/004_iteration_renames_logic.prompt`):
-```bash title='Iterate With Logic'
-# Iterate with data model and logic
-als genai --project-name='genai_demo_with_logic' --using=system/genai/examples/genai_demo/genai_demo_iteration
-# open Docs/db.dbml
-```
-Explore [genai_demo_iteration](system/genai/examples/genai_demo/genai_demo_iteration) - observe the `--using` is a *directory* of prompts.  These include the prompts from the first example, plus an *iteration prompt* (`004_iteration_renames_logic.prompt`) to rename tables and add logic.
-</details>
-</br>
-<details markdown>
-<summary> You can declare informal logic</summary>
-<br>You can declare rules using dot notation, or more informally:
-```bash title="Informal Logic (no dot notation)"
-als genai --using=system/genai/examples/genai_demo/genai_demo_informal.prompt --project-name=genai_demo_informal
-```
-</details>
-</br>
-<details markdown>
-<summary> Multi-Rule Logic</summary>
-<br>You can add new columns/tables, while keeping the prior model intact:
-```bash title="Multi-Rule Logic"
-als genai --using=system/genai/examples/emp_depts/emp_dept.prompt
-```
-</details>
-</br>
-<details markdown>
-<summary> You can ask AI to suggest logic (great way to learn!)</summary>
-<br>You can create a project, and ask GenAI for logic suggestions:
-```bash title='1. Create Project, without Rules'
-# 1. Create Project, without Rules
-als genai --project-name='genai_demo_no_logic' --using=system/genai/examples/genai_demo/genai_demo_no_logic.prompt
-```
-```bash title="2. Request Rule Suggestions"
-# 2. Request Rule Suggestions
-cd genai_demo_no_logic
-als genai-logic --suggest
-```
-You can review the [resultant logic suggestions](genai_demo_no_logic/docs/logic_suggestions) in the `genai_demo_no_logic` project:
- * See and edit: `docs/logic_suggestions/002_logic_suggestions.prompt` (used in step 3, below)
-    * This corresponds to the Logic Editor - Logic View in the WebGenAI web app
-```bash title="3. See the rules for the logic"
-# 3. See the rule code for the logic
-als genai-logic --suggest --logic='*'
-```
-Important notes about suggestions and generated code:
-* `--suggest --logic='*'` is intended to enable you to identify logic that does not translate into proper code
-* The example above was pretty good, but sometimes the results are downright silly:
-    * Just run suggest again, or
-    * Repair `docs/logic_suggestions/002_logic_suggestions.prompt`
-Also...
-* It is not advised to paste the code into `logic/declare_logic.py`
-    * The suggested logic may result in new data model attributes
-    * These are created automatically by running `als genai` (next step)
-The [logic suggestions directory](genai_demo_no_logic/docs/logic_suggestions) now contains the prompts to create a new project with the suggested logic.
-When you are ready to proceed:
-1. Execute the following to create a *new project* (iteration), with suggested logic:
-```bash title="4. Create a new project with the Rule Suggestions"
-# 4. Create a new project with the Rule Suggestions
-cd ..  # important - back to manager root dir
-als genai --project-name='genai_demo_with_logic' --using=genai_demo_no_logic/docs/logic_suggestions
-```
-Observe:
-1. The created project has the rule suggestions in `logic/declare_logic.py`
-2. A revised Data Model in `database/models.py` that includes attributes introduced by the logic suggestions
-3. Revised test database, initialized to reflect the derivations in the suggested logic
-Internal Note: this sequence available in the run configs (s1/s4).
-</details>
-</br>
-<details markdown>
-<summary>Fixup - update data model with new attributes from rules</summary>
-<br>Fixes project issues by updating the Data Model and Test Data:
-when adding rules, such as using suggestions, you may introduce new attributes.
-If these are missing, you will see exceptions when you start your project.
-The `genai-utils --fixup` fixes such project issues by updating the Data Model and Test Data:
-1. Collects the latest model, rules, and test data from the project.
-2. Calls ChatGPT (or similar) to resolve missing columns or data in the project.
-3. Saves the fixup request/response under a 'fixup' folder.
-4. You then use this to create a new project
-***Setup***
-After starting the [Manager](https://apilogicserver.github.io/Docs/Manager):
-```bash title="0. Create Project Requiring Fixup"
-# 0. Create a project requiring fixup
-als genai --repaired-response=system/genai/examples/genai_demo/genai_demo_fixup_required.json --project-name=genai_demo_fixup_required
-```
-If you run this project, you will observe that it fails with:
-```bash
-Logic Bank Activation Error -- see https://apilogicserver.github.io/Docs/WebGenAI-CLI/#recovery-options
-Invalid Rules:  [AttributeError("type object 'Customer' has no attribute 'balance'")]
-Missing Attrs (try als genai-utils --fixup): ['Customer.balance: constraint']
-```
-&nbsp;
-***Fixup***
-To Fix it:
-```bash title="1. Run FixUp to add missing attributes to the fixup response data model"
-# 1. Run FixUp to add missing attributes to the data model
-cd genai_demo_fixup_required
-als genai-utils --fixup
-```
-Finally, use the created [fixup files](genai_demo_fixup_required/docs/fixup/) to rebuild the project:
-```bash title="2. Rebuild the project from the fixup response data model"
-# 2. Rebuild the project from the fixup response data model
-cd ../
-als genai --repaired-response=genai_demo_fixup_required/docs/fixup/response_fixup.json --project-name=fixed_project
-```
-&nbsp;
-The created project may still report some attributes as missing.
-(ChatGPT seems to often miss attributes mentioned in sum/count where clauses.)  To fix:
-1. Note the missing attributes(s) from the log
-2. Add them to `docs/003_suggest.prompt`
-3. Rebuild the project: `als genai --project-name='genai_demo_with_logic' --using=genai_demo_no_logic/docs`
-Internal Note: this sequence available in the run configs (f1/f2).
-</details>
-</br>
-<details markdown>
-<summary>Create from WebGenAI, and import (merge) subsequent changes</summary>
-<br>You can use [WebGenAI](https://apilogicserver.github.io/Docs/WebGenAI/) to create a project, and export it.
-You (or colleagues) can make changes to both the WebGenAI project (on the web), and your downloaded project.  You can import the WebGenAI project, and the system will merge changes to the data model and rules automatically.
-This is possible since the logic is declarative, so ordering is automatic.  This eliminates the troublesome merge issues so prevalent in procedural code.  For more on import, [click here](https://apilogicserver.github.io/Docs/IDE-Import-WebGenAI/).
-The Manager pre-installs a sample project you can use to explore import:
-```bash
-cd system/genai/examples/genai_demo/wg_dev_merge/dev_demo_no_logic_fixed
-als genai-utils --import-genai --using=../wg_demo_no_logic_fixed
-```
-Observe:
-1. The [data model](system/genai/examples/genai_demo/wg_dev_merge/dev_demo_no_logic_fixed/database) contains `Customer.balance` and `Product.carbon_neutral`
-2. The test data has been updated to include these attributes, with proper values
-</details>
-</br>
-<details markdown>
-<summary>Rebuild the test data</summary>
-<br>Fixes project issues by rebuilding the database to conform to the derivation rules:
-1. Create genai_demo:
-```
-als genai --using=system/genai/examples/genai_demo/genai_demo.prompt --project-name=genai_demo
-```
-2. Rebuild:
-```
-cd genai_demo
-als genai-utils --rebuild-test-data
-```
-</details>
-</br>
-<details markdown>
-<summary> You can also execute directly, and iterate</summary>
-<br>You can add new columns/tables, while keeping the prior model intact:
-```bash title="Iterate"
-# create project without creating a file...
-als genai-create --project-name='customer_orders' --using='customer orders'
-als genai-iterate --using='add Order Details and Products'
-# open Docs/db.dbml
-```
-</details>
-</br>
-<details markdown>
-<summary> AI somtimes fails - here's how to recover</summary>
-<br>AI results are not consistent, so the model file may need corrections.  You can find it at `system/genai/temp/model.py`.  You can correct the model file, and then run:
-```bash
-als create --project-name=genai_demo --from-model=system/genai/temp/create_db_models.py --db-url=sqlite
-```
-Or, correct the chatgpt response, and
-```bash
-als genai --repaired-response=system/genai/examples/genai_demo/genai_demo.response_example --project-name=genai_demo
-```
-We have seen failures such as:
-* duplicate definition of `DECIMAL`
-* unclosed parentheses
-* data type errors in test data creation
-* wrong engine import: from logic_bank import Engine, constraint
-* bad test data creation: with Engine() as engine...
-* Bad load code (no session)
-</details>
-</br>
-<details markdown>
-<summary> Postgresql Example </summary>
-You can test this as follows:
-1. Use [our docker image](https://apilogicserver.github.io/Docs/Database-Docker/):
-2. And try:
-```bash
-als genai --using=system/genai/examples/postgres/genai_demo_pg.prompt --db-url=postgresql://postgres:p@localhost/genai_demo
-```
-Provisos:
-* You have to create the database first; we are considering automating that: https://stackoverflow.com/questions/76294523/why-cant-create-database-if-not-exists-using-sqlalchemy
-</details>
-</details>
-</br>
-<details markdown>
-<summary> 3. New Database - using Copilot (Signup optional) </summary>
-<br>You can use Copilot chat (if extension installed; if not, skip to step 3):
-1. Create a model, eg:
-<details markdown>
-<summary> Show Me How to Use Copilot </summary>
-<br>>Paste this into the Copilot prompt:
-```
-Use SQLAlchemy to create a sqlite database named sample_ai.sqlite, with customers, orders, items and product
-Hints: use autonum keys, allow nulls, Decimal types, foreign keys, no check constraints.
-Include a notes field for orders.
-Create a few rows of only customer and product data.
-Enforce the Check Credit requirement (do not generate check constraints):
-1. Customer.Balance <= CreditLimit
-2. Customer.Balance = Sum(Order.AmountTotal where date shipped is null)
-3. Order.AmountTotal = Sum(Items.Amount)
-4. Items.Amount = Quantity * UnitPrice
-5. Store the Items.UnitPrice as a copy from Product.UnitPrice
-```
-![copilot](system/images/copilot.png)
-</details>
-<br>
-2. Paste the copilot response into a new `sample_ai.py` file
-3. Create your project:
-```bash
-als create --project-name=sample_ai --from-model=sample_ai.py --db-url=sqlite
-```
-4. This will create your database, create an API Logic Project from it, and launch your IDE.
-5. Create business logic
-    * You can create logic with either your IDE (and code completion), or Natural Language
-    * To use Natural Language:
-        1. Use the CoPilot chat,
-        2. Paste the logic above
-        3. Copy it to `logic/declare_logic.py` after `discover_logic()`
-            * Alert:  Table and Column Names may require correction to conform to the model
-            * Alert: you may to apply [defaulting](https://apilogicserver.github.io/Docs/Logic-Use/#insert-defaulting), and initialize derived attributes in your database
-</details>
-</br>
-<details markdown>
-<summary> 4. New Database - using ChatGPT in the Browser (Signup not required)</summary>
-<br>A final option for GenAI is to use your Browser with ChatGPT.
-Please see [this doc](https://apilogicserver.github.io/Docs/Sample-AI-ChatGPT/)
-</details>
-&nbsp;
-## Explore Pre-created Samples
-<details markdown>
-<summary> Explore Pre-created Samples</summary>
-<br>The `samples` folder has pre-created important projects you will want to review at some point (Important: look for **readme files**):
-* [nw_sample_nocust](https://apilogicserver.github.io/Docs/Tutorial/) - northwind (customers, orders...) database
-    * This reflects the results you can expect with your own databases
-* [nw_sample](https://apilogicserver.github.io/Docs/Sample-Database/) - same database, but with ***with [customizations](https://apilogicserver.github.io/Docs/IDE-Customize/) added***.  It's a great resource for exploring how to customize your projects.
-    * Hint: use your IDE to search for `#als`
-* [tutorial](https://apilogicserver.github.io/Docs/Tutorial/) - short (~30 min) walk-through of using API Logic Server using the northwind (customers, orders...) database
-</br>
-<details markdown>
-<summary>You can always re-create the samples</summary>
-<br>Re-create them as follows:
-1. Open a terminal window (**Terminal > New Terminal**), and paste the following CLI command:
-```bash
-ApiLogicServer create --project-name=samples/tutorial --db-url=
-ApiLogicServer create --project-name=samples/nw_sample --db-url=nw+
-ApiLogicServer create --project-name=samples/nw_sample_nocust --db-url=nw
-```
-</details>
-</details>
-&nbsp;
-## Explore WebGenAI
-In addition to the CLI examples above, you can use [WebGenAI](https://apilogicserver.github.io/Docs/WebGenAI/) - a web interface for creating projects from prompts.  You can install WebGenAI on a server, so that created projects are easy to review with colleagues.
-To try WebGenAI:
-```bash
-cd webgenai
-docker compose up
-```
-You will be directed to the registration process.  You will also require a ChatGPT API Key as described above.
-&nbsp;
-&nbsp;
-## Appendix: Quick Basic Demo
-This is a "cheat sheet" for experienced ALS users, e.g., to show your colleagues.
-<details markdown>
-<summary>Quick Basic Demo - Instructions</summary>
-<br>This demo creates and customizes a project, starting from a database:
-```bash title="Quick Basic Demo"
-# Microservice Automation
-# Admin App, API, Project
-als create --project-name=basic_demo --db-url=basic_demo
-# Logic and Security
-# see logic (logic/declare_logic.py, logic/cocktail-napkin.jpg);  add an Order and Item
-# see security (security/declare_security.py); compare customers, s1 vs. admin
-als add-cust
-als add-auth --db_url=auth
-# Python Extensibility, Kafka Integration, Rebuild Iteration
-# see logic/declare_logic.py (breakpoint for Kafka)
-# Swagger: ServicesEndPoint.OrderB2B
-als add-cust
-als rebuild-from-database --db_url=sqlite:///database/db.sqlite
-```
-</details>
-&nbsp;
-## Appendix: GenAI Demo
-This is a "cheat sheet" for experienced ALS users, e.g., to show your colleagues.
-<details markdown>
-<summary>Quick GenAI Demo - Instructions</summary>
-<br>This demo creates and customizes a project, starting from a prompt:
-```bash title="Quick GenAI Demo"
-# Microservice Automation from GenAI Prompt
-# Admin App, API, Project
-als genai --using=system/genai/examples/genai_demo/genai_demo.prompt
-# Or, Microservice Automation from Saved Response
-# Admin App, API, Project
-als genai --repaired-response=system/genai/temp/chatgpt_retry.response
-# Logic and Security
-#   - see logic (logic/declare_logic.py, logic/cocktail-napkin.jpg);  add an Order and Item
-#   - see security (security/declare_security.py); compare customers, s1 vs. admin
-# Python Extensibility, Kafka Integration, Rebuild Iteration
-#   - see logic/declare_logic.py (breakpoint for Kafka)
-#   - Swagger: ServicesEndPoint.OrderB2B
-als add-cust
-```
-</details>

{apilogicserver-14.5.16.dist-info → apilogicserver-15.0.0.dist-info}/WHEEL RENAMED Viewed

File without changes

{apilogicserver-14.5.16.dist-info → apilogicserver-15.0.0.dist-info}/entry_points.txt RENAMED Viewed

File without changes

{apilogicserver-14.5.16.dist-info → apilogicserver-15.0.0.dist-info}/licenses/LICENSE RENAMED Viewed

File without changes

{apilogicserver-14.5.16.dist-info → apilogicserver-15.0.0.dist-info}/top_level.txt RENAMED Viewed

File without changes

ApiLogicServer 14.5.16__py3-none-any.whl → 15.0.0__py3-none-any.whl

ApiLogicServer 14.5.16py3-none-any.whl → 15.0.0py3-none-any.whl