v2.0.0

Author: Arendelle

README.md

@@ -29,7 +29,7 @@
 自版本`2.0.0`及之后, `physicsLab`会逐步增加兼容的考虑与支持
 
 但这并不意味着无意义的兼容。通常来说，会采用标注弃用, 并推荐转移到新api的模式。
-* v2.0.0: `clsss Experiment`实验性地加入`stable`支持
+* v2.0.0: `clsss Experiment, ExperimentOpenedError, ExperimentClosedError, ExperimentExistError, ExperimentNotExistError`实验性地加入`stable`支持
 
 ## 版本发布
 `physicsLab`的版本发布采取快照的方式, `physicsLab`仅会维护`trunk`

docs/errors.md

@@ -12,3 +12,9 @@
 
 ### ExperimentClosedError
 尝试在调用了`Experiment.close`之后使用该实例的方法时，会抛出此异常
+
+### ExperimentExistError
+尝试创建一个已经存在的实验时，会抛出此异常, 除非`force_crt=True`
+
+### ExperimentNotExistError
+尝试导入一个不存在的实验时，会抛出此异常

docs/log.md

@@ -242,3 +242,5 @@
 21. 元件新增`identifier`参数用于指定元件的id
 22. 废弃`elementXYZ.is_elementXYZ()`
 23. 重命名`Experiment.exit`为`Experiment.close`
+
+## 2.0.1

physicsLab/element.py

@@ -197,6 +197,7 @@ def __init__(self, open_mode: OpenMode, *args, **kwargs) -> None:
             if _ExperimentStack.inside(self):
                     raise errors.ExperimentOpenedError
 
+            # TODO 如果从物实读取的实验不存在的话，将异常转换为 ExperimentNotExistError
             assert user is not None
             _summary = user.get_summary(content_id, category)["Data"]
             del _summary["$type"]

physicsLab/errors.py

@@ -56,6 +56,7 @@ class ExperimentClosedError(Exception):
     def __str__(self):
         return "The experiment has been closed"
 
+# TODO 强化报错信息：将实验的具体信息也打印出来
 class ExperimentExistError(Exception):
     ''' 实验已存在 '''
     def __str__(self):

setup.py

@@ -3,7 +3,7 @@
 
 setuptools.setup(
     name="physicsLab",
-    version="1.6.3",
+    version="2.0.0",
     license="MIT",
     author="Arendelle",
     author_email="[email protected]",