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

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.
 

reykit/rtable.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, TypedDict, Optional, Union, overload
+from typing import Any, TypedDict, overload
 from collections.abc import Iterable
 from os.path import abspath as os_abspath
 from pandas import DataFrame, ExcelWriter, isnull
@@ -34,13 +34,13 @@ __all__ = (
 )
 
 
-type Table = Union[list[dict], dict, CursorResult, DataFrame]
-SheetSet = TypedDict('SheetsSet', {'name': str, 'index': int, 'fields': Union[str, list[str]]})
+type Table = list[dict] | dict | CursorResult | DataFrame
+SheetSet = TypedDict('SheetsSet', {'name': str, 'index': int, 'fields': str | list[str]})
 
 
 def to_table(
-    data: Union[Table, Iterable[Iterable]],
-    fields: Optional[Iterable] = None
+    data: Table | Iterable[Iterable],
+    fields: Iterable | None = None
 ) -> list[dict]:
     """
     Convert data to table in `list[dict]` format, keys and keys sort of the dictionary are the same.
@@ -95,23 +95,23 @@ def to_table(
 
 @overload
 def to_dict(
-    data: Union[Table, Iterable[Iterable]],
-    key_field: Union[int, str] = 0,
+    data: Table | Iterable[Iterable],
+    key_field: int | str = 0,
     val_field: None = None
 ) -> dict[Any, dict]: ...
 
 @overload
 def to_dict(
-    data: Union[Table, Iterable[Iterable]],
-    key_field: Union[int, str] = 0,
-    val_field: Union[int, str] = None
+    data: Table | Iterable[Iterable],
+    key_field: int | str = 0,
+    val_field: int | str = None
 ) -> dict: ...
 
 def to_dict(
-    data: Union[Table, Iterable[Iterable]],
-    key_field: Union[int, str] = 0,
-    val_field: Optional[Union[int, str]] = None
-) -> Union[dict[Any, dict], dict]:
+    data: Table | Iterable[Iterable],
+    key_field: int | str = 0,
+    val_field: int | str | None = None
+) -> dict[Any, dict] | dict:
     """
     Convert data as dictionary.
 
