reykit 1.1.0__py3-none-any.whl → 1.1.2__py3-none-any.whl

reykit/ros.py

@@ -10,7 +10,7 @@
 
 
 from __future__ import annotations
-from typing import Any, Union, Literal, Optional, NoReturn, overload
+from typing import Any, Literal, NoReturn, overload
 from io import TextIOBase, BufferedIOBase
 from os import (
     walk as os_walk,
@@ -76,12 +76,12 @@ __all__ = (
 type FilePath = str
 type FileText = str
 type FileData = bytes
-type FileStr = Union[FilePath, FileText, TextIOBase]
-type FileBytes = Union[FilePath, FileData, BufferedIOBase]
-type File = Union[FileStr, FileBytes]
+type FileStr = FilePath | FileText | TextIOBase
+type FileBytes = FilePath | FileData | BufferedIOBase
+type File = FileStr | FileBytes
 
 
-def get_md5(file: Union[str, bytes]) -> str:
+def get_md5(file: str | bytes) -> str:
     """
     Get file MD5.
 
@@ -265,7 +265,7 @@ def get_file_bytes(file: FileBytes) -> bytes:
     return file_bytes
 
 
-def read_toml(path: Union[str, RFile]) -> dict[str, Any]:
+def read_toml(path: str | RFile) -> dict[str, Any]:
     """
     Read and parse TOML file.
     Treat nan as a None or null value.
@@ -338,7 +338,7 @@ class RFile(object):
     def read(
         self,
         type_: Literal['str', 'bytes'] = 'bytes'
-    ) -> Union[bytes, str]:
+    ) -> bytes | str:
         """
         Read file data.
 
@@ -371,7 +371,7 @@ class RFile(object):
 
     def write(
         self,
-        data: Optional[Any] = '',
+        data: Any | None = '',
         append: bool = False
     ) -> None:
         """
@@ -735,7 +735,7 @@ class RFile(object):
 
     def __contains__(
         self,
-        value: Union[str, bytes]
+        value: str | bytes
     ) -> bool:
         """
         Judge if file text contain value.
@@ -775,7 +775,7 @@ class RFolder(object):
 
     def __init__(
         self,
-        path: Optional[str] = None
+        path: str | None = None
     ) -> None:
         """
         Build `folder` attributes.
@@ -873,7 +873,7 @@ class RFolder(object):
         pattern: str,
         recursion: bool = False,
         all_ : Literal[False] = False
-    ) -> Optional[str]: ...
+    ) -> str | None: ...
 
     @overload
     def search(
@@ -888,7 +888,7 @@ class RFolder(object):
         pattern: str,
         recursion: bool = False,
         all_ : bool = False
-    ) -> Optional[str]:
+    ) -> str | None:
         """
         Search file by name.
 
@@ -1149,8 +1149,8 @@ class RTempFile(object):
 
     def __init__(
         self,
-        dir_: Optional[str] = None,
-        suffix: Optional[str] = None,
+        dir_: str | None = None,
+        suffix: str | None = None,
         type_: Literal['str', 'bytes'] = 'bytes'
     ) -> None:
         """
@@ -1181,7 +1181,7 @@ class RTempFile(object):
         self.path = self.file.name
 
 
-    def read(self) -> Union[bytes, str]:
+    def read(self) -> bytes | str:
         """
         Read file data.
 
@@ -1199,7 +1199,7 @@ class RTempFile(object):
 
     def write(
         self,
-        data: Union[str, bytes]
+        data: str | bytes
     ) -> None:
         """
         Write file data.
@@ -1391,7 +1391,7 @@ class RTempFile(object):
 
     def __contains__(
         self,
-        value: Union[str, bytes]
+        value: str | bytes
     ) -> bool:
         """
         Judge if file text contain value.
@@ -1434,7 +1434,7 @@ class RTempFolder(object):
 
     def __init__(
         self,
-        dir_: Optional[str] = None
+        dir_: str | None = None
     ) -> None:
         """
         Build `temporary folder` attributes.
@@ -1529,7 +1529,7 @@ class RTempFolder(object):
         pattern: str,
         recursion: bool = False,
         all_ : Literal[False] = False
-    ) -> Optional[str]: ...
+    ) -> str | None: ...
 
     @overload
     def search(
@@ -1544,7 +1544,7 @@ class RTempFolder(object):
         pattern: str,
         recursion: bool = False,
         all_ : bool = False
-    ) -> Optional[str]:
+    ) -> str | None:
         """
         Search file by name.
 
@@ -1762,7 +1762,7 @@ class RTempFolder(object):
 
 def doc_to_docx(
     path: str,
-    save_path: Optional[str] = None
+    save_path: str | None = None
 ) -> str:
     """
     Convert `DOC` file to `DOCX` file.

