qall 0.1.0__tar.gz

qall-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.3
+Name: qall
+Version: 0.1.0
+Summary: A python tool for modern hybrid and quantum workflows.
+Requires-Dist: cloudpickle==3.1.2
+Requires-Dist: dataclasses-json>=0.6.7
+Requires-Dist: docker>=7.1.0
+Requires-Dist: grpcio>=1.81.1
+Requires-Dist: keyring>=25.7.0
+Requires-Dist: matplotlib>=3.11.0
+Requires-Dist: pyan3>=2.5.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: qio>=0.2.2
+Requires-Dist: rustworkx==0.17.1
+Requires-Dist: typer>=0.26.7
+Requires-Dist: lmdb>=2.3.0
+Requires-Dist: retry==0.9.2
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Hybrid computing as a Service
+
+## Protobuf
+
+To re-generate registry client/server API:
+
+```bash
+cd protobuf/
+
+make registry
+```
+
+To re-generate daemon client/server API:
+
+```bash
+cd protobuf/
+
+make daemon
+```
+
+## Registry server
+
+To test registry server:
+```bash
+cd qall-registry-server/
+
+make test
+```
+
+To build registry server:
+```bash
+cd qall-registry-server/
+
+make build
+```
+
+To start local instructure
+```bash
+cd infrastructure/local/
+
+make start
+```
+
+## Registry client
+
+To install registry client:
+```bash
+cd qall-registry-client/
+
+pip install .
+```
+
+To test registry client:
+```bash
+cd qall-registry-client/
+
+export qall_REGISTRY_URL=localhost:50051; pytest -vvv tests/
+```
+
+## Daemon server
+
+To run daemon server:
+```bash
+make build
+
+qall daemon start
+```
+
+## Daemon client
+
+To install daemon client:
+```bash
+cd qall-daemon-client/
+
+pip install .
+```
+
+## Scaleway HCaaS client
+TODO
+
+## qall (SDK)
+
+To install qall sdk:
+```bash
+cd qall/
+
+pip install .
+```
+
+To push a project to the registry:
+```bash
+cd qall/
+
+pip install .
+
+qall registry push examples/basic_hierarchy/my_worflow.py
+
+qall daemon start
+
+qall daemon run <root hash>
+```

qall-0.1.0/README.md

@@ -0,0 +1,101 @@
+# Hybrid computing as a Service
+
+## Protobuf
+
+To re-generate registry client/server API:
+
+```bash
+cd protobuf/
+
+make registry
+```
+
+To re-generate daemon client/server API:
+
+```bash
+cd protobuf/
+
+make daemon
+```
+
+## Registry server
+
+To test registry server:
+```bash
+cd qall-registry-server/
+
+make test
+```
+
+To build registry server:
+```bash
+cd qall-registry-server/
+
+make build
+```
+
+To start local instructure
+```bash
+cd infrastructure/local/
+
+make start
+```
+
+## Registry client
+
+To install registry client:
+```bash
+cd qall-registry-client/
+
+pip install .
+```
+
+To test registry client:
+```bash
+cd qall-registry-client/
+
+export qall_REGISTRY_URL=localhost:50051; pytest -vvv tests/
+```
+
+## Daemon server
+
+To run daemon server:
+```bash
+make build
+
+qall daemon start
+```
+
+## Daemon client
+
+To install daemon client:
+```bash
+cd qall-daemon-client/
+
+pip install .
+```
+
+## Scaleway HCaaS client
+TODO
+
+## qall (SDK)
+
+To install qall sdk:
+```bash
+cd qall/
+
+pip install .
+```
+
+To push a project to the registry:
+```bash
+cd qall/
+
+pip install .
+
+qall registry push examples/basic_hierarchy/my_worflow.py
+
+qall daemon start
+
+qall daemon run <root hash>
+```

