reykit 1.0.1__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
@@ -39,6 +39,21 @@ from time import sleep as time_sleep
 from datetime import datetime
 from varname import VarnameRetrievingError, argname
 from webbrowser import open as webbrowser_open
+from tkinter.messagebox import (
+    showinfo as tkinter_showinfo,
+    showwarning as tkinter_showwarning,
+    showerror as tkinter_showerror,
+    askyesno as tkinter_askyesno,
+    askyesnocancel as tkinter_askyesnocancel,
+    askokcancel as tkinter_askokcancel,
+    askretrycancel as tkinter_askretrycancel
+)
+from tkinter.filedialog import (
+    askopenfilename as tkinter_askopenfilename,
+    askopenfilenames as tkinter_askopenfilenames,
+    asksaveasfilename as tkinter_asksaveasfilename,
+    askdirectory as tkinter_askdirectory
+)
 
 from .rexception import throw
 from .rtype import RConfigMeta
@@ -68,7 +83,10 @@ __all__ = (
     'stop_process',
     'start_process',
     'get_idle_port',
-    'open_browser'
+    'open_browser',
+    'popup_message',
+    'popup_ask',
+    'popup_select'
 )
 
 
@@ -92,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):
@@ -190,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.
 
@@ -426,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.
@@ -464,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.
 
@@ -570,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.
 
@@ -626,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
     ]
 ]:
     """
@@ -872,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.
@@ -958,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.
@@ -996,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.
@@ -1034,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.
@@ -1092,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:
@@ -1131,7 +1149,7 @@ def memory_read(
 
 
 def memory_write(
-    process: Union[int, str],
+    process: int | str,
     dll: str,
     offset: int,
     value: int
@@ -1178,3 +1196,179 @@ def open_browser(url: str) -> bool:
     succeeded = webbrowser_open(url)
 
     return succeeded
+
+
+def popup_message(
+    style: Literal['info', 'warn', 'error'] = 'info',
+    message: str | None = None,
+    title: str | None = None
+) -> None:
+    """
+    Pop up system message box.
+
+    Parameters
+    ----------
+    style : Message box style.
+        - `Literal['info']`: Information box.
+        - `Literal['warn']`: Warning box.
+        - `Literal['error']`: Error box.
+    message : Message box content.
+    title : Message box title.
+    """
+
+    # Pop up.
+    match style:
+
+        ## Information.
+        case 'info':
+            method = tkinter_showinfo
+
+        ## Warning.
+        case 'warn':
+            method = tkinter_showwarning
+
+        ## Error.
+        case 'error':
+            method = tkinter_showerror
+
+    method(title, message)
+
+
+@overload
+def popup_ask(
+    style: Literal['yes_no_cancel'] = 'yes_no',
+    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: 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: str | None = None,
+    title: str | None = None
+) -> bool | None:
+    """
+    Pop up system ask box.
+
+    Parameters
+    ----------
+    style : Ask box style.
+        - `Literal['yes_no']`: Buttons are `yes` and `no`.
+        - `Literal['ok_cancel']`: Buttons are `ok` and `cancel`.
+        - `Literal['retry_cancel']`: Buttons are `retry` and `cancel`.
+        - `Literal['yes_no_cancel']`: Buttons are `yes` and `no` and `cancel`.
+    message : Ask box content.
+    title : Ask box title.
+    """
+
+    # Pop up.
+    match style:
+
+        ## Yes and no.
+        case 'yes_no':
+            method = tkinter_askyesno
+
+        ## Ok and cancel.
+        case 'ok_cancel':
+            method = tkinter_askokcancel
+
+        ## Retry and cancel.
+        case 'retry_cancel':
+            method = tkinter_askretrycancel
+
+        ## Yes and no and cancel.
+        case 'yes_no_cancel':
+            method = tkinter_askyesnocancel
+
+    method(title, message)
+
+
+@overload
+def popup_select(
+    style: Literal['file', 'save'] = 'file',
+    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 : 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 : str | None = None,
+    init_folder : str | None = None
+) -> str: ...
+
+def popup_select(
+    style: Literal['file', 'files', 'folder', 'save'] = 'file',
+    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.
+
+    Parameters
+    ----------
+    style : Select box style.
+        - `Literal['file']`: Select file box.
+        - `Literal['files']`: Select multiple files box.
+        - `Literal['folder']`: Select folder box.
+        - `Literal['save']`: Select save file box.
+    title : Select box title.
+    init_folder : Initial folder path.
+    init_file : Initial file name.
+    filter_file : Filter file.
+        - `tuple[str, str]`: Filter name and filter pattern.
+        - `tuple[str, list[str]]`: Filter name and multiple filter patterns (or).
+    """
+
+    # Pop up.
+    kwargs = {
+        'filetypes': filter_file,
+        'initialdir': init_folder,
+        'initialfile': init_file,
+        'title': title
+    }
+    kwargs = {
+        key: value
+        for key, value in kwargs.items()
+        if value is not None
+    }
+    match style:
+
+        ## File.
+        case 'file':
+            method = tkinter_askopenfilename
+
+        ## Files.
+        case 'files':
+            method = tkinter_askopenfilenames
+
+        ## Folder.
+        case 'folder':
+            method = tkinter_askdirectory
+
+        ## Save.
+        case 'save':
+            method = tkinter_asksaveasfilename
+
+    path = method(**kwargs)
+
+    return path

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: