reykit 1.1.24__py3-none-any.whl → 1.1.26__py3-none-any.whl

reykit/__init__.py

@@ -10,23 +10,23 @@
 Modules
 -------
 rall : All methods.
-rcomm : Network communication methods.
 rdata : Data methods.
 rdll : DLL file methods.
 remail : E-mail methods.
-rexception : Exception methods.
+rexc : Exception methods.
 rimage : Image methods.
 rlog : Log methods.
 rmonkey : Monkey patch methods.
-rmultitask : Multi task methods.
-rnumber : Number methods.
+rnet : Network methods.
+rnum : Number methods.
 ros: Operation system methods.
-rrandom : Random methods.
-rregex : Regular expression methods.
+rrand : Random methods.
+rre : Regular expression methods.
 rschedule : Schedule methods.
-rstdout : Standard output methods.
-rsystem : Interpreter system methods.
+rstdout : Standard output and input methods.
+rsys : Interpreter system methods.
 rtable : Table methods.
+rtask : Multi task methods.
 rtext : Text methods.
 rtime : Time methods.
 rtype : Type methods.

reykit/rall.py

@@ -9,23 +9,23 @@
 """
 
 
-from .rcomm import *
 from .rdata import *
 from .rdll import *
 from .remail import *
-from .rexception import *
+from .rexc import *
 from .rimage import *
 from .rlog import *
 from .rmonkey import *
-from .rmultitask import *
-from .rnumber import *
+from .rnet import *
+from .rnum import *
 from .ros import *
-from .rrandom import *
-from .rregex import *
+from .rrand import *
+from .rre import *
 from .rschedule import *
 from .rstdout import *
-from .rsystem import *
+from .rsys import *
 from .rtable import *
+from .rtask import *
 from .rtext import *
 from .rtime import *
 from .rtype import *

reykit/rdata.py

@@ -14,9 +14,9 @@ from collections import defaultdict as Defaultdict, ChainMap
 from collections.abc import Callable, Iterable, Generator
 from itertools import chain as IChain
 
-from .rexception import check_least_one, check_most_one
-from .rsystem import is_iterable
-from .rtype import T, KT, VT, RBase, Null
+from .rexc import check_least_one, check_most_one
+from .rsys import is_iterable
+from .rtype import T, KT, VT, Base, null
 
 
 __all__ = (
@@ -28,7 +28,7 @@ __all__ = (
     'objs_in',
     'chain',
     'default_dict',
-    'RGenerator'
+    'FunctionGenerator'
 )
 
 
@@ -320,14 +320,14 @@ def chain(*iterables: dict[KT, VT] | Iterable[T]) -> ChainMap[KT, VT] | IChain[T
     return data
 
 
-def default_dict(default: T = Null, data: dict[KT, VT] | None = None) -> Defaultdict[KT, VT | T]:
+def default_dict(default: T = null, data: dict[KT, VT] | None = None) -> Defaultdict[KT, VT | T]:
     """
     Set `dict` instance, default value when key does not exist.
 
     Parameters
     ----------
     default : Default value.
-        - `Literal[Null]`: Nest function self.
+        - `Literal[null]`: Nest function self.
         - `Callable`: Use call return value.
     data : `dict` instance.
         - `None`: Empty `dict`.
@@ -336,7 +336,7 @@ def default_dict(default: T = Null, data: dict[KT, VT] | None = None) -> Default
     # Handle parameter.
 
     ## Null.
-    if default == Null:
+    if default == null:
         default_factory = default_dict
 
     ## Callable.
@@ -356,9 +356,18 @@ def default_dict(default: T = Null, data: dict[KT, VT] | None = None) -> Default
     return dict_set
 
 
-class RGenerator(RBase):
+class FunctionGenerator(Base):
     """
-    Rey's `generator` type.
+    Function generator type.
+
+    Examples
+    --------
+    >>> func = lambda arg1, arg2: arg1 + arg2
+    >>> fgenerator = FunctionGenerator(func, 10)
+    >>> fgenerator.add(1)
+    >>> fgenerator.add(2)
+    >>> list(fgenerator)
+    [11, 12]
     """
 
 
@@ -369,7 +378,7 @@ class RGenerator(RBase):
         **kwargs: Any
     ) -> None:
         """
-        Build `generator` instance attributes.
+        Build instance attributes.
 
         Parameters
         ----------

reykit/rdll/__init__.py

@@ -9,9 +9,37 @@
 
 Modules
 -------
-rdll_inject_core : DLL file inject method code.
-rdll_inject : DLL file inject method.
+rdll_core : DLL file code methods.
 """
 
 
