modwrap 1.0.2

Python module wrapper for dynamic loading and callable signature validation.

modwrap is a pure Python 3 utility (no external dependencies) that lets you dynamically load and execute functions from any Python module — either via code or command line. 🐍

📦 Installation

Install directly from PyPI:

pip install modwrap

🔧 Programmatic Usage

Use modwrap directly in your Python code to load modules, validate function signatures, and execute them safely:

from modwrap import ModuleWrapper

wrapper = ModuleWrapper("./examples/shell.py")

# Optional: Validate the function signature before calling
wrapper.validate_signature("execute", {"command": str})

# Load and call the function
func = wrapper.get_callable("execute")
result = func(command="whoami")
print(result)

💻 CLI Usage

modwrap comes with a command-line interface to easily inspect and interact with any Python module.

List available callables and their signatures

modwrap list ./examples/shell.py

Call a function with positional arguments

modwrap call ./examples/shell.py execute "ls -tAbl"

Call a function with keyword arguments

modwrap call ./examples/shell.py execute --kwargs '{"command": "ls -tAbl"}'