quantum-framework 0.9.0__tar.gz

quantum_framework-0.9.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Gregorio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

quantum_framework-0.9.0/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: quantum-framework
+Version: 0.9.0
+Summary: Full-stack declarative framework for building web, desktop, and mobile applications
+Author-email: Daniel Gregorio <danielgregorio2611@gmail.com>
+License: MIT
+Project-URL: Homepage, https://quantum.sargas.cloud
+Project-URL: Documentation, https://quantum.sargas.cloud
+Project-URL: Repository, https://github.com/danielgregorio/quantum
+Keywords: framework,declarative,xml,web,desktop,mobile
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Flask
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flask>=3.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: sqlparse>=0.4.4
+Requires-Dist: gunicorn>=21.0.0
+Requires-Dist: textual>=0.80.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: bcrypt>=4.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.11.1; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: db
+Requires-Dist: psycopg2-binary>=2.9.9; extra == "db"
+Requires-Dist: pymysql>=1.1.0; extra == "db"
+Provides-Extra: rag
+Requires-Dist: chromadb>=0.5.0; extra == "rag"
+Provides-Extra: jobs
+Requires-Dist: apscheduler>=3.10.0; extra == "jobs"
+Provides-Extra: websocket
+Requires-Dist: websockets>=12.0; extra == "websocket"
+Dynamic: license-file
+
+# Quantum
+
+[![CI](https://github.com/danielgregorio/quantum/actions/workflows/ci.yml/badge.svg)](https://github.com/danielgregorio/quantum/actions/workflows/ci.yml)
+[![Docker](https://github.com/danielgregorio/quantum/actions/workflows/docker.yml/badge.svg)](https://github.com/danielgregorio/quantum/actions/workflows/docker.yml)
+[![Docs](https://img.shields.io/badge/docs-github.io-blue)](https://danielgregorio.github.io/quantum/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+> **Declarative web apps in XML, with AI and RAG built into the language.
+> No build chain, no JavaScript, no frontend framework.**
+
+Quantum is a full-stack framework whose language is markup. State, database queries,
+forms, LLM calls and retrieval-augmented generation are all tags — not libraries you
+wire together. It takes its philosophy from ColdFusion and Adobe Flex: the markup *is*
+the app.
+
+> ⚠️ **Pre-1.0, and honest about it.** See [Stability](#stability) — the table there
+> reflects what has actually been executed end-to-end, not what is aspirational.
+
+---
+
+## The part that isn't like the others
+
+Retrieval-augmented generation, as a language construct:
+
+```xml
+<q:component name="DocsBot">
+  <q:knowledge name="docs" model="phi3" embedModel="nomic-embed-text">
+    <q:source type="directory" path="./docs/" pattern="*.md" />
+  </q:knowledge>
+
+  <q:query name="answer" datasource="knowledge:docs" mode="rag">
+    SELECT answer FROM chunks WHERE content SIMILAR TO :question
+    <q:param name="question" value="{form.question}" type="string" />
+  </q:query>
+
+  <p>{answer.answer}</p>
+</q:component>
+```
+
+That indexes a directory, embeds it, stores the vectors, retrieves the relevant chunks
+and asks the model — in the markup. There is no Python file behind it.
+
+An agent with its own tools, same idea:
+
+```xml
+<q:agent name="calc" model="phi3" max_iterations="4">
+  <q:instruction>Use the add tool, then answer.</q:instruction>
+
+  <q:tool name="add" description="Add two numbers">
+    <q:param name="a" type="number" required="true" />
+    <q:param name="b" type="number" required="true" />
+    <q:function name="doAdd">
+      <q:set name="sum" value="{a + b}" type="number" />
+      <q:return value="{sum}" />
+    </q:function>
+  </q:tool>
+
+  <q:execute task="What is 17 plus 25?" />
+</q:agent>
+```
+
+The tool body is Quantum, not Python. The reasoning loop, the tool call and the type
+coercion of the model's arguments are the runtime's job.
+
+---
+
+## The rest of the language
+
+```xml
+<q:component name="Orders">
+  <q:query name="orders" datasource="db">
+    SELECT id, customer, total FROM orders WHERE total > :min
+    <q:param name="min" value="100" type="decimal" />
+  </q:query>
+
+  <table>
+    <q:loop query="orders">
+      <tr><td>{orders.customer}</td><td>{orders.total}</td></tr>
+    </q:loop>
+  </table>
+</q:component>
+```
+
+`q:query` refuses to run SQL with an undeclared `:param` — parameterised queries are
+enforced by the parser, not by discipline.
+
+Also core: `q:set` with `session.` / `application.` / `request.` scopes, `q:if`,
+`q:function`, `q:action` for form handling, `q:data` for CSV/JSON/XML import,
+`q:import` / `q:slot` for composition.
+
+---
+
+## Quick start
+
+**Requirements:** Python 3.11+ and `pip`.
+
+```bash
+git clone https://github.com/danielgregorio/quantum.git
+cd quantum
+pip install -e ".[dev]"
+
+quantum run examples/hello.q
+```
+
+```
+[EXEC] Executing component: HelloWorld
+[SUCCESS] Result: Hello World!
+```
+
+For the AI examples you also need an [Ollama](https://ollama.com) server and the RAG
+extra:
+
+```bash
+pip install -e ".[rag]"
+ollama pull phi3 && ollama pull nomic-embed-text
+export QUANTUM_LLM_BASE_URL=http://localhost:11434
+```
+
+Declare datasources in `quantum.config.yaml` and `q:query` works with nothing else
+running:
+
+```yaml
+datasources:
+  db:
+    driver: sqlite
+    database: ./data/app.db
+```
+
+### CLI
+
+| Command | What it does |
+|---------|--------------|
+| `run <file.q>` | Execute a component, app, or API |
+| `start` | Start the web server |
+| `deploy <dir>` | Deploy an application |
+| `pkg` · `jobs` · `mq` · `migrate` | Packages, jobs, message queues, migrations |
+
+---
+
+## Documentation
+
+Full docs (VitePress) at **[danielgregorio.github.io/quantum](https://danielgregorio.github.io/quantum/)** and in
+[`docs/`](docs/):
+
+- [Getting Started](docs/guide/getting-started.md) · [Installation](docs/guide/installation.md) · [Quick Start](docs/guide/quick-start.md)
+- [Components](docs/guide/components.md) · [State](docs/guide/state-management.md) · [Loops](docs/guide/loops.md) · [Conditionals](docs/guide/conditionals.md)
+- [Queries](docs/guide/query.md) · [Functions](docs/guide/functions.md) · [Data fetching](docs/guide/data-fetching.md)
+
+---
+
+## Stability
+
+Support levels are defined in **[SUPPORT_TIERS.md](SUPPORT_TIERS.md)**. Short version:
+
+| Surface | Status |
+|---------|--------|
+| Core language — `q:component`, `q:set`, `q:if`, `q:loop`, `q:function`, `q:query`, `q:action`, `q:invoke`, `q:data` | **Stable** |
+| AI — `q:llm`, `q:knowledge`, `q:agent` | **Beta** — validated end-to-end against a live Ollama server |
+| `q:team` (multi-agent handoff) | Beta, less exercised |
+| Jobs, messaging, websockets, mail, file uploads, `ui:*`, terminal target | **Experimental** — they run, but no API stability promise |
+| Python scripting (`q:python`, `q:pyclass`, `q:pyimport`) | Experimental, and a full-trust escape hatch — see [SECURITY.md](SECURITY.md) |
+
+A functional audit in 2026-09 found that several of these surfaces had never been run
+end-to-end despite being documented as complete. The findings and the fixes are in
+[`FULL_AUDIT_2026-09.md`](FULL_AUDIT_2026-09.md) and
+[`AUDIT_FIX_PLAN.md`](AUDIT_FIX_PLAN.md). Feature status is now verified by execution
+rather than asserted by hand.
+
+Pre-1.0: APIs may change between minor versions.
+
+---
+
+## Project layout
+
+```
+quantum/
+├── quantum/
+│   ├── core/        # Parser & AST (registry-based, modular)
+│   ├── runtime/     # Execution engine, web server, renderer
+│   └── cli/         # Command-line entry point
+├── examples/        # runnable .q examples
+├── tests/           # pytest suite (~2.4k tests)
+├── scripts/         # dev tools
+└── docs/            # VitePress documentation
+```
+
+Adding a tag is one parser + one executor + a registry entry — see
+[CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Contributing
+
+Read **[CONTRIBUTING.md](CONTRIBUTING.md)** for dev setup and how the modular
+parser/executor architecture works. By participating you agree to the
+[Code of Conduct](CODE_OF_CONDUCT.md).
+
+Found a security issue? Follow [SECURITY.md](SECURITY.md) — **do not** open a public issue.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

quantum_framework-0.9.0/README.md

@@ -0,0 +1,202 @@
+# Quantum
+
+[![CI](https://github.com/danielgregorio/quantum/actions/workflows/ci.yml/badge.svg)](https://github.com/danielgregorio/quantum/actions/workflows/ci.yml)
+[![Docker](https://github.com/danielgregorio/quantum/actions/workflows/docker.yml/badge.svg)](https://github.com/danielgregorio/quantum/actions/workflows/docker.yml)
+[![Docs](https://img.shields.io/badge/docs-github.io-blue)](https://danielgregorio.github.io/quantum/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+> **Declarative web apps in XML, with AI and RAG built into the language.
+> No build chain, no JavaScript, no frontend framework.**
+
+Quantum is a full-stack framework whose language is markup. State, database queries,
+forms, LLM calls and retrieval-augmented generation are all tags — not libraries you
+wire together. It takes its philosophy from ColdFusion and Adobe Flex: the markup *is*
+the app.
+
+> ⚠️ **Pre-1.0, and honest about it.** See [Stability](#stability) — the table there
+> reflects what has actually been executed end-to-end, not what is aspirational.
+
+---
+
+## The part that isn't like the others
+
+Retrieval-augmented generation, as a language construct:
+
+```xml
+<q:component name="DocsBot">
+  <q:knowledge name="docs" model="phi3" embedModel="nomic-embed-text">
+    <q:source type="directory" path="./docs/" pattern="*.md" />
+  </q:knowledge>
+
+  <q:query name="answer" datasource="knowledge:docs" mode="rag">
+    SELECT answer FROM chunks WHERE content SIMILAR TO :question
+    <q:param name="question" value="{form.question}" type="string" />
+  </q:query>
+
+  <p>{answer.answer}</p>
+</q:component>
+```
+
+That indexes a directory, embeds it, stores the vectors, retrieves the relevant chunks
+and asks the model — in the markup. There is no Python file behind it.
+
+An agent with its own tools, same idea:
+
+```xml
+<q:agent name="calc" model="phi3" max_iterations="4">
+  <q:instruction>Use the add tool, then answer.</q:instruction>
+
+  <q:tool name="add" description="Add two numbers">
+    <q:param name="a" type="number" required="true" />
+    <q:param name="b" type="number" required="true" />
+    <q:function name="doAdd">
+      <q:set name="sum" value="{a + b}" type="number" />
+      <q:return value="{sum}" />
+    </q:function>
+  </q:tool>
+
+  <q:execute task="What is 17 plus 25?" />
+</q:agent>
+```
+
+The tool body is Quantum, not Python. The reasoning loop, the tool call and the type
+coercion of the model's arguments are the runtime's job.
+
+---
+
+## The rest of the language
+
+```xml
+<q:component name="Orders">
+  <q:query name="orders" datasource="db">
+    SELECT id, customer, total FROM orders WHERE total > :min
+    <q:param name="min" value="100" type="decimal" />
+  </q:query>
+
+  <table>
+    <q:loop query="orders">
+      <tr><td>{orders.customer}</td><td>{orders.total}</td></tr>
+    </q:loop>
+  </table>
+</q:component>
+```
+
+`q:query` refuses to run SQL with an undeclared `:param` — parameterised queries are
+enforced by the parser, not by discipline.
+
+Also core: `q:set` with `session.` / `application.` / `request.` scopes, `q:if`,
+`q:function`, `q:action` for form handling, `q:data` for CSV/JSON/XML import,
+`q:import` / `q:slot` for composition.
+
+---
+
+## Quick start
+
+**Requirements:** Python 3.11+ and `pip`.
+
+```bash
+git clone https://github.com/danielgregorio/quantum.git
+cd quantum
+pip install -e ".[dev]"
+
+quantum run examples/hello.q
+```
+
+```
+[EXEC] Executing component: HelloWorld
+[SUCCESS] Result: Hello World!
+```
+
+For the AI examples you also need an [Ollama](https://ollama.com) server and the RAG
+extra:
+
+```bash
+pip install -e ".[rag]"
+ollama pull phi3 && ollama pull nomic-embed-text
+export QUANTUM_LLM_BASE_URL=http://localhost:11434
+```
+
+Declare datasources in `quantum.config.yaml` and `q:query` works with nothing else
+running:
+
+```yaml
+datasources:
+  db:
+    driver: sqlite
+    database: ./data/app.db
+```
+
+### CLI
+
+| Command | What it does |
+|---------|--------------|
+| `run <file.q>` | Execute a component, app, or API |
+| `start` | Start the web server |
+| `deploy <dir>` | Deploy an application |
+| `pkg` · `jobs` · `mq` · `migrate` | Packages, jobs, message queues, migrations |
+
+---
+
+## Documentation
+
+Full docs (VitePress) at **[danielgregorio.github.io/quantum](https://danielgregorio.github.io/quantum/)** and in
+[`docs/`](docs/):
+
+- [Getting Started](docs/guide/getting-started.md) · [Installation](docs/guide/installation.md) · [Quick Start](docs/guide/quick-start.md)
+- [Components](docs/guide/components.md) · [State](docs/guide/state-management.md) · [Loops](docs/guide/loops.md) · [Conditionals](docs/guide/conditionals.md)
+- [Queries](docs/guide/query.md) · [Functions](docs/guide/functions.md) · [Data fetching](docs/guide/data-fetching.md)
+
+---
+
+## Stability
+
+Support levels are defined in **[SUPPORT_TIERS.md](SUPPORT_TIERS.md)**. Short version:
+
+| Surface | Status |
+|---------|--------|
+| Core language — `q:component`, `q:set`, `q:if`, `q:loop`, `q:function`, `q:query`, `q:action`, `q:invoke`, `q:data` | **Stable** |
+| AI — `q:llm`, `q:knowledge`, `q:agent` | **Beta** — validated end-to-end against a live Ollama server |
+| `q:team` (multi-agent handoff) | Beta, less exercised |
+| Jobs, messaging, websockets, mail, file uploads, `ui:*`, terminal target | **Experimental** — they run, but no API stability promise |
+| Python scripting (`q:python`, `q:pyclass`, `q:pyimport`) | Experimental, and a full-trust escape hatch — see [SECURITY.md](SECURITY.md) |
+
+A functional audit in 2026-09 found that several of these surfaces had never been run
+end-to-end despite being documented as complete. The findings and the fixes are in
+[`FULL_AUDIT_2026-09.md`](FULL_AUDIT_2026-09.md) and
+[`AUDIT_FIX_PLAN.md`](AUDIT_FIX_PLAN.md). Feature status is now verified by execution
+rather than asserted by hand.
+
+Pre-1.0: APIs may change between minor versions.
+
+---
+
+## Project layout
+
+```
+quantum/
+├── quantum/
+│   ├── core/        # Parser & AST (registry-based, modular)
+│   ├── runtime/     # Execution engine, web server, renderer
+│   └── cli/         # Command-line entry point
+├── examples/        # runnable .q examples
+├── tests/           # pytest suite (~2.4k tests)
+├── scripts/         # dev tools
+└── docs/            # VitePress documentation
+```
+
+Adding a tag is one parser + one executor + a registry entry — see
+[CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Contributing
+
+Read **[CONTRIBUTING.md](CONTRIBUTING.md)** for dev setup and how the modular
+parser/executor architecture works. By participating you agree to the
+[Code of Conduct](CODE_OF_CONDUCT.md).
+
+Found a security issue? Follow [SECURITY.md](SECURITY.md) — **do not** open a public issue.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

quantum_framework-0.9.0/pyproject.toml

@@ -0,0 +1,88 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "quantum-framework"
+version = "0.9.0"
+description = "Full-stack declarative framework for building web, desktop, and mobile applications"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Daniel Gregorio", email = "danielgregorio2611@gmail.com"}
+]
+keywords = ["framework", "declarative", "xml", "web", "desktop", "mobile"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: Flask",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "flask>=3.0.0",
+    "pyyaml>=6.0",
+    "sqlparse>=0.4.4",
+    "gunicorn>=21.0.0",
+    "textual>=0.80.0",
+    "requests>=2.31.0",
+    "bcrypt>=4.1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-cov>=4.1.0",
+    "pytest-mock>=3.11.1",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+]
+db = [
+    "psycopg2-binary>=2.9.9",
+    "pymysql>=1.1.0",
+]
+rag = [
+    "chromadb>=0.5.0",
+]
+jobs = [
+    # Required by ScheduleService (q:schedule) — was undeclared, so
+    # q:schedule failed on any clean install.
+    "apscheduler>=3.10.0",
+]
+websocket = [
+    # The transport behind q:websocket. Without it the tag registers a
+    # connection and opens nothing — and says so, rather than pretending.
+    "websockets>=12.0",
+]
+
+[project.scripts]
+quantum = "quantum.cli.runner:main"
+
+[project.urls]
+Homepage = "https://quantum.sargas.cloud"
+Documentation = "https://quantum.sargas.cloud"
+Repository = "https://github.com/danielgregorio/quantum"
+
+[tool.setuptools.packages.find]
+# So o pacote `quantum` e seus subpacotes. O glob anterior `quantum*` varria
+# junto `quantum_admin` (app FastAPI separado, com deps proprias que nao sao
+# do core), e as pastas `quantum-as4`/`quantum-lsp` (projetos irmaos,
+# hifenados e nem importaveis) — 91 arquivos de peso morto no wheel. O ponto
+# em `quantum.*` casa subpacotes; sem ele, `quantum_admin` nao entra.
+include = ["quantum", "quantum.*"]
+
+
+[tool.black]
+line-length = 100
+target-version = ['py311', 'py312']
+
+[tool.ruff]
+line-length = 100
+select = ["E", "F", "W", "I"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = "-v --tb=short"

quantum_framework-0.9.0/quantum/__init__.py

@@ -0,0 +1 @@
+# Quantum main package

quantum_framework-0.9.0/quantum/cli/__init__.py

@@ -0,0 +1,2 @@
+# CLI Quantum modules
+from .runner import QuantumRunner, main

quantum_framework-0.9.0/quantum/cli/commands/__init__.py

@@ -0,0 +1,15 @@
+"""
+Quantum CLI Commands
+
+Each command module provides a click command group or command.
+"""
+
+from quantum.cli.commands.new import new
+from quantum.cli.commands.dev import dev
+from quantum.cli.commands.build import build
+from quantum.cli.commands.serve import serve
+from quantum.cli.commands.test import test
+from quantum.cli.commands.lint import lint
+from quantum.cli.commands.docs import docs
+
+__all__ = ['new', 'dev', 'build', 'serve', 'test', 'lint', 'docs']