ergon-framework-python 0.1.3__py3-none-any.whl → 0.1.4__py3-none-any.whl

ergon/__init__.py

@@ -1,13 +1,13 @@
-from . import connector, service, task, telemetry, utils
-from .task.manager import manager
-
-__all__ = [
-    "service",
-    "connector",
-    "task",
-    "telemetry",
-    "utils",
-    "manager",
-]
-
-__version__ = "0.1.3"
+from . import connector, service, task, telemetry, utils
+from .task.manager import manager
+
+__all__ = [
+    "service",
+    "connector",
+    "task",
+    "telemetry",
+    "utils",
+    "manager",
+]
+
+__version__ = "0.1.3"

ergon/bootstrap/src/__project__/main.py

@@ -1,9 +1,9 @@
-from ergon.cli import ergon
-
-
-def main():
-    ergon()
-
-
-if __name__ == "__main__":
-    main()
+from ergon.cli import ergon
+
+
+def main():
+    ergon()
+
+
+if __name__ == "__main__":
+    main()

ergon/bootstrap/src/__project__/tasks/constants.py

@@ -1,13 +1,13 @@
-from ergon.task.policies import RetryPolicy
-
-
-# ----------------------------------------
-# --- RETRY POLICY CONFIGURATION ---
-# ----------------------------------------
-def default_retry_policy():
-    return RetryPolicy(
-        max_attempts=3,
-        backoff=1,
-        backoff_multiplier=2,
-        backoff_cap=10,
-    )
+from ergon.task.policies import RetryPolicy
+
+
+# ----------------------------------------
+# --- RETRY POLICY CONFIGURATION ---
+# ----------------------------------------
+def default_retry_policy():
+    return RetryPolicy(
+        max_attempts=3,
+        backoff=1,
+        backoff_multiplier=2,
+        backoff_cap=10,
+    )

ergon/bootstrap/src/__project__/tasks/example_task/config.py

@@ -1,4 +1,4 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from ergon import task
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from ergon import task

ergon/bootstrap/src/__project__/tasks/example_task/exceptions.py

@@ -1,4 +1,4 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from ergon.task.exceptions import TransactionException
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from ergon.task.exceptions import TransactionException

ergon/bootstrap/src/__project__/tasks/example_task/helpers.py

@@ -1,4 +1,4 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from .. import helpers as shared
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from .. import helpers as shared

ergon/bootstrap/src/__project__/tasks/example_task/schemas.py

@@ -1,5 +1,5 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from pydantic import BaseModel
-# from .. import schemas as shared
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from pydantic import BaseModel
+# from .. import schemas as shared

ergon/bootstrap/src/__project__/tasks/example_task/task.py

@@ -1 +1 @@
-# from ergon import task, connector
+# from ergon import task, connector

ergon/bootstrap/src/__project__/tasks/settings.py

@@ -1,5 +1,5 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from ergon import service, connector, telemetry
-# from ergon.utils import load_env
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from ergon import service, connector, telemetry
+# from ergon.utils import load_env

ergon/cli.py

