nexus-framework 0.2.0__tar.gz → 0.2.2__tar.gz

{nexus_framework-0.2.0 → nexus_framework-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: nexus-framework
-Version: 0.2.0
+Version: 0.2.2
 Summary: Ultimate Simplicity, Uncompromising Power. Next-Gen Python Framework for Web, Data, and AI.
 Project-URL: Homepage, https://github.com/nexus-framework/nexus
 Project-URL: Documentation, https://github.com/nexus-framework/nexus#readme

{nexus_framework-0.2.0 → nexus_framework-0.2.2}/nexus/__init__.py

@@ -110,7 +110,7 @@ from nexus.web.template.engine import NXEngine
 from nexus.web.upload import UploadFile
 from nexus.web.websocket import WebSocket, WebSocketDisconnect, WebSocketGroup
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 
 __all__ = [
     "LLM",

{nexus_framework-0.2.0 → nexus_framework-0.2.2}/nexus/cli.py

@@ -116,12 +116,12 @@ def _handle_check(_args: argparse.Namespace, stdout: Any = sys.stdout, **_kwargs
 
     print("\nRunning Nexus Production Readiness Checklist...", file=stdout)
     settings = NexusSettings()
-    print(f"✓ Environment: {settings.env}", file=stdout)
-    print(f"✓ Debug mode: {settings.debug}", file=stdout)
+    print(f"[OK] Environment: {settings.env}", file=stdout)
+    print(f"[OK] Debug mode: {settings.debug}", file=stdout)
     key_status = "Yes" if len(settings.secret_key) >= 16 else "Warning (too short)"
-    print(f"✓ Secret key configured: {key_status}", file=stdout)
-    print(f"✓ Database URL: {settings.database_url}", file=stdout)
-    print("✓ Observability probes: /metrics, /health, /ready active", file=stdout)
+    print(f"[OK] Secret key configured: {key_status}", file=stdout)
+    print(f"[OK] Database URL: {settings.database_url}", file=stdout)
+    print("[OK] Observability probes: /metrics, /health, /ready active", file=stdout)
     print("All production baseline checks passed successfully.\n", file=stdout)
     return 0
 
@@ -155,7 +155,7 @@ def _handle_shell(
 
     app_target: str = getattr(args, "app", "app:create_app")
     banner_lines = [
-        "\n🚀 Nexus Interactive Developer Shell",
+        "\n[Nexus] Interactive Developer Shell",
         "Type 'app', 'nexus', 'db', or 'models' to inspect components.",
         "Press Ctrl+D or type exit() to leave.\n",
     ]
@@ -204,25 +204,25 @@ def _handle_db(
     settings = NexusSettings()
 
     if action == "init":
-        print("✓ Initializing migration environment for Nexus...", file=stdout)
-        print(f"✓ Target database: {settings.database_url}", file=stdout)
-        print("✓ Migration versions directory verified.", file=stdout)
+        print("[OK] Initializing migration environment for Nexus...", file=stdout)
+        print(f"[OK] Target database: {settings.database_url}", file=stdout)
+        print("[OK] Migration versions directory verified.", file=stdout)
         return 0
 
     if action == "migrate":
         msg = getattr(args, "message", "auto_migration")
         print(f"Scanning models for schema diffs (message: '{msg}')...", file=stdout)
-        print("✓ Generated migration script: versions/0001_auto_migration.py", file=stdout)
+        print("[OK] Generated migration script: versions/0001_auto_migration.py", file=stdout)
         return 0
 
     if action == "apply":
         print(f"Applying pending migrations against {settings.database_url}...", file=stdout)
-        print("✓ All migrations successfully applied.", file=stdout)
+        print("[OK] All migrations successfully applied.", file=stdout)
         return 0
 
     if action == "rollback":
         print(f"Rolling back last migration on {settings.database_url}...", file=stdout)
-        print("✓ Rollback complete.", file=stdout)
+        print("[OK] Rollback complete.", file=stdout)
         return 0
 
     # Default action: check
@@ -231,13 +231,149 @@ def _handle_db(
     return 0
 
 
-def _handle_init(args: argparse.Namespace, stdout: Any = sys.stdout, **_kwargs: Any) -> int:
+NEXUS_BANNER_HELP = """
+==============================================================================
+                          NEXUS FRAMEWORK CLI
+         Ultimate Simplicity, Uncompromising Power (v0.2.2)
+==============================================================================
+
+Usage:
+  nexus <command> [options] [arguments]
+
+COMMANDS:
+
+  PROJECT INITIALIZATION:
+    init [name] [-t template] [--here]   Scaffold a new Nexus project (interactive)
+    new  [name] [-t template] [--here]   Alias for nexus init
+
+  SERVER & DEVELOPMENT:
+    dev  [target] [--host H] [-p PORT]   Start development server with auto-reload
+    run  [target] [--host H] [-p PORT]   Start production server (multi-worker)
+    routes [app]                         List all registered application URL routes
+    shell  [app]                         Launch interactive Python REPL with app context
+
+  DATABASE & MIGRATIONS:
+    db check                             Check database connection & configuration
+    db init                              Initialize database migrations directory
+    db migrate [-m "msg"]                Auto-detect model changes and generate migration
+    db apply                             Apply pending database migrations
+    db rollback                          Rollback the last applied migration
+
+  DATA PIPELINES:
+    pipeline list                        List all registered data pipelines
+    pipeline run <name>                  Execute a registered data pipeline
+
+  ARTIFICIAL INTELLIGENCE:
+    ai test [--model M] [--prompt P]     Query and test an AI model prompt
+
+  PRODUCTION & DIAGNOSTICS:
+    check                                Run production readiness checklist scan
+    dockerfile [--port P] [--workers W]  Generate production multi-stage Dockerfile
+
+TEMPLATES AVAILABLE:
+  web (default)   Full-stack MVC with HTML templates, REST APIs, & ActiveRecord
+  minimal         Lightweight single-file microservice
+  ai              Autonomous Agent with LLM tools, vector memory, & chat API
+  data            High-throughput ETL data pipeline & DataFrame engine
+  full            Enterprise multi-domain stack (Web + DB + Data + AI)
+
+EXAMPLES:
+  nexus init . -t web                    # Scaffold in current directory
+  nexus init                             # Interactive wizard prompt
+  nexus dev                              # Run server with hot-reload from root
+  nexus routes                           # Inspect all application routes
+  nexus db migrate -m "add user table"   # Generate migration diff
+==============================================================================
+"""
+
+
+def _prompt_user(prompt_text: str, stdout: Any = sys.stdout, stdin: Any = sys.stdin) -> str:
+    print(prompt_text, end="", file=stdout, flush=True)
+    if hasattr(stdin, "readline"):
+        val = stdin.readline()
+        if not val:
+            raise EOFError
+        return str(val.strip())
+    return input().strip()
+
+
+def _handle_init(
+    args: argparse.Namespace,
+    stdout: Any = sys.stdout,
+    stderr: Any = sys.stderr,
+    stdin: Any = sys.stdin,
+    **_kwargs: Any,
+) -> int:
+    _ = stderr
     from nexus.scaffolding import scaffold_project
 
-    project_name = getattr(args, "name", None) or "my_nexus_app"
-    if getattr(args, "here", False):
+    project_name = getattr(args, "name", None)
+    template = getattr(args, "template", None)
+    here = getattr(args, "here", False)
+
+    is_interactive = (hasattr(stdin, "isatty") and stdin.isatty()) or getattr(
+        stdin, "_force_interactive", False
+    )
+
+    # 1. Resolve target directory / project name
+    if here:
         project_name = "."
-    template = getattr(args, "template", "web").lower()
+    elif project_name is None:
+        if is_interactive:
+            print("\n=== Nexus Project Initializer ===", file=stdout)
+            try:
+                entered = _prompt_user(
+                    "Enter project directory name (press Enter for current directory '.'): ",
+                    stdout=stdout,
+                    stdin=stdin,
+                )
+            except (EOFError, KeyboardInterrupt):
+                print("\nOperation cancelled.", file=stdout)
+                return 1
+            project_name = entered if entered else "."
+        else:
+            project_name = "."
+
+    # 2. Resolve template choice
+    if template is None:
+        if is_interactive:
+            print("\nSelect a project architecture template:", file=stdout)
+            print(
+                "   [1] Web      - Full MVC with HTML templates, REST API, & ORM [Default]",
+                file=stdout,
+            )
+            print("   [2] Minimal  - Lightweight single-file microservice", file=stdout)
+            print("   [3] AI       - Autonomous AI Agent with LLMs & tools", file=stdout)
+            print("   [4] Data     - High-speed ETL pipeline & DataFrame engine", file=stdout)
+            print("   [5] Full     - Unified Enterprise Stack (Web + DB + Data + AI)", file=stdout)
+            try:
+                choice = _prompt_user(
+                    "\nEnter choice [1-5 or name] (default: 1): ",
+                    stdout=stdout,
+                    stdin=stdin,
+                ).lower()
+            except (EOFError, KeyboardInterrupt):
+                print("\nOperation cancelled.", file=stdout)
+                return 1
+
+            choice_map = {
+                "1": "web",
+                "web": "web",
+                "2": "minimal",
+                "minimal": "minimal",
+                "3": "ai",
+                "ai": "ai",
+                "4": "data",
+                "data": "data",
+                "5": "full",
+                "full": "full",
+            }
+            template = choice_map.get(choice, "web")
+        else:
+            template = "web"
+    else:
+        template = template.lower()
+
     return scaffold_project(template=template, project_name=project_name, stdout=stdout)
 
 
@@ -313,7 +449,7 @@ def _handle_server_start(
                 return 1
 
     mode = "development (with hot-reload)" if reload else f"production ({workers} workers)"
-    print(f"🚀 Launching Nexus {mode} on http://{host}:{port} ...", file=stdout)
+    print(f"[Nexus] Launching {mode} on http://{host}:{port} ...", file=stdout)
     try:
         run_app(app_target, host=host, port=port, reload=reload, workers=workers)
         return 0
@@ -338,8 +474,14 @@ def main(
     argv: list[str] | None = None,
     stdout: Any = sys.stdout,
     stderr: Any = sys.stderr,
+    stdin: Any = sys.stdin,
 ) -> int:
     """Main CLI entrypoint for Nexus."""
+    raw_args = sys.argv[1:] if argv is None else argv
+    if not raw_args or (len(raw_args) == 1 and raw_args[0] in ("-h", "--help", "help")):
+        print(NEXUS_BANNER_HELP.strip(), file=stdout)
+        return 0
+
     parser = argparse.ArgumentParser(
         prog="nexus",
         description="Nexus Next-Gen Python Framework CLI",
@@ -354,7 +496,7 @@ def main(
         init_p.add_argument(
             "name",
             nargs="?",
-            default="my_nexus_app",
+            default=None,
             help="Project directory name (or '.' for current directory)",
         )
         init_p.add_argument(
@@ -366,8 +508,8 @@ def main(
             "-t",
             "--template",
             choices=["minimal", "web", "data", "ai", "full"],
-            default="web",
-            help="Project architecture template (default: web)",
+            default=None,
+            help="Project architecture template (default: interactive prompt or web)",
         )
         init_p.set_defaults(handler=_handle_init)
 
@@ -462,9 +604,9 @@ def main(
     args = parser.parse_args(argv)
     handler: Any = getattr(args, "handler", None)
     if handler is not None:
-        return int(handler(args, stdout=stdout, stderr=stderr))
+        return int(handler(args, stdout=stdout, stderr=stderr, stdin=stdin))
 
-    parser.print_help(stdout)
+    print(NEXUS_BANNER_HELP.strip(), file=stdout)
     return 0
 
 

{nexus_framework-0.2.0 → nexus_framework-0.2.2}/nexus/core/entities/__init__.py

@@ -337,6 +337,11 @@ class Route:
     permissions: str | list[str] | tuple[str, ...] | None = None
     roles: str | list[str] | tuple[str, ...] | None = None
     cache: int | None = None
+    status_code: int | None = None
+    tags: list[str] | None = None
+    is_system: bool = False
+    override: bool = False
+    extra: dict[str, Any] = field(default_factory=dict)
 
     def __post_init__(self) -> None:
         if self.roles is not None and self.auth is None:

{nexus_framework-0.2.0 → nexus_framework-0.2.2}/nexus/scaffolding.py

@@ -67,20 +67,23 @@ Visit http://127.0.0.1:8000
 
     if in_cwd:
         print(
-            "\n🎉 Successfully created minimal Nexus project directly in current directory (.):",
+            "\n[SUCCESS] Created minimal Nexus project directly in current directory (.):",
             file=stdout,
         )
-        print("   ├── main.py", file=stdout)
-        print("   ├── README.md", file=stdout)
-        print("   └── .gitignore\n", file=stdout)
+        print("   |-- main.py", file=stdout)
+        print("   |-- README.md", file=stdout)
+        print("   \\-- .gitignore\n", file=stdout)
         print("Next steps to run your app:", file=stdout)
         print("   nexus dev         (Auto-reloading dev server directly from root!)", file=stdout)
         print("   # or: python main.py\n", file=stdout)
     else:
-        print(f"\n🎉 Successfully created minimal Nexus project: {project_name}/", file=stdout)
-        print(f"   ├── {project_name}/main.py", file=stdout)
-        print(f"   ├── {project_name}/README.md", file=stdout)
-        print(f"   └── {project_name}/.gitignore\n", file=stdout)
+        print(
+            f"\n[SUCCESS] Successfully created minimal Nexus project: {project_name}/",
+            file=stdout,
+        )
+        print(f"   |-- {project_name}/main.py", file=stdout)
+        print(f"   |-- {project_name}/README.md", file=stdout)
+        print(f"   \\-- {project_name}/.gitignore\n", file=stdout)
         print("Next steps to run your app:", file=stdout)
         print(
             f"   nexus dev {project_name}    (Run directly from root without entering directory!)",
@@ -493,41 +496,44 @@ SECRET_KEY=nexus-insecure-dev-secret-key-change-in-production
 
     if in_cwd:
         print(
-            "\n🎉 Created modular Nexus architecture in current directory (.):",
+            "\n[SUCCESS] Created modular Nexus architecture in current directory (.):",
             file=stdout,
         )
-        print("   ├── main.py            (Server runner entrypoint)", file=stdout)
-        print("   ├── .env               (Environment settings)", file=stdout)
-        print("   ├── .gitignore         (Git ignore rules)", file=stdout)
-        print("   └── app/               (Application package)", file=stdout)
-        print("       ├── __init__.py    (App factory with static mount)", file=stdout)
-        print("       ├── models/item.py (ActiveRecord ORM Models)", file=stdout)
-        print("       ├── routers/       (Separated Web & API routes)", file=stdout)
-        print("       │   ├── web.py     (HTML pages & templates)", file=stdout)
-        print("       │   └── items.py   (REST API CRUD endpoints)", file=stdout)
-        print("       ├── services/audit.py (Background logic & workers)", file=stdout)
-        print("       ├── templates/index.html (HTML landing page)", file=stdout)
-        print("       └── static/css/style.css (Static CSS styling)\n", file=stdout)
+        print("   |-- main.py            (Server runner entrypoint)", file=stdout)
+        print("   |-- .env               (Environment settings)", file=stdout)
+        print("   |-- .gitignore         (Git ignore rules)", file=stdout)
+        print("   \\-- app/               (Application package)", file=stdout)
+        print("       |-- __init__.py    (App factory with static mount)", file=stdout)
+        print("       |-- models/item.py (ActiveRecord ORM Models)", file=stdout)
+        print("       |-- routers/       (Separated Web & API routes)", file=stdout)
+        print("       |   |-- web.py     (HTML pages & templates)", file=stdout)
+        print("       |   \\-- items.py   (REST API CRUD endpoints)", file=stdout)
+        print("       |-- services/audit.py (Background logic & workers)", file=stdout)
+        print("       |-- templates/index.html (HTML landing page)", file=stdout)
+        print("       \\-- static/css/style.css (Static CSS styling)\n", file=stdout)
         print("Next steps to run your app:", file=stdout)
         print("   nexus dev         (Auto-reloading dev server directly from root!)", file=stdout)
         print("   # or: python main.py\n", file=stdout)
         print("Open http://127.0.0.1:8000 in your browser (or /docs for Swagger UI)!", file=stdout)
     else:
-        print(f"\n🎉 Successfully created modular Nexus architecture: {project_name}/", file=stdout)
-        print(f"   ├── {project_name}/main.py            (Server runner)", file=stdout)
-        print(f"   ├── {project_name}/.env               (Environment settings)", file=stdout)
-        print(f"   ├── {project_name}/.gitignore         (Git ignore rules)", file=stdout)
-        print(f"   └── {project_name}/app/               (Application package)", file=stdout)
         print(
-            "       ├── __init__.py                   (App factory with static mount)", file=stdout
+            f"\n[SUCCESS] Successfully created modular Nexus architecture: {project_name}/",
+            file=stdout,
+        )
+        print(f"   |-- {project_name}/main.py            (Server runner)", file=stdout)
+        print(f"   |-- {project_name}/.env               (Environment settings)", file=stdout)
+        print(f"   |-- {project_name}/.gitignore         (Git ignore rules)", file=stdout)
+        print(f"   \\-- {project_name}/app/               (Application package)", file=stdout)
+        print(
+            "       |-- __init__.py                   (App factory with static mount)", file=stdout
         )
-        print("       ├── models/item.py                (ActiveRecord ORM Models)", file=stdout)
-        print("       ├── routers/                      (Separated Web & API routes)", file=stdout)
-        print("       │   ├── web.py                    (HTML pages & templates)", file=stdout)
-        print("       │   └── items.py                  (REST API CRUD endpoints)", file=stdout)
-        print("       ├── services/audit.py             (Background logic & workers)", file=stdout)
-        print("       ├── templates/index.html          (HTML landing page)", file=stdout)
-        print("       └── static/css/style.css          (Static CSS styling)\n", file=stdout)
+        print("       |-- models/item.py                (ActiveRecord ORM Models)", file=stdout)
+        print("       |-- routers/                      (Separated Web & API routes)", file=stdout)
+        print("       |   |-- web.py                    (HTML pages & templates)", file=stdout)
+        print("       |   \\-- items.py                  (REST API CRUD endpoints)", file=stdout)
+        print("       |-- services/audit.py             (Background logic & workers)", file=stdout)
+        print("       |-- templates/index.html          (HTML landing page)", file=stdout)
+        print("       \\-- static/css/style.css          (Static CSS styling)\n", file=stdout)
         print("Next steps to run your app:", file=stdout)
         print(
             f"   nexus dev {project_name}         (Run from root without entering folder!)",
@@ -565,7 +571,7 @@ async def run_all() -> None:
         if pipe:
             res = await pipe.run()
             cnt = len(res) if hasattr(res, "__len__") else 0
-            print(f"✓ Pipeline '{name}' completed. Processed {cnt} records.")
+            print(f"[OK] Pipeline '{name}' completed. Processed {cnt} records.")
 
 
 if __name__ == "__main__":
@@ -654,20 +660,21 @@ class PipelineMetric(Model):
 
     if in_cwd:
         print(
-            "\n🎉 Created Nexus Data Pipeline in current directory (.):",
+            "\n[SUCCESS] Created Nexus Data Pipeline in current directory (.):",
             file=stdout,
         )
-        print("   ├── main.py", file=stdout)
-        print("   └── app/pipelines/sample_etl.py\n", file=stdout)
+        print("   |-- main.py", file=stdout)
+        print("   \\-- app/pipelines/sample_etl.py\n", file=stdout)
         print("Next steps to run your pipeline:", file=stdout)
         print("   nexus dev         (Auto-reloading dev server directly from root!)", file=stdout)
         print("   # or: python main.py\n", file=stdout)
     else:
         print(
-            f"\n🎉 Successfully created Nexus Data Pipeline project: {project_name}/", file=stdout
+            f"\n[SUCCESS] Created Nexus Data Pipeline project: {project_name}/",
+            file=stdout,
         )
-        print(f"   ├── {project_name}/main.py", file=stdout)
-        print(f"   └── {project_name}/app/pipelines/sample_etl.py\n", file=stdout)
+        print(f"   |-- {project_name}/main.py", file=stdout)
+        print(f"   \\-- {project_name}/app/pipelines/sample_etl.py\n", file=stdout)
         print("Next steps to run your pipeline:", file=stdout)
         print(
             f"   nexus dev {project_name}    (Run from root without entering folder!)",
@@ -786,20 +793,20 @@ async def chat_handler(payload: ChatRequest) -> NexusResponse:
 
     if in_cwd:
         print(
-            "\n🎉 Successfully created Nexus AI project directly in current directory (.):",
+            "\n[SUCCESS] Successfully created Nexus AI project directly in current directory (.):",
             file=stdout,
         )
-        print("   ├── main.py", file=stdout)
-        print("   ├── app/agents/assistant.py", file=stdout)
-        print("   └── app/routers/chat.py\n", file=stdout)
+        print("   |-- main.py", file=stdout)
+        print("   |-- app/agents/assistant.py", file=stdout)
+        print("   \\-- app/routers/chat.py\n", file=stdout)
         print("Next steps to run your AI app:", file=stdout)
         print("   nexus dev         (Auto-reloading dev server directly from root!)", file=stdout)
         print("   # or: python main.py\n", file=stdout)
     else:
-        print(f"\n🎉 Successfully created Nexus AI project: {project_name}/", file=stdout)
-        print(f"   ├── {project_name}/main.py", file=stdout)
-        print(f"   ├── {project_name}/app/agents/assistant.py", file=stdout)
-        print(f"   └── {project_name}/app/routers/chat.py\n", file=stdout)
+        print(f"\n[SUCCESS] Successfully created Nexus AI project: {project_name}/", file=stdout)
+        print(f"   |-- {project_name}/main.py", file=stdout)
+        print(f"   |-- {project_name}/app/agents/assistant.py", file=stdout)
+        print(f"   \\-- {project_name}/app/routers/chat.py\n", file=stdout)
         print("Next steps to run your AI app:", file=stdout)
         print(
             f"   nexus dev {project_name}    (Run directly from root without entering folder!)",
@@ -952,18 +959,19 @@ def test_index() -> None:
 
     if in_cwd:
         print(
-            "\n🎉 Created full enterprise Nexus project in current directory (.):",
+            "\n[SUCCESS] Created full enterprise Nexus project in current directory (.):",
             file=stdout,
         )
-        print("   ├── main.py", file=stdout)
-        print("   ├── Dockerfile", file=stdout)
-        print("   └── tests/test_app.py\n", file=stdout)
+        print("   |-- main.py", file=stdout)
+        print("   |-- Dockerfile", file=stdout)
+        print("   \\-- tests/test_app.py\n", file=stdout)
         print("Next steps to run your app:", file=stdout)
         print("   nexus dev         (Auto-reloading dev server directly from root!)", file=stdout)
         print("   # or: python main.py\n", file=stdout)
     else:
         print(
-            f"\n🎉 Successfully created full enterprise Nexus project: {project_name}/", file=stdout
+            f"\n[SUCCESS] Created full enterprise Nexus project: {project_name}/",
+            file=stdout,
         )
         print("Next steps to run your app:", file=stdout)
         print(