aipostify 1.0.0__tar.gz

aipostify-1.0.0/.env.example

@@ -0,0 +1,23 @@
+APP_NAME=aipostify
+APP_ENV=local
+APP_DEBUG=true
+APP_KEY=
+APP_URL=http://127.0.0.1:8000
+APP_LOCALE=en
+
+# Database Connection: sqlite | mysql
+DB_CONNECTION=sqlite
+
+# --- SQLite (default) ---
+DB_SQLITE_PATH=database/database.sqlite
+
+# --- MySQL (Set DB_CONNECTION=mysql to use) ---
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=aipostify
+DB_USERNAME=root
+DB_PASSWORD=
+
+QUEUE_CONNECTION=database
+CACHE_DRIVER=file
+SESSION_DRIVER=file

aipostify-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AIPostify Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aipostify-1.0.0/MANIFEST.in

@@ -0,0 +1,20 @@
+include LICENSE
+include README.md
+include requirements.txt
+include pyproject.toml
+include setup.py
+include artisan
+include .env.example
+include pytest.ini
+
+recursive-include framework/stubs *.stub
+recursive-include framework/routing/templatetags *.py
+recursive-include tools/vscode-postify *
+recursive-include aipostify *
+recursive-include resources/views *.ptl
+recursive-include database/migrations *.py
+
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.sqlite
+global-exclude .DS_Store