@@ -1,174 +1,174 @@
-import argparse
-import json
-import shutil
-import sys
-import uuid
-from pathlib import Path
-from typing import List, Optional
-
-from .connector import Transaction
-from .task.base import TaskConfig
-from .task.manager import manager
-
-
-# ---------------------------------------------------------------------
-# Utility: bootstrap project
-# ---------------------------------------------------------------------
-def bootstrap_project(project_name: str, target_dir: str):
-    root = Path(__file__).resolve().parent
-    template_src = root / "bootstrap" / "src" / "__project__"
-
-    if not template_src.exists():
-        raise RuntimeError(f"Template missing: {template_src}")
-
-    target = Path(target_dir).resolve()
-    target_src = target / "src" / project_name
-    target_src.mkdir(parents=True, exist_ok=True)
-
-    for item in template_src.rglob("*"):
-        rel = item.relative_to(template_src)
-        dest = target_src / rel
-        dest.parent.mkdir(parents=True, exist_ok=True)
-        if item.is_file():
-            shutil.copy2(item, dest)
-
-    print(f"✔ Bootstrapped successfully at src/{project_name}")
-
-
-# ---------------------------------------------------------------------
-# CLI parser
-# ---------------------------------------------------------------------
-def create_parser():
-    parser = argparse.ArgumentParser(
-        prog="ergon",
-        description="Ergon Task Framework CLI",
-    )
-
-    subparsers = parser.add_subparsers(dest="command", help="Available commands")
-
-    # -------------------------------------------------------------
-    # ergon list
-    # -------------------------------------------------------------
-    subparsers.add_parser("list", help="List all registered tasks")
-
-    # -------------------------------------------------------------
-    # ergon run <task>
-    # -------------------------------------------------------------
-    run_parser = subparsers.add_parser("run", help="Run a registered task")
-    run_parser.add_argument("task_name", type=str)
-
-    # -------------------------------------------------------------
-    # ergon process-transaction
-    # -------------------------------------------------------------
-    tx_parser = subparsers.add_parser(
-        "process-transaction",
-        help="Process a single transaction (inline payload)",
-    )
-    tx_parser.add_argument("task", type=str)
-    tx_parser.add_argument("policy", type=str)
-    tx_parser.add_argument(
-        "--payload-json",
-        required=True,
-        help="Transaction payload as JSON string",
-    )
-
-    # -------------------------------------------------------------
-    # ergon process-transaction-by-id
-    # -------------------------------------------------------------
-    tx_id_parser = subparsers.add_parser(
-        "process-transaction-by-id",
-        help="Process a transaction by ID via connector fetch",
-    )
-    tx_id_parser.add_argument("task", type=str)
-    tx_id_parser.add_argument("policy", type=str)
-    tx_id_parser.add_argument("transaction_id", type=str)
-
-    # -------------------------------------------------------------
-    # ergon bootstrap
-    # -------------------------------------------------------------
-    bootstrap_parser = subparsers.add_parser(
-        "bootstrap",
-        help="Create a new project using the Ergon template",
-    )
-    bootstrap_parser.add_argument("project_name", type=str)
-    bootstrap_parser.add_argument(
-        "target_dir",
-        nargs="?",
-        default=".",
-        help="Target directory (default: current directory)",
-    )
-
-    return parser
-
-
-# ---------------------------------------------------------------------
-# CLI entry point
-# ---------------------------------------------------------------------
-def ergon(tasks: Optional[List[TaskConfig]] = None):
-    if tasks:
-        for cfg in tasks:
-            if not manager.get(cfg.name):
-                manager.register(cfg)
-
-    parser = create_parser()
-    args = parser.parse_args()
-
-    if not args.command:
-        parser.print_help()
-        sys.exit(1)
-
-    # -------------------------------------------------------------
-    # LIST TASKS
-    # -------------------------------------------------------------
-    if args.command == "list":
-        task_names = manager.list_tasks()
-        if not task_names:
-            print("No tasks registered. Did you import your config files?")
-        else:
-            print("Registered tasks:")
-            for t in task_names:
-                print(f"  - {t}")
-        return
-
-    # -------------------------------------------------------------
-    # RUN TASK
-    # -------------------------------------------------------------
-    if args.command == "run":
-        manager.run(args.task_name)
-        return
-
-    # -------------------------------------------------------------
-    # PROCESS TRANSACTION (INLINE)
-    # -------------------------------------------------------------
-    if args.command == "process-transaction":
-        try:
-            payload = json.loads(args.payload_json)
-        except json.JSONDecodeError as exc:
-            print(f"[ERROR] Invalid JSON payload: {exc}")
-            sys.exit(2)
-
-        transaction = Transaction(id=str(uuid.uuid4()), payload=payload)
-        manager.process_transaction(
-            task=args.task,
-            policy=args.policy,
-            transaction=transaction,
-        )
-        return
-
-    # -------------------------------------------------------------
-    # PROCESS TRANSACTION BY ID
-    # -------------------------------------------------------------
-    if args.command == "process-transaction-by-id":
-        manager.process_transaction_by_id(
-            task=args.task,
-            policy=args.policy,
-            transaction_id=args.transaction_id,
-        )
-        return
-
-    # -------------------------------------------------------------
-    # BOOTSTRAP
-    # -------------------------------------------------------------
-    if args.command == "bootstrap":
-        bootstrap_project(args.project_name, args.target_dir)
-        return
+import argparse
+import json
+import shutil
+import sys
+import uuid
+from pathlib import Path
+from typing import List, Optional
+
+from .connector import Transaction
+from .task.base import TaskConfig
+from .task.manager import manager
+
+
+# ---------------------------------------------------------------------
+# Utility: bootstrap project
+# ---------------------------------------------------------------------
+def bootstrap_project(project_name: str, target_dir: str):
+    root = Path(__file__).resolve().parent
+    template_src = root / "bootstrap" / "src" / "__project__"
+
+    if not template_src.exists():
+        raise RuntimeError(f"Template missing: {template_src}")
+
+    target = Path(target_dir).resolve()
+    target_src = target / "src" / project_name
+    target_src.mkdir(parents=True, exist_ok=True)
+
+    for item in template_src.rglob("*"):
+        rel = item.relative_to(template_src)
+        dest = target_src / rel
+        dest.parent.mkdir(parents=True, exist_ok=True)
+        if item.is_file():
+            shutil.copy2(item, dest)
+
+    print(f"✔ Bootstrapped successfully at src/{project_name}")
+
+
+# ---------------------------------------------------------------------
+# CLI parser
+# ---------------------------------------------------------------------
+def create_parser():
+    parser = argparse.ArgumentParser(
+        prog="ergon",
+        description="Ergon Task Framework CLI",
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    # -------------------------------------------------------------
+    # ergon list
+    # -------------------------------------------------------------
+    subparsers.add_parser("list", help="List all registered tasks")
+
+    # -------------------------------------------------------------
+    # ergon run <task>
+    # -------------------------------------------------------------
+    run_parser = subparsers.add_parser("run", help="Run a registered task")
+    run_parser.add_argument("task_name", type=str)
+
+    # -------------------------------------------------------------
+    # ergon process-transaction
+    # -------------------------------------------------------------
+    tx_parser = subparsers.add_parser(
+        "process-transaction",
+        help="Process a single transaction (inline payload)",
+    )
+    tx_parser.add_argument("task", type=str)
+    tx_parser.add_argument("policy", type=str)
+    tx_parser.add_argument(
+        "--payload-json",
+        required=True,
+        help="Transaction payload as JSON string",
+    )
+
+    # -------------------------------------------------------------
+    # ergon process-transaction-by-id
+    # -------------------------------------------------------------
+    tx_id_parser = subparsers.add_parser(
+        "process-transaction-by-id",
+        help="Process a transaction by ID via connector fetch",
+    )
+    tx_id_parser.add_argument("task", type=str)
+    tx_id_parser.add_argument("policy", type=str)
+    tx_id_parser.add_argument("transaction_id", type=str)
+
+    # -------------------------------------------------------------
+    # ergon bootstrap
+    # -------------------------------------------------------------
+    bootstrap_parser = subparsers.add_parser(
+        "bootstrap",
+        help="Create a new project using the Ergon template",
+    )
+    bootstrap_parser.add_argument("project_name", type=str)
+    bootstrap_parser.add_argument(
+        "target_dir",
+        nargs="?",
+        default=".",
+        help="Target directory (default: current directory)",
+    )
+
+    return parser
+
+
+# ---------------------------------------------------------------------
+# CLI entry point
+# ---------------------------------------------------------------------
+def ergon(tasks: Optional[List[TaskConfig]] = None):
+    if tasks:
+        for cfg in tasks:
+            if not manager.get(cfg.name):
+                manager.register(cfg)
+
+    parser = create_parser()
+    args = parser.parse_args()
+
+    if not args.command:
+        parser.print_help()
+        sys.exit(1)
+
+    # -------------------------------------------------------------
+    # LIST TASKS
+    # -------------------------------------------------------------
+    if args.command == "list":
+        task_names = manager.list_tasks()
+        if not task_names:
+            print("No tasks registered. Did you import your config files?")
+        else:
+            print("Registered tasks:")
+            for t in task_names:
+                print(f"  - {t}")
+        return
+
+    # -------------------------------------------------------------
+    # RUN TASK
+    # -------------------------------------------------------------
+    if args.command == "run":
+        manager.run(args.task_name)
+        return
+
+    # -------------------------------------------------------------
+    # PROCESS TRANSACTION (INLINE)
+    # -------------------------------------------------------------
+    if args.command == "process-transaction":
+        try:
+            payload = json.loads(args.payload_json)
+        except json.JSONDecodeError as exc:
+            print(f"[ERROR] Invalid JSON payload: {exc}")
+            sys.exit(2)
+
+        transaction = Transaction(id=str(uuid.uuid4()), payload=payload)
+        manager.process_transaction(
+            task=args.task,
+            policy=args.policy,
+            transaction=transaction,
+        )
+        return
+
+    # -------------------------------------------------------------
+    # PROCESS TRANSACTION BY ID
+    # -------------------------------------------------------------
+    if args.command == "process-transaction-by-id":
+        manager.process_transaction_by_id(
+            task=args.task,
+            policy=args.policy,
+            transaction_id=args.transaction_id,
+        )
+        return
+
+    # -------------------------------------------------------------
+    # BOOTSTRAP
+    # -------------------------------------------------------------
+    if args.command == "bootstrap":
+        bootstrap_project(args.project_name, args.target_dir)
+        return