reykit 1.1.3__tar.gz

reykit-1.1.3/.gitignore

@@ -0,0 +1,2 @@
+__pycache__/
+/dist

reykit-1.1.3/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 ReyXBo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

reykit-1.1.3/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: reykit
+Version: 1.1.3
+Summary: Rey's kit method set.
+Project-URL: homepage, https://github.com/reyxbo/reykit/
+Author-email: Rey <reyxbo@163.com>
+License: Copyright 2025 ReyXBo
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+License-File: LICENSE
+Keywords: kit,rey,reyxbo,tool,tools
+Requires-Python: >=3.12
+Requires-Dist: aiohttp
+Requires-Dist: apscheduler
+Requires-Dist: captcha
+Requires-Dist: concurrent-log-handler
+Requires-Dist: filetype
+Requires-Dist: pandas
+Requires-Dist: pdfplumber
+Requires-Dist: pillow
+Requires-Dist: psutil
+Requires-Dist: pymem
+Requires-Dist: python-docx
+Requires-Dist: pyzbar
+Requires-Dist: qrcode
+Requires-Dist: requests
+Requires-Dist: tqdm
+Requires-Dist: urwid
+Requires-Dist: varname
+Description-Content-Type: text/markdown
+
+# reykit
+
+> Rey's kit method set.
+
+## Install
+
+```
+pip install reykit
+```

reykit-1.1.3/README.md

@@ -0,0 +1,9 @@
+# reykit
+
+> Rey's kit method set.
+
+## Install
+
+```
+pip install reykit
+```

reykit-1.1.3/pyproject.toml

@@ -0,0 +1,37 @@
+[project]
+name = "reykit"
+version = "1.1.3"
+description = "Rey's kit method set."
+readme = "README.md"
+requires-python = ">=3.12"
+license = {file = "LICENSE"}
+keywords = ["rey", "reyxbo", "kit", "tool", "tools"]
+authors = [
+    {name = "Rey", email = "reyxbo@163.com"}
+]
+dependencies = [
+    "aiohttp",
+    "apscheduler",
+    "captcha",
+    "concurrent-log-handler",
+    "filetype",
+    "pandas",
+    "pyzbar",
+    "pdfplumber",
+    "psutil",
+    "pymem",
+    "python-docx",
+    "qrcode",
+    "requests",
+    "tqdm",
+    "urwid",
+    "varname",
+    "Pillow"
+]
+
+[project.urls]
+homepage = "https://github.com/reyxbo/reykit/"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

reykit-1.1.3/src/reykit/__init__.py

@@ -0,0 +1,35 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2022-12-05 14:09:21
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : Rey's kit method set.
+
+Modules
+-------
+rall : All methods.
+rcomm : Network communication methods.
+rdata : Data methods.
+rdll : DLL file methods.
+remail : E-mail methods.
+rexception : Exception methods.
+rimage : Image methods.
+rlog : Log methods.
+rmonkey : Monkey patch methods.
+rmultitask : Multi task methods.
+rnumber : Number methods.
+ros: Operation system methods.
+rrandom : Random methods.
+rregex : Regular expression methods.
+rschedule : Schedule methods.
+rstdout : Standard output methods.
+rsystem : Interpreter system methods.
+rtable : Table methods.
+rtext : Text methods.
+rtime : Time methods.
+rtype : Type methods.
+rwrap : Decorators.
+rzip : File compress methods.
+"""

reykit-1.1.3/src/reykit/rall.py

@@ -0,0 +1,33 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2022-12-08 13:11:09
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : All methods.
+"""
+
+
+from .rcomm import *
+from .rdata import *
+from .rdll import *
+from .remail import *
+from .rexception import *
+from .rimage import *
+from .rlog import *
+from .rmonkey import *
+from .rmultitask import *
+from .rnumber import *
+from .ros import *
+from .rrandom import *
+from .rregex import *
+from .rschedule import *
+from .rstdout import *
+from .rsystem import *
+from .rtable import *
+from .rtext import *
+from .rtime import *
+from .rtype import *
+from .rwrap import *
+from .rzip import *

reykit-1.1.3/src/reykit/rcomm.py

