ApiLogicServer 15.1.3__tar.gz → 15.2.0__tar.gz

apilogicserver-15.2.0/ApiLogicServer.egg-info/PKG-INFO

@@ -0,0 +1,506 @@
+Metadata-Version: 2.4
+Name: ApiLogicServer
+Version: 15.2.0
+Author-email: Val Huber <apilogicserver@gmail.com>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://www.genai-logic.com
+Project-URL: Docs, https://apilogicserver.github.io/Docs/Doc-Home/
+Project-URL: Source, https://github.com/ApiLogicServer/ApiLogicServer-src
+Project-URL: Issues, https://github.com/ApiLogicServer/ApiLogicServer-src/issues
+Keywords: Flask,SQLAlchemy,Rules,WebApp,Microservice,ReactAdmin,Angular
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyJWT==2.6.0
+Requires-Dist: python-dateutil==2.8.2
+Requires-Dist: SQLAlchemy-Utils==0.38.2
+Requires-Dist: logicbankutils==0.6.0
+Requires-Dist: inflect==5.0.2
+Requires-Dist: inflection==0.5.1
+Requires-Dist: Flask==2.3.2
+Requires-Dist: Flask-Cors==3.0.10
+Requires-Dist: Flask-RESTful>=0.3.9
+Requires-Dist: flask-restful-swagger-2>=0.35
+Requires-Dist: Flask-SQLAlchemy==3.0.3
+Requires-Dist: flask-swagger-ui>=4.11.1
+Requires-Dist: flask_bcrypt==1.0.1
+Requires-Dist: itsdangerous==2.1.2
+Requires-Dist: Jinja2==3.1.5
+Requires-Dist: MarkupSafe==2.1.3
+Requires-Dist: six==1.16.0
+Requires-Dist: SQLAlchemy>=2.0.39
+Requires-Dist: Werkzeug==2.3.3
+Requires-Dist: safrs>=3.1.7
+Requires-Dist: Flask-Admin==1.5.7
+Requires-Dist: Flask-JWT-Extended==4.4.4
+Requires-Dist: Flask-Login==0.6.2
+Requires-Dist: Flask-OpenID==1.3.0
+Requires-Dist: python-dotenv==0.15.0
+Requires-Dist: email-validator==1.1.1
+Requires-Dist: LogicBank>=1.30.00
+Requires-Dist: cryptography==36.0.1
+Requires-Dist: rsa
+Requires-Dist: PyMySQL==1.0.3
+Requires-Dist: oracledb==2.1.2
+Requires-Dist: requests==2.31.0
+Requires-Dist: gunicorn==22.0.0
+Requires-Dist: psycopg2-binary>=2.9.5; python_version < "3.13"
+Requires-Dist: psycopg[binary]>=3.1.0; python_version >= "3.13"
+Requires-Dist: dotmap==1.3.25
+Requires-Dist: WTForms==2.3.3
+Requires-Dist: behave==1.2.6
+Requires-Dist: alembic==1.7.7
+Requires-Dist: python-ulid==2.7.0
+Requires-Dist: psutil==6.0.0
+Requires-Dist: pandas==2.2.2
+Requires-Dist: openpyxl==3.1.5
+Requires-Dist: GeoAlchemy2==0.12.5
+Requires-Dist: confluent-kafka==2.6.0
+Requires-Dist: translate==3.6.1
+Requires-Dist: libretranslatepy==2.1.1
+Requires-Dist: reportlab==4.2.0
+Requires-Dist: xlsxwriter==3.2.0
+Requires-Dist: natsort==8.4.0
+Requires-Dist: astor==0.8.1
+Requires-Dist: colorama==0.4.6
+Requires-Dist: openai==1.55.3
+Dynamic: license-file
+
+# API Logic Server
+
+[![Downloads](https://pepy.tech/badge/apilogicserver)](https://pepy.tech/project/apilogicserver)
+[![Latest Version](https://img.shields.io/pypi/v/apilogicserver.svg)](https://pypi.python.org/pypi/apilogicserver/)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/apilogicserver.svg)](https://pypi.python.org/pypi/apilogicserver/)
+
+**Transform 30-40 years of backend development requests into 3-4 days** with GenAI-powered microservice automation.
+
+Create **instant microservices** (MCP-enabled API + Admin App + Business Logic) from your database or a natural language prompt:
+
+```bash
+ApiLogicServer create --project_name=my_app --db_url=mysql://...
+```
+
+![API Logic Server Architecture](https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/Architecture-What-Is.png)
+
+---
+
+## ⚡ Quick Start (2 minutes)
+
+```bash
+# Install (Python 3.10-3.13)
+python -m venv venv                      # windows: python -m venv venv
+source venv/bin/activate                 # windows: venv\Scripts\activate
+python -m pip install ApiLogicServer
+
+# Start the Manager (opens readme with instructions)
+ApiLogicServer start
+
+# Create project from your database (or use sample)
+ApiLogicServer create --project_name=my_app --db_url=
+
+# Run it
+cd my_app
+python api_logic_server_run.py
+```
+
+**What you get in 5 seconds:**
+- 🚀 **JSON:API** - Endpoints for every table with filtering, pagination, related data
+- 📱 **Admin App** - Multi-page React app with automatic joins
+- 🧠 **Logic Engine** - Spreadsheet-like rules (40X more concise than code)
+- 🔐 **Security** - Row-level authorization, JWT authentication
+- 🐳 **Docker-ready** - Pre-configured containers for deployment
+
+**[📖 4-minute video demo](https://www.youtube.com/watch?v=7I33Fa9Ulos)** | **[📚 Full Documentation](https://apilogicserver.github.io/Docs/)** | **[🏠 Home](https://www.genai-logic.com)**
+
+---
+
+## 🎯 Why API Logic Server?
+
+**Built on 40+ years of proven technology** (Wang PACE → Versata → API Logic Server):
+- **6,000+ production deployments** validated the declarative approach
+- **Fortune 500 companies** relied on this architecture for mission-critical systems
+- Now **open source** and **modernized** for cloud-native Python/React stack
+
+### The Problem It Solves
+
+| Traditional Approach | API Logic Server |
+|---------------------|------------------|
+| Weeks to create API endpoints | **5 seconds** (automated) |
+| 200+ lines of update logic code | **5 rules** (40X reduction) |
+| Manual screen painting | **Automated** from data model |
+| Hard to integrate systems | **MCP-enabled** APIs |
+| Opaque procedural code | **Declarative** living documentation |
+
+---
+
+## 💡 Use Cases
+
+- **🔌 Application Integration** - Instant APIs for legacy databases
+- **⚡ Rapid Prototyping** - Working backend in minutes, not weeks
+- **🤖 GenAI Backends** - Natural language → working microservice
+- **🏢 Backoffice Apps** - Admin dashboards for data maintenance
+- **🔗 Microservices** - Decompose monoliths with instant services
+
+---
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────────────┐
+│  Natural Language Prompt or Existing DB     │
+└───────────────┬─────────────────────────────┘
+                │ ApiLogicServer create
+                ↓
+┌─────────────────────────────────────────────┐
+│         Generated Project                    │
+├─────────────────────────────────────────────┤
+│  📱 Admin App (React)                       │
+│  🔌 JSON:API (SAFRS)                        │
+│  🧠 Logic (Rules Engine)                    │
+│  💾 ORM (SQLAlchemy)                        │
+│  🔐 Security (JWT + Row-level)              │
+└─────────────────────────────────────────────┘
+                │
+                ↓
+        🐳 Docker Container
+```
+
+**Technology Stack:**
+- Python 3.10-3.13
+- Flask + SQLAlchemy
+- React + Material-UI
+- Docker + Docker Compose
+
+---
+
+## 📦 What Gets Created
+
+```
+my_app/
+├── api/                    # JSON:API endpoints
+│   ├── expose_api_models.py
+│   └── customize_api.py    # Add custom endpoints
+├── ui/admin/              # Admin App
+│   └── admin.yaml         # Declare UI behavior
+├── logic/                 # Business Logic
+│   └── declare_logic.py   # Spreadsheet-like rules
+├── security/              # Authentication & Authorization
+│   └── declare_security.py
+├── database/              # SQLAlchemy models
+│   └── models.py
+├── tests/                 # BDD tests (Behave)
+└── devops/
+    └── docker/            # Deployment configs
+```
+
+---
+
+## 🚀 Key Features
+
+### 1️⃣ Declarative Logic (40X More Concise)
+
+**Before (200+ lines of Python):**
+```python
+# Manual cascade updates, balance calculations, constraint checking...
+# Complex dependency tracking, old_row comparisons...
+# Missed corner cases: reassign order, change quantity, delete order...
+# (Imagine 200 lines of procedural code here)
+```
+
+**After (5 declarative rules):**
+```python
+Rule.constraint(derive=Customer.Balance <= Customer.CreditLimit)
+Rule.sum(derive=Customer.Balance, as_sum_of=Order.AmountTotal, 
+         where=lambda row: row.ShippedDate is None)
+Rule.sum(derive=Order.AmountTotal, as_sum_of=OrderDetail.Amount)
+Rule.formula(derive=OrderDetail.Amount, 
+             as_expression=lambda row: row.Quantity * row.UnitPrice)
+Rule.copy(derive=OrderDetail.UnitPrice, from_parent=Product.UnitPrice)
+```
+
+**Rules automatically handle all dependencies:**
+- ✅ Chain up (OrderDetail → Order → Customer)
+- ✅ Chain down (Product price change cascades)
+- ✅ Old row comparisons (moved orders adjust both customers)
+- ✅ All 9 use cases (add, update, delete, reassign...)
+
+### 2️⃣ Self-Serve APIs
+
+Consumers select their own attributes and related data - no custom API development required:
+
+```bash
+# Get customer with orders and order details
+GET /api/Customer/ALFKI?include=OrderList,OrderList.OrderDetailList&fields[Customer]=CompanyName,Balance
+
+# Filter and sort
+GET /api/Customer?filter[Balance][$gt]=1000&sort=-Balance&page[size]=10
+```
+
+**Features:**
+- Filtering, sorting, pagination
+- Related data (automatic joins)
+- Optimistic locking
+- Swagger documentation
+- **Logic enforcement** on all updates
+
+### 3️⃣ GenAI Integration
+
+#### Create from Natural Language
+```bash
+ApiLogicServer genai --using=prompt.txt
+```
+
+**Example prompt:**
+```
+Create a system for customers, orders, items and products.
+Customer balance is sum of unshipped order totals.
+Order total is sum of item amounts.
+Item amount is quantity * unit price.
+Copy product price to item unit price.
+Constraint: customer balance cannot exceed credit limit.
+```
+
+**Result:** Working microservice with logic in 10 seconds!
+
+#### AI-Assisted Development
+Every created project includes:
+- 🤖 **Copilot instructions** (`.copilot-instructions.md`)
+- 📚 **Training materials** (`docs/training/`)
+- 🔍 **Logic from natural language** (translate English → rules)
+
+```python
+# Paste into Copilot: "Create logic for check credit"
+# Copilot generates the 5 rules above!
+```
+
+### 4️⃣ Living Documentation
+
+**Automated test generation** from your rules:
+```bash
+# Generate Behave tests from declared logic
+ApiLogicServer add-tests
+
+# Run tests
+behave
+
+# Generate documentation
+python behave_logic_report.py
+```
+
+**Output:** Complete traceability from requirements → tests → rules → execution trace.
+
+---
+
+## 🎬 Video Overview (4 min)
+
+See how **Microservice Automation** creates and runs a microservice - a multi-page app and an API:
+
+[![GenAI Automation](https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/sample-ai/copilot/genai-automation-video.png)](https://www.youtube.com/watch?v=7I33Fa9Ulos "Microservice Automation")
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Areas of interest:
+
+| Area | Current | Ideas for Contribution |
+|------|---------|----------------------|
+| **API** | JSON:API, Swagger | GraphQL, gRPC support |
+| **Deployment** | Docker, Azure | AWS (ECS/Lambda), Kubernetes/Helm charts |
+| **Logic** | Rules engine | Additional rule types, performance tuning |
+| **UI** | Admin App (React) | Custom UI frameworks, mobile SDK |
+| **GenAI** | Web version, CLI | Enhanced natural language understanding |
+
+**[See issues](https://github.com/ApiLogicServer/ApiLogicServer-src/issues)** for current requests.
+
+### Development Setup
+
+For ***development*** (extending API Logic Server itself):
+
+```bash
+# Clone and install dev version
+git clone https://github.com/ApiLogicServer/ApiLogicServer-src.git
+cd ApiLogicServer-src
+
+# Install dependencies
+python -m pip install -r requirements.txt
+
+# Run build/test automation
+python test/build_and_test.py
+```
+
+**[See dev installation docs](https://apilogicserver.github.io/Docs/Architecture-Internals/)** for complete setup.
+
+---
+
+## 📚 Documentation
+
+- **[📖 Full Documentation](https://apilogicserver.github.io/Docs/)** - Comprehensive guides and reference
+- **[🚀 Quick Start Tutorial](https://apilogicserver.github.io/Docs/Tutorial/)** - 20-minute walkthrough
+- **[🧠 Logic Documentation](https://apilogicserver.github.io/Docs/Logic/)** - Rule types and patterns
+- **[🔐 Security Guide](https://apilogicserver.github.io/Docs/Security-Overview/)** - Authentication and authorization
+- **[🐳 Deployment](https://apilogicserver.github.io/Docs/DevOps-Containers/)** - Docker, Azure, containers
+- **[🔧 Architecture](https://apilogicserver.github.io/Docs/Architecture-What-Is/)** - How it works
+- **[❓ FAQs](https://apilogicserver.github.io/Docs/FAQ-Low-Code/)** - Common questions
+- **[🐛 Issue Tracker](https://github.com/ApiLogicServer/ApiLogicServer-src/issues)** - Bug reports and feature requests
+
+---
+
+## 📖 Key Documentation Pages
+
+### Getting Started
+- **[Express Install](https://apilogicserver.github.io/Docs/Install-Express/)** - Get running in 10 minutes
+- **[Manager Workspace](https://apilogicserver.github.io/Docs/Manager/)** - Project organization and readme
+- **[Tutorial](https://apilogicserver.github.io/Docs/Tutorial/)** - Complete walkthrough
+
+### Core Concepts
+- **[Logic: Why](https://apilogicserver.github.io/Docs/Logic-Why/)** - The case for declarative logic
+- **[API Self-Serve](https://apilogicserver.github.io/Docs/API-Self-Serve/)** - Consumer-driven APIs
+- **[Behave Testing](https://apilogicserver.github.io/Docs/Behave/)** - BDD test framework integration
+
+### Advanced Topics
+- **[Natural Language Logic](https://apilogicserver.github.io/Docs/WebGenAI-CLI/)** - GenAI logic translation
+- **[Integration Patterns](https://apilogicserver.github.io/Docs/Sample-Integration/)** - Kafka, B2B, MCP
+- **[Database Changes](https://apilogicserver.github.io/Docs/Database-Changes/)** - Schema evolution
+
+---
+
+## 🌟 Examples and Samples
+
+**[See all sample projects](https://apilogicserver.github.io/Docs/Data-Model-Examples/)**
+
+| Sample | Description | Database |
+|--------|-------------|----------|
+| **basic_demo** | Check credit rules, Behave testing | SQLite (Northwind) |
+| **genai_demo** | Created from natural language | SQLite |
+| **classicmodels** | Sales, employees, offices | MySQL |
+| **chinook** | Music store (artists, albums, tracks) | SQLite/PostgreSQL |
+| **postgres-nw** | Northwind on PostgreSQL | PostgreSQL |
+| **sqlserver** | Adventure Works | SQL Server |
+
+---
+
+## 🏆 Technology Lineage
+
+API Logic Server builds on proven technology with **40+ years** of production validation:
+
+### Wang Labs PACE (1980s-1990s)
+- **Inventor:** Val Huber (Designer and Co-inventor with Ron Ross of declarative rules)
+- **Scale:** 6,000+ production deployments
+- **Innovation:** First commercial declarative business rules system
+- **Platform:** Minicomputers → Visual Basic
+
+### Versata (1990s-2010s)
+- **Leadership:** Val Huber (CTO)
+- **Customers:** Fortune 500 companies
+- **Scale:** $3.4 billion company (IPO: VSTA)
+- **Innovation:** Evolved rules for J2EE enterprise applications
+- **Platform:** Java Enterprise Edition
+
+### API Logic Server (2020-present)
+- **Leadership:** Val Huber (Architect and Lead Developer)
+- **Innovation:** Modern cloud-native Python/React implementation
+- **Platform:** Open source, Docker, microservices architecture
+- **Unique:** Combined with GenAI for natural language logic
+
+**The same declarative rules paradigm, proven at scale, now open source and AI-enhanced.**
+
+---
+
+## 📊 Comparison: Frameworks vs Low Code vs API Logic Server
+
+| Aspect | Frameworks<br>(Django, Flask) | Low Code<br>(Retool, Appsmith) | API Logic Server |
+|--------|------------------------------|-------------------------------|------------------|
+| **API Creation** | Manual (weeks) | Limited/proprietary | ✅ Automated (5 sec) |
+| **Logic Automation** | ❌ Manual code | ❌ Limited | ✅ Rules (40X) |
+| **App Automation** | ❌ Manual | ✅ GUI builder | ✅ From data model |
+| **Customization** | ✅ Full Python | ⚠️ Proprietary | ✅ Python + Rules |
+| **IDE** | ✅ Standard tools | ❌ Proprietary | ✅ VSCode, PyCharm |
+| **Deployment** | ✅ Any platform | ⚠️ Vendor lock-in | ✅ Docker, any cloud |
+| **GenAI Integration** | ❌ None | ⚠️ Limited | ✅ Full (DB + Logic) |
+| **Testing** | Manual | Limited | ✅ Auto-generated |
+
+---
+
+## 💾 Supported Databases
+
+- **SQLite** (included samples)
+- **PostgreSQL**
+- **MySQL / MariaDB**
+- **SQL Server**
+- **Oracle**
+- Any SQLAlchemy-supported database
+
+---
+
+## 🔐 Security Features
+
+- **Authentication:** SQL-based, Keycloak, or custom providers
+- **Authorization:** Role-based grants with row-level filtering
+- **Multi-tenant:** Global filters based on user attributes
+- **JWT Tokens:** Standard authentication flow
+- **Swagger Security:** Integrated with API documentation
+
+**[See Security Overview](https://apilogicserver.github.io/Docs/Security-Overview/)**
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file
+
+---
+
+## 🙏 Acknowledgments
+
+Built on the shoulders of giants:
+
+**Technology Pioneers:**
+- **Wang Labs PACE** (1980s) - Original declarative rules concept (Val Huber, designer/co-inventor)
+- **Versata** (1990s-2010s) - $3.4B company, Fortune 500 deployments (Val Huber, CTO)
+- **Ron Ross** - Co-inventor of declarative rules paradigm
+
+**Open Source Foundation:**
+- **Flask** - Web framework
+- **SQLAlchemy** - ORM layer
+- **SAFRS** - JSON:API implementation
+- **React** - Admin App UI
+- **Material-UI** - Component library
+- **Behave** - BDD testing framework
+
+**Community:**
+- All contributors who have submitted issues, PRs, and feedback
+- The Python and React ecosystems
+
+---
+
+## 📞 Connect
+
+- **🏠 Home:** [genai-logic.com](https://www.genai-logic.com)
+- **💬 Discord:** [Join our community](https://discord.gg/fNRTTVFT) - Get help and discuss
+- **🐛 Issues:** [GitHub Issues](https://github.com/ApiLogicServer/ApiLogicServer-src/issues)
+- **� Discussions:** [GitHub Discussions](https://github.com/ApiLogicServer/ApiLogicServer-src/discussions)
+- **� Documentation:** [apilogicserver.github.io/Docs](https://apilogicserver.github.io/Docs/)
+- **📝 Blog:** [Medium Articles](https://medium.com/@valjhuber) - Conceptual background and insights
+
+### 📖 Recommended Reading
+
+Start with the welcome article to understand the vision and architecture:
+- **[Welcome to GenAI Logic](https://medium.com/@valjhuber/welcome-to-genai-logic-a610ba14bd72)** - Introduction and core concepts
+
+---
+
+**[⭐ Star this repo](https://github.com/ApiLogicServer/ApiLogicServer-src)** if you find it useful!
+
+**Made with ❤️ by the API Logic Server team**