quantum-framework 0.18.0__py3-none-any.whl

quantum_admin/components/admin/applications.q

@@ -0,0 +1,160 @@
+<q:component name="AdminApplications" require_auth="true" require_role="admin" login_url="/admin/login">
+  <!--
+    Aplicações. A lógica está em quantum_admin/services/projects.py
+    (admin.projects.*); esta tela só chama os serviços e mostra o resultado.
+    Os dados ficam no banco do admin — antes, em settings/projects.yaml.
+  -->
+  <q:import component="AdminShell" from="admin/_layout" />
+
+  <q:action name="createProject" method="POST">
+    <q:param name="name" type="string" required="true" minlength="2" />
+    <q:param name="description" type="string" />
+    <q:param name="source_path" type="string" />
+    <q:invoke name="criado" service="admin.projects.create" onerror="continue">
+      <q:param name="name" value="{name}" />
+      <q:param name="description" value="{form.description}" />
+      <q:param name="source_path" value="{form.source_path}" />
+    </q:invoke>
+    <q:if condition="criado_result.success">
+      <q:redirect url="/admin/applications" flash="Application {criado.name} created" />
+    </q:if>
+    <q:flash type="error" message="{criado_result.error.message}" />
+    <q:redirect url="/admin/applications" />
+  </q:action>
+
+  <q:action name="deleteProject" method="POST">
+    <q:param name="project_id" type="integer" required="true" />
+    <q:invoke name="removido" service="admin.projects.delete">
+      <q:param name="project_id" value="{project_id}" type="integer" />
+    </q:invoke>
+    <q:redirect url="/admin/applications" flash="Application record removed (files were kept)" />
+  </q:action>
+
+  <q:action name="syncProjects" method="POST">
+    <q:invoke name="sincronia" service="admin.projects.sync" />
+    <q:redirect url="/admin/applications" flash="{len(sincronia.created)} new application(s) found on disk" />
+  </q:action>
+
+  <q:action name="importYaml" method="POST">
+    <q:invoke name="importacao" service="admin.import.run" />
+    <q:redirect url="/admin/applications" flash="{len(importacao.projects)} application(s) imported; database backup at {importacao.backup}" />
+  </q:action>
+
+  <!-- query.search pode não existir: a referência pura vale '' (EXPR-3) -->
+  <q:set name="busca" value="{query.search}" />
+  <q:invoke name="apps" service="admin.projects.list">
+    <q:param name="search" value="{busca}" />
+  </q:invoke>
+  <q:invoke name="totais" service="admin.projects.summary" />
+  <q:invoke name="pendentes" service="admin.import.pending" />
+
+  <AdminShell title="Applications" active="applications" flash="{flash}" flashType="{flashType}">
+
+    <q:if condition="len(pendentes.projects) &gt; 0">
+      <div class="qa-card qa-mb-6">
+        <div class="qa-card-body">
+          <p class="qa-text-sm">
+            {len(pendentes.projects)} application(s) exist only in the old settings/projects.yaml:
+            <span class="qa-font-mono">{join(pendentes.projects)}</span>.
+            Importing copies them into the admin database (a backup of the database is made first; the YAML file is not changed).
+          </p>
+          <form method="POST" action="/admin/applications">
+            <input type="hidden" name="action" value="importYaml" />
+            <button type="submit" class="qa-btn qa-btn-primary qa-btn-sm">Import</button>
+          </form>
+        </div>
+      </div>
+    </q:if>
+
+    <div class="qa-grid qa-grid-4 qa-mb-6">
+      <div class="qa-stat-card"><div class="qa-stat-label">Total Apps</div><div class="qa-stat-value">{totais.total}</div></div>
+      <div class="qa-stat-card"><div class="qa-stat-label">Active</div><div class="qa-stat-value">{totais.active}</div></div>
+      <div class="qa-stat-card"><div class="qa-stat-label">Running</div><div class="qa-stat-value">{totais.running}</div></div>
+      <div class="qa-stat-card"><div class="qa-stat-label">Connectors</div><div class="qa-stat-value">{totais.connectors}</div></div>
+    </div>
+
+    <div style="display: flex; gap: 12px; margin-bottom: 24px; flex-wrap: wrap;">
+      <form method="GET" action="/admin/applications" style="flex: 1; min-width: 200px;">
+        <div class="qa-search-bar">
+          <input type="text" name="search" placeholder="Search applications..." value="{busca}" aria-label="Search applications" />
+        </div>
+      </form>
+      <form method="POST" action="/admin/applications">
+        <input type="hidden" name="action" value="syncProjects" />
+        <button type="submit" class="qa-btn qa-btn-secondary qa-btn-sm">Sync from Disk</button>
+      </form>
+    </div>
+
+    <div class="qa-card qa-mb-6">
+      <div class="qa-card-header">
+        <div>
+          <div class="qa-card-title">New Application</div>
+          <div class="qa-card-subtitle">Create a new Quantum project</div>
+        </div>
+      </div>
+      <div class="qa-card-body">
+        <form method="POST" action="/admin/applications">
+          <input type="hidden" name="action" value="createProject" />
+          <div class="qa-form-row qa-mb-4">
+            <div class="qa-form-group">
+              <label class="qa-label" for="name">Name</label>
+              <input id="name" type="text" name="name" class="qa-input" placeholder="my-app" required="" minlength="2" />
+            </div>
+            <div class="qa-form-group">
+              <label class="qa-label" for="source_path">Source Path</label>
+              <input id="source_path" type="text" name="source_path" class="qa-input" placeholder="projects/my-app (optional)" />
+            </div>
+          </div>
+          <div class="qa-form-group qa-mb-4">
+            <label class="qa-label" for="description">Description</label>
+            <input id="description" type="text" name="description" class="qa-input" placeholder="Brief description of the application" />
+          </div>
+          <button type="submit" class="qa-btn qa-btn-primary">Create Application</button>
+        </form>
+      </div>
+    </div>
+
+    <q:if condition="len(apps) &gt; 0">
+      <div class="qa-card qa-mb-6">
+        <div class="qa-card-body" style="padding: 0;">
+          <q:loop type="array" var="proj" items="{apps}">
+            <div class="qa-app-card">
+              <div class="qa-app-card-icon">{proj.initial}</div>
+              <div style="flex: 1; min-width: 0;">
+                <div style="display: flex; align-items: center; gap: 8px; margin-bottom: 2px;">
+                  <a href="/admin/app/{proj.name}" style="font-weight: 600; color: var(--q-text-primary); font-size: 0.9375rem;">{proj.name}</a>
+                  <span class="{'qa-badge qa-badge-success' if proj.status == 'active' else ('qa-badge qa-badge-danger' if proj.status == 'error' else 'qa-badge qa-badge-gray')}" style="font-size: 0.65rem;">{proj.status}</span>
+                  <span class="{'qa-process-running' if proj.running else 'qa-process-stopped'}">{'Running' if proj.running else 'Stopped'}</span>
+                </div>
+                <div style="display: flex; align-items: center; gap: 10px;">
+                  <span class="qa-font-mono qa-text-xs qa-text-muted">{proj.source_path}</span>
+                  <span class="qa-text-xs qa-text-muted qa-truncate" style="max-width: 300px;">{proj.description or 'No description'}</span>
+                </div>
+              </div>
+              <div class="qa-app-metrics">
+                <div class="qa-app-metric"><span class="qa-app-metric-value">{proj.component_count}</span><span class="qa-app-metric-label">Comps</span></div>
+                <div class="qa-app-metric"><span class="qa-app-metric-value">{proj.connector_count}</span><span class="qa-app-metric-label">Conns</span></div>
+                <div class="qa-app-metric"><span class="qa-app-metric-value">{proj.port or '-'}</span><span class="qa-app-metric-label">Port</span></div>
+              </div>
+              <form method="POST" action="/admin/applications" style="flex-shrink: 0; margin: 0;" onsubmit="return confirm('Remove this application record? Files on disk will NOT be deleted.');">
+                <input type="hidden" name="action" value="deleteProject" />
+                <input type="hidden" name="project_id" value="{proj.id}" />
+                <button type="submit" class="qa-btn qa-btn-ghost qa-btn-sm" style="color: var(--q-danger);" title="Remove record" aria-label="Remove {proj.name}">Remove</button>
+              </form>
+            </div>
+          </q:loop>
+        </div>
+      </div>
+    </q:if>
+
+    <q:if condition="len(apps) == 0">
+      <div class="qa-card qa-mb-6">
+        <div class="qa-empty">
+          <div class="qa-empty-title">{'No Results' if busca else 'No Applications Found'}</div>
+          <div class="qa-empty-text">{'No applications match your search.' if busca else 'Use Sync from Disk to discover existing projects, or create one above.'}</div>
+        </div>
+      </div>
+    </q:if>
+
+  </AdminShell>
+</q:component>