@@ -0,0 +1,431 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2022-12-08 11:07:25
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : Network communication methods.
+"""
+
+
+from typing import Any, Literal
+from collections.abc import Callable, Iterable
+from warnings import filterwarnings
+from os.path import abspath as os_abspath, isfile as os_isfile
+from socket import socket as  Socket
+from urllib.parse import urlsplit as urllib_urlsplit, quote as urllib_quote, unquote as urllib_unquote
+from requests.api import request as requests_request
+from requests.models import Response
+from mimetypes import guess_type
+from filetype import guess as filetype_guess
+
+from .rexception import throw, check_response_code
+from .ros import RFile
+from .rregex import search
+
+
+__all__ = (
+    'join_url',
+    'split_url',
+    'join_cookie',
+    'split_cookie',
+    'get_content_type',
+    'request',
+    'download',
+    'get_file_stream_time',
+    'listen_socket'
+)
+
+
+def join_url(url: str, params: dict) -> str:
+    """
+    Join URL and parameters.
+
+    Parameters
+    ----------
+    url : URL.
+    params : Parameters of URL.
+
+    Returns
+    -------
+    Joined URL.
+    """
+
+    # Join parameter.
+    params_str = '&'.join(
+        [
+            f'{key}={urllib_quote(value)}'
+            for key, value in params.items()
+        ]
+    )
+
+    # Join URL.
+    if '?' not in url:
+        url += '?'
+    elif url[-1] != '?':
+        url += '&'
+    url += params_str
+
+    return url
+
+
+def split_url(url: str) -> tuple[str, dict[str, str]]:
+    """
+    Split URL and parameters.
+
+    Parameters
+    ----------
+    url : URL.
+
+    Returns
+    -------
+    Split URL and parameters.
+    """
+
+    # Split URL.
+    split_result = urllib_urlsplit(url)
+    params_str = split_result.query
+    url = split_result.scheme + '://' + split_result.netloc + split_result.path
+
+    # Split parameter.
+    params = {
+        key: urllib_unquote(value)
+        for key, value in map(
+            lambda item: item.split('=', 1),
+            params_str.split('&')
+        )
+    }
+
+    return url, params
+
+
+def join_cookie(params: dict[str, str]) -> str:
+    """
+    Join parameters of Cookie.
+
+    Parameters
+    ----------
+    params : Parameters.
+
+    Returns
+    -------
+    Joined cookie.
+    """
+
+    # Join.
+    cookie = '; '.join(
+        [
+            f'{key}={value}'
+            for key, value in params.items()
+        ]
+    )
+
+    return cookie
+
+
+def split_cookie(cookie: str) -> dict[str, str]:
+    """
+    Split parameters of Cookie.
+
+    Parameters
+    ----------
+    cookie : Cookie.
+
+    Returns
+    -------
+    Split parameters
+    """
+
+    # Split parameter.
+    params = {
+        key: value
+        for key, value in map(
+            lambda item: item.split('=', 1),
+            cookie.split('; ')
+        )
+    }
+
+    return params
+
+
+def get_content_type(file: str | bytes) -> str | None:
+    """
+    Get HTTP content type of file.
+
+    Parameters
+    ----------
+    file : File path or bytes data.
+
+    Returns
+    -------
+    HTTP content type.
+    """
+
+    # Guess.
+    if (
+        (
+            file.__class__ == str
+            and os_isfile(file)
+        ) or file.__class__ == bytes
+    ):
+        file_type_obj = filetype_guess(file)
+    else:
+        file_type_obj = None
+    if file_type_obj is not None:
+        file_type = file_type_obj.MIME
+    elif file.__class__ == str:
+        file_type, _ = guess_type(file)
+    else:
+        file_type = None
+
+    return file_type
+
+
+def request(
+    url: str,
+    params: dict | None = None,
+    data: dict | str | bytes | None = None,
+    json: dict | None = None,
+    files: dict[str, str | bytes | tuple[str | bytes, dict]] | None = None,
+    headers: dict[str, str] = {},
+    timeout: float | None = None,
+    proxies: dict[str, str] = {},
+    stream: bool = False,
+    verify: bool = False,
+    method: Literal['get', 'post', 'put', 'patch', 'delete', 'options', 'head'] | None = None,
+    check: bool | int | Iterable[int] = False
+) -> Response:
+    """
+    Send request.
+
+    Parameters
+    ----------
+    url : Request URL.
+    params : Request URL add parameters.
+    data : Request body data.
+        - `dict`, Convert to `key=value&...`: format bytes.
+            Automatic set `Content-Type` to `application/x-www-form-urlencoded`.
+        - `str`: File path to read file bytes data.
+            Automatic set `Content-Type` to file media type, and `filename` to file name.
+        - `bytes`: File bytes data.
+            Automatic set `Content-Type` to file media type.
+    json : Request body data, convert to `JSON` format.
+        Automatic set `Content-Type` to `application/json`.
+    files : Request body data, convert to `multi form` format.
+        Automatic set `Content-Type` to `multipart/form-data`.
+        - `dict[str, str]`: Parameter name and File path to read file bytes data.
+            Automatic set `Content-Type` to file media type, and `filename` to file name.
+        - `dict[str, bytes]`: Parameter name and file bytes data.
+        - `dict[str, tuple[str, dict]`: Parameter name and File path to read file bytes data and other parameters.
+            Automatic set `Content-Type` to file media type, and `filename` to file name.
+        - `dict[str, tuple[bytes, dict]`: Parameter name and file bytes data and other parameters.
+    headers : Request header data.
+    timeout : Request maximun waiting time.
+    proxies : Proxy IP setup.
+        - `None`: No setup.
+        - `dict[str, str]`: Name and use IP of each protocol.
+    stream : Whether use stream request.
+    verify : Whether verify certificate.
+    method : Request method.
+        - `None`: Automatic judge.
+            When parameter `data` or `json` or `files` not has value, then request method is `get`.
+            When parameter `data` or `json` or `files` has value, then request method is `post`.
+        - `Literal['get', 'post', 'put', 'patch', 'delete', 'options', 'head']`: Use this request method.
+    check : Check response code, and throw exception.
+        - `Literal[False]`: Not check.
+        - `Literal[True]`: Check if is between 200 and 299.
+        - `int`: Check if is this value.
+        - `Iterable`: Check if is in sequence.
+
+    Returns
+    -------
+    Response object of requests package.
+    """
+
+    # Handle parameter.
+    if method is None:
+        if data is None and json is None and files is None:
+            method = 'get'
+        else:
+            method = 'post'
+    if files is None:
+        if data.__class__ == str:
+            rfile = RFile(data)
+            data = rfile.bytes
+            if 'Content-Disposition' not in headers:
+                file_name = rfile.name_suffix
+                headers['Content-Disposition'] = f'attachment; filename={file_name}'
+        if data.__class__ == bytes:
+            if 'Content-Type' not in headers:
+                headers['Content-Type'] = get_content_type(data)
+    else:
+        for key, value in files.items():
+            if value.__class__ == tuple:
+                item_data, item_headers = value
+            else:
+                item_data, item_headers = value, {}
+            if item_data.__class__ == str:
+                rfile = RFile(item_data)
+                data = rfile.bytes
+                item_headers.setdefault('filename', rfile.name_suffix)
+            if item_data.__class__ == bytes:
+                if 'Content-Type' not in item_headers:
+                    item_headers['Content-Type'] = get_content_type(item_data)
+            files[key] = (
+                item_headers.get('filename', key),
+                item_data,
+                item_headers.get('Content-Type'),
+                item_headers
+            )
+    if not verify:
+        filterwarnings(
+            'ignore',
+            'Unverified HTTPS request is being made to host'
+        )
+
+    # Request.
+    response = requests_request(
+        method,
+        url,
+        params=params,
+        data=data,
+        json=json,
+        files=files,
+        headers=headers,
+        timeout=timeout,
+        proxies=proxies,
+        verify=verify,
+        stream=stream
+    )
+
+    # Set encod type.
+    if response.encoding == 'ISO-8859-1':
+        pattern = r'<meta [^>]*charset=([\w-]+)[^>]*>'
+        charset = search(pattern, response.text)
+        if charset is None:
+            charset = 'utf-8'
+        response.encoding = charset
+
+    # Check code.
+    if check is not False:
+        if check is True:
+            range_ = None
+        else:
+            range_ = check
+        check_response_code(response.status_code, range_)
+
+    return response
+
+
+def download(url: str, path: str | None = None) -> str:
+    """
+    Download file from URL.
+
+    Parameters
+    ----------
+    url : Download URL.
+    path : Save path.
+        - `None`, File name is `download`: and automatic judge file type.
+
+    Returns
+    -------
+    File absolute path.
+    """
+
+    # Download.
+    response = request(url)
+    content = response.content
+
+    # Judge file type and path.
+    if path is None:
+        Content_disposition = response.headers.get('Content-Disposition', '')
+        if 'filename' in Content_disposition:
+            file_name = search(
+                'filename=[\'"]?([^\\s\'"]+)',
+                Content_disposition
+            )
+        else:
+            file_name = None
+        if file_name is None:
+            file_type_obj = get_content_type(content)
+            if file_type_obj is not None:
+                file_name = 'download.' + file_type_obj.EXTENSION
+        if file_name is None:
+            file_name = 'download'
+        path = os_abspath(file_name)
+
+    # Save.
+    rfile = RFile(path)
+    rfile(content)
+
+    return path
+
+
+def get_file_stream_time(
+    file: str | bytes | int,
+    bandwidth: float
+) -> float:
+    """
+    Get file stream transfer time, unit second.
+
+    Parameters
+    ----------
+    file : File data.
+        - `str`: File path.
+        - `bytes`: File bytes data.
+        - `int`: File bytes size.
+    bandwidth : Bandwidth, unit Mpbs.
+
+    Returns
+    -------
+    File send seconds.
+    """
+
+    # Get parameter.
+    match file:
+        case str():
+            rfile = RFile(file)
+            file_size = rfile.size
+        case bytes() | bytearray():
+            file_size = len(file)
+        case int():
+            file_size = file
+        case _:
+            throw(TypeError, file)
+
+    # Calculate.
+    seconds = file_size / 125_000 / bandwidth
+
+    return seconds
+
+
+def listen_socket(
+    host: str,
+    port: str | int,
+    handler: Callable[[bytes], Any]
+) -> None:
+    """
+    Listen socket and handle data.
+
+    Parameters
+    ----------
+    host : Socket host.
+    port : Socket port.
+    handler : Handler function.
+    """
+
+    # Handle parameter.
+    port = int(port)
+    rece_size = 1024 * 1024 * 1024
+
+    # Instance.
+    socket = Socket()
+    socket.bind((host, port))
+    socket.listen()
+
+    # Loop.
+    while True:
+        socket_conn, _ = socket.accept()
+        data = socket_conn.recv(rece_size)
+        handler(data)