reykit 1.0.1__py3-none-any.whl → 1.1.1__py3-none-any.whl

reykit/rmultitask.py

@@ -10,7 +10,7 @@
 
 
 from __future__ import annotations
-from typing import Any, Optional, Literal, Union
+from typing import Any, Literal
 from collections.abc import Callable, Iterable, Generator, Coroutine
 from threading import RLock as TRLock, get_ident as threading_get_ident
 from concurrent.futures import ThreadPoolExecutor, Future as CFuture, as_completed as concurrent_as_completed
@@ -78,15 +78,15 @@ def async_run(*coroutines: Coroutine) -> list:
 
 async def async_request(
     url: str,
-    params: Optional[dict] = None,
-    data: Optional[Union[dict, str, bytes]] = None,
-    json: Optional[dict] = None,
+    params: dict | None = None,
+    data: dict | str | bytes | None = None,
+    json: dict | None = None,
     headers: dict[str, str] = {},
-    timeout: Optional[float] = None,
-    proxy: Optional[str] = None,
-    method: Optional[Literal['get', 'post', 'put', 'patch', 'delete', 'options', 'head']] = None,
-    check: Union[bool, int, Iterable[int]] = False,
-    handler: Optional[Union[str, tuple[str], Callable[[ClientResponse], Union[Coroutine, Any]]]] = None
+    timeout: float | None = None,
+    proxy: str | None = None,
+    method: Literal['get', 'post', 'put', 'patch', 'delete', 'options', 'head'] | None = None,
+    check: bool | int | Iterable[int] = False,
+    handler: str | tuple[str] | Callable[[ClientResponse], Coroutine | Any] | None = None
 ) -> Any:
     """
     Get asynchronous `Coroutine` instance of send request.
@@ -119,7 +119,6 @@ async def async_request(
         - `Literal[True]`: Check if is between 200 and 299.
         - `int`: Check if is this value.
         - `Iterable`: Check if is in sequence.
-
     handler : Response handler.
         - `None`: Automatic handle.
             `Response 'Content-Type' is 'application/json'`: Use `ClientResponse.json` method.
@@ -247,7 +246,7 @@ class RThreadLock():
 
         # Set attribute.
         self.lock = TRLock()
-        self.acquire_thread_id: Optional[int] = None
+        self.acquire_thread_id: int | None = None
 
 
     def acquire(
@@ -372,7 +371,7 @@ class RThreadPool(object):
         self,
         task: Callable,
         *args: Any,
-        _max_workers: Optional[int] = None,
+        _max_workers: int | None = None,
         **kwargs: Any
     ) -> None:
         """
@@ -498,7 +497,7 @@ class RThreadPool(object):
 
     def generate(
         self,
-        timeout: Optional[float] = None
+        timeout: float | None = None
     ) -> Generator[CFuture]:
         """
         Return the generator of added task instance.
@@ -601,7 +600,7 @@ class RAsyncPool(object):
         async_func: Callable[..., Coroutine],
         *args: Any,
         _max_async: int = 10,
-        _exc_handler: Optional[Callable] = None,
+        _exc_handler: Callable | None = None,
         **kwargs: Any
     ) -> None:
         """
@@ -783,7 +782,7 @@ class RAsyncPool(object):
 
     def get(
         self,
-        timeout: Optional[float] = None
+        timeout: float | None = None
     ) -> Any:
         """
         Get one execution result of asynchronous `Coroutine`, will block.

reykit/rnumber.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, Union
+from typing import Any
 
 from .rexception import throw
 
@@ -21,7 +21,7 @@ __all__ = (
 )
 
 
-def digits(number: Union[int, float]) -> tuple[int, int]:
+def digits(number: int | float) -> tuple[int, int]:
     """
     Judge the number of integer digits and decimal digits.
 

reykit/ros.py

@@ -10,7 +10,7 @@
 
 
 from __future__ import annotations
