unidecompiler-cli 0.1.0__tar.gz → 0.1.2__tar.gz

unidecompiler_cli-0.1.2/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: unidecompiler-cli
+Version: 0.1.2
+Summary: Command-line host for unidecompiler plugins
+Author-email: Wker <1670133844@qq.com>
+License-Expression: AGPL-3.0-or-later
+Project-URL: Homepage, https://github.com/Wker666/unidecompiler
+Project-URL: Repository, https://github.com/Wker666/unidecompiler
+Project-URL: Issues, https://github.com/Wker666/unidecompiler/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: unidecompiler<0.2.0,>=0.1.10
+Requires-Dist: unidecompiler-simulator<0.2.0,>=0.1.5
+Requires-Dist: unidecompiler-simulation-host-python<0.2.0,>=0.1.2
+
+# unidecompiler-cli
+
+`unidecompiler-cli` is the command-line host for installed `unidecompiler`
+frontend plugins. It discovers plugins through the `unidecompiler.frontends`
+entry-point group and uses the public `DecompilerEngine` facade.
+
+Install the CLI and one or more frontend packages:
+
+```sh
+python -m pip install unidecompiler-cli unidecompiler-plugin-python-pyc
+```
+
+Run `unidecompiler --help` for command-line usage.
+
+The optional simulator command is hosted here, while execution remains in the
+separate simulator library:
+
+```sh
+unidecompiler simulate sample.bytecode --function 'Example.run' --args '[1, 2]'
+```
+
+For trusted programs that require functions outside the lifted module, pass a
+Python environment file. Top-level functions are matched by name, while their
+stdout and stderr are returned as structured simulation events:
+
+```sh
+unidecompiler simulate sample.pyc --function main --environment runtime.py
+```

unidecompiler_cli-0.1.2/README.md

@@ -0,0 +1,28 @@
+# unidecompiler-cli
+
+`unidecompiler-cli` is the command-line host for installed `unidecompiler`
+frontend plugins. It discovers plugins through the `unidecompiler.frontends`
+entry-point group and uses the public `DecompilerEngine` facade.
+
+Install the CLI and one or more frontend packages:
+
+```sh
+python -m pip install unidecompiler-cli unidecompiler-plugin-python-pyc
+```
+
+Run `unidecompiler --help` for command-line usage.
+
+The optional simulator command is hosted here, while execution remains in the
+separate simulator library:
+
+```sh
+unidecompiler simulate sample.bytecode --function 'Example.run' --args '[1, 2]'
+```
+
+For trusted programs that require functions outside the lifted module, pass a
+Python environment file. Top-level functions are matched by name, while their
+stdout and stderr are returned as structured simulation events:
+
+```sh
+unidecompiler simulate sample.pyc --function main --environment runtime.py
+```

