qubecli 1.0.0__py3-none-any.whl

qubecli/main.py

@@ -0,0 +1,186 @@
+import json
+from contextlib import contextmanager
+from importlib.metadata import version
+from pathlib import Path
+from typing import Annotated, Generator, Optional
+
+import grpc
+import typer
+from qubecore_client import QubeClient
+
+_CONFIG_PATH = Path.home() / ".qubecore" / "config.json"
+
+app = typer.Typer(help="QubeCore CLI — Quantum Computing Operating System")
+config_app = typer.Typer(help="서버 설정 관리")
+app.add_typer(config_app, name="config")
+
+
+class _State:
+    address: str = "localhost:50051"
+
+
+_state = _State()
+
+
+def _load_config() -> dict:
+    if _CONFIG_PATH.exists():
+        return json.loads(_CONFIG_PATH.read_text())
+    return {}
+
+
+def _save_config(data: dict) -> None:
+    _CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
+    _CONFIG_PATH.write_text(json.dumps(data, indent=2))
+
+
+def _resolve_address(host: Optional[str]) -> str:
+    if host is not None:
+        return host
+    return _load_config().get("host", "localhost:50051")
+
+
+@contextmanager
+def _get_client(address: str) -> Generator[QubeClient, None, None]:
+    client = QubeClient(address=address)
+    try:
+        yield client
+    except grpc.RpcError as e:
+        if e.code() == grpc.StatusCode.UNAVAILABLE:
+            typer.echo(f"서버에 연결할 수 없습니다: {address}", err=True)
+            typer.echo("  'qubecore config set host <host:port>' 로 서버 주소를 확인하세요.", err=True)
+        else:
+            typer.echo(f"gRPC 오류: {e.details()}", err=True)
+        raise typer.Exit(1)
+    finally:
+        client.close()
+
+
+def _priority_label(priority: int) -> str:
+    return {1: "CRITICAL", 2: "HIGH", 3: "NORMAL", 4: "LOW"}.get(priority, str(priority))
+
+
+@app.callback()
+def _callback(
+    host: Annotated[Optional[str], typer.Option(help="QubeCore 서버 주소 (host:port)")] = None,
+    ver: Annotated[bool, typer.Option("-v", "--version", help="버전 출력", is_eager=True)] = False,
+) -> None:
+    if ver:
+        typer.echo(f"v{version('qubecli')}")
+        raise typer.Exit()
+    _state.address = _resolve_address(host)
+
+
+@config_app.command("set")
+def config_set(
+    key: Annotated[str, typer.Argument(help="설정 키")],
+    value: Annotated[str, typer.Argument(help="설정 값")],
+) -> None:
+    """설정값 저장 (예: qubecore config set host 192.168.1.100:50051)"""
+    if key not in ("host",):
+        typer.echo(f"알 수 없는 키: {key}. 사용 가능: host", err=True)
+        raise typer.Exit(1)
+    cfg = _load_config()
+    cfg[key] = value
+    _save_config(cfg)
+    typer.echo(f"✓ {key} = {value} 저장 완료 ({_CONFIG_PATH})")
+
+
+@config_app.command("get")
+def config_get(
+    key: Annotated[Optional[str], typer.Argument(help="설정 키 (생략 시 전체 출력)")] = None,
+) -> None:
+    """설정값 조회"""
+    cfg = _load_config()
+    if not cfg:
+        typer.echo("저장된 설정 없음")
+        return
+    if key:
+        typer.echo(f"  {key} : {cfg.get(key, '(없음)')}")
+    else:
+        for k, v in cfg.items():
+            typer.echo(f"  {k} : {v}")
+
+
+@config_app.command("unset")
+def config_unset(
+    key: Annotated[str, typer.Argument(help="삭제할 설정 키")],
+) -> None:
+    """설정값 삭제"""
+    cfg = _load_config()
+    if key not in cfg:
+        typer.echo(f"  {key} : 설정된 값 없음")
+        return
+    del cfg[key]
+    _save_config(cfg)
+    typer.echo(f"✓ {key} 삭제 완료")
+
+
+@app.command()
+def submit(
+    backend: Annotated[str, typer.Option(help="백엔드 이름 (backend1, kreo.sc-20 등)")],
+    circuit: Annotated[str, typer.Option(help="회로 문자열 (QASM2/QASM3/JSON)")],
+    shots: Annotated[int, typer.Option(help="실행 횟수")],
+    priority: Annotated[Optional[int], typer.Option(help="우선순위 1~4 (기본값 3=NORMAL)")] = None,
+    optimization_level: Annotated[Optional[int], typer.Option(help="최적화 레벨 0~3")] = None,
+) -> None:
+    """게이트 회로 실행 작업 제출"""
+    with _get_client(_state.address) as client:
+        job_id = client.submit_gate_job(
+            backend_name=backend,
+            gate_circuits=[circuit.encode("raw_unicode_escape").decode("unicode_escape")],
+            shots=shots,
+            priority=priority,
+            optimization_level=optimization_level,
+        )
+    typer.echo("✓ 작업 제출 완료")
+    typer.echo(f"  job_id   : {job_id}")
+    typer.echo(f"  priority : {_priority_label(priority or 3)}")
+    typer.echo(f"  status   : PENDING")
+
+
+@app.command()
+def status(
+    job_id: Annotated[str, typer.Option(help="작업 ID")],
+) -> None:
+    """작업 상태 조회"""
+    with _get_client(_state.address) as client:
+        job = client.get_job_status(job_id)
+    typer.echo(f"  job_id    : {job['job_id']}")
+    typer.echo(f"  status    : {job['status']}")
+    typer.echo(f"  priority  : {_priority_label(job['priority'])}")
+    typer.echo(f"  submitted : {job['submitted_at']}")
+    typer.echo(f"  started   : {job['started_at'] or '(미시작)'}")
+    typer.echo(f"  finished  : {job['finished_at'] or '(미완료)'}")
+    if job["error"]:
+        typer.echo(f"  error     : {job['error']}")
+
+
+@app.command()
+def result(
+    job_id: Annotated[str, typer.Option(help="작업 ID")],
+) -> None:
+    """작업 결과 조회"""
+    with _get_client(_state.address) as client:
+        job = client.get_job_result(job_id)
+    typer.echo(f"  job_id : {job['job_id']}")
+    typer.echo(f"  status : {job['status']}")
+    for i, r in enumerate(job["results"]):
+        typer.echo(f"  [회로 {i}] counts : {r['counts_json']}")
+
+
+@app.command()
+def cancel(
+    job_id: Annotated[str, typer.Option(help="작업 ID")],
+) -> None:
+    """작업 취소 (PENDING 상태일 때만 가능)"""
+    with _get_client(_state.address) as client:
+        message = client.cancel_job(job_id)
+    typer.echo(f"✓ {message}")
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