quantum_admin/components/admin/component/[...path].q

@@ -0,0 +1,205 @@
+<q:component name="AdminComponentDetail" require_auth="true" require_role="admin" login_url="/admin/login">
+  <!--
+    Detalhe de um componente: /admin/component/components/loja.q.
+    admin.components.get lê; admin.tests.generate e admin.tests.run agem.
+    `path` vem da URL também dentro das actions (ROUTE-2) — antes ia num
+    campo escondido do formulário. Rodar testes só aceita test_*.py de
+    tests/ (a versão anterior rodava pytest em qualquer caminho absoluto), e
+    gerar não sobrescreve um teste existente sem o botão Regenerate.
+  -->
+  <q:import component="AdminShell" from="admin/_layout" />
+
+  <q:action name="generateTests" method="POST">
+    <q:param name="overwrite" type="boolean" default="false" />
+    <q:invoke name="gerado" service="admin.tests.generate" onerror="continue">
+      <q:param name="comp_path" value="{path}" />
+      <q:param name="overwrite" value="{overwrite}" type="boolean" />
+    </q:invoke>
+    <q:if condition="gerado_result.success">
+      <q:redirect url="/admin/component/{path}?tab=tests" flash="{gerado.test_file} {'regenerated' if gerado.overwritten else 'created'}" />
+    </q:if>
+    <q:flash type="error" message="{gerado_result.error.message}" />
+    <q:redirect url="/admin/component/{path}?tab=tests" />
+  </q:action>
+
+  <q:action name="runTests" method="POST">
+    <q:invoke name="alvo" service="admin.components.get">
+      <q:param name="path" value="{path}" />
+    </q:invoke>
+    <q:invoke name="execucao" service="admin.tests.run" onerror="continue">
+      <q:param name="test_file" value="{alvo.test_file or ''}" />
+    </q:invoke>
+    <q:if condition="not execucao_result.success">
+      <q:flash type="error" message="{execucao_result.error.message}" />
+      <q:redirect url="/admin/component/{path}?tab=tests" />
+    </q:if>
+    <q:if condition="execucao.passed">
+      <q:redirect url="/admin/component/{path}?tab=tests" flash="{execucao.summary.passed} passed in {execucao.summary.duration}s" />
+    </q:if>
+    <q:flash type="error" message="{execucao.summary.failed} failed, {execucao.summary.errors} errors, {execucao.summary.passed} passed" />
+    <q:redirect url="/admin/component/{path}?tab=tests" />
+  </q:action>
+
+  <q:set name="aba" value="{query.tab}" />
+  <q:invoke name="comp" service="admin.components.get" onerror="continue">
+    <q:param name="path" value="{path}" />
+  </q:invoke>
+
+  <AdminShell title="Component" active="components" flash="{flash}" flashType="{flashType}">
+
+    <q:if condition="not comp_result.success">
+      <div class="qa-card">
+        <div class="qa-empty">
+          <div class="qa-empty-title">Cannot Load Component</div>
+          <div class="qa-empty-text">{comp_result.error.message}</div>
+          <a href="/admin/components" class="qa-text-sm">Back to Components</a>
+        </div>
+      </div>
+    </q:if>
+
+    <q:if condition="comp_result.success">
+      <div class="qa-flex qa-items-center qa-mb-4" style="gap: 12px; flex-wrap: wrap;">
+        <span class="qa-font-medium">{comp.name}</span>
+        <span class="qa-font-mono qa-text-sm qa-text-muted">{comp.path}</span>
+        <span class="qa-badge qa-badge-primary">{comp.type}</span>
+        <a href="/admin/components" class="qa-text-sm">Back to Components</a>
+      </div>
+
+      <q:if condition="aba == 'tests'">
+        <input type="radio" name="cdtabs" id="cdtab-general" class="qa-tab-radio" />
+        <input type="radio" name="cdtabs" id="cdtab-tests" class="qa-tab-radio" checked="checked" />
+      <q:else>
+        <input type="radio" name="cdtabs" id="cdtab-general" class="qa-tab-radio" checked="checked" />
+        <input type="radio" name="cdtabs" id="cdtab-tests" class="qa-tab-radio" />
+      </q:else>
+      </q:if>
+      <div class="qa-tabs-bar">
+        <label for="cdtab-general" class="qa-tab-label">General</label>
+        <label for="cdtab-tests" class="qa-tab-label">Tests</label>
+      </div>
+
+      <div class="qa-tabs-content">
+        <div class="qa-panel-cd-general">
+          <div class="qa-card qa-mb-6">
+            <div class="qa-card-header"><div class="qa-card-title">Metadata</div></div>
+            <div class="qa-card-body">
+              <div class="qa-grid qa-grid-3" style="gap: 20px;">
+                <div><div class="qa-text-xs qa-text-muted">Size</div><div class="qa-text-sm">{comp.size}</div></div>
+                <div><div class="qa-text-xs qa-text-muted">Lines</div><div class="qa-text-sm">{comp.lines}</div></div>
+                <div><div class="qa-text-xs qa-text-muted">Last Modified</div><div class="qa-text-sm">{comp.modified}</div></div>
+              </div>
+            </div>
+          </div>
+
+          <q:if condition="len(comp.actions) &gt; 0">
+            <div class="qa-card qa-mb-6">
+              <div class="qa-card-header"><div class="qa-card-title">Actions</div></div>
+              <div class="qa-card-body">
+                <div class="qa-flex" style="flex-wrap: wrap; gap: 8px;">
+                  <q:loop type="array" var="acao" items="{comp.actions}">
+                    <span class="qa-badge qa-badge-info qa-font-mono">{acao}</span>
+                  </q:loop>
+                </div>
+              </div>
+            </div>
+          </q:if>
+
+          <q:if condition="len(comp.queries) &gt; 0">
+            <div class="qa-card qa-mb-6">
+              <div class="qa-card-header"><div class="qa-card-title">Queries</div></div>
+              <div class="qa-card-body">
+                <div class="qa-flex" style="flex-wrap: wrap; gap: 8px;">
+                  <q:loop type="array" var="consulta" items="{comp.queries}">
+                    <span class="qa-badge qa-badge-info qa-font-mono">{consulta}</span>
+                  </q:loop>
+                </div>
+              </div>
+            </div>
+          </q:if>
+
+          <q:if condition="len(comp.feature_tags) &gt; 0">
+            <div class="qa-card qa-mb-6">
+              <div class="qa-card-header"><div class="qa-card-title">Tags Used</div></div>
+              <div class="qa-card-body">
+                <div class="qa-flex" style="flex-wrap: wrap; gap: 8px;">
+                  <q:loop type="array" var="tag" items="{comp.feature_tags}">
+                    <span class="qa-badge qa-badge-primary">q:{tag}</span>
+                  </q:loop>
+                </div>
+              </div>
+            </div>
+          </q:if>
+
+          <a href="/admin/source?file={comp.path}" class="qa-text-sm">View Full Source</a>
+        </div>
+
+        <div class="qa-panel-cd-tests">
+          <div class="qa-card qa-mb-6">
+            <div class="qa-card-header">
+              <div>
+                <div class="qa-card-title">Tests</div>
+                <div class="qa-card-subtitle qa-font-mono">{comp.test_file or 'no test file yet'}</div>
+              </div>
+              <div class="qa-flex qa-items-center" style="gap: 8px;">
+                <q:if condition="comp.test_file">
+                  <form method="POST" action="/admin/component/{comp.path}" style="margin: 0;"
+                        onsubmit="return confirm('Replace the test file? Changes made by hand will be lost.');">
+                    <input type="hidden" name="action" value="generateTests" />
+                    <input type="hidden" name="overwrite" value="true" />
+                    <button type="submit" class="qa-btn qa-btn-ghost qa-btn-sm">Regenerate</button>
+                  </form>
+                  <form method="POST" action="/admin/component/{comp.path}" style="margin: 0;">
+                    <input type="hidden" name="action" value="runTests" />
+                    <button type="submit" class="qa-btn qa-btn-primary qa-btn-sm">Run Tests</button>
+                  </form>
+                <q:else>
+                  <form method="POST" action="/admin/component/{comp.path}" style="margin: 0;">
+                    <input type="hidden" name="action" value="generateTests" />
+                    <button type="submit" class="qa-btn qa-btn-primary qa-btn-sm">Generate Tests</button>
+                  </form>
+                </q:else>
+                </q:if>
+              </div>
+            </div>
+          </div>
+
+          <q:if condition="comp.last_run">
+            <div class="qa-grid qa-grid-4 qa-mb-6">
+              <div class="qa-stat-card"><div class="qa-stat-label">Passed</div><div class="qa-stat-value" style="color: var(--q-success);">{comp.last_run.summary.passed}</div></div>
+              <div class="qa-stat-card"><div class="qa-stat-label">Failed</div><div class="qa-stat-value" style="color: var(--q-danger);">{comp.last_run.summary.failed + comp.last_run.summary.errors}</div></div>
+              <div class="qa-stat-card"><div class="qa-stat-label">Skipped</div><div class="qa-stat-value" style="color: var(--q-warning);">{comp.last_run.summary.skipped}</div></div>
+              <div class="qa-stat-card"><div class="qa-stat-label">Ran at</div><div class="qa-text-sm">{comp.last_run.ran_at}</div></div>
+            </div>
+          </q:if>
+
+          <q:if condition="len(comp.test_status) &gt; 0">
+            <div class="qa-card qa-mb-6">
+              <div class="qa-card-body qa-p-0">
+                <table class="qa-table">
+                  <thead><tr><th style="width: 110px;">Status</th><th>Test</th></tr></thead>
+                  <tbody>
+                    <q:loop type="array" var="caso" items="{comp.test_status}">
+                      <tr>
+                        <td><span class="{'qa-badge qa-badge-success' if caso.status == 'PASSED' else ('qa-badge qa-badge-danger' if caso.status in ['FAILED', 'ERROR'] else 'qa-badge qa-badge-gray')}">{caso.status}</span></td>
+                        <td><span class="qa-font-mono qa-text-sm">{caso.name}</span></td>
+                      </tr>
+                    </q:loop>
+                  </tbody>
+                </table>
+              </div>
+            </div>
+            <a href="/admin/source?file={comp.test_file}" class="qa-text-sm">View test source</a>
+          </q:if>
+
+          <q:if condition="comp.last_run">
+            <details class="qa-card qa-mb-6">
+              <summary class="qa-text-sm" style="padding: 12px 16px; cursor: pointer;">Raw pytest output</summary>
+              <pre class="qa-log-viewer">{comp.last_run.output}</pre>
+            </details>
+          </q:if>
+        </div>
+      </div>
+    </q:if>
+
+  </AdminShell>
+</q:component>

