physicsLab 2.0.2__tar.gz → 2.0.4__tar.gz

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: physicsLab
-Version: 2.0.2
+Version: 2.0.4
 Summary: Python API for Quantum-Physics App
 Home-page: https://github.com/GoodenoughPhysicsLab/physicsLab
 Author: Arendelle
@@ -15,7 +15,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typing-extensions
 Requires-Dist: requests==2.32.3
-Requires-Dist: colorama==0.4.6
+Requires-Dist: executing==2.2.0
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -23,6 +23,7 @@ Dynamic: description
 Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: license
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary

{physicslab-2.0.2 → physicslab-2.0.4}/README.md

@@ -4,7 +4,7 @@
 
 [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![build](https://github.com/gaogaotiantian/viztracer/workflows/build/badge.svg)](https://github.com/GoodenoughPhysicsLab/physicsLab/actions)
-<!-- ![support-version](https://img.shields.io/pypi/pyversions/viztracer) 支持3.8及以上版本 -->
+![support-version](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)
 
 ## 介绍
 当我们在[物理实验室AR](https://www.turtlesim.com/)纯手动做实验的时候，往往会遇到一些琐碎、麻烦但又不得不做的事情，比如：重复的搭建某些电路，调整元件的位置，电路内部结构的重复。这些问题都可以通过使用`physicsLab`生成这些电路结构来轻易解决！于是我写了`physicsLab`，让你能用`Python`在物实做实验。
@@ -27,11 +27,12 @@
 * 大多数物实网络api封装的支持 (直接与物实服务器进行交互)
 
 ## 稳定&兼容
-自版本`2.0.0`及之后, `physicsLab`会逐步增加兼容的考虑与支持
+自版本`2.0.0`及之后, `physicsLab`会逐步增加兼容的考虑与支持。宣布`stable`的api将永远不会移除，行为永远也不会改变。
 
-但这并不意味着无意义的兼容。通常来说，会采用标注弃用, 并推荐转移到新api的模式。
-* v2.0.0: `class Experiment, ExperimentOpenedError, ExperimentClosedError, ExperimentExistError, ExperimentNotExistError`实验性地加入`stable`支持
-* v2.0.1: 三大实验所有元件的类名实验性地加入`stable`支持
+* v2.0.0: 承诺`ExperimentOpenedError, ExperimentClosedError, ExperimentExistError, ExperimentNotExistError`会`stable`
+* v2.0.1: 承诺三大实验所有元件的类名会`stable`
+* v2.0.3: 承诺`class Experiment`会`stable`
+* v2.0.4: 承诺`class User, anonymous_login, email_login, token_login`会`stable`
 
 ## 版本发布
 `physicsLab`的版本发布采取快照的方式, `physicsLab`仅会维护`trunk`

{physicslab-2.0.2 → physicslab-2.0.4}/physicsLab/__init__.py

@@ -1,7 +1,6 @@
 # -*- coding: utf-8 -*-
 ''' Python API for Physics-Lab-AR '''
 
-from ._colorUtils import close_color_print
 # 操作实验
 from .element import search_experiment, Experiment
 from ._core import (
@@ -12,7 +11,7 @@ from ._core import (
     ElementXYZ,
 )
 # 实验, 标签类型
-from .enums import ExperimentType, Category, Tag, OpenMode, WireColor
+from .enums import ExperimentType, Category, Tag, OpenMode, WireColor, GetUserMode
 # 电学实验
 from .circuit import *
 # 天体物理实验
@@ -21,6 +20,7 @@ from .celestial import *
 from .electromagnetism import *
 # `physicsLab`自定义异常类
 from .errors import *
+from . import _warn
 
 from physicsLab.plAR import *
 from physicsLab.utils import *
@@ -34,8 +34,9 @@ import platform
 
 if not os.path.exists(Experiment.SAV_PATH_DIR):
     if platform.system() == "Windows":
-        warning("Have you installed Physics-Lab-AR?")
+        _warn.warning("Have you installed Physics-Lab-AR?")
     os.makedirs(Experiment.SAV_PATH_DIR)
 
 del os
 del platform
+del _warn

physicslab-2.0.4/physicsLab/_colorUtils.py

@@ -0,0 +1,184 @@
+# -*- coding: utf-8 -*-
+''' 在命令行打印出有颜色的字
+    为physicsLab最基础, 最底层的设施,
+    所以不能依赖physicsLab的任何其他设施, 包括 errors.py
+
+    Usage:
+        >>> from physicsLab._colorUtils import *
+        >>> cprint(Red("test")) # 输出红色字
+        # 支持变参函数, 一次性打印多个不同颜色的Object
+        # 但不像python的print一样支持sep参数 [设计如此]
+        >>> cprint(Green("test"), "test", Yellow("test"), 1111, 3.14)
+        >>> cprint(Blue("test")) # 还支持以下颜色
+        >>> cprint(Magenta("test"))
+        >>> cprint(Cyan("test"))
+        >>> cprint(White("test"))
+        >>> cprint(Black("test"))
+        >>> cprint(Red("test"), file=sys.stderr) # 输出到stderr
+        >>> cprint(Red("test"), end='') # 支持print那样指定end
+        # 如果你不希望打印出颜色字 (即使使用了Red("xxx")之类的), 请使用python原生print
+        >>> print(Green("test"), "test", Yellow("test")) # 此时打印无颜色
+'''
+
+import platform
+from physicsLab._typing import final
+
+# 设置终端的编码为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")
+
+import ctypes
+if platform.system() == "Windows":
+    from ctypes import wintypes
+
+    class _CONSOLE_SCREEN_BUFFER_INFO(ctypes.Structure):
+        _fields_ = [
+            ("dwSize", wintypes._COORD),
+            ("dwCursorPosition", wintypes._COORD),
+            ("wAttributes", wintypes.WORD),
+            ("srWindow", wintypes.SMALL_RECT),
+            ("dwMaximumWindowSize", wintypes._COORD),
+        ]
+
+    kernel32 = ctypes.windll.kernel32
+
+    _GetStdHandle = ctypes.windll.kernel32.GetStdHandle
+    _GetStdHandle.argtypes = [
+        wintypes.DWORD,
+    ]
+    _GetStdHandle.restype = wintypes.HANDLE
+
+    _GetConsoleScreenBufferInfo = ctypes.windll.kernel32.GetConsoleScreenBufferInfo
+    _GetConsoleScreenBufferInfo.argtypes = [
+        wintypes.HANDLE,
+        ctypes.POINTER(_CONSOLE_SCREEN_BUFFER_INFO),
+    ]
+    _GetConsoleScreenBufferInfo.restype = wintypes.BOOL
+
+    _SetConsoleTextAttribute = ctypes.windll.kernel32.SetConsoleTextAttribute
+    _SetConsoleTextAttribute.argtypes = [
+        wintypes.HANDLE,
+        wintypes.WORD,
+    ]
+    _SetConsoleTextAttribute.restype = wintypes.BOOL
+
+    _stdout_handle = _GetStdHandle(-11) # STD_OUTPUT_HANDLE
+    _stderr_handle = _GetStdHandle(-12) # STD_ERROR_HANDLE
+
+class _Color:
+    fore: int
+
+    def __init__(self, msg: str) -> None:
+        if type(self) is _Color:
+            raise NotImplementedError("_Color class can't be instantiated directly")
+        if not isinstance(msg, str):
+            raise TypeError(f"Parameter msg must be of type `str`, but got value `{msg}` of type {type(msg).__name__}")
+
+        self.msg = msg
+
+    def __repr__(self) -> str:
+        return self.msg
+
+    @final
+    def cprint(self, file):
+        if platform.system() == "Windows":
+            # 临时更改终端打印字符的属性
+            csbi = _CONSOLE_SCREEN_BUFFER_INFO()
+            if file is sys.stdout:
+                _GetConsoleScreenBufferInfo(_stdout_handle, ctypes.byref(csbi))
+                _SetConsoleTextAttribute(_stdout_handle, self.fore)
+            elif file is sys.stderr:
+                _GetConsoleScreenBufferInfo(_stderr_handle, ctypes.byref(csbi))
+                _SetConsoleTextAttribute(_stderr_handle, self.fore)
+            else:
+                assert False
+            print(self.msg, flush=True, end='', file=file)
+            # 恢复终端打印字符的属性
+            if file is sys.stdout:
+                _SetConsoleTextAttribute(_stdout_handle, csbi.wAttributes)
+            elif file is sys.stderr:
+                _SetConsoleTextAttribute(_stderr_handle, csbi.wAttributes)
+            else:
+                assert False
+        else:
+            print(f"\033[{self.fore}m{self.msg}\033[39m", end='', file=file)
+
+class Black(_Color):
+    if platform.system() == "Windows":
+        fore = 0
+    else:
+        fore = 30
+
+class Red(_Color):
+    if platform.system() == "Windows":
+        fore = 4
+    else:
+        fore = 31
+
+class Green(_Color):
+    if platform.system() == "Windows":
+        fore = 2
+    else:
+        fore = 32
+
+class Yellow(_Color):
+    if platform.system() == "Windows":
+        fore = 6
+    else:
+        fore = 33
+
+class Blue(_Color):
+    if platform.system() == "Windows":
+        fore = 1
+    else:
+        fore = 34
+
+class Magenta(_Color):
+    if platform.system() == "Windows":
+        fore = 5
+    else:
+        fore = 35
+
+class Cyan(_Color):
+    if platform.system() == "Windows":
+        fore = 3
+    else:
+        fore = 36
+
+class White(_Color):
+    if platform.system() == "Windows":
+        fore = 7
+    else:
+        fore = 37
+
+def cprint(*args, end='\n', file = sys.stdout) -> None:
+    # 先刷新再打印, 避免在Windows下打印缓冲区的内容还未输出就被改变了Attribute
+    # e.g.
+    # print("test")
+    # _colorUtils.cprint("test")
+    if file == sys.stdout:
+        sys.stdout.flush()
+    elif file == sys.stderr:
+        sys.stderr.flush()
+    else:
+        assert False, "unreachable touched"
+
+    for arg in args:
+        if isinstance(arg, _Color):
+            arg.cprint(file=file)
+        else:
+            print(arg, end='', file=file)
+    print(end, end='', file=file)
+    # 再次刷新，确保终端的输出已经输出
+    # e.g.
+    # cprint(Green("test"), file=sys.stderr)
+    # cprint(Red("ttt"), file=sys.stdout)
+    if file == sys.stdout:
+        sys.stdout.flush()
+    elif file == sys.stderr:
+        sys.stderr.flush()
+    else:
+        assert False, "unreachable touched"