-from .rdll_inject import *
+from ctypes import create_string_buffer
+
+from .rdll_core import InjectDLL
+
+
+__all__ = (
+    'inject_dll',
+)
+
+
+def inject_dll(
+    id_: int,
+    path: str
+) -> None:
+    """
+    Inject DLL file.
+
+    Parameters
+    ----------
+    id_ : Process ID.
+    path : DLL file path.
+    """
+
+
+    # Get parameter.
+    path_bytes = path.encode()
+    buffer = create_string_buffer(path_bytes)
+
+    # Inject.
+    InjectDLL(id_, buffer)

reykit/rdll/{rdll_inject_core.py → rdll_core.py}

@@ -5,7 +5,7 @@
 @Time    : 2023-12-06 16:17:04
 @Author  : Rey
 @Contact : reyxbo@163.com
-@Explain : DLL file inject method code.
+@Explain : DLL file code methods.
 """
 
 

reykit/remail.py

@@ -15,19 +15,19 @@ from email.mime.text import MIMEText
 from email.mime.application import MIMEApplication
 
 from .rdata import unique
-from .rexception import throw
+from .rexc import throw
 from .ros import FileBytes, get_file_bytes
-from .rtype import RBase
+from .rtype import Base
 
 
 __all__ = (
-    'REmail',
+    'Email',
 )
 
 
-class REmail(RBase):
+class Email(Base):
     """
-    Rey's `email` type.
+    Email type.
     """
 
 
@@ -37,7 +37,7 @@ class REmail(RBase):
         password: str
     ) -> None:
         """
-        Build `email` instance attributes.
+        Build instance attributes.
 
         Parameters
         ----------
@@ -108,7 +108,7 @@ class REmail(RBase):
         show_cc: list[str] | None
     ) -> str:
         """
-        create email content.
+        Create email content.
 
         Parameters
         ----------

reykit/{rexception.py → rexc.py}

@@ -9,17 +9,6 @@
 """
 
 
-# !/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-@Time    : 2022-12-05 14:09:42
-@Author  : Rey
-@Contact : reyxbo@163.com
-@Explain : Interpreter system methods.
-"""
-
-
 from typing import Any, NoReturn, overload
 from types import TracebackType
 from collections.abc import Iterable
@@ -28,12 +17,12 @@ from os.path import exists as os_exists
 from traceback import format_exc
 from warnings import warn as warnings_warn
 
-from .rtype import Null
+from .rtype import Base, null
 
 
 __all__ = (
-    'RError',
-    'RActiveError',
+    'Error',
+    'ActiveError',
     'throw',
     'warn',
     'catch_exc',
@@ -45,21 +34,21 @@ __all__ = (
 )
 
 
-class RError(Exception):
+class Error(Base, Exception):
     """
-    Rey `error` type.
+    Error type.
     """
 
 
-class RActiveError(RError):
+class ActiveError(Error):
     """
-    Rey's `active error` type.
+    Active error type.
     """
 
 
 def throw(
     exception: type[BaseException] = AssertionError,
-    value: Any = Null,
+    value: Any = null,
     *values: Any,
     text: str | None = None,
     frame: int = 2
@@ -89,11 +78,11 @@ def throw(
             text = text[0].lower() + text[1:]
 
     ## Value.
-    if value != Null:
+    if value != null:
         values = (value,) + values
 
         ### Name.
-        from .rsystem import get_name
+        from .rsys import get_name
         name = get_name(value, frame)
         names = (name,)
         if values != ():
@@ -234,7 +223,7 @@ def check_least_one(*values: Any) -> None:
             return
 
     # Throw exception.
-    from .rsystem import get_name
+    from .rsys import get_name
     vars_name = get_name(values)
     if vars_name is not None:
         vars_name_de_dup = list(set(vars_name))
@@ -261,7 +250,7 @@ def check_most_one(*values: Any) -> None:
             if exist is True:
 
                 # Throw exception.
-                from .rsystem import get_name
+                from .rsys import get_name
                 vars_name = get_name(values)
                 if vars_name is not None:
                     vars_name_de_dup = list(set(vars_name))

reykit/rimage.py

@@ -16,19 +16,13 @@ from qrcode.image.pil import PilImage
 from PIL.Image import open as pil_open, LANCZOS
 from captcha.image import ImageCaptcha
 
-from .rexception import catch_exc
 from .rmonkey import monkey_path_pil_image_get_bytes
-from .ros import RFile
-from .rrandom import randchar
-
-try:
-    from pyzbar.pyzbar import decode as pyzbar_decode
-except:
-    *_, pyzbar_decode, _ = catch_exc()
+from .ros import File
+from .rrand import randchar
 
 
 __all__ = (
-    'RImage',
+    'Image',
     'encode_qrcode',
     'decode_qrcode',
     'compress_image',
@@ -39,7 +33,7 @@ __all__ = (
 
 # Monkey path.
 monkey_image_type = monkey_path_pil_image_get_bytes()
-RImage = monkey_image_type
+Image = monkey_image_type
 
 
 def encode_qrcode(text: str, path: str | None = None) -> bytes:
@@ -67,7 +61,7 @@ def encode_qrcode(text: str, path: str | None = None) -> bytes:
 
     # Save.
     if path is not None:
-        rfile = RFile(path)
+        rfile = File(path)
         rfile.write(file_bytes)
 
     return file_bytes
@@ -86,6 +80,9 @@ def decode_qrcode(image: str | bytes) -> list[str]:
     QR code or bar code text list.
     """
 
