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

reykit/__init__.py

@@ -38,4 +38,4 @@ rzip : File compress methods.
 from typing import Final
 
 
-__version__: Final[str] = '1.0.0'
+__version__: Final[str] = '1.1.0'

reykit/rrandom.py

@@ -10,7 +10,7 @@
 
 
 from __future__ import annotations
-from typing import Dict, Union, Optional, Literal, Self, overload
+from typing import Union, Optional, 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
@@ -42,30 +42,62 @@ class RConfigRandom(object, metaclass=RConfigMeta):
     """
 
     # RRandom.
-    _rrandom_dict: Dict[int, RRandomSeed] = {}
+    _rrandom_dict: dict[int, RRandomSeed] = {}
 
 
 class RRandomSeed(object):
     """
-    Rey's `random seed` type.
-    To be used in syntax `with`, set random seed.
+    Rey's `random seed` type, set random seed.
     If set, based on `random` package.
     If not set, based on `secrets` package.
+
+    Examples
+    --------
+    Use active switch.
+    >>> RRandomSeed(seed)
+    >>> randn()
+    >>> RRandomSeed()
+
+    Use `with` syntax.
+    >>> with RRandomSeed(seed):
+    >>>     randn()
     """
 
 
-    def __init__(self, seed: Union[int, float, str, bytes, bytearray]) -> None:
+    def __init__(self, seed: Optional[Union[int, float, str, bytes, bytearray]] = None) -> None:
         """
         Build `random` attributes.
+
+        Parameters
+        ----------
+        seed : Random seed.
+            - `None`: Clear seed.
+            - `Union[int, float, str, bytes, bytearray]` : Set seed.
         """
 
+        # Delete.
+        if seed is None:
+            self.__del__()
+
         # Build.
-        self.seed = seed
-        self.random = Random(seed)
+        else:
+            self.seed = seed
+            self.random = Random(seed)
 
-        # Record.
+            ## Record.
+            thread_id = threading_get_ident()
+            RConfigRandom._rrandom_dict[thread_id] = self
+
+
+    def __del__(self) -> None:
+        """
+        Delete instance.
+        """
+
+        # Delete.
         thread_id = threading_get_ident()
-        RConfigRandom._rrandom_dict[thread_id] = self
+        if thread_id in RConfigRandom._rrandom_dict:
+            del RConfigRandom._rrandom_dict[thread_id]
 
 
     def __enter__(self) -> Self:
@@ -97,8 +129,7 @@ class RRandomSeed(object):
         """
 
         # Delete.
-        thread_id = threading_get_ident()
-        del RConfigRandom._rrandom_dict[thread_id]
+        self.__del__()
 
 
 @overload

reykit/rsystem.py

@@ -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'
 )
 
 
@@ -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: Optional[str] = None,
+    title: Optional[str] = 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: Optional[str] = None,
+    title: Optional[str] = None
+) -> Optional[bool]: ...
+
+@overload
+def popup_ask(
+    style: Literal['yes_no', 'ok_cancel', 'retry_cancel'] = 'yes_no',
+    message: Optional[str] = None,
+    title: Optional[str] = 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]:
+    """
+    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 : Optional[str] = None,
+    init_folder : Optional[str] = None,
+    init_file : Optional[str] = None,
+    filter_file : Optional[list[tuple[str, str | list[str]]]] = 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
+) -> tuple[str, ...]: ...
+
+@overload
+def popup_select(
+    style: Literal['folder'] = 'file',
+    title : Optional[str] = None,
+    init_folder : Optional[str] = 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, ...]]:
+    """
+    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-1.0.0.dist-info → reykit-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reykit
-Version: 1.0.0
+Version: 1.1.0
 Summary: Rey's kit method set.
 Home-page: https://github.com/reyxbo/reykit/
 Author: Rey