unidecompiler_cli-0.1.2/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "unidecompiler-cli"
+version = "0.1.2"
+description = "Command-line host for unidecompiler plugins"
+readme = "README.md"
+license = "AGPL-3.0-or-later"
+authors = [{ name = "Wker", email = "1670133844@qq.com" }]
+requires-python = ">=3.11"
+dependencies = [
+    "unidecompiler>=0.1.10,<0.2.0",
+    "unidecompiler-simulator>=0.1.5,<0.2.0",
+    "unidecompiler-simulation-host-python>=0.1.2,<0.2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Wker666/unidecompiler"
+Repository = "https://github.com/Wker666/unidecompiler"
+Issues = "https://github.com/Wker666/unidecompiler/issues"
+
+[project.scripts]
+unidecompiler = "unidecompiler_cli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

{unidecompiler_cli-0.1.0 → unidecompiler_cli-0.1.2}/src/unidecompiler_cli/cli.py

@@ -17,6 +17,11 @@ from unidecompiler.input_sources import expand_input_path
 
 
 def main(argv: list[str] | None = None, *, registry: FrontendRegistry | None = None) -> int:
+    command_argv = sys.argv[1:] if argv is None else argv
+    if command_argv[:1] == ["simulate"]:
+        from unidecompiler_cli.simulation import main as simulate_main
+
+        return simulate_main(command_argv[1:], registry=registry)
     parser = argparse.ArgumentParser(
         prog="unidecompiler",
         description="Decompile bytecode into generic pseudocode.",
@@ -38,7 +43,7 @@ def main(argv: list[str] | None = None, *, registry: FrontendRegistry | None = N
         default="pseudocode",
         help="output format (default: pseudocode)",
     )
-    args = parser.parse_args(argv)
+    args = parser.parse_args(command_argv)
 
     registry = registry or FrontendRegistry.discover()
     if args.versions:
@@ -61,9 +66,6 @@ def main(argv: list[str] | None = None, *, registry: FrontendRegistry | None = N
     ast_modules: list[dict[str, Any]] = []
     processed = 0
     for artifact in artifacts:
-        if artifact.kind == "resource":
-            print(f"resource: {artifact.display_path}", file=sys.stderr)
-            continue
         try:
             frontend = registry.select(
                 artifact.data, artifact.display_path, explicit_id=args.frontend

unidecompiler_cli-0.1.2/src/unidecompiler_cli/simulation.py

@@ -0,0 +1,84 @@
+"""Simulation command hosted by the unidecompiler CLI package."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+from unidecompiler.plugin_registry import FrontendRegistry
+from unidecompiler_simulator import SimulationEngine, SimulationLimits
+from unidecompiler_simulation_host_python import PythonFileEnvironment
+
+
+def main(argv: list[str] | None = None, *, registry: FrontendRegistry | None = None) -> int:
+    parser = argparse.ArgumentParser(prog="unidecompiler simulate")
+    parser.add_argument("input")
+    parser.add_argument("--function", required=True, help="frontend-owned function query")
+    parser.add_argument("--args", default="[]", help="JSON array of function arguments")
+    parser.add_argument("--frontend")
+    parser.add_argument("--max-steps", type=int, default=100_000)
+    parser.add_argument("--max-call-depth", type=int, default=128)
+    parser.add_argument("--environment", type=Path, help="trusted Python file providing unresolved functions")
+    parser.add_argument(
+        "--show-host-output",
+        action="store_true",
+        help="write captured environment stdout and stderr to stderr",
+    )
+    args = parser.parse_args(argv)
+    try:
+        values = json.loads(args.args)
+        if not isinstance(values, list):
+            raise ValueError("--args must be a JSON array")
+        environment = PythonFileEnvironment.load(args.environment) if args.environment else None
+        engine = SimulationEngine.from_registry(registry or FrontendRegistry.discover())
+        result = engine.simulate_path(
+            Path(args.input),
+            args.function,
+            frontend_id=args.frontend,
+            args=tuple(values),
+            environment=environment,
+            limits=SimulationLimits(args.max_steps, args.max_call_depth),
+        )
+    except (OSError, ValueError, json.JSONDecodeError) as error:
+        print(f"invalid simulation request: {error}", file=sys.stderr)
+        return 2
+    if args.show_host_output:
+        for event in result.events:
+            if event.kind != "external-call":
+                continue
+            if event.stdout:
+                print(event.stdout, file=sys.stderr, end="")
+            if event.stderr:
+                print(event.stderr, file=sys.stderr, end="")
+    print(json.dumps(_result_payload(result), default=repr, sort_keys=True))
+    return 0 if result.status.value == "completed" else 1
+
+
+def _result_payload(result):
+    return {
+        "status": result.status.value,
+        "values": result.values,
+        "exception": result.exception,
+        "locals": result.locals,
+        "steps": result.steps,
+        "diagnostic": result.diagnostic,
+        "trace_truncated": result.trace_truncated,
+        "events": [
+            {
+                "function": event.function,
+                "function_index": event.function_index,
+                "block": event.block,
+                "kind": event.kind,
+                "detail": event.detail,
+                "args": event.args,
+                "values": event.values,
+                "exception": event.exception,
+                "stdout": event.stdout,
+                "stderr": event.stderr,
+                "source": event.source,
+            }
+            for event in result.events
+        ],
+    }

unidecompiler_cli-0.1.2/src/unidecompiler_cli.egg-info/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: unidecompiler-cli
+Version: 0.1.2
+Summary: Command-line host for unidecompiler plugins
+Author-email: Wker <1670133844@qq.com>
+License-Expression: AGPL-3.0-or-later
+Project-URL: Homepage, https://github.com/Wker666/unidecompiler
+Project-URL: Repository, https://github.com/Wker666/unidecompiler
+Project-URL: Issues, https://github.com/Wker666/unidecompiler/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: unidecompiler<0.2.0,>=0.1.10
+Requires-Dist: unidecompiler-simulator<0.2.0,>=0.1.5
+Requires-Dist: unidecompiler-simulation-host-python<0.2.0,>=0.1.2
+
+# unidecompiler-cli
+
+`unidecompiler-cli` is the command-line host for installed `unidecompiler`
+frontend plugins. It discovers plugins through the `unidecompiler.frontends`
+entry-point group and uses the public `DecompilerEngine` facade.
+
+Install the CLI and one or more frontend packages:
+
+```sh
+python -m pip install unidecompiler-cli unidecompiler-plugin-python-pyc
+```
+
+Run `unidecompiler --help` for command-line usage.
+
+The optional simulator command is hosted here, while execution remains in the
+separate simulator library:
+
+```sh
+unidecompiler simulate sample.bytecode --function 'Example.run' --args '[1, 2]'
+```
+
+For trusted programs that require functions outside the lifted module, pass a
+Python environment file. Top-level functions are matched by name, while their
+stdout and stderr are returned as structured simulation events:
+
+```sh
+unidecompiler simulate sample.pyc --function main --environment runtime.py
+```

{unidecompiler_cli-0.1.0 → unidecompiler_cli-0.1.2}/src/unidecompiler_cli.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ pyproject.toml
 src/unidecompiler_cli/__init__.py
 src/unidecompiler_cli/cli.py
 src/unidecompiler_cli/input_sources.py
+src/unidecompiler_cli/simulation.py
 src/unidecompiler_cli.egg-info/PKG-INFO
 src/unidecompiler_cli.egg-info/SOURCES.txt
 src/unidecompiler_cli.egg-info/dependency_links.txt

unidecompiler_cli-0.1.2/src/unidecompiler_cli.egg-info/requires.txt

@@ -0,0 +1,3 @@
+unidecompiler<0.2.0,>=0.1.10
+unidecompiler-simulator<0.2.0,>=0.1.5
+unidecompiler-simulation-host-python<0.2.0,>=0.1.2

unidecompiler_cli-0.1.0/PKG-INFO

@@ -1,21 +0,0 @@
-Metadata-Version: 2.4
-Name: unidecompiler-cli
-Version: 0.1.0
-Summary: Command-line host for unidecompiler plugins
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: unidecompiler<0.2.0,>=0.1.0
-
-# unidecompiler-cli
-
-`unidecompiler-cli` is the command-line host for installed `unidecompiler`
-frontend plugins. It discovers plugins through the `unidecompiler.frontends`
-entry-point group and uses the public `DecompilerEngine` facade.
-
-Install the CLI and one or more frontend packages:
-
-```sh
-python -m pip install unidecompiler-cli unidecompiler-plugin-python-pyc
-```
-
-Run `unidecompiler --help` for command-line usage.

unidecompiler_cli-0.1.0/README.md

@@ -1,13 +0,0 @@
-# unidecompiler-cli
-
-`unidecompiler-cli` is the command-line host for installed `unidecompiler`
-frontend plugins. It discovers plugins through the `unidecompiler.frontends`
-entry-point group and uses the public `DecompilerEngine` facade.
-
-Install the CLI and one or more frontend packages:
-
-```sh
-python -m pip install unidecompiler-cli unidecompiler-plugin-python-pyc
-```
-
-Run `unidecompiler --help` for command-line usage.

unidecompiler_cli-0.1.0/pyproject.toml

@@ -1,17 +0,0 @@
-[build-system]
-requires = ["setuptools>=68"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "unidecompiler-cli"
-version = "0.1.0"
-description = "Command-line host for unidecompiler plugins"
-readme = "README.md"
-requires-python = ">=3.11"
-dependencies = ["unidecompiler>=0.1.0,<0.2.0"]
-
-[project.scripts]
-unidecompiler = "unidecompiler_cli.cli:main"
-
-[tool.setuptools.packages.find]
-where = ["src"]

unidecompiler_cli-0.1.0/src/unidecompiler_cli.egg-info/PKG-INFO

@@ -1,21 +0,0 @@
-Metadata-Version: 2.4
-Name: unidecompiler-cli
-Version: 0.1.0
-Summary: Command-line host for unidecompiler plugins
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: unidecompiler<0.2.0,>=0.1.0
-
-# unidecompiler-cli
-
-`unidecompiler-cli` is the command-line host for installed `unidecompiler`
-frontend plugins. It discovers plugins through the `unidecompiler.frontends`
-entry-point group and uses the public `DecompilerEngine` facade.
-
-Install the CLI and one or more frontend packages:
-
-```sh
-python -m pip install unidecompiler-cli unidecompiler-plugin-python-pyc
-```
-
-Run `unidecompiler --help` for command-line usage.

unidecompiler_cli-0.1.0/src/unidecompiler_cli.egg-info/requires.txt

@@ -1 +0,0 @@
-unidecompiler<0.2.0,>=0.1.0