aipostify-1.0.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: aipostify
+Version: 1.0.0
+Summary: Laravel-Style Python MVC Framework with PTL (Postify Template Language)
+Author: AIPostify Contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aipostify/aipostify
+Project-URL: Documentation, https://github.com/aipostify/aipostify#readme
+Project-URL: Repository, https://github.com/aipostify/aipostify.git
+Project-URL: Issues, https://github.com/aipostify/aipostify/issues
+Keywords: laravel,python,mvc,django,ptl,blade,artisan,template-engine,web-framework
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
+Classifier: Framework :: Django
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Web Environment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django<6.2,>=5.0
+Requires-Dist: PyMySQL>=1.1.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# AIPostify – Laravel-Style Python MVC Framework
+
+> Brings the elegant, productive developer experience of **Laravel** (`artisan`, `.env`, `routes/web.py`, Controllers, Models, Migrations, Seeders) to **Python and Django**, powered by **PTL (Postify Template Language)**.
+
+---
+
+## 🚀 Key Features
+
+- **PTL (Postify Template Language):** Native `.ptl` view engine with Blade-like `@if`, `@foreach`, `@extends`, `<x-components>`, pipe filters (`| upper`), and auto-escaped security.
+- **Zero Django Boilerplate:** Never edit `settings.py`, `INSTALLED_APPS`, or `urls.py`. Core configuration is completely abstracted.
+- **Artisan CLI Engine:** Run `python artisan make:...`, `python artisan migrate`, `python artisan db:...`, and `python artisan serve`.
+- **Instant SQLite ↔ MySQL Switching:** Switch databases effortlessly by changing `DB_CONNECTION=sqlite` to `DB_CONNECTION=mysql` in `.env`.
+- **Docker-Free & Dependency-Light:** Runs locally on SQLite with zero external services required.
+- **Auto-Discovery Engine:** Automatically scans and connects models in `app/models/`, controllers in `app/http/controllers/`, commands in `app/console/commands/`, and views in `resources/views/`.
+- **Database Queue & Task Scheduler:** Integrated database queue worker (`python artisan queue:work`) and cron task runner (`python artisan schedule:run`).
+- **Automatic VS Code Tooling:** Automatic syntax highlighting, `{ P }` file icon, and snippet setup on first run/clone.
+
+---
+
+## 📁 Directory Structure
+
+```text
+aipostify/
+├── artisan                          # CLI entry point (python artisan ...)
+├── .env                             # Environment configuration
+├── .env.example
+├── .gitattributes                   # GitHub language syntax detection
+├── .vscode/                         # VS Code settings & extensions
+├── requirements.txt
+├── app/                             # User Application Code
+│   ├── http/
+│   │   ├── controllers/             # Controller, WelcomeController
+│   │   ├── middleware/              # Custom HTTP Middlewares
+│   │   └── requests/                # Form validation classes
+│   ├── models/                      # User model
+│   ├── services/                    # Application services
+│   ├── jobs/                        # Queueable background jobs
+│   └── console/commands/            # Custom Artisan CLI commands
+├── config/                          # app.py, database.py, queue.py, mail.py
+├── database/
+│   ├── migrations/                  # Database migrations (0001_initial.py)
+│   ├── seeders/                     # DatabaseSeeder, UserSeeder
+│   └── database.sqlite              # Default SQLite database file
+├── resources/
+│   ├── views/                       # PTL Templates (.ptl)
+│   │   ├── components/              # Reusable <x-component> templates
+│   │   ├── layouts/app.ptl          # Base layout template
+│   │   └── welcome.ptl              # Welcome landing page
+│   └── lang/                        # en.json, gu.json, hi.json
+├── routes/
+│   ├── web.py                       # Web routes (Route.get, Route.resource)
+│   ├── api.py                       # API routes (prefixed with /api)
+│   └── console.py                   # Scheduled tasks
+├── public/                          # Static assets (css, js)
+├── storage/                         # App logs, sessions, and view cache
+├── tools/
+│   └── vscode-postify/              # PTL VS Code Extension (Icon + Grammar)
+└── tests/                           # Pytest test suite
+```
+
+---
+
+## ⚡ Quick Start
+
+### 1. Installation
+```bash
+# Clone the repository
+git clone <repo-url> myapp && cd myapp
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Setup environment key and database
+cp .env.example .env
+python artisan key:generate
+python artisan migrate
+python artisan db:seed
+```
+
+### 2. Start Development Server
+```bash
+python artisan serve
+```
+Open [http://127.0.0.1:8000](http://127.0.0.1:8000) in your browser.
+
+---
+
+## 🛠️ Artisan CLI Commands
+
+| Command | Description |
+|---|---|
+| `python artisan list` | Display all available commands |
+| `python artisan serve [--host --port]` | Start development server with live reload |
+| `python artisan route:list` | Show all registered routes in a formatted table |
+| `python artisan make:view <name>` | Generate new `.ptl` template view |
+| `python artisan make:component <name>`| Generate new `.ptl` component |
+| `python artisan make:layout <name>` | Generate new `.ptl` layout |
+| `python artisan view:cache` | Compile and cache all PTL templates |
+| `python artisan view:clear` | Clear compiled template cache |
+| `python artisan view:check` | Validate syntax of all PTL templates |
+| `python artisan ptl:install-vscode` | Install PTL VS Code extension (Icon + Grammar) |
+| `python artisan make:model <Model>` | Create new Eloquent-style model |
+| `python artisan make:controller <Name>`| Create standard or resource controller |
+| `python artisan make:crud <Model>` | Scaffold full CRUD resource in 1 command |
+| `python artisan make:migration <name>` | Generate database migration |
+| `python artisan make:auth` | Scaffold complete authentication system |
+| `python artisan migrate` | Run pending database migrations |
+| `python artisan migrate:fresh [--seed]` | Drop all tables and re-run all migrations |
+| `python artisan db:check` | Diagnose database connection and health |
+| `python artisan db:seed` | Run seeders |
+| `python artisan queue:work` | Start background queue worker daemon |
+| `python artisan schedule:run` | Execute scheduled cron tasks |
+| `python artisan tinker` | Interactive Python REPL with models preloaded |
+| `python artisan test` | Run pytest test suite |
+
+---
+
+## 🧪 Running Tests
+
+```bash
+python artisan test
+# or
+pytest
+```

aipostify-1.0.0/README.md

@@ -0,0 +1,124 @@
+# AIPostify – Laravel-Style Python MVC Framework
+
+> Brings the elegant, productive developer experience of **Laravel** (`artisan`, `.env`, `routes/web.py`, Controllers, Models, Migrations, Seeders) to **Python and Django**, powered by **PTL (Postify Template Language)**.
+
+---
+
+## 🚀 Key Features
+
+- **PTL (Postify Template Language):** Native `.ptl` view engine with Blade-like `@if`, `@foreach`, `@extends`, `<x-components>`, pipe filters (`| upper`), and auto-escaped security.
+- **Zero Django Boilerplate:** Never edit `settings.py`, `INSTALLED_APPS`, or `urls.py`. Core configuration is completely abstracted.
+- **Artisan CLI Engine:** Run `python artisan make:...`, `python artisan migrate`, `python artisan db:...`, and `python artisan serve`.
+- **Instant SQLite ↔ MySQL Switching:** Switch databases effortlessly by changing `DB_CONNECTION=sqlite` to `DB_CONNECTION=mysql` in `.env`.
+- **Docker-Free & Dependency-Light:** Runs locally on SQLite with zero external services required.
+- **Auto-Discovery Engine:** Automatically scans and connects models in `app/models/`, controllers in `app/http/controllers/`, commands in `app/console/commands/`, and views in `resources/views/`.
+- **Database Queue & Task Scheduler:** Integrated database queue worker (`python artisan queue:work`) and cron task runner (`python artisan schedule:run`).
+- **Automatic VS Code Tooling:** Automatic syntax highlighting, `{ P }` file icon, and snippet setup on first run/clone.
+
+---
+
+## 📁 Directory Structure
+
+```text
+aipostify/
+├── artisan                          # CLI entry point (python artisan ...)
+├── .env                             # Environment configuration
+├── .env.example
+├── .gitattributes                   # GitHub language syntax detection
+├── .vscode/                         # VS Code settings & extensions
+├── requirements.txt
+├── app/                             # User Application Code
+│   ├── http/
+│   │   ├── controllers/             # Controller, WelcomeController
+│   │   ├── middleware/              # Custom HTTP Middlewares
+│   │   └── requests/                # Form validation classes
+│   ├── models/                      # User model
+│   ├── services/                    # Application services
+│   ├── jobs/                        # Queueable background jobs
+│   └── console/commands/            # Custom Artisan CLI commands
+├── config/                          # app.py, database.py, queue.py, mail.py
+├── database/
+│   ├── migrations/                  # Database migrations (0001_initial.py)
+│   ├── seeders/                     # DatabaseSeeder, UserSeeder
+│   └── database.sqlite              # Default SQLite database file
+├── resources/
+│   ├── views/                       # PTL Templates (.ptl)
+│   │   ├── components/              # Reusable <x-component> templates
+│   │   ├── layouts/app.ptl          # Base layout template
+│   │   └── welcome.ptl              # Welcome landing page
+│   └── lang/                        # en.json, gu.json, hi.json
+├── routes/
+│   ├── web.py                       # Web routes (Route.get, Route.resource)
+│   ├── api.py                       # API routes (prefixed with /api)
+│   └── console.py                   # Scheduled tasks
+├── public/                          # Static assets (css, js)
+├── storage/                         # App logs, sessions, and view cache
+├── tools/
+│   └── vscode-postify/              # PTL VS Code Extension (Icon + Grammar)
+└── tests/                           # Pytest test suite
+```
+
+---
+
+## ⚡ Quick Start
+
+### 1. Installation
+```bash
+# Clone the repository
+git clone <repo-url> myapp && cd myapp
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Setup environment key and database
+cp .env.example .env
+python artisan key:generate
+python artisan migrate
+python artisan db:seed
+```
+
+### 2. Start Development Server
+```bash
+python artisan serve
+```
+Open [http://127.0.0.1:8000](http://127.0.0.1:8000) in your browser.
+
+---
+
+## 🛠️ Artisan CLI Commands
+
+| Command | Description |
+|---|---|
+| `python artisan list` | Display all available commands |
+| `python artisan serve [--host --port]` | Start development server with live reload |
+| `python artisan route:list` | Show all registered routes in a formatted table |
+| `python artisan make:view <name>` | Generate new `.ptl` template view |
+| `python artisan make:component <name>`| Generate new `.ptl` component |
+| `python artisan make:layout <name>` | Generate new `.ptl` layout |
+| `python artisan view:cache` | Compile and cache all PTL templates |
+| `python artisan view:clear` | Clear compiled template cache |
+| `python artisan view:check` | Validate syntax of all PTL templates |
+| `python artisan ptl:install-vscode` | Install PTL VS Code extension (Icon + Grammar) |
+| `python artisan make:model <Model>` | Create new Eloquent-style model |
+| `python artisan make:controller <Name>`| Create standard or resource controller |
+| `python artisan make:crud <Model>` | Scaffold full CRUD resource in 1 command |
+| `python artisan make:migration <name>` | Generate database migration |
+| `python artisan make:auth` | Scaffold complete authentication system |
+| `python artisan migrate` | Run pending database migrations |
+| `python artisan migrate:fresh [--seed]` | Drop all tables and re-run all migrations |
+| `python artisan db:check` | Diagnose database connection and health |
+| `python artisan db:seed` | Run seeders |
+| `python artisan queue:work` | Start background queue worker daemon |
+| `python artisan schedule:run` | Execute scheduled cron tasks |
+| `python artisan tinker` | Interactive Python REPL with models preloaded |
+| `python artisan test` | Run pytest test suite |
+
+---
+
+## 🧪 Running Tests
+
+```bash
+python artisan test
+# or
+pytest
+```

aipostify-1.0.0/aipostify/__init__.py

@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+"""
+AIPostify
+Laravel-Style Python MVC Framework with PTL (Postify Template Language).
+"""
+
+__title__ = "aipostify"
+__version__ = "1.0.0"
+__author__ = "AIPostify Contributors"
+__license__ = "MIT"
+__description__ = "Laravel-Style Python MVC Starter Framework with PTL Template Engine"
+
+from framework.kernel import bootstrap, get_wsgi_application, get_asgi_application
+
+__all__ = [
+    "bootstrap",
+    "get_wsgi_application",
+    "get_asgi_application",
+    "__version__",
+    "__author__",
+    "__license__",
+]

aipostify-1.0.0/aipostify/cli.py

@@ -0,0 +1,165 @@
+# -*- coding: utf-8 -*-
+"""
+AIPostify CLI Entry Point
+Provides global 'aipostify' and 'artisan' command-line tools.
+"""
+
+import sys
+import os
+import shutil
+from pathlib import Path
+
+
+BANNER = r"""
+   ___    ____  ___              __   _  ____       
+  /   |  /  _/ / _ \___   ___  / /_ (_)/ __/__  __
+ / /| |  / /  / ___/ _ \ (_-< / __// // _/ / / / /
+/_/ |_|_/___//_/   \___//___//_/  /_//_/    \__, / 
+                                           /____/  
+   Laravel-Style Python MVC Framework • v1.0.0
+"""
+
+
+def _find_project_root():
+    """Look up directory tree for an artisan file to identify AIPostify project root."""
+    current = Path.cwd().resolve()
+    while current != current.parent:
+        if (current / "artisan").exists() and (current / "framework").exists():
+            return current
+        current = current.parent
+    return None
+
+
+def _create_new_project(project_name: str):
+    """Scaffold a brand new AIPostify project in the specified directory."""
+    target_dir = Path.cwd() / project_name
+    if target_dir.exists() and any(target_dir.iterdir()):
+        print(f"\033[91m[Error]\033[0m Directory [{project_name}] already exists and is not empty.")
+        return 1
+
+    print(f"\033[95m{BANNER}\033[0m")
+    print(f"\033[96mCreating a new AIPostify application in:\033[0m {target_dir}\n")
+
+    # Locate package template / source directory
+    pkg_root = Path(__file__).resolve().parent.parent
+
+    # Folders and files to scaffold into new project
+    copy_dirs = [
+        "app",
+        "config",
+        "database",
+        "public",
+        "resources",
+        "routes",
+        "storage",
+        "tools",
+    ]
+    copy_files = [
+        "artisan",
+        ".env.example",
+        ".gitignore",
+        ".gitattributes",
+        "requirements.txt",
+        "pytest.ini",
+    ]
+
+    target_dir.mkdir(parents=True, exist_ok=True)
+
+    # Copy directories
+    for d in copy_dirs:
+        src = pkg_root / d
+        if src.exists():
+            shutil.copytree(src, target_dir / d, dirs_exist_ok=True)
+            print(f"  \033[92m+\033[0m Created directory {d}/")
+
+    # Copy files
+    for f in copy_files:
+        src = pkg_root / f
+        if src.exists():
+            shutil.copy2(src, target_dir / f)
+            print(f"  \033[92m+\033[0m Created file {f}")
+
+    # Create .env from .env.example
+    env_example = target_dir / ".env.example"
+    env_file = target_dir / ".env"
+    if env_example.exists() and not env_file.exists():
+        shutil.copy2(env_example, env_file)
+        print(f"  \033[92m+\033[0m Generated .env configuration")
+
+    # Ensure storage subdirectories exist
+    for sub in ["logs", "framework/cache", "framework/sessions", "framework/views"]:
+        (target_dir / "storage" / sub).mkdir(parents=True, exist_ok=True)
+
+    print("\n\033[92m[Success] AIPostify application created successfully!\033[0m")
+    print("\n\033[93mNext Steps:\033[0m")
+    print(f"  cd {project_name}")
+    print("  python artisan key:generate")
+    print("  python artisan migrate")
+    print("  python artisan serve\n")
+    return 0
+
+
+def main():
+    """Main CLI handler for 'aipostify' command."""
+    args = sys.argv[1:]
+
+    if not args or args[0] in ["-h", "--help", "help"]:
+        print(f"\033[95m{BANNER}\033[0m")
+        print("Usage:")
+        print("  aipostify new <project_name>   Create a new AIPostify project")
+        print("  aipostify --version, -v        Display AIPostify version")
+        print("  aipostify <command>            Run artisan command in current project")
+        print("\nExamples:")
+        print("  aipostify new myapp")
+        print("  aipostify serve")
+        print("  aipostify route:list")
+        return 0
+
+    if args[0] in ["-v", "--version", "version"]:
+        from . import __version__
+        print(f"AIPostify Framework v{__version__}")
+        return 0
+
+    if args[0] == "new":
+        if len(args) < 2:
+            print("\033[91m[Error]\033[0m Please provide a project name:")
+            print("  aipostify new <project_name>")
+            return 1
+        return _create_new_project(args[1])
+
+    # Check if we are inside an AIPostify project
+    project_root = _find_project_root()
+    if project_root:
+        artisan_path = project_root / "artisan"
+        cmd = [sys.executable, str(artisan_path)] + args
+        import subprocess
+        return subprocess.run(cmd).returncode
+    else:
+        print(f"\033[91m[Error]\033[0m Could not find an AIPostify project with an 'artisan' file.")
+        print("Run \033[96maipostify new <project_name>\033[0m to create a new application.")
+        return 1
+
+
+def artisan_main():
+    """Entry point for standalone 'artisan' command."""
+    project_root = _find_project_root()
+    if not project_root:
+        # Fall back to current working directory
+        project_root = Path.cwd().resolve()
+
+    if str(project_root) not in sys.path:
+        sys.path.insert(0, str(project_root))
+
+    try:
+        from framework.kernel import bootstrap
+        bootstrap(project_root)
+        from framework.console import Artisan
+        exit_code = Artisan.handle(sys.argv[1:])
+        return exit_code or 0
+    except Exception as e:
+        print(f"\033[91m[Artisan Error]\033[0m {e}")
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())