physicsLab 2.0.2__tar.gz → 2.0.3__tar.gz

{physicslab-2.0.2 → physicslab-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: physicsLab
-Version: 2.0.2
+Version: 2.0.3
 Summary: Python API for Quantum-Physics App
 Home-page: https://github.com/GoodenoughPhysicsLab/physicsLab
 Author: Arendelle

{physicslab-2.0.2 → physicslab-2.0.3}/physicsLab/_colorUtils.py

@@ -3,7 +3,13 @@
 from enum import Enum, unique
 
 import colorama
-colorama.init(autoreset=True)
+
+# 设置终端的编码为UTF-8
+import io
+import sys
+sys.stdin = io.TextIOWrapper(sys.stdin.buffer, encoding='utf-8')
+sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
 
 @unique
 class COLOR(Enum):
@@ -25,7 +31,7 @@ def color_print(msg: str, color: COLOR, end='\n') -> None:
     global _ColorSupport
 
     if _ColorSupport:
-        print(color.value + msg, end=end)
+        print(color.value + msg + colorama.Fore.RESET, end=end)
     else:
         print(msg, end=end)
 

{physicslab-2.0.2 → physicslab-2.0.3}/physicsLab/_core.py

@@ -1,11 +1,13 @@
 # -*- coding: utf-8 -*-
 ''' `physicsLab` 操作存档的核心文件
-    该文件提供操作存档的核心: `class _Experiment` 与所有元件的基类: class `_ElementBase`
+    该文件提供操作存档的核心: `class _Experiment` 与所有元件的基类: class `ElementBase`
     为了避免在physicsLab内出现大量的cyclic import
     该文件仅会对存档进行文件读写方面的操作, 将元件的的信息进一步导入由`class Experiment`负责
     `class Experiment`也提供了对用户更加友好的接口
 '''
 import os
+import sys
+import abc
 import json
 import copy
 import time
@@ -29,7 +31,7 @@ class _ExperimentStack:
 
     @classmethod
     def inside(cls, item: "_Experiment") -> bool:
-        assert isinstance(item, _Experiment)
+        errors.assert_true(isinstance(item, _Experiment))
 
         for a_expe in cls.data:
             if a_expe.SAV_PATH == item.SAV_PATH:
@@ -98,6 +100,13 @@ class _Experiment:
     def __init__(*args, **kwargs) -> NoReturn:
         raise NotImplementedError
 
+    @property
+    def is_anonymous_sav(self) -> bool:
+        ''' 是否为匿名存档
+            若为匿名存档则返回True, 否则返回False
+        '''
+        return "InternalName" not in self.PlSav
+
     @property
     @_check_not_closed
     def is_elementXYZ(self) -> bool:
@@ -163,7 +172,7 @@ class _Experiment:
             if can_break:
                 break
         else:
-            assert False
+            errors.unreachable()
 
         assert identifier in self._id2element.keys()
         del self._id2element[identifier]
@@ -253,7 +262,7 @@ class _Experiment:
                 "Elements": [a_element.data for a_element in self.Elements],
             }
         else:
-            assert False
+            errors.unreachable()
 
         self.PlSav["Experiment"]["CreationDate"] = int(time.time() * 1000)
         self.PlSav["Summary"]["CreationDate"] = int(time.time() * 1000)
@@ -283,38 +292,43 @@ class _Experiment:
         else:
             target_path = os.path.abspath(target_path)
 
-        if self.open_mode in (OpenMode.load_by_sav_name, OpenMode.load_by_filepath, OpenMode.load_by_plar_app):
-            status: str = "update"
-        elif self.open_mode == OpenMode.crt:
-            status: str = "create"
-        else:
-            assert False
-
         self.__write()
 
-        context: str = json.dumps(self.PlSav, indent=2, ensure_ascii=False, separators=(',', ':'))
+        try:
+            context: str = json.dumps(self.PlSav, indent=2, ensure_ascii=False, separators=(',', ':'))
+        except TypeError as e:
+            # 通常由序列化出现 <Generate>导致
+            print("TypeError: ", e, file=sys.stderr)
+            errors.unreachable()
 
         with open(target_path, "w", encoding="utf-8") as f:
             f.write(context)
 
         if not no_print_info:
