luawrap 0.1.0__tar.gz

luawrap-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: luawrap
+Version: 0.1.0
+Summary: Write and run Lua code directly from Python files.
+License: LicenseRef-LuaWrap-Custom
+Author: Your Name V011DZ
+Requires-Python: >=3.8,<4.0
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+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: Programming Language :: Python :: 3.14
+Requires-Dist: lupa (>=2.0,<3.0)
+Description-Content-Type: text/markdown
+
+# LuaWrap
+
+Write and run Lua code directly inside your Python files — no separate Lua install needed.
+
+## Installation
+
+```bash
+poetry add lupa
+poetry install
+```
+
+## Usage
+
+```python
+from luawrap import lua, run_lua, lua_function, LuaBlock
+
+# Run Lua directly
+lua("print('Hello from Lua!')")
+
+# Get a return value back in Python
+result = run_lua("return 2 + 2")
+print(result)  # 4
+
+# Decorator style
+@lua_function
+def my_script():
+    return "print('I am a Lua function!')"
+
+my_script()
+
+# Context manager style
+with LuaBlock() as lb:
+    lb.code = "print('Runs when the block exits!')"
+```
+
+## API
+
+| Function | Description |
+|---|---|
+| `lua(code)` | Run a Lua string |
+| `run_lua(code)` | Same as `lua()`, alias |
+| `@lua_function` | Decorator — function returns Lua code as a string |
+| `LuaBlock` | Context manager — set `lb.code` to your Lua string |

luawrap-0.1.0/README.md

@@ -0,0 +1,43 @@
+# LuaWrap
+
+Write and run Lua code directly inside your Python files — no separate Lua install needed.
+
+## Installation
+
+```bash
+poetry add lupa
+poetry install
+```
+
+## Usage
+
+```python
+from luawrap import lua, run_lua, lua_function, LuaBlock
+
+# Run Lua directly
+lua("print('Hello from Lua!')")
+
+# Get a return value back in Python
+result = run_lua("return 2 + 2")
+print(result)  # 4
+
+# Decorator style
+@lua_function
+def my_script():
+    return "print('I am a Lua function!')"
+
+my_script()
+
+# Context manager style
+with LuaBlock() as lb:
+    lb.code = "print('Runs when the block exits!')"
+```
+
+## API
+
+| Function | Description |
+|---|---|
+| `lua(code)` | Run a Lua string |
+| `run_lua(code)` | Same as `lua()`, alias |
+| `@lua_function` | Decorator — function returns Lua code as a string |
+| `LuaBlock` | Context manager — set `lb.code` to your Lua string |

luawrap-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[tool.poetry]
+name = "luawrap"
+version = "0.1.0"
+description = "Write and run Lua code directly from Python files."
+authors = ["Your Name V011DZ"]
+readme = "README.md"
+license = "LicenseRef-LuaWrap-Custom"
+packages = [{include = "luawrap", from = "src"}]
+
+[tool.poetry.dependencies]
+python = "^3.8"
+lupa = "^2.0"
+
+[tool.poetry.dev-dependencies]
+pytest = "^7.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

luawrap-0.1.0/src/LuaWrap/__init__.py

@@ -0,0 +1,11 @@
+"""
+LuaWrap - Write and run Lua code directly from Python files!
+
+Import:
+    from luawrap import lua, run_lua, lua_function, LuaBlock
+"""
+
+from .main import lua, run_lua, lua_function, LuaBlock
+
+__version__ = "0.1.0"
+__all__ = ["lua", "run_lua", "lua_function", "LuaBlock"]

luawrap-0.1.0/src/LuaWrap/main.py

@@ -0,0 +1,98 @@
+"""
+LuaWrap core - internal implementation.
+Import from the top-level package instead:
+    from luawrap import lua, run_lua, lua_function, LuaBlock
+"""
+
+from functools import wraps
+from typing import Optional
+
+try:
+    from lupa import LuaRuntime
+except ImportError:
+    raise ImportError(
+        "\n[LuaWrap] The 'lupa' package is not installed!\n"
+        "Fix it by running:\n"
+        "    poetry add lupa\n"
+    )
+
+
+_runtime: Optional[LuaRuntime] = None
+
+
+def _get_runtime() -> LuaRuntime:
+    """Get (or create) the shared Lua runtime."""
+    global _runtime
+    if _runtime is None:
+        _runtime = LuaRuntime(unpack_returned_tuples=True)
+    return _runtime
+
+
+def run_lua(code: str) -> object:
+    """
+    Run a string of Lua code and return the result.
+
+    Example:
+        run_lua("print('Hello from Lua!')")
+        result = run_lua("return 2 + 2")
+        print(result)  # 4
+    """
+    rt = _get_runtime()
+    return rt.execute(code)
+
+
+def lua(code: str) -> object:
+    """
+    Shorthand for run_lua(). Run Lua code from a Python string.
+
+    Example:
+        lua("print('Hello!')")
+    """
+    return run_lua(code)
+
+
+def lua_function(func):
+    """
+    Decorator that turns a Python function into a Lua runner.
+    The function should return a string of Lua code when called.
+
+    Example:
+        @lua_function
+        def say_hello():
+            return "print('Hello from a Lua function!')"
+
+        say_hello()
+    """
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        lua_code = func(*args, **kwargs)
+        if not isinstance(lua_code, str):
+            raise TypeError(
+                "[LuaWrap] @lua_function '{}' must return a string of Lua code, got {} instead.".format(
+                    func.__name__, type(lua_code).__name__
+                )
+            )
+        return run_lua(lua_code)
+    return wrapper
+
+
+class LuaBlock:
+    """
+    Context manager for writing a block of Lua code.
+    Set lb.code inside the with-block and it runs automatically on exit.
+
+    Example:
+        with LuaBlock() as lb:
+            lb.code = "print('Runs when the block exits!')"
+    """
+
+    def __init__(self):
+        self.code: str = ""
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if exc_type is None and self.code.strip():
+            run_lua(self.code)
+        return False