reykit/rrandom.py

@@ -10,7 +10,7 @@
 
 
 from __future__ import annotations
-from typing import Union, Optional, Literal, Self, overload
+from typing import Literal, Self, overload
 from types import TracebackType
 from collections.abc import Sequence
 from string import digits as string_digits, ascii_letters as string_ascii_letters, punctuation as string_punctuation
@@ -64,7 +64,7 @@ class RRandomSeed(object):
     """
 
 
-    def __init__(self, seed: Optional[Union[int, float, str, bytes, bytearray]] = None) -> None:
+    def __init__(self, seed: int | float | str | bytes | bytearray | None = None) -> None:
         """
         Build `random` attributes.
 
@@ -72,7 +72,7 @@ class RRandomSeed(object):
         ----------
         seed : Random seed.
             - `None`: Clear seed.
-            - `Union[int, float, str, bytes, bytearray]` : Set seed.
+            - `int | float | str | bytes | bytearray` : Set seed.
         """
 
         # Delete.
@@ -114,9 +114,9 @@ class RRandomSeed(object):
 
     def __exit__(
         self,
-        exc_type: Optional[type[BaseException]],
-        exc_instance: Optional[BaseException],
-        exc_traceback: Optional[TracebackType]
+        exc_type: type[BaseException] | None,
+        exc_instance: BaseException | None,
+        exc_traceback: TracebackType | None
     ) -> None:
         """
         Exit syntax `with`.
@@ -158,8 +158,8 @@ def randn(
 
 def randn(
     *thresholds: float,
-    precision: Optional[int] = None
-) -> Union[int, float]:
+    precision: int | None = None
+) -> int | float:
     """
     Random number.
 
@@ -273,9 +273,9 @@ def randi(
 
 def randi(
     data: Sequence,
-    multi: Optional[int] = None,
+    multi: int | None = None,
     unique: bool = True
-) -> Union[Element, list[Element]]:
+) -> Element | list[Element]:
     """
     Random index data element.
 

reykit/rregex.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Optional, Union, Literal, overload
+from typing import Literal, overload
 from collections.abc import Callable
 from re import (
     search as re_search,
@@ -38,7 +38,7 @@ __all__ = (
 def search(
     pattern: str,
     text: str
-) -> Optional[Union[str, tuple[Optional[str], ...]]]:
+) -> str | tuple[str | None, ...] | None:
     """
     Regular search text.
 
@@ -73,7 +73,7 @@ def search(
 def findall(
     pattern: str,
     text: str,
-) -> Union[list[str], list[tuple[str, ...]]]:
+) -> list[str] | list[tuple[str, ...]]:
     """
     Regular find all text.
 
@@ -96,8 +96,8 @@ def findall(
 def sub(
     pattern: str,
     text: str,
-    replace: Optional[Union[str, Callable[[RMatch], str]]] = None,
-    count: Optional[int] = None
+    replace: str | Callable[[RMatch], str] | None = None,
+    count: int | None = None
 ) -> str:
     """
     Regular replace text.
@@ -130,7 +130,7 @@ def sub(
 def split(
     pattern: str,
     text: str,
-    count: Optional[int] = None
+    count: int | None = None
 ) -> list[str]:
     """
     Regular split text.
@@ -161,23 +161,20 @@ def search_batch(
     text: str,
     *patterns: str,
     first: Literal[True] = True
-) -> Optional[Union[str, tuple[Optional[str], ...]]]: ...
+) -> str | tuple[str | None, ...] | None: ...
 
 @overload
 def search_batch(
     text: str,
     *patterns: str,
     first: Literal[False] = True
-) -> list[Optional[Union[str, tuple[Optional[str], ...]]]]: ...
+) -> list[str | tuple[str | None, ...] | None]: ...
 
 def search_batch(
     text: str,
     *patterns: str,
     first: bool = True
-) -> Union[
-    Optional[Union[str, tuple[Optional[str], ...]]],
-    list[Optional[Union[str, tuple[Optional[str], ...]]]]
-]:
+) -> str | tuple[str | None, ...] | list[str | tuple[str | None, ...] | None] | None:
     """
     Batch regular search text.
 
@@ -237,7 +234,7 @@ def findall_batch(text: str, *patterns: str) -> str:
     return texts
 
 
-def sub_batch(text: str, *patterns: Union[str, tuple[str, Union[str, Callable[[RMatch], str]]]]) -> str:
+def sub_batch(text: str, *patterns: str | tuple[str, str | Callable[[RMatch], str]]) -> str:
     """
     Batch regular replace text.
 

