tensorneko-util 0.3.20__py3-none-any.whl → 0.3.22__py3-none-any.whl

tensorneko_util/io/audio/audio_writer.pyi

@@ -0,0 +1,29 @@
+from typing import overload, Union
+from pathlib import Path
+
+from .audio_data import AudioData
+from ...backend.audio_lib import AudioLib
+from ...util.type import T_ARRAY
+
+
+class AudioWriter:
+
+    @classmethod
+    @overload
+    def to(cls, path: Union[str, Path], audio: AudioData, channel_first: bool = True, backend: AudioLib = None
+    ) -> None: ...
+
+    @classmethod
+    @overload
+    def to(cls, path: Union[str, Path], audio: T_ARRAY, sample_rate: int = 16000, channel_first: bool = True,
+        backend: AudioLib = None
+    ): ...
+
+    @overload
+    def __new__(cls, path: Union[str, Path], audio: AudioData, channel_first: bool = True, backend: AudioLib = None
+    ) -> None: ...
+
+    @overload
+    def __new__(cls, path: Union[str, Path], audio: T_ARRAY, sample_rate: int = 16000, channel_first: bool = True,
+        backend: AudioLib = None
+    ): ...

tensorneko_util/io/video/video_reader.pyi

@@ -0,0 +1,38 @@
+from typing import Optional, overload, Union
+from pathlib import Path
+
+from numpy import ndarray
+
+from .video_data import VideoData
+from ...backend.visual_lib import VisualLib
+
+
+class VideoReader:
+
+    @classmethod
+    def of(cls, path: Union[str, Path], channel_first: bool = True, backend: Optional[VisualLib] = None) -> VideoData:
+        ...
+
+    @classmethod
+    def with_indexes(cls, path: Union[str, Path], indexes: ndarray,
+        channel_first: bool = True, backend: Optional[VisualLib] = None
+    ) -> VideoData:
+        ...
+
+    @classmethod
+    @overload
+    def with_range(cls, path: Union[str, Path], start: int, end: int, step: int, channel_first: bool = True,
+        backend: Optional[VisualLib] = None
+    ) -> VideoData:
+        ...
+
+    @classmethod
+    @overload
+    def with_range(cls, path: Union[str, Path], end: int, channel_first: bool = True,
+        backend: Optional[VisualLib] = None
+    ) -> VideoData:
+        ...
+
+    def __new__(cls, path: Union[str, Path], channel_first: bool = True, backend: Optional[VisualLib] = None
+    ) -> VideoData:
+        ...

tensorneko_util/io/video/video_writer.pyi

@@ -0,0 +1,33 @@
+from typing import overload, Optional, Union
+from pathlib import Path
+
+from .video_data import VideoData
+from ...backend.visual_lib import VisualLib
+from ...util.type import T_ARRAY
+
+
+class VideoWriter:
+
+    @classmethod
+    @overload
+    def to(cls, path: Union[str, Path], video: VideoData, audio_codec: str = None, channel_first: bool = False,
+        backend: VisualLib = None
+    ) -> None: ...
+
+    @classmethod
+    @overload
+    def to(cls, path: Union[str, Path], video: T_ARRAY, video_fps: float, audio: T_ARRAY = None,
+        audio_fps: Optional[int] = None, audio_codec: str = None, channel_first: bool = False,
+        backend: VisualLib = None
+    ) -> None: ...
+
+    @overload
+    def __new__(cls, path: Union[str, Path], video: VideoData, audio_codec: str = None, channel_first: bool = False,
+        backend: VisualLib = None
+    ) -> None: ...
+
+    @overload
+    def __new__(cls, path: Union[str, Path], video: T_ARRAY, video_fps: float, audio: T_ARRAY = None,
+        audio_fps: Optional[int] = None, audio_codec: str = None, channel_first: bool = False,
+        backend: VisualLib = None
+    ) -> None: ...

tensorneko_util/msg/__init__.py

@@ -1,3 +1,9 @@
-from .gotify import push_gotify
+from . import gotify
 
-__all__ = ["push_gotify"]
+__all__ = ["gotify"]
+
+try:
+    from . import postgres
+    __all__.append("postgres")
+except ImportError:
+    pass

tensorneko_util/msg/gotify.py

@@ -6,7 +6,7 @@ from typing import Optional
 from urllib.error import HTTPError
 
 
