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

reykit/rdata.py

@@ -14,9 +14,7 @@ from collections import defaultdict as Defaultdict, ChainMap
 from collections.abc import Callable, Iterable, Generator
 from itertools import chain as IChain
 
-from .rexc import check_least_one, check_most_one
-from .rsys import is_iterable
-from .rtype import T, KT, VT, Base, null
+from .rbase import T, KT, VT, Base, null, check_least_one, check_most_one, is_iterable
 
 
 __all__ = (
@@ -134,10 +132,10 @@ def flatten(data: Any, *, _flattern_data: list | None = None) -> list:
 
 
 @overload
-def split(data: Iterable[T], share: int = None, bin_size: None = None) -> list[list[T]]: ...
+def split(data: Iterable[T], share: int) -> list[list[T]]: ...
 
 @overload
-def split(data: Iterable[T], share: None = None, bin_size: int = None) -> list[list[T]]: ...
+def split(data: Iterable[T], *, bin_size: int) -> list[list[T]]: ...
 
 def split(data: Iterable[T], share: int | None = None, bin_size: int | None = None) -> list[list[T]]:
     """

reykit/remail.py

@@ -14,10 +14,9 @@ from email.mime.multipart import MIMEMultipart
 from email.mime.text import MIMEText
 from email.mime.application import MIMEApplication
 
+from .rbase import Base, throw
 from .rdata import unique
-from .rexc import throw
 from .ros import FileBytes, get_file_bytes
-from .rtype import Base
 
 
 __all__ = (

reykit/rimage.py

@@ -32,8 +32,8 @@ __all__ = (
 
 
 # Monkey path.
-monkey_image_type = monkey_path_pil_image_get_bytes()
-Image = monkey_image_type
+Image_ = monkey_path_pil_image_get_bytes()
+Image = Image_
 
 
 def encode_qrcode(text: str, path: str | None = None) -> bytes:

reykit/rlog.py

@@ -29,14 +29,12 @@ from logging import (
 from logging.handlers import QueueHandler
 from concurrent_log_handler import ConcurrentRotatingFileHandler, ConcurrentTimedRotatingFileHandler
 
-from .rexc import throw, catch_exc
+from .rbase import Base, ConfigMeta, throw, catch_exc, get_first_notnone, get_stack_param
 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 Base, ConfigMeta
 from .rwrap import wrap_thread
 
 
@@ -421,7 +419,7 @@ class Log(Base):
         """
 
         # Get parameter.
-        format_ = get_first_notnull(format_, self.default_format, default='exception')
+        format_ = get_first_notnone(format_, self.default_format)
         filter_ = filter_ or self.get_default_filter_method(format_, 'print')
 
         # Create handler.
@@ -443,7 +441,7 @@ class Log(Base):
         self,
         path: str | None = None,
         mb: float | None = None,
-        time: None = None,
+        *,
         level: int = DEBUG,
         format_: str | None = None,
         filter_: Callable[[LogRecord], bool] | None = None
@@ -453,7 +451,7 @@ class Log(Base):
     def add_file(
         self,
         path: str | None = None,
-        mb: None = None,
+        *,
         time: float | Literal['m', 'w0', 'w1', 'w2', 'w3', 'w4', 'w5', 'w6'] = None,
         level: int = DEBUG,
         format_: str | None = None,
@@ -500,7 +498,7 @@ class Log(Base):
         """
 
         # Get parameter.
-        format_ = get_first_notnull(format_, self.default_format, default='exception')
+        format_ = get_first_notnone(format_, self.default_format)
         path = path or self.name
         filter_ = filter_ or self.get_default_filter_method(format_, 'file')
 

reykit/rmonkey.py

@@ -48,6 +48,7 @@ def monkey_patch_sqlalchemy_result_more_fetch():
     # Import.
     from sqlalchemy.engine.cursor import CursorResult
     from pandas import DataFrame, NA, concat
+    from .rbase import Base
     from .rstdout import echo
     from .rtable import (
         to_table,
@@ -62,7 +63,6 @@ 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
@@ -323,7 +323,7 @@ def monkey_path_pil_image_get_bytes():
 
     from PIL.Image import Image
     from io import BytesIO
-    from reykit.rtype import Base
+    from reykit.rbase import Base
 
 
     # Define.

reykit/rnet.py

@@ -30,10 +30,9 @@ from mimetypes import guess_type
 from filetype import guess as filetype_guess
 from datetime import datetime
 
-from .rexc import throw, check_response_code
+from .rbase import Base, throw, check_response_code
 from .ros import File
 from .rre import search
-from .rtype import Base
 
 
 __all__ = (

reykit/rnum.py

@@ -11,10 +11,11 @@
 
 from typing import Any
 
-from .rexc import throw
+from .rbase import throw
 
 
 __all__ = (
+    'is_int',
     'digits',
     'to_number',
     'number_ch'

reykit/ros.py

@@ -51,11 +51,10 @@ from docx.oxml.table import CT_Tbl
 from lxml.etree import ElementChildIterator
 from pdfplumber import open as pdfplumber_open
 
-from .rexc import throw
+from .rbase import Base, throw
 from .rre import search, sub
-from .rsys import dos_command
+from .rsys import run_cmd
 from .rtext import to_json
-from .rtype import Base
 
 
 __all__ = (
@@ -324,14 +323,14 @@ class File(Base):
     @overload
     def open(
         self,
-        mode: OpenTextMode = 'wb+'
-    ) -> TextIO: ...
+        mode: OpenBinaryMode = 'wb+'
+    ) -> BinaryIO: ...
 
     @overload
     def open(
         self,
-        mode: OpenBinaryMode = 'wb+'
-    ) -> BinaryIO: ...
+        mode: OpenTextMode
+    ) -> TextIO: ...
 
     def open(
         self,
@@ -368,22 +367,10 @@ class File(Base):
 
 
     @overload
-    def r(self) -> TextIO: ...
-
-    @overload
-    def w(self) -> TextIO: ...
+    def __getattr__(self, name: Literal['r', 'w', 'a']) -> TextIO: ...
 
     @overload
-    def a(self) -> TextIO: ...
-
-    @overload
-    def rb(self) -> BinaryIO: ...
-
-    @overload
-    def wb(self) -> BinaryIO: ...
-
-    @overload
-    def ab(self) -> BinaryIO: ...
+    def __getattr__(self, name: Literal['rb', 'wb', 'ab']) -> BinaryIO: ...
 
     def __getattr__(self, name: Literal['r', 'w', 'a', 'rb', 'wb', 'ab']) -> TextIO | BinaryIO:
         """
@@ -398,10 +385,14 @@ class File(Base):
         IO object.
         """
 
+        # Open.
         if name in ('r', 'w', 'a', 'rb', 'wb', 'ab'):
             io = self.open(name)
             return io
 
+        # Throw exception.
+        throw(AttributeError, name)
+
 
     @overload
     def read(
@@ -412,7 +403,7 @@ class File(Base):
     @overload
     def read(
         self,
-        type_: Literal['str'] = 'bytes'
+        type_: Literal['str']
     ) -> str: ...
 
     def read(
@@ -538,7 +529,7 @@ class File(Base):
         # Read only.
         except PermissionError:
             command = f'attrib -r "{self.path}"'
-            dos_command(command)
+            run_cmd(command)
             os_remove(self.path)
 
 
@@ -958,7 +949,8 @@ class Folder(Base):
         self,
         pattern: str,
         recursion: bool = False,
-        all_ : Literal[True] = False
+        *,
+        all_ : Literal[True]
     ) -> list[str]: ...
 
     def search(
@@ -966,7 +958,7 @@ class Folder(Base):
         pattern: str,
         recursion: bool = False,
         all_ : bool = False
-    ) -> str | None:
+    ) -> str | list[str] | None:
         """
         Search file by name.
 
@@ -1452,6 +1444,23 @@ class TempFile(Base):
         return file_md5
 
 
+    @property
+    def toml(self) -> dict[str, Any]:
+        """
+        Read and parse TOML file.
+        Treat nan as a None or null value.
+
+        Returns
+        -------
+        Parameter dictionary.
+        """
+
+        # Read and parse.
+        params = read_toml(self.path)
+
+        return params
+
+
     def __len__(self) -> int:
         """
         Return file byte size.
@@ -1614,7 +1623,8 @@ class TempFolder(Base):
         self,
         pattern: str,
         recursion: bool = False,
-        all_ : Literal[True] = False
+        *,
+        all_ : Literal[True]
     ) -> list[str]: ...
 
     def search(

reykit/rrand.py

@@ -19,9 +19,8 @@ from random import Random
 from secrets import randbelow as secrets_randbelow
 from threading import get_ident as threading_get_ident
 
-from .rexc import throw
+from .rbase import T, Base, ConfigMeta, throw
 from .rnum import digits
-from .rtype import T, Base, ConfigMeta
 
 
 __all__ = (
@@ -132,48 +131,24 @@ class RandomSeed(Base):
 
 
 @overload
-def randn(
-    *,
-    precision: None = None
-) -> int: ...
+def randn() -> int: ...
 
 @overload
-def randn(
-    high: int = 10,
-    *,
-    precision: None = None
-) -> int: ...
+def randn(high: int = 10) -> int: ...
 
 @overload
-def randn(
-    low: int = 0,
-    high: int = 10,
-    *,
-    precision: None = None
-) -> int: ...
+def randn(low: int = 0, high: int = 10) -> int: ...
 
 @overload
-def randn(
-    *thresholds: float,
-    precision: None = None
-) -> float: ...
+def randn(*thresholds: float) -> float: ...
 
 @overload
-def randn(
-    *thresholds: float,
-    precision: Literal[0] = None
-) -> int: ...
+def randn(*thresholds: float, precision: Literal[0]) -> int: ...
 
 @overload
-def randn(
-    *thresholds: float,
-    precision: int = None
-) -> float: ...
-
-def randn(
-    *thresholds: float,
-    precision: int | None = None
-) -> int | float:
+def randn(*thresholds: float, precision: int) -> float: ...
+
+def randn(*thresholds: float, precision: int | None = None) -> int | float:
     """
     Random number.
 
@@ -281,7 +256,7 @@ def randi(
 @overload
 def randi(
     data: Sequence,
-    multi: int = None,
+    multi: int,
     unique: bool = True
 ) -> list[T]: ...
 

reykit/rre.py

@@ -167,7 +167,7 @@ def search_batch(
 def search_batch(
     text: str,
     *patterns: str,
-    first: Literal[False] = True
+    first: Literal[False]
 ) -> list[str | tuple[str | None, ...] | None]: ...
 
 def search_batch(

reykit/rschedule.py

@@ -16,7 +16,7 @@ from apscheduler.schedulers.background import BackgroundScheduler
 from apscheduler.schedulers.blocking import BlockingScheduler
 from apscheduler.job import Job
 
-from .rtype import Base
+from .rbase import Base
 
 
 __all__ = (

reykit/rstdout.py

@@ -16,9 +16,8 @@ from io import TextIOWrapper
 from os import devnull as os_devnull
 from os.path import abspath as os_abspath
 
-from .rsys import get_first_notnull, get_name, get_stack_param
+from .rbase import Base, ConfigMeta, get_first_notnone, get_name, get_stack_param
 from .rtext import to_text, add_text_frame
-from .rtype import Base, ConfigMeta
 
 
 __all__ = (
@@ -112,7 +111,7 @@ def beautify_text(
         title = None
 
     ## Width.
-    width = get_first_notnull(width, ConfigStdout.default_width, default='exception')
+    width = get_first_notnone(width, ConfigStdout.default_width)
 
     ## Frame.
     if ConfigStdout.is_frame_plain: