edutin-toolkit 1.5.0__tar.gz

edutin_toolkit-1.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Edutin
+
+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.

edutin_toolkit-1.5.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: edutin-toolkit
+Version: 1.5.0
+Summary: CLI to manage AWS Lambda and DynamoDB resources from the terminal
+Author-email: Pablo Ospino <cto@edutin.com>
+License: MIT
+Keywords: aws,lambda,dynamodb,cli,devops,toolkit,edutin
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: botocore>=1.34.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Requires-Dist: tomli-w>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Dynamic: license-file
+
+# aws-toolkit (`etk`)
+
+CLI to manage AWS Lambda and DynamoDB resources from the terminal.
+
+> This is the package README, bundled inside the installed wheel.
+> For full docs (DESIGN, MIGRATION_GUIDE, CHANGELOG), see the project
+> repository.
+
+## Install
+
+```bash
+pip install edutin-toolkit
+```
+
+Provides the `etk` command. Requires Python 3.10+ and AWS credentials
+configured (`aws configure`).
+
+## Quick start
+
+```bash
+cd <your-project>
+etk init                  # set up .aws-toolkit/ in the current repo
+etk lambda_download_all   # bulk-pull every accessible Lambda
+etk lambda_deploy <fn>    # push local code + config to AWS
+etk config                # view / edit toolkit settings
+etk --help                # full command list
+```
+
+Every command supports `-ai` for machine-readable TSV output. See the
+project docs for the full reference.
+
+## License
+
+MIT. See `LICENSE` in the repo root.

edutin_toolkit-1.5.0/README.md

@@ -0,0 +1,34 @@
+# aws-toolkit (`etk`)
+
+CLI to manage AWS Lambda and DynamoDB resources from the terminal.
+
+> This is the package README, bundled inside the installed wheel.
+> For full docs (DESIGN, MIGRATION_GUIDE, CHANGELOG), see the project
+> repository.
+
+## Install
+
+```bash
+pip install edutin-toolkit
+```
+
+Provides the `etk` command. Requires Python 3.10+ and AWS credentials
+configured (`aws configure`).
+
+## Quick start
+
+```bash
+cd <your-project>
+etk init                  # set up .aws-toolkit/ in the current repo
+etk lambda_download_all   # bulk-pull every accessible Lambda
+etk lambda_deploy <fn>    # push local code + config to AWS
+etk config                # view / edit toolkit settings
+etk --help                # full command list
+```
+
+Every command supports `-ai` for machine-readable TSV output. See the
+project docs for the full reference.
+
+## License
+
+MIT. See `LICENSE` in the repo root.

edutin_toolkit-1.5.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "edutin-toolkit"
+version = "1.5.0"
+description = "CLI to manage AWS Lambda and DynamoDB resources from the terminal"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Pablo Ospino", email = "cto@edutin.com" },
+]
+keywords = [
+    "aws", "lambda", "dynamodb", "cli", "devops", "toolkit", "edutin",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "boto3>=1.34.0",
+    "botocore>=1.34.0",
+    "rich>=13.7.0",
+    "tomli>=2.0; python_version < '3.11'",
+    "tomli-w>=1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "build>=1.0",
+]
+
+[project.scripts]
+etk = "aws_toolkit.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+aws_toolkit = [
+    "_bundled_templates/**/*",
+    "_bundled_vscode/*.vsix",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

edutin_toolkit-1.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

edutin_toolkit-1.5.0/src/aws_toolkit/__init__.py

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

edutin_toolkit-1.5.0/src/aws_toolkit/__main__.py

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

edutin_toolkit-1.5.0/src/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!')
+    }

edutin_toolkit-1.5.0/src/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"]
+}

edutin_toolkit-1.5.0/src/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()

edutin_toolkit-1.5.0/src/aws_toolkit/commands/__init__.py

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