+            _colorUtils.color_print("Successfully save experiment ", color=_colorUtils.COLOR.GREEN, end='')
+            if self.is_anonymous_sav:
+                # 对匿名实验的特殊处理
+                _colorUtils.color_print(f"<anonymous>", color=_colorUtils.COLOR.CYAN, end='')
+            else:
+                _colorUtils.color_print(
+                    f"\"{self.PlSav['InternalName']}\"",
+                    color=_colorUtils.COLOR.GREEN,
+                    end='',
+                )
+            _colorUtils.color_print(f" at \"{target_path}\"! ", _colorUtils.COLOR.GREEN, end='')
             if self.experiment_type == ExperimentType.Circuit:
                 _colorUtils.color_print(
-                    f"Successfully {status} experiment \"{self.PlSav['InternalName']}\""
-                    f"(\"{target_path}\")! "
                     f"{self.get_elements_count()} elements, {self.get_wires_count()} wires.",
                     color=_colorUtils.COLOR.GREEN
                 )
             elif self.experiment_type == ExperimentType.Celestial \
                     or self.experiment_type == ExperimentType.Electromagnetism:
                 _colorUtils.color_print(
-                    f"Successfully {status} experiment \"{self.PlSav['InternalName']}\""
-                    f"(\"{target_path}\")! "
                     f"{self.get_elements_count()} elements.",
                     color=_colorUtils.COLOR.GREEN
                 )
             else:
-                assert False
+                errors.unreachable()
 
         return self
 
@@ -326,10 +340,12 @@ class _Experiment:
         if delete:
             if os.path.exists(self.SAV_PATH): # 之所以判断路径是否存在是因为一个实验可能被创建但还未被写入就调用了delete
                 os.remove(self.SAV_PATH)
-                _colorUtils.color_print(
-                    f"Successfully delete experiment \"{self.PlSav['InternalName']}\"(\"{self.SAV_PATH}\")",
-                    _colorUtils.COLOR.BLUE
-                )
+                _colorUtils.color_print("Successfully delete experiment ", _colorUtils.COLOR.BLUE, end='')
+                if self.is_anonymous_sav:
+                    _colorUtils.color_print("<anonymous>", color=_colorUtils.COLOR.CYAN, end='')
+                else:
+                    _colorUtils.color_print(f"\"{self.PlSav['InternalName']}\"", _colorUtils.COLOR.BLUE, end='')
+                _colorUtils.color_print(f"at \"{self.SAV_PATH}\"!", _colorUtils.COLOR.BLUE)
             if os.path.exists(self.SAV_PATH.replace(".sav", ".jpg")): # 用存档生成的实验无图片
                 os.remove(self.SAV_PATH.replace(".sav", ".jpg"))
 
@@ -646,7 +662,7 @@ class _Experiment:
         if self is other:
             raise errors.ExperimentError("can not merge to itself") # TODO 换一个更好的异常类型?
 
-        assert self.SAV_PATH is not None and other.SAV_PATH is not None
+        errors.assert_true(self.SAV_PATH is not None and other.SAV_PATH is not None)
 
         if self is other:
             return self
@@ -690,6 +706,10 @@ class ElementBase:
     def __init__(self) -> None:
         raise NotImplementedError
 
+    @abc.abstractmethod
+    def zh_name(self):
+        raise NotImplementedError
+
     def set_position(self, x: num_type, y: num_type, z: num_type) -> Self:
         ''' 设置元件的位置 '''
         if not isinstance(x, (int, float)) \

{physicslab-2.0.2 → physicslab-2.0.3}/physicsLab/celestial/planets.py

@@ -1,7 +1,12 @@
 # -*- coding: utf-8 -*-
 from physicsLab.savTemplate import Generate
 from ._planetbase import PlanetBase