+    # Import.
+    from pyzbar.pyzbar import decode as pyzbar_decode
+
     # Check.
     if isinstance(pyzbar_decode, BaseException):
         raise pyzbar_decode
@@ -142,7 +139,7 @@ def compress_image(
 
     # Handle parameter.
     if type(input_image) == str:
-        rfile = RFile(input_image)
+        rfile = File(input_image)
         input_image = rfile.str
     now_size = len(input_image)
     if target_size < 1:
@@ -183,11 +180,11 @@ def compress_image(
 
     ## Save file and return path.
     else:
-        rfile = RFile(ouput_image)
+        rfile = File(ouput_image)
         rfile(content)
 
 
-def to_pil_image(source: str | bytes) -> RImage:
+def to_pil_image(source: str | bytes) -> Image:
     """
     Get `Image` instance of `PIL` package.
 
@@ -250,12 +247,12 @@ def generate_captcha_image(
     }
     default_kwargs.update(kwargs)
     icaptcha = ImageCaptcha(**default_kwargs)
-    image: RImage = icaptcha.generate_image(text)
+    image: Image = icaptcha.generate_image(text)
     file_bytes = image.get_bytes()
 
     # Save.
     if path is not None:
-        rfile = RFile(path)
+        rfile = File(path)
         rfile.write(file_bytes)
 
     return file_bytes

reykit/rlog.py

@@ -9,7 +9,6 @@
 """
 
 
-from __future__ import annotations
 from typing import Any, Literal, Final, overload
 from collections.abc import Callable
 from queue import Queue
@@ -30,36 +29,36 @@ from logging import (
 from logging.handlers import QueueHandler
 from concurrent_log_handler import ConcurrentRotatingFileHandler, ConcurrentTimedRotatingFileHandler
 
-from .rexception import throw, catch_exc
-from .ros import RFile
-from .rregex import search, sub
-from .rstdout import RConfigStdout, modify_print, reset_print
-from .rsystem import get_first_notnull, get_stack_param
+from .rexc import throw, catch_exc
+from .ros import File
+from .rre import search, sub
+from .rstdout import ConfigStdout, modify_print, reset_print
+from .rsys import get_first_notnull, get_stack_param
 from .rtext import to_text
 from .rtime import now, time_to
-from .rtype import RBase, RConfigMeta
+from .rtype import Base, ConfigMeta
 from .rwrap import wrap_thread
 
 
 __all__ = (
-    'RConfigLog',
-    'RLog',
-    'RRecord'
+    'ConfigLog',
+    'Log',
+    'Record'
 )
 
 
-class RConfigLog(object, metaclass=RConfigMeta):
+class ConfigLog(Base, metaclass=ConfigMeta):
     """
-    Rey's `config log` type.
+    Config log type.
     """
 
     # Module path.
     path_rlog: Final[str] = os_abspath(__file__)
 
 
-class RLog(object):
+class Log(Base):
     """
-    Rey's `log` type.
+    Log type.
     """
 
     # Status.
@@ -91,7 +90,7 @@ class RLog(object):
         name: str = 'Log'
     ) -> None:
         """
-        Build `log` instance attributes.
+        Build instance attributes.
 
         Parameters
         ----------
@@ -126,21 +125,21 @@ class RLog(object):
 
         ## Compatible '__call__'.
         if (
-            stack_param['filename'] == RConfigLog.path_rlog
+            stack_param['filename'] == ConfigLog.path_rlog
             and stack_param['name'] in ('debug', 'info', 'warning', 'error', 'critical')
         ):
             stack_param = stack_params[-2]
 
         ## Compatible 'print'.
         if (
-            stack_param['filename'] == RConfigLog.path_rlog
+            stack_param['filename'] == ConfigLog.path_rlog
             and stack_param['name'] == 'preprocess'
         ):
             stack_param = stack_params[-3]
 
         ## Compatible 'echo'.
         if (
-            stack_param['filename'] == RConfigStdout._path_rstdout
+            stack_param['filename'] == ConfigStdout._path_rstdout
             and stack_param['name'] == 'echo'
         ):
             stack_param = stack_params[-4]
@@ -348,7 +347,7 @@ class RLog(object):
     def get_filter(
         self,
         method: Callable[[LogRecord], bool]
-    ) -> Filter:
+    ):
         """
         Get filter.
 
@@ -363,9 +362,9 @@ class RLog(object):
 
 
         # Define.
-        class RFilter(Filter):
+        class _Filter(Base, Filter):
             """
-            Rey's filter type.
+            Filter type.
             """
 
 
@@ -390,7 +389,7 @@ class RLog(object):
                 return result
 
 
-        return RFilter
+        return _Filter
 
 
     def add_print(
@@ -939,9 +938,9 @@ class RLog(object):
     __call__ = log
 
 
-class RRecord(object):
+class Record(Base):
     """
-    Rey's `record` type.
+    Record type.
     """
 
 
@@ -950,7 +949,7 @@ class RRecord(object):
         path: str | None = '_rrecord'
     ) -> None:
         """
-        Build `record` instance attributes.
+        Build instance attributes.
 
         Parameters
         ----------
@@ -983,7 +982,7 @@ class RRecord(object):
 
         # To file.
         else:
-            rfile = RFile(self.path)
+            rfile = File(self.path)
 
             ## Convert.
             if type(value) != str:
@@ -1019,7 +1018,7 @@ class RRecord(object):
 
         # To file.
         else:
-            rfile = RFile(self.path)
+            rfile = File(self.path)
 
             ## Convert.
             if type(value) != str:

reykit/rmonkey.py

@@ -45,10 +45,9 @@ def monkey_patch_sqlalchemy_result_more_fetch():
     >>> result.empty
     """
 
-
+    # Import.
     from sqlalchemy.engine.cursor import CursorResult
     from pandas import DataFrame, NA, concat
-
     from .rstdout import echo
     from .rtable import (
         to_table,
@@ -63,7 +62,7 @@ def monkey_patch_sqlalchemy_result_more_fetch():
         to_excel
     )
     from .rtime import time_to
-
+    from .rtype import Base
 
     # Fetch result as table in 'list[dict]' format.
     CursorResult.fetch_table = to_table
@@ -97,7 +96,7 @@ def monkey_patch_sqlalchemy_result_more_fetch():
 
 
     # Print result.
-    def method_show(self: RResult, limit: int | None = None) -> None:
+    def method_show(self: Result, limit: int | None = None) -> None:
         """
         Print result.
 
@@ -151,7 +150,7 @@ def monkey_patch_sqlalchemy_result_more_fetch():
 
     # Whether is exist.
     @property
-    def method_exist(self: RResult) -> bool:
+    def method_exist(self: Result) -> bool:
         """
         Judge whether is exist row.
 
@@ -171,7 +170,7 @@ def monkey_patch_sqlalchemy_result_more_fetch():
 
     # Whether is empty.
     @property
-    def method_empty(self: RResult) -> bool:
+    def method_empty(self: Result) -> bool:
         """
         Judge whether is empty row.
 
@@ -190,7 +189,7 @@ def monkey_patch_sqlalchemy_result_more_fetch():
 
 
     # Update annotations.
-    class RResult(CursorResult):
+    class Result(Base, CursorResult):
         """
         Update based on `CursorResult` object, for annotation return value.
         """
@@ -214,7 +213,7 @@ def monkey_patch_sqlalchemy_result_more_fetch():
         empty = method_empty
 
 
-    return RResult
+    return Result
 
 
 def monkey_patch_sqlalchemy_row_index_field():
@@ -228,11 +227,10 @@ def monkey_patch_sqlalchemy_row_index_field():
     ...     row['field']
     """
 
-
+    # Import.
     from typing import Any, overload
     from sqlalchemy.engine.row import Row
 
-
     # Define.
     @overload
     def __getitem__(self, index: str | int) -> Any: ...
@@ -271,17 +269,15 @@ def monkey_patch_pprint_modify_width_judgment() -> None:
     Monkey patch of package `pprint`, modify the chinese width judgment.
     """
 
-
+    # Import.
     from pprint import PrettyPrinter, _recursion
 
 
-    # New method.
+    # Define.
     def _format(_self, obj, stream, indent, allowance, context, level):
 
-
         from .rtext import get_width
 
-
         objid = id(obj)
         if objid in context:
             stream.write(_recursion(obj))
@@ -325,9 +321,9 @@ def monkey_path_pil_image_get_bytes():
     >>> image.get_bytes()
     """
 
-
     from PIL.Image import Image
     from io import BytesIO
+    from reykit.rtype import Base
 
 
     # Define.
@@ -353,7 +349,7 @@ def monkey_path_pil_image_get_bytes():
 
 
     # Update annotations.
-    class RImage(Image):
+    class Image(Base, Image):
         """
         Update based on `Image` object, for annotation return value.
         """
@@ -365,4 +361,4 @@ def monkey_path_pil_image_get_bytes():
         get_bytes = method_get_bytes
 
 
-    return RImage
+    return Image