-from typing import Any, Union, Literal, Optional, NoReturn, overload
+from typing import Any, Literal, NoReturn, overload
 from io import TextIOBase, BufferedIOBase
 from os import (
     walk as os_walk,
@@ -76,12 +76,12 @@ __all__ = (
 type FilePath = str
 type FileText = str
 type FileData = bytes
-type FileStr = Union[FilePath, FileText, TextIOBase]
-type FileBytes = Union[FilePath, FileData, BufferedIOBase]
-type File = Union[FileStr, FileBytes]
+type FileStr = FilePath | FileText | TextIOBase
+type FileBytes = FilePath | FileData | BufferedIOBase
+type File = FileStr | FileBytes
 
 
-def get_md5(file: Union[str, bytes]) -> str:
+def get_md5(file: str | bytes) -> str:
     """
     Get file MD5.
 
@@ -265,7 +265,7 @@ def get_file_bytes(file: FileBytes) -> bytes:
     return file_bytes
 
 
-def read_toml(path: Union[str, RFile]) -> dict[str, Any]:
+def read_toml(path: str | RFile) -> dict[str, Any]:
     """
     Read and parse TOML file.
     Treat nan as a None or null value.
@@ -338,7 +338,7 @@ class RFile(object):
     def read(
         self,
         type_: Literal['str', 'bytes'] = 'bytes'
-    ) -> Union[bytes, str]:
+    ) -> bytes | str:
         """
         Read file data.
 
@@ -371,7 +371,7 @@ class RFile(object):
 
     def write(
         self,
-        data: Optional[Any] = '',
+        data: Any | None = '',
         append: bool = False
     ) -> None:
         """
@@ -735,7 +735,7 @@ class RFile(object):
 
     def __contains__(
         self,
-        value: Union[str, bytes]
+        value: str | bytes
     ) -> bool:
         """
         Judge if file text contain value.
@@ -775,7 +775,7 @@ class RFolder(object):
 
     def __init__(
         self,
-        path: Optional[str] = None
+        path: str | None = None
     ) -> None:
         """
         Build `folder` attributes.
@@ -873,7 +873,7 @@ class RFolder(object):
         pattern: str,
         recursion: bool = False,
         all_ : Literal[False] = False
-    ) -> Optional[str]: ...
+    ) -> str | None: ...
 
     @overload
     def search(
@@ -888,7 +888,7 @@ class RFolder(object):
         pattern: str,
         recursion: bool = False,
         all_ : bool = False
-    ) -> Optional[str]:
+    ) -> str | None:
         """
         Search file by name.
 
@@ -1149,8 +1149,8 @@ class RTempFile(object):
 
     def __init__(
         self,
-        dir_: Optional[str] = None,
-        suffix: Optional[str] = None,
+        dir_: str | None = None,
+        suffix: str | None = None,
         type_: Literal['str', 'bytes'] = 'bytes'
     ) -> None:
         """
@@ -1181,7 +1181,7 @@ class RTempFile(object):
         self.path = self.file.name
 
 
-    def read(self) -> Union[bytes, str]:
+    def read(self) -> bytes | str:
         """
         Read file data.
 
@@ -1199,7 +1199,7 @@ class RTempFile(object):
 
     def write(
         self,
-        data: Union[str, bytes]
+        data: str | bytes
     ) -> None:
         """
         Write file data.
@@ -1391,7 +1391,7 @@ class RTempFile(object):
 
     def __contains__(
         self,
-        value: Union[str, bytes]
+        value: str | bytes
     ) -> bool:
         """
         Judge if file text contain value.
@@ -1434,7 +1434,7 @@ class RTempFolder(object):
 
     def __init__(
         self,
-        dir_: Optional[str] = None
+        dir_: str | None = None
     ) -> None:
         """
         Build `temporary folder` attributes.
@@ -1529,7 +1529,7 @@ class RTempFolder(object):
         pattern: str,
         recursion: bool = False,
         all_ : Literal[False] = False
-    ) -> Optional[str]: ...
+    ) -> str | None: ...
 
     @overload
     def search(
@@ -1544,7 +1544,7 @@ class RTempFolder(object):
         pattern: str,
         recursion: bool = False,
         all_ : bool = False
-    ) -> Optional[str]:
+    ) -> str | None:
         """
         Search file by name.
 
@@ -1762,7 +1762,7 @@ class RTempFolder(object):
 
 def doc_to_docx(
     path: str,
-    save_path: Optional[str] = None
+    save_path: str | None = None
 ) -> str:
     """
     Convert `DOC` file to `DOCX` file.

reykit/rrandom.py

@@ -10,7 +10,7 @@
 
 
 from __future__ import annotations