-from physicsLab._typing import num_type, Optional
+from physicsLab._typing import (
+    num_type,
+    Optional,
+    LiteralString,
+    final,
+)
 
 class Mercury(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
@@ -21,6 +26,11 @@ class Mercury(PlanetBase):
             "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "水星"
+
 class Venus(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -40,6 +50,11 @@ class Venus(PlanetBase):
             "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "金星"
+
 class Earth(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -58,6 +73,12 @@ class Earth(PlanetBase):
             "AxisSemi": 10.0, "Perihelion": 10.0, "Aphelion": 10.0,
             "LeavingKepler": False
         }
+
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "地球"
+
 class Mars(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -75,6 +96,11 @@ class Mars(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "火星"
+
 class Jupiter(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -92,6 +118,11 @@ class Jupiter(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "木星"
+
 class Saturn(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -109,6 +140,11 @@ class Saturn(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "土星"
+
 class Uranus(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -126,6 +162,11 @@ class Uranus(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "天王星"
+
 class Neptune(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -142,6 +183,11 @@ class Neptune(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "海王星"
+
 class Pluto(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -159,6 +205,11 @@ class Pluto(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "冥王星"
+
 class Sun(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -176,6 +227,11 @@ class Sun(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "太阳"
+
 class Blue_Giant(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -193,6 +249,11 @@ class Blue_Giant(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "蓝巨星"
+
 class Red_Giant(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -210,6 +271,11 @@ class Red_Giant(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "红巨星"
+
 class Red_Dwarf(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -227,6 +293,11 @@ class Red_Dwarf(PlanetBase):
             "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "红矮星"
+
 class White_Dwarf(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -244,6 +315,11 @@ class White_Dwarf(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "白矮星"
+
 class Blackhole(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -261,6 +337,11 @@ class Blackhole(PlanetBase):
             "Perihelion": 10.0, "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "黑洞"
+
 class Fantasy_Star(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -278,6 +359,11 @@ class Fantasy_Star(PlanetBase):
             "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "幻想恒星"
+
 class Moon(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -295,6 +381,11 @@ class Moon(PlanetBase):
             "Aphelion": "NaN", "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "月球"
+
 class Chocolate_Ball(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -311,6 +402,11 @@ class Chocolate_Ball(PlanetBase):
             "Aphelion": "NaN", "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "巧克力球"
+
 class Continential(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -328,6 +424,11 @@ class Continential(PlanetBase):
             "Aphelion": 10.0, "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "大陆行星"
+
 class Arctic(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -345,6 +446,11 @@ class Arctic(PlanetBase):
             "Aphelion": "NaN", "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "封冻行星"
+
 class Arid(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
@@ -363,32 +469,135 @@ class Arid(PlanetBase):
             "Aphelion": "NaN", "LeavingKepler": False
         }
 
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "干旱行星"
+
 class Barren(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
-            "Identifier": Generate, "Model": "Barren", "Override": None, "Name": "贫瘠行星", "Parent": None, "Type": 1, "Changed": False, "Extras": {}, "Radius": 4541.27246, "RadiusVisible": 0.030356545, "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0, "Mass": 2.03722143, "OrbitType": 0, "OrbitEstimation": 3, "Density": 5.192983592302659, "Gravity": 6.5928702184257375, "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.10571566044065506, "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0, "Position": Generate, "Velocity": Generate, "Acceleration": Generate, "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN", "AxisSemi": "NaN", "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False}
+            "Identifier": Generate, "Model": "Barren", "Override": None, "Name": "贫瘠行星",
+            "Parent": None, "Type": 1, "Changed": False, "Extras": {}, "Radius": 4541.27246,
+            "RadiusVisible": 0.030356545, "RotationPeriod": 1.0, "RotationPhase": 0.0,
+            "AxialTilt": 0.0, "Mass": 2.03722143, "OrbitType": 0, "OrbitEstimation": 3,
+            "Density": 5.192983592302659, "Gravity": 6.5928702184257375,
+            "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.10571566044065506,
+            "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0,
+            "Position": Generate, "Velocity": Generate, "Acceleration": Generate,
+            "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN",
+            "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN", "AxisSemi": "NaN",
+            "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False}
+
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "贫瘠行星"
 
 class Desert(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
-            "Identifier": Generate, "Model": "Desert", "Override": None, "Name": "沙漠行星", "Parent": None, "Type": 1, "Changed": False, "Extras": {}, "Radius": 4934.40771, "RadiusVisible": 0.03298449, "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0, "Mass": 2.710787, "OrbitType": 0, "OrbitEstimation": 3, "Density": 5.386438443611148, "Gravity": 7.430477946170987, "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.21723898875306347, "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0, "Position": Generate, "Velocity": Generate, "Acceleration": Generate, "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN", "AxisSemi": "NaN", "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False}
+            "Identifier": Generate, "Model": "Desert", "Override": None,
+            "Name": "沙漠行星", "Parent": None, "Type": 1, "Changed": False,
+            "Extras": {}, "Radius": 4934.40771, "RadiusVisible": 0.03298449,
+            "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0,
+            "Mass": 2.710787, "OrbitType": 0, "OrbitEstimation": 3,
+            "Density": 5.386438443611148, "Gravity": 7.430477946170987,
+            "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.21723898875306347,
+            "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0,
+            "Position": Generate, "Velocity": Generate, "Acceleration": Generate,
+            "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN",
+            "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN",
+            "AxisSemi": "NaN", "Perihelion": "NaN",
+            "Aphelion": "NaN", "LeavingKepler": False}
+
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "沙漠行星"
 
 class Jungle(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
-            "Identifier": Generate, "Model": "Jungle", "Override": None, "Name": "丛林行星", "Parent": None, "Type": 1, "Changed": False, "Extras": {}, "Radius": 2861.00879, "RadiusVisible": 0.0191246718, "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0, "Mass": 0.5192027, "OrbitType": 0, "OrbitEstimation": 3, "Density": 5.2928643631051635, "Gravity": 4.233406517765326, "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.10596970288294205, "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0, "Position": Generate, "Velocity": Generate, "Acceleration": Generate, "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN", "AxisSemi": "NaN", "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False}
+            "Identifier": Generate, "Model": "Jungle", "Override": None,
+            "Name": "丛林行星", "Parent": None, "Type": 1, "Changed": False,
+            "Extras": {}, "Radius": 2861.00879, "RadiusVisible": 0.0191246718,
+            "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0,
+            "Mass": 0.5192027, "OrbitType": 0, "OrbitEstimation": 3,
+            "Density": 5.2928643631051635, "Gravity": 4.233406517765326,
+            "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.10596970288294205,
+            "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0,
+            "Position": Generate, "Velocity": Generate, "Acceleration": Generate,
+            "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN",
+            "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN",
+            "AxisSemi": "NaN", "Perihelion": "NaN",
+            "Aphelion": "NaN", "LeavingKepler": False}
+
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "丛林行星"
 
 class Toxic(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
-            "Identifier": Generate, "Model": "Toxic", "Override": None, "Name": "剧毒行星", "Parent": None, "Type": 1, "Changed": False, "Extras": {}, "Radius": 9783.194, "RadiusVisible": 0.0653966442, "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0, "Mass": 20.55713, "OrbitType": 0, "OrbitEstimation": 3, "Density": 5.241213470473673, "Gravity": 14.334829985641749, "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.11500446600565795, "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0, "Position": Generate, "Velocity": Generate, "Acceleration": Generate, "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN", "AxisSemi": "NaN", "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False}
+            "Identifier": Generate, "Model": "Toxic", "Override": None,
+            "Name": "剧毒行星", "Parent": None, "Type": 1, "Changed": False,
+            "Extras": {}, "Radius": 9783.194, "RadiusVisible": 0.0653966442,
+            "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0,
+            "Mass": 20.55713, "OrbitType": 0, "OrbitEstimation": 3,
+            "Density": 5.241213470473673, "Gravity": 14.334829985641749, "Luminosity": 0.0,
+            "Temperature": 0.0, "Albedo": 0.11500446600565795, "PowerAbsorbtion": 0.0,
+            "PlanetariumBalance": 0.0, "Position": Generate, "Velocity": Generate,
+            "Acceleration": Generate, "Period": 0.0, "Eccentricity": "NaN",
+            "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN", "Phase": 0.0,
+            "PhaseCurrent": "NaN", "AxisSemi": "NaN", "Perihelion": "NaN",
+            "Aphelion": "NaN", "LeavingKepler": False}
+
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "剧毒行星"
 
 class Lava(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
-            "Identifier": Generate, "Model": "Lava", "Override": None, "Name": "熔岩行星", "Parent": None, "Type": 1, "Changed": False, "Extras": {}, "Radius": 5447.97, "RadiusVisible": 0.036417447, "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0, "Mass": 3.63040853, "OrbitType": 0, "OrbitEstimation": 3, "Density": 5.3599744007793495, "Gravity": 8.163519931681726, "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.2376526732503912, "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0, "Position": Generate, "Velocity": Generate, "Acceleration": Generate, "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN", "AxisSemi": "NaN", "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False}
+            "Identifier": Generate, "Model": "Lava", "Override": None,
+            "Name": "熔岩行星", "Parent": None, "Type": 1, "Changed": False,
+            "Extras": {}, "Radius": 5447.97, "RadiusVisible": 0.036417447,
+            "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0,
+            "Mass": 3.63040853, "OrbitType": 0, "OrbitEstimation": 3,
+            "Density": 5.3599744007793495, "Gravity": 8.163519931681726,
+            "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.2376526732503912,
+            "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0, "Position": Generate,
+            "Velocity": Generate, "Acceleration": Generate, "Period": 0.0,
+            "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN",
+            "Phase": 0.0, "PhaseCurrent": "NaN", "AxisSemi": "NaN",
+            "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False}
+
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "熔岩行星"
 
 class Ocean(PlanetBase):
     def __init__(self, x: num_type, y: num_type, z: num_type, /, *, identifier: Optional[str] = None) -> None:
         self.data = {
-            "Identifier": Generate, "Model": "Ocean", "Override": None, "Name": "海洋行星", "Parent": None, "Type": 1, "Changed": False, "Extras": {}, "Radius": 6777.314, "RadiusVisible": 0.0453035645, "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0, "Mass": 7.10958433, "OrbitType": 0, "OrbitEstimation": 3, "Density": 5.452338182781527, "Gravity": 10.330477777335007, "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.2213094047766173, "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0, "Position": Generate, "Velocity": Generate, "Acceleration": Generate, "Period": 0.0, "Eccentricity": "NaN", "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN", "Phase": 0.0, "PhaseCurrent": "NaN", "AxisSemi": "NaN", "Perihelion": "NaN", "Aphelion": "NaN", "LeavingKepler": False}
+            "Identifier": Generate, "Model": "Ocean", "Override": None,
+            "Name": "海洋行星", "Parent": None, "Type": 1, "Changed": False,
+            "Extras": {}, "Radius": 6777.314, "RadiusVisible": 0.0453035645,
+            "RotationPeriod": 1.0, "RotationPhase": 0.0, "AxialTilt": 0.0,
+            "Mass": 7.10958433, "OrbitType": 0, "OrbitEstimation": 3,
+            "Density": 5.452338182781527, "Gravity": 10.330477777335007,
+            "Luminosity": 0.0, "Temperature": 0.0, "Albedo": 0.2213094047766173,
+            "PowerAbsorbtion": 0.0, "PlanetariumBalance": 0.0, "Position": Generate,
+            "Velocity": Generate, "Acceleration": Generate, "Period": 0.0, "Eccentricity": "NaN",
+            "OmegaUC": 0.0, "OmegaLC": "NaN", "Inclination": "NaN", "Phase": 0.0,
+            "PhaseCurrent": "NaN", "AxisSemi": "NaN", "Perihelion": "NaN",
+            "Aphelion": "NaN", "LeavingKepler": False}
+
+    @final
+    @staticmethod
+    def zh_name() -> LiteralString:
+        return "海洋行星"
+

{physicslab-2.0.2 → physicslab-2.0.3}/physicsLab/circuit/_circuit_core.py

@@ -45,7 +45,7 @@ class Pin(metaclass=_PinMeta):
         for name, a_pin in self.element_self.get_all_pins_property():
             if a_pin.fget(self.element_self) == self:
                 return name
-        assert False
+        errors.unreachable()
 
     def get_wires(self) -> List["Wire"]:
         ''' 获取该引脚上连接的所有导线