sotkalib 0.0.6.post1__tar.gz → 0.1.0b1__tar.gz

{sotkalib-0.0.6.post1 → sotkalib-0.1.0b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: sotkalib
-Version: 0.0.6.post1
+Version: 0.1.0b1
 Summary: 
 Author: alexey
 Author-email: alexey <me@pyrorhythm.dev>

{sotkalib-0.0.6.post1 → sotkalib-0.1.0b1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sotkalib"
-version = "0.0.6.post1"
+version = "0.1.0b1"
 description = ""
 authors = [
     { email = "me@pyrorhythm.dev", name = "alexey" }

sotkalib-0.1.0b1/src/sotkalib/__init__.py

@@ -0,0 +1,3 @@
+from . import config, enum, exceptions, http, log, redis, sqla, time, type
+
+__all__ = ["config", "enum", "exceptions", "http", "log", "redis", "sqla", "time", "type"]

sotkalib-0.1.0b1/src/sotkalib/dict/__init__.py

@@ -0,0 +1,13 @@
+from typing import Any
+
+from sotkalib.type import Unset
+
+
+def without_unset(d: dict[str, Any]) -> dict[str, Any]:
+	newd = {}
+	for k, v in d.items():
+		if v == Unset:
+			continue
+		newd[k] = v
+	return newd
+

sotkalib-0.1.0b1/src/sotkalib/enum/__init__.py

@@ -0,0 +1,3 @@
+from .mixins import UppercaseMixin, ValidatorMixin, ValuesMixin
+
+__all__ = ["ValidatorMixin", "UppercaseMixin", "ValuesMixin"]

{sotkalib-0.0.6.post1 → sotkalib-0.1.0b1}/src/sotkalib/enum/mixins.py

@@ -1,15 +1,15 @@
 from collections.abc import Sequence
-from enum import Enum
+from enum import StrEnum
 from typing import Any, Literal, Self, overload
 
 
-class UppercaseStrEnumMixin(str, Enum):
+class UppercaseMixin(StrEnum):
 	@staticmethod
 	def _generate_next_value_(name: str, start: int, count: int, last_values: Sequence) -> str:  # noqa
 		return name.upper()
 
 
-class ValidatorStrEnumMixin(str, Enum):
+class ValidatorMixin(StrEnum):
 	@classmethod
 	def _normalize_value(cls, val: Any) -> str:
 		if isinstance(val, (str, bytes, bytearray)):
@@ -57,3 +57,17 @@ class ValidatorStrEnumMixin(str, Enum):
 	@classmethod
 	def values(cls) -> Sequence[Self]:
 		return list(cls)
+
+
+class ValuesMixin:
+	@classmethod
+	def values_list(cls) -> list[str]:
+		return [v for k, v in vars(cls).items() if not k.startswith("_") and isinstance(v, str)]
+
+	@classmethod
+	def values_set(cls) -> set[str]:
+		return set(cls.values_list())
+
+	@classmethod
+	def names_list(cls) -> list[str]:
+		return [k for k, v in vars(cls).items() if not k.startswith("_") and isinstance(v, str)]

sotkalib-0.1.0b1/src/sotkalib/exceptions/__init__.py

@@ -0,0 +1,4 @@
+from . import api, handlers
+from .traceback import traceback_from
+
+__all__ = ["api", "handlers", "traceback_from"]

sotkalib-0.1.0b1/src/sotkalib/exceptions/traceback.py

@@ -0,0 +1,5 @@
+import traceback
+
+
+def traceback_from(exc: BaseException) -> str:
+	return "".join(traceback.format_exception(exc))

sotkalib-0.1.0b1/src/sotkalib/func/__init__.py

@@ -0,0 +1,6 @@
+from .concur import asyncfn, asyncfn_or_raise
+from .cond import or_raise, suppress, type_or_raise
+
+__all__ = [
+    "asyncfn", "asyncfn_or_raise", "or_raise", "type_or_raise", "suppress"
+]

sotkalib-0.1.0b1/src/sotkalib/func/concur.py

@@ -0,0 +1,12 @@
+import inspect
+from collections.abc import Callable
+from typing import Any
+
+
+def asyncfn(fn: Callable[..., Any]) -> bool:
+	return inspect.iscoroutinefunction(fn)
+
+
+def asyncfn_or_raise(fn: Callable[..., Any]) -> None:
+	if not inspect.iscoroutinefunction(fn):
+		raise TypeError(f"{fn} is not an async function")

sotkalib-0.1.0b1/src/sotkalib/func/cond.py

@@ -0,0 +1,40 @@
+from collections.abc import Generator, Sequence
+from contextlib import contextmanager
+from typing import Literal
+from warnings import warn
+
+
+@contextmanager
+def suppress(
+	mode: Literal["all", "exact"] = "all", excts: Sequence[type[BaseException]] | None = None
+) -> Generator[None]:
+	if excts is None:
+		if mode == "exact":
+			warn("mode = 'exact' and excts = None is passed to suppress, bubbling exception up")
+		exc_ts = ()
+	else:
+		exc_ts = excts
+
+	try:
+		yield None
+	except Exception as exc:
+		if mode == "all":
+			return
+
+		if mode == "exact" and type(exc) in exc_ts:
+			return
+
+		raise exc
+
+
+def or_raise[T](v: T | None, msg: str = "v is None") -> T:
+	if v is None:
+		raise ValueError(msg)
+
+	return v
+
+
+def type_or_raise[T](v: object, exp: type[T], msg: str | None = None) -> T:
+	if not isinstance(v, exp):
+		raise TypeError(msg or f"want {exp}, got {type(v)}")
+	return v

{sotkalib-0.0.6.post1 → sotkalib-0.1.0b1}/src/sotkalib/http/client_session.py

@@ -189,9 +189,9 @@ class ClientSettings(BaseModel):
 		for k, v in kws.items():
 			if "." in k:
 				pk, ck = k.split(".")
-				setattr(self, pk, setattr(getattr(self, pk), ck, v))
-
-			setattr(self, k, v)
+				setattr(getattr(self, pk), ck, v)
+			else:
+				setattr(self, k, v)
 
 		return self
 

sotkalib-0.1.0b1/src/sotkalib/sqla/__init__.py

@@ -0,0 +1,4 @@
+from .db import Database, DatabaseSettings
+from .dbm import BasicDBM
+
+__all__ = ("Database", "DatabaseSettings", "BasicDBM")

sotkalib-0.1.0b1/src/sotkalib/sqla/dbm.py

@@ -0,0 +1,20 @@
+from typing import Any
+
+from sqlalchemy import inspect
+from sqlalchemy.orm import DeclarativeBase
+
+
+class BasicDBM(DeclarativeBase):
+	__abstract__ = True
+	__table_args__ = {"extend_existing": True}
+
+	def dict(self, **kw) -> dict[str, Any]:
+		result = {field.name: getattr(self, field.name) for field in self.__table__.c}
+		if kw is not None:
+			result.update(kw)
+		return result
+
+	def attribute_loaded(self, key: str):
+		if key not in (k := {c.key for c in inspect(self).mapper.all_orm_descriptors}):  # type:ignore
+			raise KeyError(k)
+		return key not in inspect(self).unloaded

sotkalib-0.1.0b1/src/sotkalib/time/__init__.py

@@ -0,0 +1,10 @@
+from datetime import UTC, datetime, timezone
+
+__all__ = ["utcnow", "now"]
+
+def utcnow() -> datetime:
+	return datetime.now(UTC)
+
+
+def now(tz: timezone | None = None) -> datetime:
+	return datetime.now(tz)

sotkalib-0.1.0b1/src/sotkalib/type/__init__.py

@@ -0,0 +1,18 @@
+__all__ = ["Unset", "unset"]
+
+
+class _UnsetType:
+	__slots__ = ()
+
+	def __repr__(self) -> str:
+		return "Unset"
+
+	def __bool__(self) -> bool:
+		return False
+
+
+Unset = _UnsetType()
+
+
+def unset(val: object) -> bool:
+	return val is Unset

sotkalib-0.0.6.post1/src/sotkalib/__init__.py

@@ -1,3 +0,0 @@
-from . import config, enum, exceptions, http, log, redis, sqla
-
-__all__ = ["config", "enum", "exceptions", "http", "log", "redis", "sqla"]

sotkalib-0.0.6.post1/src/sotkalib/enum/__init__.py

@@ -1,3 +0,0 @@
-from .mixins import UppercaseStrEnumMixin, ValidatorStrEnumMixin
-
-__all__ = ["ValidatorStrEnumMixin", "UppercaseStrEnumMixin"]

sotkalib-0.0.6.post1/src/sotkalib/exceptions/__init__.py

@@ -1,3 +0,0 @@
-from . import api, handlers
-
-__all__ = ["api", "handlers"]

sotkalib-0.0.6.post1/src/sotkalib/exceptions/api/__init__.py

@@ -1 +0,0 @@
-from .exc import APIError, ErrorSchema

sotkalib-0.0.6.post1/src/sotkalib/sqla/__init__.py

@@ -1,3 +0,0 @@
-from .db import Database, DatabaseSettings
-
-__all__ = ("Database", "DatabaseSettings")