audex 1.0.7a3__py3-none-any.whl

audex/helper/__init__.py

@@ -0,0 +1 @@
+from __future__ import annotations

audex/helper/hash.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import argon2
+
+argon2_hasher = argon2.PasswordHasher()
+
+
+def argon2_hash(v: str, /) -> str:
+    """Hash a string using Argon2.
+
+    Args:
+        v (str): The string to hash.
+
+    Returns:
+        str: The Argon2 hashed string.
+    """
+    return argon2_hasher.hash(v)
+
+
+def argon2_verify(v: str, /, hashed: str) -> bool:
+    """Verify a string against an Argon2 hash.
+
+    Args:
+        v (str): The string to verify.
+        hashed (str): The hashed string.
+
+    Returns:
+        bool: True if the string matches the hash, False otherwise.
+    """
+    try:
+        return argon2_hasher.verify(hashed, v)
+    except argon2.exceptions.VerifyMismatchError:
+        return False

audex/helper/mixin.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import inspect
+import types
+import typing as t
+
+import loguru
+
+
+class AsyncContextMixin:
+    async def init(self) -> None: ...
+    async def close(self) -> None: ...
+
+    async def __aenter__(self) -> t.Self:
+        await self.init()
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        traceback: types.TracebackType | None,
+    ) -> t.Literal[False]:
+        await self.close()
+        return False
+
+
+class ContextMixin:
+    def init(self) -> None: ...
+    def close(self) -> None: ...
+
+    def __enter__(self) -> t.Self:
+        self.init()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        traceback: types.TracebackType | None,
+    ) -> t.Literal[False]:
+        self.close()
+        return False
+
+
+class LifecycleMixin:
+    def start(self) -> None: ...
+    def stop(self) -> None: ...
+
+
+class AsyncLifecycleMixin:
+    async def start(self) -> None: ...
+    async def stop(self) -> None: ...
+
+
+class LoggingMixin:
+    __logtag__: t.ClassVar[str]
+
+    def __init_subclass__(cls, **kwargs: t.Any) -> None:
+        super().__init_subclass__(**kwargs)
+        if not inspect.isabstract(cls) and not getattr(cls, "__logtag__", None):
+            raise TypeError(f"{cls.__name__} must define __logtag__ class variable")
+
+    def __init__(self) -> None:
+        self.logger = loguru.logger.bind(tag=self.__logtag__)

audex/helper/net.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+import socket
+import typing as t
+
+
+def getaddr() -> str:
+    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    try:
+        s.connect(("8.8.8.8", 80))
+        return t.cast(str, s.getsockname()[0])
+    finally:
+        s.close()
+
+
+def getfreeport() -> int:
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        s.bind(("", 0))
+        return t.cast(int, s.getsockname()[1])