-from typing import Dict, Union, Optional, Literal, Self, overload
+from typing import 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):
@@ -64,7 +64,7 @@ class RRandomSeed(object):
     """
 
 
-    def __init__(self, seed: Optional[Union[int, float, str, bytes, bytearray]] = None) -> None:
+    def __init__(self, seed: int | float | str | bytes | bytearray | None = None) -> None:
         """
         Build `random` attributes.
 
@@ -72,7 +72,7 @@ class RRandomSeed(object):
         ----------
         seed : Random seed.
             - `None`: Clear seed.
-            - `Union[int, float, str, bytes, bytearray]` : Set seed.
+            - `int | float | str | bytes | bytearray` : Set seed.
         """
 
         # Delete.
@@ -114,9 +114,9 @@ class RRandomSeed(object):
 
     def __exit__(
         self,
-        exc_type: Optional[type[BaseException]],
-        exc_instance: Optional[BaseException],
-        exc_traceback: Optional[TracebackType]
+        exc_type: type[BaseException] | None,
+        exc_instance: BaseException | None,
+        exc_traceback: TracebackType | None
     ) -> None:
         """
         Exit syntax `with`.
@@ -158,8 +158,8 @@ def randn(
 
 def randn(
     *thresholds: float,
-    precision: Optional[int] = None
-) -> Union[int, float]:
+    precision: int | None = None
+) -> int | float:
     """
     Random number.
 
@@ -273,9 +273,9 @@ def randi(
 
 def randi(
     data: Sequence,
-    multi: Optional[int] = None,
+    multi: int | None = None,
     unique: bool = True
-) -> Union[Element, list[Element]]:
+) -> Element | list[Element]:
     """
     Random index data element.
 

reykit/rregex.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Optional, Union, Literal, overload
+from typing import Literal, overload
 from collections.abc import Callable
 from re import (
     search as re_search,
@@ -38,7 +38,7 @@ __all__ = (
 def search(
     pattern: str,
     text: str
-) -> Optional[Union[str, tuple[Optional[str], ...]]]:
+) -> str | tuple[str | None, ...] | None:
     """
     Regular search text.
 
@@ -73,7 +73,7 @@ def search(
 def findall(
     pattern: str,
     text: str,
-) -> Union[list[str], list[tuple[str, ...]]]:
+) -> list[str] | list[tuple[str, ...]]:
     """
     Regular find all text.
 
@@ -96,8 +96,8 @@ def findall(
 def sub(
     pattern: str,
     text: str,
-    replace: Optional[Union[str, Callable[[RMatch], str]]] = None,
-    count: Optional[int] = None
+    replace: str | Callable[[RMatch], str] | None = None,
+    count: int | None = None
 ) -> str:
     """
     Regular replace text.
@@ -130,7 +130,7 @@ def sub(
 def split(
     pattern: str,
     text: str,
-    count: Optional[int] = None
+    count: int | None = None
 ) -> list[str]:
     """
     Regular split text.
@@ -161,23 +161,20 @@ def search_batch(
     text: str,
     *patterns: str,
     first: Literal[True] = True
-) -> Optional[Union[str, tuple[Optional[str], ...]]]: ...
+) -> str | tuple[str | None, ...] | None: ...
 
 @overload
 def search_batch(
     text: str,
     *patterns: str,
     first: Literal[False] = True
-) -> list[Optional[Union[str, tuple[Optional[str], ...]]]]: ...
+) -> list[str | tuple[str | None, ...] | None]: ...
 
 def search_batch(
     text: str,
     *patterns: str,
     first: bool = True
-) -> Union[
-    Optional[Union[str, tuple[Optional[str], ...]]],
-    list[Optional[Union[str, tuple[Optional[str], ...]]]]
-]:
+) -> str | tuple[str | None, ...] | list[str | tuple[str | None, ...] | None] | None:
     """
     Batch regular search text.
 
@@ -237,7 +234,7 @@ def findall_batch(text: str, *patterns: str) -> str:
     return texts
 
 
-def sub_batch(text: str, *patterns: Union[str, tuple[str, Union[str, Callable[[RMatch], str]]]]) -> str:
+def sub_batch(text: str, *patterns: str | tuple[str, str | Callable[[RMatch], str]]) -> str:
     """
     Batch regular replace text.
 

