edutin-toolkit 1.5.0__py3-none-any.whl

aws_toolkit/__init__.py

@@ -0,0 +1,3 @@
+"""AWS Toolkit — utilidades CLI para Lambda."""
+
+__version__ = "0.1.0"

aws_toolkit/__main__.py

@@ -0,0 +1,5 @@
+"""Enables: python -m aws_toolkit [command] [args]"""
+
+from aws_toolkit.cli import main
+
+main()

aws_toolkit/_bundled_templates/python312_arm64/code_template/main.py

@@ -0,0 +1,7 @@
+import json
+
+def lambda_handler(event, context):
+    return {
+        'statusCode': 200,
+        'body': json.dumps('Hello from Lambda!')
+    }

aws_toolkit/_bundled_templates/python312_arm64/template.json

@@ -0,0 +1,10 @@
+{
+  "runtime": "python3.12",
+  "architectures": ["arm64"],
+  "timeout": 5,
+  "memory_size": 128,
+  "ephemeral_storage_size": 512,
+  "handler": "main.main",
+  "role": "lambda_dynamodb_exec",
+  "aliases": ["current", "develop", "legacy"]
+}

aws_toolkit/cli.py

@@ -0,0 +1,173 @@
+#!/usr/bin/env python3
+"""AWS Toolkit – unified CLI dispatcher."""
+
+import sys
+import importlib
+
+COMMANDS = {
+    "init": {
+        "desc": "Initialize the current directory as an aws-toolkit project",
+        "usage": "etk init [--template <n>] [--lambdas <p>] [--layers <p>] [--dynamo <p>] [--author <n>] [--profile <p>] [--sandbox <l>] [--force] [-ai]",
+        "module": "aws_toolkit.commands.init",
+    },
+    "lambda_explorer": {
+        "desc": "Interactive TUI to browse, search and download Lambda functions",
+        "usage": "etk lambda_explorer [-ai [query]]",
+        "module": "aws_toolkit.commands.lambda_explorer",
+    },
+    "lambda_download": {
+        "desc": "Download a Lambda function by name",
+        "usage": "etk lambda_download <function_name> [-ai]",
+        "module": "aws_toolkit.commands.lambda_download",
+    },
+    "lambda_download_all": {
+        "desc": "Bulk download every accessible Lambda (idempotent, parallel)",
+        "usage": "etk lambda_download_all [--filter <pat>] [--force] [--dry-run] [--workers N] [-ai]",
+        "module": "aws_toolkit.commands.lambda_download_all",
+    },
+    "dynamodb_doc": {
+        "desc": "Document DynamoDB table schemas to JSON files",
+        "usage": "etk dynamodb_doc [-ai] | etk dynamodb_doc <table_name> [-ai]",
+        "module": "aws_toolkit.commands.dynamodb_doc",
+    },
+    "lambda_create": {
+        "desc": "Create a Lambda function from a template",
+        "usage": "etk lambda_create <function_name> [--template <name>] [-ai]",
+        "module": "aws_toolkit.commands.lambda_create",
+    },
+    "lambda_deploy": {
+        "desc": "Deploy local code and lambda_config.json to AWS",
+        "usage": "etk lambda_deploy <function_name> [-ai]",
+        "module": "aws_toolkit.commands.lambda_deploy",
+    },
+    "lambda_test": {
+        "desc": "Deploy source lambda to test lambda and invoke it with an event",
+        "usage": "etk lambda_test <function_name> <event_name> [-ai]",
+        "module": "aws_toolkit.commands.lambda_test",
+    },
+    "lambda_download_tests": {
+        "desc": "Download shareable test events from AWS into event_tests/",
+        "usage": "etk lambda_download_tests <function_name> [-ai]",
+        "module": "aws_toolkit.commands.lambda_download_tests",
+    },
+    "lambda_publish_version": {
+        "desc": "Publish a new version of a Lambda from $LATEST (optionally aliasing it as `current`)",
+        "usage": "etk lambda_publish_version <name> <description> [--prod] [-ai]",
+        "module": "aws_toolkit.commands.lambda_publish_version",
+    },
+    "lambda_layer_doc": {
+        "desc": "Download and document Lambda layer versions (top 3 most recent)",
+        "usage": "etk lambda_layer_doc [layer_name] [-ai]",
+        "module": "aws_toolkit.commands.lambda_layer_doc",
+    },
+    "config": {
+        "desc": "Create / modify toolkit configuration",
+        "usage": "etk config [-ai] | etk config set <key> <value> [-ai]",
+        "module": "aws_toolkit.commands.config",
+    },
+    "install_vscode_extension": {
+        "desc": "Install the bundled VSCode extension (▶/☁⬆ buttons on lambda files)",
+        "usage": "etk install_vscode_extension [-ai]",
+        "module": "aws_toolkit.commands.install_vscode_extension",
+    },
+}
+
+def _make_commands_table(title: str, commands: dict, T, box):
+    from rich.table import Table
+    tbl = Table(
+        show_header=True,
+        header_style=T.HEADER_ST,
+        border_style=T.BORDER,
+        box=box.DOUBLE_EDGE,
+        title=title,
+        title_style=T.TITLE,
+        padding=(0, 2),
+    )
+    tbl.add_column("COMMAND", style=f"bold {T.NEON_GREEN}", min_width=20)
+    tbl.add_column("DESCRIPTION", style=T.NORMAL, min_width=30)
+    tbl.add_column("USAGE", style=T.DIM_STYLE, min_width=45)
+    for name, info in commands.items():
+        tbl.add_row(name, info["desc"], info["usage"])
+    return tbl
+
+
+def show_help():
+    from aws_toolkit.commands._shared import console, Theme as T
+    from rich.align import Align
+    from rich import box
+
+    console.print()
+    console.print(f"[bold {T.CYAN}]AWS TOOLKIT[/bold {T.CYAN}]")
+    console.print(f"  [{T.DIM_STYLE}]Usage: etk <command> [args][/{T.DIM_STYLE}]")
+    console.print()
+
+    console.print(Align.center(_make_commands_table(
+        f"[{T.CYAN}]《 COMMANDS 》[/{T.CYAN}]", COMMANDS, T, box
+    )))
+
+    console.print()
+
+
+def _check_config(ai_mode: bool) -> None:
+    """Force config resolution to surface a clear error before the command runs.
+
+    ConfigError subclasses (RepoRootNotFound, ProjectConfigMissingField,
+    UserConfigMissingField, etc.) are caught by the dispatcher's
+    try/except and produce a consistent error code in -ai mode.
+    """
+    from aws_toolkit.config_resolver import resolve_config
+    resolve_config()
+
+
+def main():
+    args = sys.argv[1:]
+
+    if not args or args[0] in ("--help", "-h", "help"):
+        show_help()
+        return
+
+    cmd = args[0]
+    rest = args[1:]
+    ai_mode = "-ai" in rest
+
+    if cmd not in COMMANDS:
+        from aws_toolkit.commands._shared import die
+        die(
+            f"Unknown command: [bold]{cmd}[/bold]\n\n"
+            f"  Run [bold]etk --help[/bold] to see available commands."
+        )
+
+    from aws_toolkit.commands._shared import log_command
+    from aws_toolkit.config_resolver import ConfigError
+
+    entry = COMMANDS[cmd]
+
+    try:
+        mod = importlib.import_module(entry["module"])
+
+        if cmd not in ("config", "init", "install_vscode_extension"):
+            _check_config(ai_mode=ai_mode)
+        detail = mod.main(rest) or ""
+        log_command(cmd, rest, "SUCCESS", detail)
+    except ConfigError as exc:
+        log_command(cmd, rest, "ERROR", f"config_error={exc.code}")
+        if ai_mode:
+            print(f"error\t{exc.code}\t{exc}", file=sys.stderr)
+            sys.exit(1)
+        else:
+            from aws_toolkit.commands._shared import die as _die
+            _die(str(exc))  # exits with code 1
+    except SystemExit as exc:
+        code = exc.code if exc.code is not None else 0
+        if code == 0:
+            log_command(cmd, rest, "SUCCESS")
+        else:
+            log_command(cmd, rest, "ERROR", f"exit_code={code}")
+        raise
+    except Exception as exc:
+        log_command(cmd, rest, "ERROR", f"exception={type(exc).__name__}: {exc}")
+        raise
+
+
+if __name__ == "__main__":
+    main()

aws_toolkit/commands/__init__.py

@@ -0,0 +1 @@
+"""Subcomandos de la CLI (p. ej. lambda_explorer)."""