reykit/rschedule.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, Literal, Union, Optional
+from typing import Any, Literal
 from collections.abc import Callable
 from apscheduler.executors.pool import ThreadPoolExecutor
 from apscheduler.schedulers.background import BackgroundScheduler
@@ -123,8 +123,8 @@ class RSchedule(object):
         self,
         func: Callable,
         trigger: Literal['date', 'interval', 'cron'] = 'date',
-        args: Optional[tuple] = None,
-        kwargs: Optional[dict] = None,
+        args: tuple | None = None,
+        kwargs: dict | None = None,
         **trigger_kwargs: Any
     ) -> Job:
         """
@@ -157,10 +157,10 @@ class RSchedule(object):
 
     def modify_task(
         self,
-        task: Union[Job, str],
-        trigger: Optional[Literal['date', 'interval', 'cron']] = None,
-        args: Optional[tuple] = None,
-        kwargs: Optional[dict] = None,
+        task: Job | str,
+        trigger: Literal['date', 'interval', 'cron'] | None = None,
+        args: tuple | None = None,
+        kwargs: dict | None = None,
         **trigger_kwargs: Any
     ) -> None:
         """
@@ -205,7 +205,7 @@ class RSchedule(object):
 
     def remove_task(
         self,
-        task: Union[Job, str]
+        task: Job | str
     ) -> None:
         """
         Remove task.
@@ -227,7 +227,7 @@ class RSchedule(object):
 
     def pause_task(
         self,
-        task: Union[Job, str]   
+        task: Job | str   
     ) -> None:
         """
         Pause task.
@@ -249,7 +249,7 @@ class RSchedule(object):
 
     def resume_task(
         self,
-        task: Union[Job, str]
+        task: Job | str
     ) -> None:
         """
         Resume task.

reykit/rstdout.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, Literal, Optional, Union, Final, Self
+from typing import Any, Literal, Final, Self
 from collections.abc import Callable
 import sys
 from io import TextIOWrapper
@@ -60,9 +60,9 @@ class RConfigStdout(object, metaclass=RConfigMeta):
 
 def beautify_text(
     data: tuple[Any],
-    title: Union[bool, str] = True,
-    width: Optional[int] = None,
-    frame: Optional[Literal['full', 'half', 'top', 'half_plain', 'top_plain']] = 'full'
+    title: bool | str = True,
+    width: int | None = None,
+    frame: Literal['full', 'half', 'top', 'half_plain', 'top_plain'] | None = 'full'
 ) -> str:
     """
     Beautify data to text.
