QuLab 2.5.2__cp312-cp312-macosx_10_13_universal2.whl → 2.5.4__cp312-cp312-macosx_10_13_universal2.whl

{QuLab-2.5.2.dist-info → QuLab-2.5.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: QuLab
-Version: 2.5.2
+Version: 2.5.4
 Summary: contral instruments and manage data
 Author-email: feihoo87 <feihoo87@gmail.com>
 Maintainer-email: feihoo87 <feihoo87@gmail.com>

{QuLab-2.5.2.dist-info → QuLab-2.5.4.dist-info}/RECORD

@@ -1,19 +1,19 @@
 qulab/__init__.py,sha256=XnSePkDDgfbmEpu5uXK6spygxaqVt9emMubHYKIjSwc,244
 qulab/__main__.py,sha256=fjaRSL_uUjNIzBGNgjlGswb9TJ2VD5qnkZHW3hItrD4,68
 qulab/dicttree.py,sha256=tRRMpGZYVOLw0TEByE3_2Ss8FdOmzuGL9e1DWbs8qoY,13684
-qulab/fun.cpython-312-darwin.so,sha256=UXBsAcQKI9_JzqAzjrrv3fcCogirOKv2zG1NSqkEmzo,126864
+qulab/fun.cpython-312-darwin.so,sha256=Xy5kG_e3ih1w_mhSG3jDBLzIaN53MgKXEsXfXA6T6ec,126864
 qulab/typing.py,sha256=5xCLfrp1aZpKpDy4p2arbFszw2eK3hGUjZa-XSvC_-8,69
-qulab/version.py,sha256=w6piXlEvrVvbn_4rTzwW2-HxvwxuHYQ5nIl8vcMmXAs,21
+qulab/version.py,sha256=kUk6VjaCueGXZEsY69h4VouFnQXNOenbPlluQV766gk,21
 qulab/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 qulab/cli/commands.py,sha256=tgDIkkeIoasQXAifJZ6NU8jDgpNgb2a-B0C4nF0evrE,559
 qulab/cli/config.py,sha256=SdNmWzweWAdyk8M2oKYhMxnkaJ0qIayPlsLGCNlVqME,3108
 qulab/executor/__init__.py,sha256=LosPzOMaljSZY1thy_Fxtbrgq7uubJszMABEB7oM7tU,101
-qulab/executor/cli.py,sha256=owdDSaSuzTPQA5SlNCxX4nHWITU1BF0VZMj7tLqCZhM,5781
-qulab/executor/load.py,sha256=i2MKxE5kflAGLt3e9LjME59K7IO7s68EUApP9228LhQ,12125
-qulab/executor/schedule.py,sha256=4D8o68Cx6vCkpSTMHzULTwuuq1tS8unc2n8WdBA9oB0,12013
+qulab/executor/cli.py,sha256=ZGnQdUFZmU812gsnqbKhaJzwWLdoPt42CukPbZ7Yv8k,6684
+qulab/executor/load.py,sha256=M4_CfWU65y5wXTNSaaJFp9Plui0wOtxPF181prD-HVU,14345
+qulab/executor/schedule.py,sha256=SeeP3QwABoa8KWee_5QMwaSSjv6VwbRpDVTF1pHRnR0,12367
 qulab/executor/storage.py,sha256=s1xrI4bPTnyM4Nj0CkPxr3NdmnSp18LKnwm-ZoxR-Q0,7191
 qulab/executor/transform.py,sha256=AazWdlkEoOBaUJpTYsT5J4f0RanzCEeo-ThwEg8BB4Y,1262
-qulab/executor/utils.py,sha256=RNDEo17M-n_tge7uLITHxmoNNYSTm9OES75wQygR8dM,4065
+qulab/executor/utils.py,sha256=VZ_VPYT2MFIfrCtfEW1I7T4NKFIbOvfVac8Sv377MTY,4221
 qulab/monitor/__init__.py,sha256=nTHelnDpxRS_fl_B38TsN0njgq8eVTEz9IAnN3NbDlM,42
 qulab/monitor/__main__.py,sha256=w3yUcqq195LzSnXTkQcuC1RSFRhy4oQ_PEBmucXguME,97
 qulab/monitor/config.py,sha256=fQ5JcsMApKc1UwANEnIvbDQZl8uYW0tle92SaYtX9lI,744
@@ -93,9 +93,9 @@ qulab/visualization/plot_seq.py,sha256=UWTS6p9nfX_7B8ehcYo6UnSTUCjkBsNU9jiOeW2ca
 qulab/visualization/qdat.py,sha256=ZeevBYWkzbww4xZnsjHhw7wRorJCBzbG0iEu-XQB4EA,5735
 qulab/visualization/rot3d.py,sha256=lMrEJlRLwYe6NMBlGkKYpp_V9CTipOAuDy6QW_cQK00,734
 qulab/visualization/widgets.py,sha256=6KkiTyQ8J-ei70LbPQZAK35wjktY47w2IveOa682ftA,3180
-QuLab-2.5.2.dist-info/LICENSE,sha256=PRzIKxZtpQcH7whTG6Egvzl1A0BvnSf30tmR2X2KrpA,1065
-QuLab-2.5.2.dist-info/METADATA,sha256=MhNBnGpjyYm-eEdCxeRZ-bxVK2ZSbTA4du9MKmqpIYs,3698
-QuLab-2.5.2.dist-info/WHEEL,sha256=iDXcyuxg-66TzzqHGH-kgw_HJdaJE_1RHznrvPNCSNs,115
-QuLab-2.5.2.dist-info/entry_points.txt,sha256=b0v1GXOwmxY-nCCsPN_rHZZvY9CtTbWqrGj8u1m8yHo,45
-QuLab-2.5.2.dist-info/top_level.txt,sha256=3T886LbAsbvjonu_TDdmgxKYUn939BVTRPxPl9r4cEg,6
-QuLab-2.5.2.dist-info/RECORD,,
+QuLab-2.5.4.dist-info/LICENSE,sha256=PRzIKxZtpQcH7whTG6Egvzl1A0BvnSf30tmR2X2KrpA,1065
+QuLab-2.5.4.dist-info/METADATA,sha256=TwwWVTHbmI2g3NKVmVe_gpJG-w5WgzzynlzzXe4yjBU,3698
+QuLab-2.5.4.dist-info/WHEEL,sha256=iDXcyuxg-66TzzqHGH-kgw_HJdaJE_1RHznrvPNCSNs,115
+QuLab-2.5.4.dist-info/entry_points.txt,sha256=b0v1GXOwmxY-nCCsPN_rHZZvY9CtTbWqrGj8u1m8yHo,45
+QuLab-2.5.4.dist-info/top_level.txt,sha256=3T886LbAsbvjonu_TDdmgxKYUn939BVTRPxPl9r4cEg,6
+QuLab-2.5.4.dist-info/RECORD,,

qulab/executor/cli.py

@@ -1,20 +1,35 @@
 import functools
+import graphlib
 import importlib
 import os
-import sys
 from pathlib import Path
 
 import click
 from loguru import logger
 
-from ..cli.config import ENV_PREFIX, get_config_value, log_options
-from .load import find_unreferenced_workflows, get_entries, load_workflow
+from ..cli.config import get_config_value, log_options
+from .load import (WorkflowType, find_unreferenced_workflows, get_entries,
+                   load_workflow, make_graph)
 from .schedule import maintain as maintain_workflow
 from .schedule import run as run_workflow
 from .transform import set_config_api
 from .utils import workflow_template
 
 
+@logger.catch(reraise=True)
+def check_toplogy(workflow: WorkflowType, code_path: str | Path) -> dict:
+    graph = {}
+    try:
+        graphlib.TopologicalSorter(make_graph(workflow, graph,
+                                              code_path)).static_order()
+    except graphlib.CycleError as e:
+        logger.error(
+            f"Workflow {workflow.__workflow_id__} has a circular dependency: {e}"
+        )
+        raise e
+    return graph
+
+
 def command_option(command_name):
     """命令专属配置装饰器工厂"""
 
@@ -68,7 +83,7 @@ def create(workflow, code):
     deps = find_unreferenced_workflows(code)
 
     with open(fname, 'w') as f:
-        f.write(workflow_template(list(deps)))
+        f.write(workflow_template(workflow, list(deps)))
     click.echo(f'{workflow} created')
 
 
@@ -142,6 +157,7 @@ def run(workflow, code, data, api, plot, no_dependents, update):
     data = Path(os.path.expanduser(data))
 
     wf = load_workflow(workflow, code)
+    check_toplogy(wf, code)
 
     if no_dependents:
         if hasattr(wf, 'entries'):
@@ -152,9 +168,19 @@ def run(workflow, code, data, api, plot, no_dependents, update):
     else:
         if hasattr(wf, 'entries'):
             for entry in get_entries(wf, code):
-                maintain_workflow(entry, code, data, run=True, plot=plot, update=update)
+                maintain_workflow(entry,
+                                  code,
+                                  data,
+                                  run=True,
+                                  plot=plot,
+                                  update=update)
         else:
-            maintain_workflow(wf, code, data, run=True, plot=plot, update=update)
+            maintain_workflow(wf,
+                              code,
+                              data,
+                              run=True,
+                              plot=plot,
+                              update=update)
 
 
 @click.command()
@@ -181,6 +207,8 @@ def maintain(workflow, code, data, api, plot):
     data = Path(os.path.expanduser(data))
 
     wf = load_workflow(workflow, code)
+    check_toplogy(wf, code)
+
     if hasattr(wf, 'entries'):
         for entry in get_entries(wf, code):
             maintain_workflow(entry, code, data, run=False, plot=plot)

qulab/executor/load.py

@@ -1,4 +1,5 @@
 import base64
+import graphlib
 import hashlib
 import inspect
 import lzma
@@ -259,7 +260,7 @@ def load_workflow_from_template(template_path: str,
     with open(base_path / path) as f:
         content = f.read()
 
-    mtime = max(Path(template_path).stat().st_mtime, mtime)
+    mtime = max((base_path / template_path).stat().st_mtime, mtime)
     hash_str, mapping_code = encode_mapping(mapping)
 
     def replace(text):
@@ -354,14 +355,65 @@ def load_workflow(workflow: str | tuple[str, dict],
 
 def get_dependents(workflow: WorkflowType,
                    code_path: str | Path) -> list[WorkflowType]:
-    return [
-        load_workflow(n, code_path, mtime=workflow.__mtime__)
-        for n in workflow.depends()
-    ]
+    if callable(getattr(workflow, 'depends', None)):
+        if not can_call_without_args(workflow.depends):
+            raise AttributeError(
+                f'Workflow {workflow.__workflow_id__} "depends" function should not have any parameters'
+            )
+        return [
+            load_workflow(n, code_path, mtime=workflow.__mtime__)
+            for n in workflow.depends()
+        ]
+    elif isinstance(getattr(workflow, 'depends', None), (list, tuple)):
+        return [
+            load_workflow(n, code_path, mtime=workflow.__mtime__)
+            for n in workflow.depends
+        ]
+    elif getattr(workflow, 'entries', None) is None:
+        return []
+    else:
+        raise AttributeError(
+            f'Workflow {workflow.__workflow_id__} "depends" should be a callable or a list'
+        )
 
 
-def get_entries(workflow: WorkflowType, code_path: str | Path) -> WorkflowType:
-    return [
-        load_workflow(n, code_path, mtime=workflow.__mtime__)
-        for n in workflow.entries()
-    ]
+def get_entries(workflow: WorkflowType,
+                code_path: str | Path) -> list[WorkflowType]:
+    if callable(getattr(workflow, 'entries', None)):
+        if not can_call_without_args(workflow.entries):
+            raise AttributeError(
+                f'Workflow {workflow.__workflow_id__} "entries" function should not have any parameters'
+            )
+        return [
+            load_workflow(n, code_path, mtime=workflow.__mtime__)
+            for n in workflow.entries()
+        ]
+    elif isinstance(getattr(workflow, 'entries', None), (list, tuple)):
+        return [
+            load_workflow(n, code_path, mtime=workflow.__mtime__)
+            for n in workflow.entries
+        ]
+    elif getattr(workflow, 'entries', None) is None:
+        return []
+    else:
+        raise AttributeError(
+            f'Workflow {workflow.__workflow_id__} "entries" should be a callable or a list'
+        )
+
+
+def make_graph(workflow: WorkflowType, graph: dict, code_path: str | Path):
+    if workflow.__workflow_id__ in graph:
+        raise graphlib.CycleError(
+            f"Workflow {workflow.__workflow_id__} has a circular dependency")
+    graph[workflow.__workflow_id__] = []
+
+    if hasattr(workflow, 'entries'):
+        for w in get_entries(workflow, code_path):
+            graph[workflow.__workflow_id__].append(w.__workflow_id__)
+            make_graph(w, graph=graph, code_path=code_path)
+    elif hasattr(workflow, 'depends'):
+        for w in get_dependents(workflow, code_path):
+            graph[workflow.__workflow_id__].append(w.__workflow_id__)
+            make_graph(w, graph=graph, code_path=code_path)
+
+    return graph

qulab/executor/schedule.py

@@ -73,9 +73,17 @@ def call_analyzer(node,
                   plot=False) -> Result:
     if check:
         result = node.check_analyze(result, history=history)
+        if not isinstance(result, Result):
+            raise TypeError(
+                f'"{node.__workflow_id__}" : "check_analyze" must return a Result object'
+            )
         result.fully_calibrated = False
     else:
         result = node.analyze(result, history=history)
+        if not isinstance(result, Result):
+            raise TypeError(
+                f'"{node.__workflow_id__}" : "analyze" must return a Result object'
+            )
         result.fully_calibrated = True
         if plot:
             call_plot(node, result)

qulab/executor/utils.py

@@ -30,7 +30,7 @@ def dependent_tree(node: str, code_path: str | Path) -> dict[str, list[str]]:
     return tree
 
 
-def workflow_template(deps: list[str]) -> str:
+def workflow_template(workflow: str, deps: list[str]) -> str:
     return f"""def VAR(s): pass  # 没有实际作用，只是用来抑制编辑器的警告。
 
 import numpy as np
@@ -47,7 +47,7 @@ def depends():
 
 
 def calibrate():
-    logger.info(f"run {{__name__}}")
+    logger.info(f"running {workflow} ...")
 
     # calibrate 是一个完整的校准实验，如power Rabi，Ramsey等。
     # 你需要足够的扫描点，以使得后续的 analyze 可以拟合出合适的参数。
@@ -58,10 +58,11 @@ def calibrate():
     for i in x:
         y.append(np.sin(i))
 
+    logger.info(f"running {workflow} ... finished!")
     return x, y
 
 
-def analyze(result: Result, history: Result | None) -> Result:
+def analyze(result: Result, history: Result | None = None) -> Result:
     \"\"\"
     分析校准结果。
 
@@ -93,7 +94,7 @@ def analyze(result: Result, history: Result | None) -> Result:
 
 
 def check():
-    logger.info(f"check {{__name__}}")
+    logger.info(f"checking {workflow} ...")
 
     # check 是一个快速检查实验，用于检查校准是否过时。
     # 你只需要少数扫描点，让后续的 check_analyze 知道参数是否漂移，数据
@@ -105,10 +106,11 @@ def check():
     for i in x:
         y.append(np.sin(i))
 
+    logger.info(f"checking {workflow} ... finished!")
     return x, y
 
 
-def check_analyze(result: Result, history: Result) -> Result:
+def check_analyze(result: Result, history: Result | None = None) -> Result:
     \"\"\"
     分析检查结果。
 

qulab/version.py

@@ -1 +1 @@
-__version__ = "2.5.2"
+__version__ = "2.5.4"