qubecli-1.0.0.dist-info/METADATA

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: qubecli
+Version: 1.0.0
+Summary: QubeCore CLI — Command Line Interface for QubeCore
+License: MIT License
+        
+        Copyright (c) 2026 QubeCore Project
+        
+        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.
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: qubecore-client>=1.0.10
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# QubeCli
+
+Command Line Interface for QubeCore — Quantum Computing Operating System.
+
+## Overview
+
+QubeCli provides a terminal-based interface for submitting and managing
+quantum jobs on QubeCore. Built on [qubecore-client](https://github.com/sdt-quantum/qubecore-client).
+
+## Requirements
+
+- Python 3.11+
+- QubeCore Server running and accessible
+
+## Installation
+
+```bash
+pip install qubecli
+```
+
+## Quick Start
+
+```bash
+# Set server address
+qubecore config set host 192.168.1.100:50051
+
+# Submit a job (use single quotes to avoid shell interpretation of \n)
+qubecore submit --backend backend1 --circuit 'OPENQASM 2.0;\ninclude "qelib1.inc";\nqreg q[2];\ncreg c[2];\nh q[0];\ncx q[0],q[1];\nmeasure q -> c;' --shots 100
+
+# Check status
+qubecore status --job-id <job_id>
+
+# Fetch result
+qubecore result --job-id <job_id>
+
+# Cancel job
+qubecore cancel --job-id <job_id>
+```
+
+## Commands
+
+### Version
+
+```bash
+qubecore -v
+qubecore --version
+```
+
+### Server Configuration
+
+```bash
+qubecore config set host 192.168.1.100:50051
+qubecore config get
+qubecore config get host
+qubecore config unset host
+```
+
+### Job Commands
+
+```bash
+# Submit
+qubecore submit --backend <backend> --circuit <circuit_string> --shots <n>
+qubecore submit --backend backend1 --circuit '...' --shots 100 --priority 2 --optimization-level 1
+
+# Status
+qubecore status --job-id <job_id>
+
+# Result
+qubecore result --job-id <job_id>
+
+# Cancel (PENDING 상태일 때만 가능)
+qubecore cancel --job-id <job_id>
+```
+
+One-time server override:
+
+```bash
+qubecore --host 10.0.0.1:50051 submit --backend backend1 --circuit "..." --shots 100
+```
+
+## Options
+
+### `submit`
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--backend` | Yes | 백엔드 이름 (`backend1`, `kreo.sc-20` 등) |
+| `--circuit` | Yes | 회로 문자열 (QASM2/QASM3/JSON) |
+| `--shots` | Yes | 실행 횟수 |
+| `--priority` | No | 우선순위 1~4 (1=CRITICAL, 2=HIGH, 3=NORMAL, 4=LOW) |
+| `--optimization-level` | No | 최적화 레벨 0~3 |
+
+## Compatibility
+
+| qubecli | qubecore-client | qubecore |
+|---------|----------------|----------|
+| 1.x | 1.x | 1.x |
+
+## License
+
+MIT

qubecli-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+qubecli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+qubecli/main.py,sha256=MDjlRNGqEdq3Z6KciSsRGEnk_KgON3-1cv9RQELxYyM,5890
+qubecli-1.0.0.dist-info/METADATA,sha256=7d1epRXAgkmPYFeiadQiUp8do33LTdcPxd4wFCF_8qo,3760
+qubecli-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+qubecli-1.0.0.dist-info/entry_points.txt,sha256=wqFAyzHQSyGZAH-55bOWlBJxc0mxbPWRw6FxbkBcv1Q,47
+qubecli-1.0.0.dist-info/licenses/LICENSE,sha256=MtfyWLHSlemM7mXY9Cx2xx97V_rzxlQhqXun0dXX2X8,1072
+qubecli-1.0.0.dist-info/RECORD,,

qubecli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

qubecli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+qubecore = qubecli.main:main

qubecli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QubeCore Project
+
+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.