quantum-framework 0.9.0__py3-none-any.whl

quantum/runtime/terminal_templates.py

@@ -0,0 +1,243 @@
+"""
+Terminal Engine - Python Code Templates and PyBuilder
+
+Provides:
+  - PyBuilder: Structured Python code emitter with proper indentation
+  - App template for Textual applications
+"""
+
+import re
+
+
+# ==========================================================================
+# PyBuilder - Structured Python code emitter
+# ==========================================================================
+
+class PyBuilder:
+    """Builds syntactically valid Python code with proper indentation.
+
+    Every append method returns self for chaining.
+    """
+
+    def __init__(self, indent_size: int = 4):
+        self._lines: list[str] = []
+        self._indent: int = 0
+        self._indent_size: int = indent_size
+
+    # -- core --
+
+    @property
+    def _pad(self) -> str:
+        return ' ' * (self._indent * self._indent_size)
+
+    def line(self, code: str = '') -> 'PyBuilder':
+        """Emit a single line at current indent."""
+        self._lines.append(f"{self._pad}{code}" if code else '')
+        return self
+
+    def raw(self, code: str) -> 'PyBuilder':
+        """Emit raw code at current indent (multi-line)."""
+        for ln in code.split('\n'):
+            self._lines.append(f"{self._pad}{ln}")
+        return self
+
+    def blank(self) -> 'PyBuilder':
+        self._lines.append('')
+        return self
+
+    def comment(self, text: str) -> 'PyBuilder':
+        return self.line(f"# {text}")
+
+    def section(self, title: str) -> 'PyBuilder':
+        return self.blank().line(f"# === {title} ===")
+
+    def indent(self) -> 'PyBuilder':
+        self._indent += 1
+        return self
+
+    def dedent(self) -> 'PyBuilder':
+        self._indent = max(0, self._indent - 1)
+        return self
+
+    # -- Python constructs --
+
+    def assign(self, target: str, value: str) -> 'PyBuilder':
+        return self.line(f"{target} = {value}")
+
+    def class_def(self, name: str, bases: str = '') -> 'PyBuilder':
+        """Open a class definition."""
+        if bases:
+            self.line(f"class {name}({bases}):")
+        else:
+            self.line(f"class {name}:")
+        self._indent += 1
+        return self
+
+    def method_def(self, name: str, params: str = 'self') -> 'PyBuilder':
+        """Open a method definition."""
+        self.line(f"def {name}({params}):")
+        self._indent += 1
+        return self
+
+    def async_method_def(self, name: str, params: str = 'self') -> 'PyBuilder':
+        """Open an async method definition."""
+        self.line(f"async def {name}({params}):")
+        self._indent += 1
+        return self
+
+    def func_def(self, name: str, params: str = '') -> 'PyBuilder':
+        """Open a function definition."""
+        self.line(f"def {name}({params}):")
+        self._indent += 1
+        return self
+
+    def if_block(self, condition: str) -> 'PyBuilder':
+        self.line(f"if {condition}:")
+        self._indent += 1
+        return self
+
+    def elif_block(self, condition: str) -> 'PyBuilder':
+        self._indent = max(0, self._indent - 1)
+        self.line(f"elif {condition}:")
+        self._indent += 1
+        return self
+
+    def else_block(self) -> 'PyBuilder':
+        self._indent = max(0, self._indent - 1)
+        self.line("else:")
+        self._indent += 1
+        return self
+
+    def for_block(self, var: str, iterable: str) -> 'PyBuilder':
+        self.line(f"for {var} in {iterable}:")
+        self._indent += 1
+        return self
+
+    def with_block(self, expr: str) -> 'PyBuilder':
+        self.line(f"with {expr}:")
+        self._indent += 1
+        return self
+
+    def try_block(self) -> 'PyBuilder':
+        self.line("try:")
+        self._indent += 1
+        return self
+
+    def except_block(self, exc: str = 'Exception as e') -> 'PyBuilder':
+        self._indent = max(0, self._indent - 1)
+        self.line(f"except {exc}:")
+        self._indent += 1
+        return self
+
+    def end_block(self) -> 'PyBuilder':
+        """Dedent to close a block."""
+        self._indent = max(0, self._indent - 1)
+        return self
+
+    def decorator(self, name: str) -> 'PyBuilder':
+        return self.line(f"@{name}")
+
+    def docstring(self, text: str) -> 'PyBuilder':
+        return self.line(f'"""{text}"""')
+
+    def return_stmt(self, value: str = '') -> 'PyBuilder':
+        if value:
+            return self.line(f"return {value}")
+        return self.line("return")
+
+    def yield_stmt(self, value: str) -> 'PyBuilder':
+        return self.line(f"yield {value}")
+
+    def pass_stmt(self) -> 'PyBuilder':
+        return self.line("pass")
+
+    def build(self) -> str:
+        return '\n'.join(self._lines)
+
+
+# ==========================================================================
+# Utility functions
+# ==========================================================================
+
+def py_string(value: str) -> str:
+    """Safe Python string literal."""
+    escaped = value.replace('\\', '\\\\').replace('"', '\\"').replace('\n', '\\n')
+    return f'"{escaped}"'
+
+
+def py_bool(value: bool) -> str:
+    return "True" if value else "False"
+
+
+def py_id(name: str) -> str:
+    """Convert a string to a valid Python identifier.
+
+    Trocava tres caracteres — `-`, `.` e espaco — e devolvia o resto como
+    estava. Um `on-click="salvar()"` chegava aqui e saia `salvar()`, que o
+    gerador entao escrevia como
+
+        def action_salvar()(self):
+
+    ou seja: o arquivo Python gerado nao COMPILAVA. Um unico botao com
+    parenteses — a forma como se escreve uma chamada em toda outra
+    linguagem — derrubava o aplicativo inteiro na hora de importar.
+
+    Agora tudo que nao serve num identificador vira `_`, entao esta funcao
+    nao consegue mais produzir codigo invalido. Quem quiser tratar
+    `nome(args)` como chamada deve usar `split_call` ANTES.
+    """
+    result = re.sub(r'\W', '_', name or '')
+    if not result:
+        return '_'
+    if result[0].isdigit():
+        result = '_' + result
+    return result
+
+
+_CALL = re.compile(r'^\s*([A-Za-z_][\w.-]*)\s*\((.*)\)\s*$', re.DOTALL)
+
+
+def split_call(handler: str):
+    """`"salvar()"` -> `("salvar", "")`; `"salvar"` -> `("salvar", None)`.
+
+    Devolve (nome, argumentos) com argumentos None quando o handler nao e
+    uma chamada. Existe porque os geradores comparavam o texto CRU do
+    on-click com os nomes das q:function: `"salvar()"` nunca casava com
+    `salvar`, entao a funcao do usuario nao era chamada nem quando existia.
+    """
+    if not handler:
+        return '', None
+    m = _CALL.match(handler)
+    if m:
+        return m.group(1), m.group(2).strip()
+    return handler.strip(), None
+
+
+# ==========================================================================
+# App template
+# ==========================================================================
+
+APP_TEMPLATE = '''#!/usr/bin/env python3
+"""
+{title} - Generated by Quantum Terminal Engine
+Run: python {filename}
+Requires: pip install textual
+"""
+
+from textual.app import App, ComposeResult
+from textual.containers import Horizontal, Vertical
+from textual.widgets import (
+    Header, Footer, Static, Button, Input,
+    DataTable, ProgressBar, Tree, RichLog,
+    TabbedContent, TabPane, OptionList,
+)
+from textual.binding import Binding
+from textual.reactive import reactive
+{extra_imports}
+
+{app_code}
+
+if __name__ == "__main__":
+    app = {app_class}()
+    app.run()
+'''