reykit/rschedule.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, Literal, Union, Optional
+from typing import Any, Literal
 from collections.abc import Callable
 from apscheduler.executors.pool import ThreadPoolExecutor
 from apscheduler.schedulers.background import BackgroundScheduler
@@ -123,8 +123,8 @@ class RSchedule(object):
         self,
         func: Callable,
         trigger: Literal['date', 'interval', 'cron'] = 'date',
-        args: Optional[tuple] = None,
-        kwargs: Optional[dict] = None,
+        args: tuple | None = None,
+        kwargs: dict | None = None,
         **trigger_kwargs: Any
     ) -> Job:
         """
@@ -157,10 +157,10 @@ class RSchedule(object):
 
     def modify_task(
         self,
-        task: Union[Job, str],
-        trigger: Optional[Literal['date', 'interval', 'cron']] = None,
-        args: Optional[tuple] = None,
-        kwargs: Optional[dict] = None,
+        task: Job | str,
+        trigger: Literal['date', 'interval', 'cron'] | None = None,
+        args: tuple | None = None,
+        kwargs: dict | None = None,
         **trigger_kwargs: Any
     ) -> None:
         """
@@ -205,7 +205,7 @@ class RSchedule(object):
 
     def remove_task(
         self,
-        task: Union[Job, str]
+        task: Job | str
     ) -> None:
         """
         Remove task.
@@ -227,7 +227,7 @@ class RSchedule(object):
 
     def pause_task(
         self,
-        task: Union[Job, str]   
+        task: Job | str   
     ) -> None:
         """
         Pause task.
@@ -249,7 +249,7 @@ class RSchedule(object):
 
     def resume_task(
         self,
-        task: Union[Job, str]
+        task: Job | str
     ) -> None:
         """
         Resume task.

reykit/rstdout.py

@@ -9,7 +9,7 @@
 """
 
 
-from typing import Any, Literal, Optional, Union, Final, Self
+from typing import Any, Literal, Final, Self
 from collections.abc import Callable
 import sys
 from io import TextIOWrapper
@@ -60,9 +60,9 @@ class RConfigStdout(object, metaclass=RConfigMeta):
 
 def beautify_text(
     data: tuple[Any],
-    title: Union[bool, str] = True,
-    width: Optional[int] = None,
-    frame: Optional[Literal['full', 'half', 'top', 'half_plain', 'top_plain']] = 'full'
+    title: bool | str = True,
+    width: int | None = None,
+    frame: Literal['full', 'half', 'top', 'half_plain', 'top_plain'] | None = 'full'
 ) -> str:
     """
     Beautify data to text.
@@ -132,9 +132,9 @@ def beautify_text(
 
 def echo(
     *data: Any,
-    title: Union[bool, str] = True,
-    width: Optional[int] = None,
-    frame: Optional[Literal['full', 'half', 'top', 'half_plain', 'top_plain']] = 'full'
+    title: bool | str = True,
+    width: int | None = None,
+    frame: Literal['full', 'half', 'top', 'half_plain', 'top_plain'] | None = 'full'
 ) -> str:
     """
     Beautify data to text, and print.
@@ -176,10 +176,10 @@ def echo(
 
 def rinput(
     *data: Any,
-    title: Union[bool, str] = True,
-    width: Optional[int] = None,
-    frame: Optional[Literal['full', 'half', 'top', 'half_plain', 'top_plain']] = 'full',
-    extra: Optional[str] = None
+    title: bool | str = True,
+    width: int | None = None,
+    frame: Literal['full', 'half', 'top', 'half_plain', 'top_plain'] | None = 'full',
+    extra: str | None = None
 ) -> str:
     """
     Beautify data to text, and print data, and read string from standard input.
@@ -251,7 +251,7 @@ def start_print() -> None:
     RConfigStdout._stoped = False
 
 
-def modify_print(preprocess: Callable[[str], Optional[str]]) -> None:
+def modify_print(preprocess: Callable[[str], str] | None) -> None:
     """
     Modify standard output print write method.
 
@@ -264,7 +264,7 @@ def modify_print(preprocess: Callable[[str], Optional[str]]) -> None:
 
 
     # Define.
-    def write(__s: str) -> Optional[int]:
+    def write(__s: str) -> int | None:
         """
         Modified standard output write method.