litexpy 0.0.2__py3-none-any.whl

litexpy/__init__.py

@@ -0,0 +1,7 @@
+"""Python runner for an interactive litex terminal session."""
+
+from .runner import Runner, runner
+
+__version__ = "0.0.2"
+
+__all__ = ["Runner", "runner", "__version__"]

litexpy/runner.py

@@ -0,0 +1,59 @@
+"""Runner for interactive litex sessions."""
+
+from __future__ import annotations
+
+import subprocess
+from collections.abc import Sequence
+
+
+class Runner:
+    """Run commands inside an interactive ``litex`` process."""
+
+    def __init__(self, command: str | Sequence[str] = "litex") -> None:
+        if isinstance(command, str):
+            args = [command]
+        else:
+            args = list(command)
+
+        self._process = subprocess.Popen(
+            args,
+            stdin=subprocess.PIPE,
+            text=True,
+        )
+
+    def run(self, script: str) -> None:
+        """Send a script line to the running litex process."""
+        if self._process.poll() is not None:
+            raise RuntimeError("litex process is not running")
+        if self._process.stdin is None:
+            raise RuntimeError("litex process stdin is not available")
+
+        self._process.stdin.write(f"{script}\n")
+        self._process.stdin.flush()
+
+    def clear(self) -> None:
+        """Clear the litex terminal session."""
+        self.run("clear")
+
+    def quit(self) -> None:
+        """Stop the running litex process."""
+        if self._process.poll() is not None:
+            return
+
+        if self._process.stdin is not None:
+            self._process.stdin.close()
+
+        try:
+            self._process.wait(timeout=2)
+        except subprocess.TimeoutExpired:
+            self._process.terminate()
+            try:
+                self._process.wait(timeout=2)
+            except subprocess.TimeoutExpired:
+                self._process.kill()
+                self._process.wait()
+
+
+def runner() -> Runner:
+    """Create a litex runner."""
+    return Runner()

litexpy-0.0.2.dist-info/METADATA

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: litexpy
+Version: 0.0.2
+Summary: Python runner for an interactive litex terminal session.
+Project-URL: Homepage, https://github.com/litexlang/litexpy
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# litexpy
+
+Python runner for an interactive `litex` terminal session.
+
+## Usage
+
+```python
+import litexpy
+
+runner = litexpy.Runner()
+
+runner.run("1 = 1")
+runner.clear()
+runner.quit()
+```
+
+`litexpy.Runner()` starts the `litex` command in an interactive terminal
+process. `run(script)` sends one script line to that process, `clear()` is
+equivalent to `run("clear")`, and `quit()` closes the running `litex` process.

litexpy-0.0.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+litexpy/__init__.py,sha256=zQjvMKSNtW86kmeTxKOm2_JPxEDfErgLzqmuEwwyWBc,169
+litexpy/runner.py,sha256=-R3Ji14eqLuqv60PaKP9frKi6r_9BwuFekFOtNhGXHc,1667
+litexpy-0.0.2.dist-info/METADATA,sha256=hYBW11oTjFNs3IwM6_u9MonEG_vdI3y8Cu310EWrU6I,760
+litexpy-0.0.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+litexpy-0.0.2.dist-info/top_level.txt,sha256=gWGdARZ13Ry-1Py1zS_rx0iK1MErQmdNeMNq59agvU4,8
+litexpy-0.0.2.dist-info/RECORD,,

litexpy-0.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

litexpy-0.0.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+litexpy