quantum/runtime/testing_builder.py

@@ -0,0 +1,77 @@
+"""
+Testing Engine - Builder/Orchestrator
+
+Orchestrates the compilation pipeline:
+  ApplicationNode (type="testing") -> extract suites/config/fixtures/mocks -> TestingCodeGenerator -> test_*.py
+
+Usage:
+    builder = TestingBuilder()
+    python_code = builder.build(app_node)
+    builder.build_to_file(app_node, "test_output.py")
+"""
+
+from pathlib import Path
+from typing import Optional
+
+from quantum.core.ast_nodes import ApplicationNode
+from quantum.core.features.testing_engine.src.ast_nodes import (
+    QTestSuiteNode, BrowserConfigNode, FixtureNode_Testing,
+    MockNode_Testing, AuthNode,
+)
+from quantum.runtime.testing_code_generator import QTestCodeGenerator
+
+
+class TestingBuildError(Exception):
+    """Error during testing app build."""
+    pass
+
+
+class TestingBuilder:
+    """Builds a standalone pytest file from a Quantum testing ApplicationNode."""
+
+    def build(self, app: ApplicationNode) -> str:
+        """Build Python test source string from an ApplicationNode with type='testing'.
+
+        The ApplicationNode is expected to have:
+        - app.test_suites: list of TestSuiteNode
+        - app.test_config: optional BrowserConfigNode
+        - app.test_fixtures: list of FixtureNode_Testing
+        - app.test_mocks: list of MockNode_Testing
+        - app.test_auth_states: list of AuthNode
+        """
+        suites = getattr(app, 'test_suites', [])
+        config = getattr(app, 'test_config', None)
+        fixtures = getattr(app, 'test_fixtures', [])
+        mocks = getattr(app, 'test_mocks', [])
+        auth_states = getattr(app, 'test_auth_states', [])
+
+        if not suites:
+            raise TestingBuildError("No test suites found in testing application")
+
+        valid_suites = [s for s in suites if isinstance(s, QTestSuiteNode)]
+        if not valid_suites:
+            raise TestingBuildError("No valid QTestSuiteNode found in testing application")
+
+        generator = QTestCodeGenerator()
+        python_code = generator.generate(
+            suites=valid_suites,
+            title=app.app_id,
+            browser_config=config if isinstance(config, BrowserConfigNode) else None,
+            fixtures=[f for f in fixtures if isinstance(f, FixtureNode_Testing)],
+            mocks=[m for m in mocks if isinstance(m, MockNode_Testing)],
+            auth_states=[a for a in auth_states if isinstance(a, AuthNode)],
+        )
+        return python_code
+
+    def build_to_file(self, app: ApplicationNode, output_path: Optional[str] = None) -> str:
+        """Build and write test_*.py file. Returns the output file path."""
+        python_code = self.build(app)
+
+        if output_path is None:
+            output_path = f"test_{app.app_id}.py"
+
+        path = Path(output_path)
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(python_code, encoding='utf-8')
+
+        return str(path.resolve())