reykit 1.0.1__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.1'
+__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,7 +42,7 @@ class RConfigRandom(object, metaclass=RConfigMeta):
     """
 
     # RRandom.
-    _rrandom_dict: Dict[int, RRandomSeed] = {}
+    _rrandom_dict: dict[int, RRandomSeed] = {}
 
 
 class RRandomSeed(object):

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.1.dist-info → reykit-1.1.0.dist-info}/METADATA

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

reykit-1.1.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+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
+reykit/remail.py,sha256=-uSU2yHyFbjs6X9M5Sjb4TMjw4cK8_Bnsmsaos3f0Rs,6860
+reykit/rexception.py,sha256=sI5EKD5gfsdwApovA4DFnlm_MxmPp7TChNLzGmGvZ9M,8150
+reykit/rimage.py,sha256=BmNNyhqezN9f40gaE5_rv6B7-v9mYkUwT8n2tfCDfdw,6331
+reykit/rlog.py,sha256=J-fnY5B3Y2oJOuyHvemy6ltkr8he4spS3iQOADIUg00,26525
+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=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=jFaIk80gH2Ky-WKmu40jYN38wxmbI7SHcxMbbpABzdc,34623
+reykit/rtable.py,sha256=ghsppMMOGkz3boV_CSxpkel5Lfj-ViBziZrpcCoY5YA,12229
+reykit/rtext.py,sha256=xilQxaMMdaVCBk6rxQb1aI8-j52QVUH5EtTZVMQsa8Q,11108
+reykit/rtime.py,sha256=2xOGGETwl1Sc3W80a2KiPbI4GsSfIyksTeXgqNOTYVw,17178
+reykit/rtype.py,sha256=PbfaHjNQTMiZynlz8HwP2K9SS-t91ThMOYBxQIBf9Ug,1975
+reykit/rwrap.py,sha256=4RdTxT2y7ViyeiWx2fJ54k9ZZT6Bmx5QStIiwEHB6rY,15320
+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.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,,

reydb/__init__.py

@@ -1,25 +0,0 @@
-# !/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-@Time    : 2024-01-07 20:51:57
-@Author  : Rey
-@Contact : reyxbo@163.com
-@Explain : Rey's database method set.
-
-Modules
--------
-rall : All methods.
-rbuild : Database build methods.
-rdatabase : Database connection methods.
-rexecute : Database execute methods.
-rfile : Database file methods.
-rinformation : Database information methods.
-rparameter : Database parameter methods.
-"""
-
-
-from typing import Final
-
-
-__version__: Final[str] = '1.0.0'

reydb/rall.py

@@ -1,17 +0,0 @@
-# !/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-@Time    : 2024-01-07 20:50:02
-@Author  : Rey
-@Contact : reyxbo@163.com
-@Explain : All methods.
-"""
-
-
-from .rbuild import *
-from .rconnection import *
-from .rexecute import *
-from .rfile import *
-from .rinformation import *
-from .rparameter import *