@@ -132,9 +132,9 @@ def beautify_text(
 
 def echo(
     *data: Any,
-    title: Union[bool, str] = True,
-    width: Optional[int] = None,
-    frame: Optional[Literal['full', 'half', 'top', 'half_plain', 'top_plain']] = 'full'
+    title: bool | str = True,
+    width: int | None = None,
+    frame: Literal['full', 'half', 'top', 'half_plain', 'top_plain'] | None = 'full'
 ) -> str:
     """
     Beautify data to text, and print.
@@ -176,10 +176,10 @@ def echo(
 
 def rinput(
     *data: Any,
-    title: Union[bool, str] = True,
-    width: Optional[int] = None,
-    frame: Optional[Literal['full', 'half', 'top', 'half_plain', 'top_plain']] = 'full',
-    extra: Optional[str] = None
+    title: bool | str = True,
+    width: int | None = None,
+    frame: Literal['full', 'half', 'top', 'half_plain', 'top_plain'] | None = 'full',
+    extra: str | None = None
 ) -> str:
     """
     Beautify data to text, and print data, and read string from standard input.
@@ -251,7 +251,7 @@ def start_print() -> None:
     RConfigStdout._stoped = False
 
 
-def modify_print(preprocess: Callable[[str], Optional[str]]) -> None:
+def modify_print(preprocess: Callable[[str], str] | None) -> None:
     """
     Modify standard output print write method.
 
@@ -264,7 +264,7 @@ def modify_print(preprocess: Callable[[str], Optional[str]]) -> None:
 
 
     # Define.
-    def write(__s: str) -> Optional[int]:
+    def write(__s: str) -> int | None:
         """
         Modified standard output write method.
 

reykit/rsystem.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, TypedDict, Literal, Optional, Union, overload
+from typing import Any, TypedDict, Literal, overload
 from collections.abc import Callable, Iterable, Sequence
 from inspect import signature as inspect_signature, _ParameterKind, _empty
 from sys import path as sys_path, modules as sys_modules
@@ -110,17 +110,17 @@ ComputerInfo = TypedDict(
 NetWorkInfo = TypedDict(
     'NetWorkTable',
     {
-        'family': Optional[str],
-        'socket': Optional[str],
+        'family': str | None,
+        'socket': str | None,
         'local_ip': str,
         'local_port': int,
-        'remote_ip': Optional[str],
-        'remote_port': Optional[int],
-        'status': Optional[str],
-        'pid': Optional[int]
+        'remote_ip': str | None,
+        'remote_port': int | None,
+        'status': str | None,
+        'pid': int | None
     }
 )
-ProcessInfo = TypedDict('ProcessInfo', {'create_time': datetime, 'id': int, 'name': str, 'ports': Optional[list[int]]})
+ProcessInfo = TypedDict('ProcessInfo', {'create_time': datetime, 'id': int, 'name': str, 'ports': list[int] | None})
 
 
 class RConfigSystem(object, metaclass=RConfigMeta):
@@ -208,7 +208,7 @@ def del_modules(path: str) -> list[str]:
     return deleted_dict
 
 
-def dos_command(command: Union[str, Iterable[str]]) -> str:
+def dos_command(command: str | Iterable[str]) -> str:
     """
     Execute DOS command.
 
@@ -444,7 +444,7 @@ def is_number_str(
 
 def get_first_notnull(
     *values: Any,
-    default: Union[None, Any, Literal['exception']] = None,
+    default: Any | Literal['exception'] | None = None,
     nulls: tuple = (None,)) -> Any:
     """
     Get the first value that is not null.
@@ -482,12 +482,12 @@ def get_first_notnull(
 
 
 @overload
-def get_name(obj: tuple, frame: int = 2) -> Optional[tuple[str, ...]]: ...
+def get_name(obj: tuple, frame: int = 2) -> tuple[str, ...] | None: ...
 
 @overload
-def get_name(obj: Any, frame: int = 2) -> Optional[str]: ...
+def get_name(obj: Any, frame: int = 2) -> str | None: ...
 
-def get_name(obj: Any, frame: int = 2) -> Optional[Union[str, tuple[str, ...]]]:
+def get_name(obj: Any, frame: int = 2) -> str | tuple[str, ...] | None:
     """
     Get name of object or variable.
 
@@ -588,7 +588,7 @@ def get_stack_param(format_: Literal['floor'] = 'floor', limit: int = 2) -> dict
 @overload
 def get_stack_param(format_: Literal['full'] = 'floor', limit: int = 2) -> list[dict]: ...
 
-def get_stack_param(format_: Literal['floor', 'full'] = 'floor', limit: int = 2) -> Union[dict, list[dict]]:
+def get_stack_param(format_: Literal['floor', 'full'] = 'floor', limit: int = 2) -> dict | list[dict]:
     """
     Get code stack parameters.
 
@@ -644,7 +644,7 @@ def get_stack_param(format_: Literal['floor', 'full'] = 'floor', limit: int = 2)
 def get_arg_info(func: Callable) -> list[
     dict[
         Literal['name', 'type', 'annotation', 'default'],
-        Optional[str]
+        str | None
     ]
 ]:
     """
@@ -890,9 +890,9 @@ def get_process_table() -> list[ProcessInfo]:
 
 
 def search_process(
-    id_: Optional[Union[int, Sequence[int]]] = None,
-    name: Optional[Union[str, Sequence[str]]] = None,
-    port: Optional[Union[str, int, Sequence[Union[str, int]]]] = None,
+    id_: int | Sequence[int] | None = None,
+    name: str | Sequence[str] | None = None,
+    port: str | int | Sequence[str | int] | None = None,
 ) -> list[Process]:
     """
     Search process by ID or name or port.
@@ -976,9 +976,9 @@ def search_process(
 
 
 def kill_process(
-    id_: Optional[Union[int, Sequence[int]]] = None,
-    name: Optional[Union[str, Sequence[str]]] = None,
-    port: Optional[Union[str, int, Sequence[Union[str, int]]]] = None,
+    id_: int | Sequence[int] | None = None,
+    name: str | Sequence[str] | None = None,
+    port: str | int | Sequence[str | int] | None = None,
 ) -> list[Process]:
     """
     Search and kill process by ID or name or port.
@@ -1014,9 +1014,9 @@ def kill_process(
 
 
 def stop_process(
-    id_: Optional[Union[int, Sequence[int]]] = None,
-    name: Optional[Union[str, Sequence[str]]] = None,
-    port: Optional[Union[str, int, Sequence[Union[str, int]]]] = None,
+    id_: int | Sequence[int] | None = None,
+    name: str | Sequence[str] | None = None,
+    port: str | int | Sequence[str | int] | None = None,
 ) -> list[Process]:
     """
     Search and stop process by ID or name or port.
@@ -1052,9 +1052,9 @@ def stop_process(
 
 
 def start_process(
-    id_: Optional[Union[int, Sequence[int]]] = None,
-    name: Optional[Union[str, Sequence[str]]] = None,
-    port: Optional[Union[str, int, Sequence[Union[str, int]]]] = None,
+    id_: int | Sequence[int] | None = None,
+    name: str | Sequence[str] | None = None,
+    port: str | int | Sequence[str | int] | None = None,
 ) -> list[Process]:
     """
     Search and start process by ID or name or port.
@@ -1110,7 +1110,7 @@ def get_idle_port(min: int = 49152) -> int:
 
 
 def memory_read(
-    process: Union[int, str],
+    process: int | str,
     dll: str,
     offset: int
 ) -> int:
@@ -1149,7 +1149,7 @@ def memory_read(
 
 
 def memory_write(
-    process: Union[int, str],
+    process: int | str,
     dll: str,
     offset: int,
     value: int
@@ -1200,8 +1200,8 @@ def open_browser(url: str) -> bool:
 
 def popup_message(
     style: Literal['info', 'warn', 'error'] = 'info',
-    message: Optional[str] = None,
-    title: Optional[str] = None
+    message: str | None = None,
+    title: str | None = None
 ) -> None:
     """
     Pop up system message box.
@@ -1237,22 +1237,22 @@ def popup_message(
 @overload
 def popup_ask(
     style: Literal['yes_no_cancel'] = 'yes_no',
-    message: Optional[str] = None,
-    title: Optional[str] = None
-) -> Optional[bool]: ...
+    message: str | None = None,
+    title: str | None = None
+) -> bool | None: ...
 
 @overload
 def popup_ask(
     style: Literal['yes_no', 'ok_cancel', 'retry_cancel'] = 'yes_no',
-    message: Optional[str] = None,
-    title: Optional[str] = None
+    message: str | None = None,
+    title: str | None = None
 ) -> bool: ...
 
 def popup_ask(
     style: Literal['yes_no', 'ok_cancel', 'retry_cancel', 'yes_no_cancel'] = 'yes_no',
-    message: Optional[str] = None,
-    title: Optional[str] = None
-) -> Optional[bool]:
+    message: str | None = None,
+    title: str | None = None
+) -> bool | None:
     """
     Pop up system ask box.
 
@@ -1292,35 +1292,35 @@ def popup_ask(
 @overload
 def popup_select(
     style: Literal['file', 'save'] = 'file',
-    title : Optional[str] = None,
-    init_folder : Optional[str] = None,
-    init_file : Optional[str] = None,
-    filter_file : Optional[list[tuple[str, str | list[str]]]] = None
+    title : str | None = None,
+    init_folder : str | None = None,
+    init_file : str | None = None,
+    filter_file : list[tuple[str, str | list[str]]] | None = None
 ) -> str: ...
 
 @overload
 def popup_select(
     style: Literal['files'] = 'file',
-    title : Optional[str] = None,
-    init_folder : Optional[str] = None,
-    init_file : Optional[str] = None,
-    filter_file : Optional[list[tuple[str, str | list[str]]]] = None
+    title : str | None = None,
+    init_folder : str | None = None,
+    init_file : str | None = None,
+    filter_file : list[tuple[str, str | list[str]]] | None = None
 ) -> tuple[str, ...]: ...
 
 @overload
 def popup_select(
     style: Literal['folder'] = 'file',
-    title : Optional[str] = None,
-    init_folder : Optional[str] = None
+    title : str | None = None,
+    init_folder : str | None = None
 ) -> str: ...
 
 def popup_select(
     style: Literal['file', 'files', 'folder', 'save'] = 'file',
-    title : Optional[str] = None,
-    init_folder : Optional[str] = None,
-    init_file : Optional[str] = None,
-    filter_file : Optional[list[tuple[str, str | list[str]]]] = None
-) -> Union[str, tuple[str, ...]]:
+    title : str | None = None,
+    init_folder : str | None = None,
+    init_file : str | None = None,
+    filter_file : list[tuple[str, str | list[str]]] | None = None
+) -> str | tuple[str, ...]:
     """
     Pop up system select box.