@@ -169,8 +169,8 @@ def to_dict(
 
 
 def to_list(
-    data: Union[Table, Iterable[Iterable]],
-    field: Union[int, str] = 0,
+    data: Table | Iterable[Iterable],
+    field: int | str = 0,
 ) -> list:
     """
     Convert data as list.
@@ -209,8 +209,8 @@ def to_list(
 
 
 def to_df(
-    data: Union[Table, Iterable[Iterable]],
-    fields: Optional[Iterable] = None
+    data: Table | Iterable[Iterable],
+    fields: Iterable | None = None
 ) -> DataFrame:
     """
     Convert data to table of `DataFrame` object.
@@ -253,8 +253,8 @@ def to_df(
 
 
 def to_json(
-    data: Union[Table, Iterable[Iterable]],
-    fields: Optional[Iterable] = None,
+    data: Table | Iterable[Iterable],
+    fields: Iterable | None = None,
     compact: bool = True
 ) -> str:
     """
@@ -283,8 +283,8 @@ def to_json(
 
 
 def to_text(
-    data: Union[Table, Iterable[Iterable]],
-    fields: Optional[Iterable] = None,
+    data: Table | Iterable[Iterable],
+    fields: Iterable | None = None,
     width: int = 100
 ) -> str:
     """
@@ -313,8 +313,8 @@ def to_text(
 
 
 def to_sql(
-    data: Union[Table, Iterable[Iterable]],
-    fields: Optional[Iterable] = None
+    data: Table | Iterable[Iterable],
+    fields: Iterable | None = None
 ) -> str:
     """
     Convert data to SQL string.
@@ -365,8 +365,8 @@ def to_sql(
 
 
 def to_html(
-    data: Union[Table, Iterable[Iterable]],
-    fields: Optional[Iterable] = None
+    data: Table | Iterable[Iterable],
+    fields: Iterable | None = None
 ) -> str:
     """
     Convert data to HTML string.
@@ -393,9 +393,9 @@ def to_html(
 
 
 def to_csv(
-    data: Union[Table, Iterable[Iterable]],
+    data: Table | Iterable[Iterable],
     path: str = 'data.csv',
-    fields: Optional[Iterable] = None
+    fields: Iterable | None = None
 ) -> str:
     """
     Convert data to save CSV format file.
@@ -429,10 +429,10 @@ def to_csv(
 
 
 def to_excel(
-    data: Union[Table, Iterable[Iterable]],
+    data: Table | Iterable[Iterable],
     path: str = 'data.xlsx',
-    group_field: Optional[str] = None,
-    sheets_set: dict[Union[str, int], SheetSet] = {}
+    group_field: str | None = None,
+    sheets_set: dict[str | int, SheetSet] = {}
 ) -> str:
     """
     Convert data to save Excel format file and return sheet name and sheet data.

reykit/rtext.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, Literal, Optional
+from typing import Any, Literal
 from collections.abc import Iterable
 from decimal import Decimal
 from pprint import pformat as pprint_pformat
@@ -278,7 +278,7 @@ def join_filter_text(data: Iterable, char: str = ',', filter_: tuple = (None, ''
 
 def add_text_frame(
     *texts: str,
-    title: Optional[str],
+    title: str | None,
     width: int,
     frame: Literal['full', 'half', 'top', 'half_plain', 'top_plain']
 ) -> str:
@@ -289,7 +289,7 @@ def add_text_frame(
     ----------
     texts : Texts.
     title : Frame title.
-        - `Union[None, Literal['']]`: No title.
+        - `None | Literal['']`: No title.
         - `str`: Use this value as the title.
     width : Frame width.
     frame : Frame type.

reykit/rtime.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, TypedDict, Literal, Optional, Union, overload, NoReturn
+from typing import Any, TypedDict, Literal, overload, NoReturn
 from collections.abc import Callable
 from pandas import (
     DataFrame,
@@ -47,7 +47,7 @@ __all__ = (
 )
 
 
-RecordData = TypedDict('RecordData', {'timestamp': int, 'datetime': datetime_datetime, 'timedelta': Optional[datetime_timedelta], 'note': Optional[str]})
+RecordData = TypedDict('RecordData', {'timestamp': int, 'datetime': datetime_datetime, 'timedelta': datetime_timedelta | None, 'note': str | None})
 
 
 @overload
@@ -78,13 +78,7 @@ def now(
         'time_str',
         'timestamp'
     ] = 'datetime'
-) -> Union[
-    datetime_datetime,
-    datetime_date,
-    datetime_time,
-    str,
-    int
-]:
+) -> datetime_datetime | datetime_date | datetime_time | str | int:
     """
     Get the now time.
 
@@ -126,15 +120,7 @@ def now(
 
 @overload
 def time_to(
-    obj: Union[
-        datetime_datetime,
-        datetime_date,
-        datetime_time,
-        datetime_timedelta,
-        time_struct_time,
-        pd_timestamp,
-        pd_timedelta
-    ],
+    obj: datetime_datetime | datetime_date | datetime_time | datetime_timedelta | time_struct_time | pd_timestamp | pd_timedelta,
     decimal: bool = False,
     raising: bool = True
 ) -> str: ...
@@ -241,13 +227,7 @@ def time_to(
 
 def text_to_time(
     string: str
-) -> Optional[
-    Union[
-        datetime_datetime,
-        datetime_date,
-        datetime_time
-    ]
-]:
+) -> datetime_datetime | datetime_date | datetime_time | None:
     """
     Convert text to time object.
 
@@ -332,11 +312,11 @@ def text_to_time(
 def to_time(
     obj: str,
     raising: bool = True
-) -> Union[datetime_datetime, datetime_date, datetime_time]: ...
+) -> datetime_datetime | datetime_date | datetime_time: ...
 
 @overload
 def to_time(
-    obj: Union[time_struct_time, float],
+    obj: time_struct_time | float,
     raising: bool = True
 ) -> datetime_datetime: ...
 
@@ -413,7 +393,7 @@ def to_time(
 
 def sleep(
     *thresholds: float,
-    precision: Optional[int] = None
+    precision: int | None = None
 ) -> float:
     """
     Sleep random seconds.
@@ -452,7 +432,7 @@ def wait(
     func: Callable[..., bool],
     *args: Any,
     _interval: float = 1,
-    _timeout: Optional[float] = None,
+    _timeout: float | None = None,
     **kwargs: Any
 ) -> float:
     """
@@ -522,7 +502,7 @@ class RTimeMark():
         self.record: dict[int, RecordData] = {}
 
 
-    def mark(self, note: Optional[str] = None) -> int:
+    def mark(self, note: str | None = None) -> int:
         """
         Marking now time.
 
@@ -560,7 +540,7 @@ class RTimeMark():
         return index
 
 
-    def report(self, title: Optional[str] = None) -> DataFrame:
+    def report(self, title: str | None = None) -> DataFrame:
         """
         Print and return time mark information table.
 

reykit/rtype.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, Optional, Self
+from typing import Any, Self
 from collections.abc import Callable
 
 
@@ -86,7 +86,7 @@ class RSingleton(object):
     When instantiated, method `__singleton__` will be called only once, and will accept arguments.
     """
 
-    _instance: Optional[Self] = None
+    _instance: Self | None = None
 
 
     def __new__(self, *arg: Any, **kwargs: Any) -> Self:

reykit/rwrap.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, Optional, Union, Literal, overload
+from typing import Any, Literal, overload
 from collections.abc import Callable
 from io import IOBase, StringIO
 from inspect import getdoc
@@ -78,7 +78,7 @@ def wrap_frame(decorator: Callable) -> Callable:
 
     # Decorate Decorator.
     @overload
-    def wrap(func: Callable, *args: Any, _execute: None = None, **kwargs: Any) -> Union[Callable, Any]: ...
+    def wrap(func: Callable, *args: Any, _execute: None = None, **kwargs: Any) -> Callable | Any: ...
 
     @overload
     def wrap(func: Callable, *args: Any, _execute: Literal[True] = None, **kwargs: Any) -> Any: ...
@@ -87,7 +87,7 @@ def wrap_frame(decorator: Callable) -> Callable:
     def wrap(func: Callable, *args: Any, _execute: Literal[False] = None, **kwargs: Any) -> Callable: ...
 
     @functools_wraps(decorator)
-    def wrap(func: Callable, *args: Any, _execute: Optional[bool] = None, **kwargs: Any) -> Union[Callable, Any]:
+    def wrap(func: Callable, *args: Any, _execute: bool | None = None, **kwargs: Any) -> Callable | Any:
         """
         Decorative shell.
 
@@ -167,7 +167,7 @@ def wrap_runtime(
     *args: Any,
     _return_report: bool = False,
     **kwargs: Any
-) -> Union[Any, tuple[Any, str]]:
+) -> Any | tuple[Any, str]:
     """
     Decorator, print or return runtime report of the function.
 
@@ -260,19 +260,19 @@ def wrap_thread(
 def wrap_exc(
     func: Callable,
     *args: Any,
-    _exception: Union[BaseException, tuple[BaseException, ...]] = BaseException,
-    _handler: Optional[Callable] = None,
+    _exception: BaseException | tuple[BaseException, ...] = BaseException,
+    _handler: Callable | None = None,
     **kwargs: Any
-) -> Optional[Any]: ...
+) -> Any | None: ...
 
 @wrap_frame
 def wrap_exc(
     func: Callable,
     *args: Any,
-    _exception: Union[BaseException, tuple[BaseException, ...]] = BaseException,
-    _handler: Optional[Callable] = None,
+    _exception: BaseException | tuple[BaseException, ...] = BaseException,
+    _handler: Callable | None = None,
     **kwargs: Any
-) -> Optional[Any]:
+) -> Any | None:
     """
     Decorator, execute function with `try` and `except` syntax.
 
@@ -307,8 +307,8 @@ def wrap_exc(
 def wrap_retry(
     func: Callable,
     *args: Any,
-    _report: Optional[str] = None,
-    _exception: Union[BaseException, tuple[BaseException, ...]] = BaseException,
+    _report: str | None = None,
+    _exception: BaseException | tuple[BaseException, ...] = BaseException,
     _try_total: int = 1,
     _try_count: int = 0,
     **kwargs: Any
@@ -318,8 +318,8 @@ def wrap_retry(
 def wrap_retry(
     func: Callable,
     *args: Any,
-    _report: Optional[str] = None,
-    _exception: Union[BaseException, tuple[BaseException, ...]] = BaseException,
+    _report: str | None = None,
+    _exception: BaseException | tuple[BaseException, ...] = BaseException,
     _try_total: int = 1,
     _try_count: int = 0,
     **kwargs: Any
@@ -569,7 +569,7 @@ def wrap_cache(
 def wrap_redirect_stdout(
     func: Callable,
     *args: Any,
-    _redirect: Optional[Union[list, IOBase]] = None,
+    _redirect: list | IOBase | None = None,
     **kwargs: Any
 ) -> Any: ...
 
@@ -577,7 +577,7 @@ def wrap_redirect_stdout(
 def wrap_redirect_stdout(
     func: Callable,
     *args: Any,
-    _redirect: Optional[Union[list, IOBase]] = None,
+    _redirect: list | IOBase | None = None,
     **kwargs: Any
 ) -> Any:
     """

reykit/rzip.py

@@ -10,7 +10,6 @@
 
 
 from __future__ import annotations
-from typing import Optional
 from zipfile import ZipFile, is_zipfile, ZIP_DEFLATED
 from os import getcwd as os_getcwd, walk as os_walk
 from os.path import join as os_join, isfile as os_isfile
@@ -27,7 +26,7 @@ __all__ = (
 
 def compress(
     obj_path: str,
-    build_dir: Optional[str] = None,
+    build_dir: str | None = None,
     overwrite: bool = True
 ) -> None:
     """
@@ -82,8 +81,8 @@ def compress(
 
 def decompress(
     obj_path: str,
-    build_dir: Optional[str] = None,
-    password: Optional[str] = None
+    build_dir: str | None = None,
+    password: str | None = None
 ) -> None:
     """
     Decompress compressed object.
@@ -114,7 +113,7 @@ def decompress(
 
 def zip(
     obj_path: str,
-    build_dir: Optional[str] = None
+    build_dir: str | None = None
 ) -> None:
     """
     Automatic judge and compress or decompress object.