quantum_admin/components/admin/components.q

@@ -0,0 +1,59 @@
+<q:component name="AdminComponents" require_auth="true" require_role="admin" login_url="/admin/login">
+  <!-- Os .q de components/ (admin.components.list). -->
+  <q:import component="AdminShell" from="admin/_layout" />
+
+  <q:invoke name="lista" service="admin.components.list" />
+
+  <AdminShell title="Components" active="components" flash="{flash}" flashType="{flashType}">
+
+    <div class="qa-grid qa-grid-3 qa-mb-6">
+      <div class="qa-stat-card">
+        <div class="qa-stat-label">Total Components</div>
+        <div class="qa-stat-value">{len(lista.components)}</div>
+        <div class="qa-stat-change"><span class="qa-text-muted">.q files in components/</span></div>
+      </div>
+      <div class="qa-stat-card">
+        <div class="qa-stat-label">Directories</div>
+        <div class="qa-stat-value">{lista.directories}</div>
+        <div class="qa-stat-change"><span class="qa-text-muted">component groups</span></div>
+      </div>
+      <div class="qa-stat-card">
+        <div class="qa-stat-label">Examples</div>
+        <div class="qa-stat-value">{lista.examples}</div>
+        <div class="qa-stat-change"><span class="qa-text-muted">.q files in examples/</span></div>
+      </div>
+    </div>
+
+    <q:if condition="len(lista.components) &gt; 0">
+      <div class="qa-card">
+        <div class="qa-card-body qa-p-0" style="overflow-x: auto;">
+          <table class="qa-table">
+            <thead><tr><th>Path</th><th>Lines</th><th>Size</th><th>Group</th><th>Tags</th><th></th></tr></thead>
+            <tbody>
+              <q:loop type="array" var="comp" items="{lista.components}">
+                <tr>
+                  <td><a class="qa-font-mono" href="/admin/component/components/{comp.path}">{comp.path}</a></td>
+                  <td style="font-variant-numeric: tabular-nums;">{comp.lines}</td>
+                  <td>{comp.size}</td>
+                  <td><span class="qa-badge qa-badge-info">{comp.group}</span></td>
+                  <td><span class="qa-text-sm qa-text-muted">{join(comp.feature_tags, ', ') if comp.feature_tags else '-'}</span></td>
+                  <td><a href="/admin/source?file=components/{comp.path}" class="qa-text-sm">Source</a></td>
+                </tr>
+              </q:loop>
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </q:if>
+
+    <q:if condition="len(lista.components) == 0">
+      <div class="qa-card">
+        <div class="qa-empty">
+          <div class="qa-empty-title">No Components</div>
+          <div class="qa-empty-text">There is no .q file under components/ in the project root.</div>
+        </div>
+      </div>
+    </q:if>
+
+  </AdminShell>
+</q:component>