{reykit-1.0.0.dist-info → reykit-1.1.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-reykit/__init__.py,sha256=6_scPOFt0urqRmhU5MJwghJHNudgWPhgV6J6fuYibKg,917
+reykit/__init__.py,sha256=cvteTneRjZ-mxhKx57bNG5pdQc4nEtNkGG8pNXmApQs,917
 reykit/rall.py,sha256=mOFwHXZ4-BOkJ5Ptbm6lQc2zwNf_VqcqM6AYYnYPfoo,672
 reykit/rcomm.py,sha256=_i0hrCB3moZhA3sm2ebg54i9dQ8QjI57ZV2cKm0vxA4,11523
 reykit/rdata.py,sha256=qmx9yKrfP2frOQjj-34ze8sa1l4sOQXtemkKyrVtKXs,8495
@@ -10,11 +10,11 @@ reykit/rmonkey.py,sha256=s8TdR-_tRRMiR11eCLHCkFAJuAZe7PVIhkR-74Xt8vw,7644
 reykit/rmultitask.py,sha256=L4_dlIKGV3DrWlID2MDc1Fl-o0kt23l7oYGp4-WJRYU,22057
 reykit/rnumber.py,sha256=MajaVOVa3_H1lm91cu9HLaLXd9ZsvZYFxXvcklC0LWs,3209
 reykit/ros.py,sha256=wv1DM2N8MXBwGqBhNUSiDLrvHRK7syibhFwEPGkpxYM,39336
-reykit/rrandom.py,sha256=uroEvO8oy5zyp8pk2NWcq49ofJxo1_F3H5_W1U_oj5w,8499
+reykit/rrandom.py,sha256=88SN3BxbVqF0UQJxk6z_76butNnzePHsKD7izEYyNvs,9155
 reykit/rregex.py,sha256=E9BConP7ADYyGVZ5jpxwUmtc_WXFb-I1Zjt6IZSHkIQ,6218
 reykit/rschedule.py,sha256=TiIFQ0siL20nlhikWfvRGhOdeRbyHQtN6uxFivA2WoI,5852
 reykit/rstdout.py,sha256=yjCTegPqm2FNIpNGVrmz16Jn2bNncYO1axuANVdTmVQ,9710
-reykit/rsystem.py,sha256=EbPOKtwtVyXqX4AqKMKPW1cEAixqHAOemaxrlEpT0ZY,29388
+reykit/rsystem.py,sha256=jFaIk80gH2Ky-WKmu40jYN38wxmbI7SHcxMbbpABzdc,34623
 reykit/rtable.py,sha256=ghsppMMOGkz3boV_CSxpkel5Lfj-ViBziZrpcCoY5YA,12229
 reykit/rtext.py,sha256=xilQxaMMdaVCBk6rxQb1aI8-j52QVUH5EtTZVMQsa8Q,11108
 reykit/rtime.py,sha256=2xOGGETwl1Sc3W80a2KiPbI4GsSfIyksTeXgqNOTYVw,17178
@@ -24,7 +24,7 @@ reykit/rzip.py,sha256=HTrxyb4e6f38eOPFIXsdbcEwr7FQSqnU2MVmVRBYTbg,3563
 reykit/rdll/__init__.py,sha256=vM9V7wSNno-WH9RrxgHTIgCkQm8LmBFoLFO8z7qovNo,306
 reykit/rdll/rdll_inject.py,sha256=bETl8tywtN1OiQudbA21u6GwBM_bqVX7jbiisNj_JBg,645
 reykit/rdll/rdll_inject_core.py,sha256=Trgh_pdJs_Lw-Y-0Kkn8kHr4BnilM9dBKnHnX25T_pM,5092
-reykit-1.0.0.dist-info/METADATA,sha256=vUTX5EFI5_u-5aksMa9dRmhar7ESZqvIbljey8pbav0,700
-reykit-1.0.0.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-reykit-1.0.0.dist-info/top_level.txt,sha256=2hvySInjpVEcpYg-XFCYVU5xB2TWW8RovoDtBDzAqyE,7
-reykit-1.0.0.dist-info/RECORD,,
+reykit-1.1.0.dist-info/METADATA,sha256=bbyeoS_7XYrdRSiOH0BD6CSIMRbeewvCIxtX01Z9acc,700
+reykit-1.1.0.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+reykit-1.1.0.dist-info/top_level.txt,sha256=2hvySInjpVEcpYg-XFCYVU5xB2TWW8RovoDtBDzAqyE,7
+reykit-1.1.0.dist-info/RECORD,,