qall-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "qall"
+version = "0.1.0"
+description = "A python tool for modern hybrid and quantum workflows."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "cloudpickle==3.1.2",
+    "dataclasses-json>=0.6.7",
+    "docker>=7.1.0",
+    "grpcio>=1.81.1",
+    "keyring>=25.7.0",
+    "matplotlib>=3.11.0",
+    "pyan3>=2.5.0",
+    "pyyaml>=6.0.3",
+    "qio>=0.2.2",
+    "rustworkx==0.17.1",
+    "typer>=0.26.7",
+    "lmdb>=2.3.0",
+    "retry==0.9.2",
+]
+
+### Dependencies ###
+[dependency-groups]
+dev = [
+    "black>=26.1.0",
+]
+test = [
+    "pytest>=9.1.0",
+    "pytest-progress>=1.4.0",
+]
+
+### CLI Tool ###
+[project.scripts]
+qall = "qall.cli.main:cli"
+
+[build-system]
+requires = ["uv_build>=0.11.29,<0.12"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "qall"
+module-root = ""
+data = ["qall/data"]

qall-0.1.0/qall/__init__.py

@@ -0,0 +1,35 @@
+# Copyright 2026 Scaleway
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+
+formatter = logging.Formatter(
+    fmt="[%(asctime)s] %(levelname)s | %(name)s | %(message)s",
+    datefmt="%Y-%m-%d %H:%M:%S",
+)
+
+console_handler = logging.StreamHandler()
+console_handler.setFormatter(formatter)
+
+logger = logging.getLogger(__name__)
+logger.setLevel(logging.INFO)
+logger.addHandler(console_handler)
+
+# Optional: Prevent logs from propagating to the global root logger
+# to avoid duplicate logs if the end-user also configures logging.
+logger.propagate = False
+
+from qorus.sdk import task, workflow, run
+
+__all__ = ["task", "workflow", "run"]

qall-0.1.0/qall/cli/__init__.py

@@ -0,0 +1,13 @@
+# Copyright 2026 Scaleway
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

qall-0.1.0/qall/cli/artifact.py

@@ -0,0 +1,53 @@
+# Copyright 2026 Scaleway
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import typer
+
+from qorus.core import artifact
+
+artifact_cli = typer.Typer(
+    name="artifact",
+    help="Inspect and download generated execution artifacts.",
+    no_args_is_help=True,
+)
+
+
+@artifact_cli.command("ls")
+def list_artifacts(
+    workflow_run_id: str = typer.Argument(
+        ..., help="The ID of the workflow run to list artifacts for."
+    )
+):
+    typer.echo("Available artifacts:")
+
+    artifacts = artifact.list_artifacts(workflow_run_id)
+
+    if not artifacts:
+        typer.echo("  No artifacts found.")
+        return
+
+    for name in artifacts:
+        typer.echo(f"- {typer.style(name, bold=True)}")
+
+
+@artifact_cli.command("info")
+def artifact_info(
+    artifact_id: str = typer.Argument(
+        ..., help="The unique identifier tracking hash of the generated asset."
+    )
+):
+    """Display download links, sizing, and origin execution contexts for a specific task artifact."""
+    art = artifact.get_artifact(artifact_id=artifact_id)
+    typer.echo(
+        f"Artifact Name: {art.name} | Task Run Origin: {art.task_run_id} | URL: {art.url}"
+    )

qall-0.1.0/qall/cli/checkpoint.py

@@ -0,0 +1,22 @@
+# Copyright 2026 Scaleway
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import typer
+
+import qorus.core as core
+
+checkpoint_cli = typer.Typer(
+    name="checkpoint",
+    help="Inspect generated execution task checkpoints.",
+    no_args_is_help=True,
+)

qall-0.1.0/qall/cli/config.py

@@ -0,0 +1,44 @@
+# Copyright 2026 Scaleway
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import typer
+
+from typing import Optional
+
+import qorus.core as core
+
+config_cli = typer.Typer(
+    name="config",
+    help="Manage local configuration profile configurations.",
+    no_args_is_help=True,
+)
+
+
+@config_cli.command("init")
+def config_init(
+    provider: Optional[str] = typer.Option(
+        "scaleway", "--provider", help="Default target cloud provider name."
+    ),
+    erase: bool = typer.Option(
+        False, "--erase", help="Overwrite existing configuration files if present."
+    ),
+):
+    """Initialize a default .qorus.yml project layout file inside the current directory boundary."""
+    res = core.init_config(provider_name=provider, erase_exists=erase)
+
+    if res is None:
+        typer.echo("Configuration file already exists. Use --erase to force overwrite.")
+    else:
+        typer.echo(
+            "Project workspace configuration initialized successfully (.qorus.yml)."
+        )

qall-0.1.0/qall/cli/daemon.py

@@ -0,0 +1,217 @@
+# Copyright 2026 Scaleway
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import typer
+
+from typing import Optional
+
+from qorus.core.daemon import (
+    start_daemon,
+    run_task,
+    get_daemon_status,
+    stop_daemon,
+    restart_daemon,
+)
+
+daemon_cli = typer.Typer(
+    name="daemon",
+    help="Manage daemon",
+    no_args_is_help=True,
+)
+
+
+@daemon_cli.command("start")
+def daemon_start(
+    port: int = typer.Option(50053, "--port", "-p", help="gRPC port for the daemon"),
+    image: str = typer.Option(
+        None,
+        "--image",
+        "-i",
+        help="Daemon Docker image to use",
+    ),
+    block_registry: str = typer.Option(
+        None,
+        "--block-dir",
+        "-b",
+        help="Path to block registry directory",
+    ),
+    artifact_registry: str = typer.Option(
+        None,
+        "--artifact-dir",
+        "-a",
+        help="Path to artifact registry directory",
+    ),
+    worker_provider: str = typer.Option(
+        None,
+        "--worker-provider",
+        "-w",
+        help="Name of the worker provider",
+    ),
+):
+    """
+    Start a local Qorus daemon in a Docker container.
+    """
+    try:
+        start_daemon(
+            port=port,
+            block_registry_path=block_registry,
+            artifact_registry_path=artifact_registry,
+            image=image,
+            worker_provider=worker_provider,
+        )
+    except KeyboardInterrupt:
+        typer.echo("Daemon stopped.")
+    except Exception as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise typer.Exit(code=1)
+
+
+@daemon_cli.command("stop")
+def daemon_stop(
+    port: int = typer.Option(50053, "--port", "-p", help="gRPC port for the daemon"),
+):
+    try:
+        stop_daemon(port)
+    except Exception as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise typer.Exit(code=1)
+
+
+@daemon_cli.command("restart")
+def daemon_restart(
+    port: int = typer.Option(50053, "--port", "-p", help="gRPC port for the daemon"),
+):
+    try:
+        restart_daemon(port)
+    except Exception as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise typer.Exit(code=1)
+
+
+@daemon_cli.command("run")
+def daemon_run(
+    task_hash: str = typer.Argument(
+        ..., help="Hash of the task stored in registry to execute."
+    ),
+    artifact_hash: str = typer.Option(
+        None,
+        "--artifact-hash",
+        "-a",
+        help="Hash of the input artifact stored in registry for the task execution.",
+    ),
+    daemon_image: str = typer.Option(
+        None,
+        "--daemon-image",
+        "-i",
+        help="Daemon Docker image to use",
+    ),
+    daemon_address: Optional[str] = typer.Option(
+        None,
+        "--daemon-address",
+        "-d",
+        help="Daemon gRPC address (default: QORUS_DAEMON_ADDRESS env var or localhost:50053)",
+    ),
+    block_registry: str = typer.Option(
+        None,
+        "--block-dir",
+        "-b",
+        help="Path to block registry directory",
+    ),
+    artifact_registry: str = typer.Option(
+        None,
+        "--artifact-dir",
+        "-a",
+        help="Path to artifact registry directory",
+    ),
+    worker_provider: str = typer.Option(
+        None,
+        "--worker-provider",
+        "-w",
+        help="Name of the worker provider",
+    ),
+    timeout: int = typer.Option(
+        300, "--timeout", "-t", help="Timeout for the task execution."
+    ),
+):
+    """
+    Orders a local Daemon instance to start and execute a given task.
+    """
+    try:
+        artifacts = run_task(
+            task_hash=task_hash,
+            input_artifact_hash=artifact_hash,
+            daemon_address=daemon_address,
+            block_registry=block_registry,
+            artifact_registry=artifact_registry,
+            daemon_image=daemon_image,
+            timeout=timeout,
+            worker_provider=worker_provider,
+        )
+
+        if artifacts:
+            typer.echo(f"Task completed successfully!")
+            typer.echo(f"Output artifacts: {len(artifacts)}")
+
+            for artifact in artifacts:
+                typer.echo(f"  - {artifact.hash}")
+
+    except Exception as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise typer.Exit(code=1)
+
+
+@daemon_cli.command("status")
+def daemon_status(
+    daemon_image: str = typer.Option(
+        None,
+        "--daemon-image",
+        "-i",
+        help="Daemon Docker image to use",
+    ),
+    daemon_address: Optional[str] = typer.Option(
+        None,
+        "--daemon-address",
+        "-d",
+        help="Daemon gRPC address (default: QORUS_DAEMON_ADDRESS env var or localhost:50053)",
+    ),
+    block_registry: str = typer.Option(
+        None,
+        "--block-dir",
+        "-b",
+        help="Path to block registry directory",
+    ),
+    artifact_registry: str = typer.Option(
+        None,
+        "--artifact-dir",
+        "-a",
+        help="Path to artifact registry directory",
+    ),
+):
+    """
+    Check the status of the local daemon container.
+    """
+    try:
+        status = get_daemon_status(
+            daemon_image=daemon_image,
+            daemon_address=daemon_address,
+            block_registry=block_registry,
+            artifact_registry=artifact_registry,
+        )
+
+        if status:
+            typer.echo(f"status: {status}")
+
+    except Exception as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise typer.Exit(code=1)

qall-0.1.0/qall/cli/log.py

@@ -0,0 +1,22 @@
+# Copyright 2026 Scaleway
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import typer
+
+import qorus.core as core
+
+log_cli = typer.Typer(
+    name="logs",
+    help="Manage workflow and task logs generation.",
+    no_args_is_help=True,
+)