-def push_gotify(message: str, url: Optional[str] = None, token: Optional[str] = None, title: Optional[str] = None,
+def push(message: str, url: Optional[str] = None, token: Optional[str] = None, title: Optional[str] = None,
     priority: int = 0
 ):
     """
@@ -21,7 +21,7 @@ def push_gotify(message: str, url: Optional[str] = None, token: Optional[str] =
 
     Examples::
 
-        push_gotify("This is a test message", "<URL>", "<APP_TOKEN>")
+        push("This is a test message", "<URL>", "<APP_TOKEN>")
         # then the message will be sent to the Gotify server.
         # title = "<HOST_NAME>", message = "This is a test message", priority = 0
 

tensorneko_util/msg/postgres.py

@@ -0,0 +1,66 @@
+import os
+from typing import Any, List, Optional, Tuple
+
+import psycopg
+
+
+def execute(sql: str, db_url: Optional[str] = None) -> Optional[List[Tuple[Any, ...]]]:
+    """
+    Execute a PostgreSQL database SQL query.
+
+    Args:
+        sql (``str``): The SQL query to be executed.
+        db_url (``str``, optional): The URL of the PostgreSQL database. The default value is environment variable DB_URL.
+
+    Returns:
+        ``list[tuple] | None``: The result of the query. If the query is not a SELECT query, then it will return None.
+
+    Examples::
+
+        result = execute("SELECT * FROM table_name", "postgresql://user:password@localhost:5432/db_name")
+        # then the result will be a list of tuples.
+
+        execute("INSERT INTO table_name (column1, column2) VALUES (value1, value2)", "postgresql://user:password@localhost:5432/db_name")
+        # then the execute will be executed and committed.
+    """
+    db_url = db_url or os.environ.get("DB_URL")
+
+    with psycopg.Connection.connect(db_url) as conn:
+        with conn.cursor() as cur:
+            cur.execute(sql)
+            conn.commit()
+            if cur.description:
+                return cur.fetchall()
+            return None
+
+
+async def execute_async(sql: str, db_url: Optional[str] = None) -> Optional[List[Tuple[Any, ...]]]:
+    """
+    Execute a PostgreSQL database SQL query with async.
+
+    Args:
+        sql (``str``): The SQL query to be executed.
+        db_url (``str``, optional): The URL of the PostgreSQL database. The default value is environment variable DB_URL.
+
+    Returns:
+        ``list[tuple] | None``: The result of the query. If the query is not a SELECT query, then it will return None.
+
+    Examples::
+
+        result = await execute_async("SELECT * FROM table_name", "postgresql://user:password@localhost:5432/db_name")
+        # then the result will be a list of tuples.
+
+        await execute_async("INSERT INTO table_name (column1, column2) VALUES (value1, value2)")
+        # then the execute will be executed
+    """
+    db_url = db_url or os.environ.get("DB_URL")
+
+    if db_url is None:
+        raise ValueError("DB_URL environment variable is not set.")
+
+    async with await psycopg.AsyncConnection.connect(db_url, autocommit=True) as conn:
+        async with conn.cursor() as cur:
+            await cur.execute(sql)
+            if cur.description:
+                return await cur.fetchall()
+            return None

tensorneko_util/preprocess/crop.pyi

@@ -0,0 +1,15 @@
+from typing import overload, Union
+
+from numpy import ndarray
+
+
+@overload
+def crop_with_padding(image: ndarray, x1: int, x2: int, y1: int, y2: int, pad_value: Union[int, float] = 0.,
+    batch: bool = False
+) -> ndarray: ...
+
+
+@overload
+def crop_with_padding(image: ndarray, x1: ndarray, x2: ndarray, y1: ndarray, y2: ndarray,
+    pad_value: Union[int, float] = 0., batch: bool = False
+) -> ndarray: ...

tensorneko_util/util/dispatched_misc.pyi

@@ -0,0 +1,23 @@
+from typing import overload, List
+
+from numpy import ndarray
+
+
+@overload
+def sparse2binary(x: ndarray, length: int = None) -> ndarray:
+    ...
+
+
+@overload
+def sparse2binary(x: List[int], length: int = None) -> List[int]:
+    ...
+
+
+@overload
+def binary2sparse(x: ndarray) -> ndarray:
+    ...
+
+
+@overload
+def binary2sparse(x: List[int]) -> List[int]:
+    ...

tensorneko_util/util/ref.pyi

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from typing import Generic, overload
+
+from .type import P
+
+
+class Ref(Generic[P]):
+    value: P
+    @overload
+    def __new__(cls, value: str) -> StringRef: ...
+    @overload
+    def __new__(cls, value: int) -> IntRef: ...
+    @overload
+    def __new__(cls, value: float) -> FloatRef: ...
+    @overload
+    def __new__(cls, value: bool) -> BoolRef: ...
+
+class StringRef(Ref[str]):
+    def __str__(self) -> str: ...
+
+class IntRef(Ref[int]):
+    def __int__(self) -> int: ...
+
+class FloatRef(Ref[float]):
+    def __float__(self) -> float: ...
+
+class BoolRef(Ref[bool]):
+    def __bool__(self) -> bool: ...
+
+@overload
+def ref(value: str) -> StringRef: ...
+@overload
+def ref(value: int) -> IntRef: ...
+@overload
+def ref(value: float) -> FloatRef: ...
+@overload
+def ref(value: bool) -> BoolRef: ...

tensorneko_util/version.txt

@@ -1 +1 @@
-0.3.20
+0.3.22