sotkalib 0.0.6.post1__py3-none-any.whl → 0.1.0b1__py3-none-any.whl

sotkalib/__init__.py

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

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/enum/__init__.py

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

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/exceptions/__init__.py

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

sotkalib/exceptions/traceback.py

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

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/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/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/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/sqla/__init__.py

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

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/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/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.dist-info → sotkalib-0.1.0b1.dist-info}/METADATA

@@ -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.1.0b1.dist-info/RECORD

@@ -0,0 +1,32 @@
+sotkalib/__init__.py,sha256=3gWJxBiPbbWpSXapHWDtJBzSww9pWPJz_FgrPDQg2r4,167
+sotkalib/config/__init__.py,sha256=_F7rSYgBsSxnNL1JtxrJYlw3lBXyVg0JdsOrxbWtcDA,96
+sotkalib/config/field.py,sha256=vbKGAEevEmdvyw4eaZprfR2g7ZVAB-5AbYPx0f4uusc,317
+sotkalib/config/struct.py,sha256=gv1jFrSRytMC6bZTUDOUQf00Zo1iKxQvuTxGv9qnyHI,5679
+sotkalib/dict/__init__.py,sha256=jfE3RATv6xrpEr5GJ8aJuTfCktKbccM661TlxkGlc1c,206
+sotkalib/enum/__init__.py,sha256=pxO9YipTLoKbXJTgWzCybbKm7dSvetgcQwSVOqvrq20,127
+sotkalib/enum/mixins.py,sha256=3_x3x8NgNluk2Rycp4BLiVO3dQ9jqbgd_ImqKkE7HzU,1980
+sotkalib/exceptions/__init__.py,sha256=jXqvK7RbP7Kw7mJt2bG9R9qDpVQmtivoN_0v0F9v3RQ,115
+sotkalib/exceptions/api.py,sha256=gqx4GrHXUvKcR7tEmJpRqPbDWOT2AgKoyck8-FovQCc,1329
+sotkalib/exceptions/handlers/__init__.py,sha256=Pz1akT2x3SaRsPezNPYnCoTcejxy4n4_cO4cXRJUBIk,179
+sotkalib/exceptions/handlers/args_incl_error.py,sha256=rYiBximsXVw1YDUBbdsqeqsfTWxshyX4EdISXWYkPDE,533
+sotkalib/exceptions/handlers/core.py,sha256=5fhusoxBhUz59TaVWobplBvD-sbkZKBnmmu-fcSyRk4,836
+sotkalib/exceptions/traceback.py,sha256=lIcYIgbJ3SBc9rp1ZJ0WOht5YZF_QNXIwmpxkAmVfM4,115
+sotkalib/func/__init__.py,sha256=j-18eXcSJ6RDqsJJE1i4rxJdbgpx-mEuJy9rY_xzLmE,187
+sotkalib/func/concur.py,sha256=J75_puWR61Bom3lGsMROvfuXfJNLoOxCmvwzHogtKbk,311
+sotkalib/func/cond.py,sha256=k53U74Ouc5N9iMknNxneZOsRITEyxMhwf-dIz6xV0AY,879
+sotkalib/http/__init__.py,sha256=xi4qStyHRgLufX_3ziSL5_-hDlbVLzA1Eg8JtjfHMz8,421
+sotkalib/http/client_session.py,sha256=u6rrxKhzewrNMUbBI0GJxI98NYXELjWcjjLqWUGpJJ8,12747
+sotkalib/log/__init__.py,sha256=xrBx--c8QU5xkb3_n61LuqF8ySUaxlQkHCxHyH_D8aE,58
+sotkalib/log/factory.py,sha256=BM8gTHoITCsS4b9JNGST4czpDql5mVTIPsESutO2OGQ,214
+sotkalib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sotkalib/redis/__init__.py,sha256=-0ZXD-cC-Xi6RmAvnrAgU-8Z6g4l88XmXf3kvIgBD9k,154
+sotkalib/redis/client.py,sha256=W13VOlPtEb9HuDomQ9Uz7Fh3iq94mBWX6EXOeRRYtiQ,1137
+sotkalib/redis/lock.py,sha256=nEZjIyXmgq3vH-Urs8qXC_N8lmXNho00SaTZ7wJIEIo,2528
+sotkalib/sqla/__init__.py,sha256=-mCvR5aGpCSWimPWnGhZfziRhKMo7s_WmgS1vNRuDNQ,125
+sotkalib/sqla/db.py,sha256=6ZckKQ8kmRlYrwCAzKidc_JNPwqp38tSGEy3XMGnv08,3376
+sotkalib/sqla/dbm.py,sha256=Cd_2jM-mB5G6RxSu9H0f8pkvIXEjS0zaxsJqivSu29o,580
+sotkalib/time/__init__.py,sha256=SIfMwGfbHGQNL0RqvUPGrXTsGKuiEk860ZpkyLmvUkk,203
+sotkalib/type/__init__.py,sha256=S94n-b5jU3TB5I9a8GIVanMKqlWtfUTTTch_87xYS-U,234
+sotkalib-0.1.0b1.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
+sotkalib-0.1.0b1.dist-info/METADATA,sha256=YEheXrjYWfL8UvqnJ-Qh_Lt-rAyUNdlZ87qxkelh6JA,388
+sotkalib-0.1.0b1.dist-info/RECORD,,

sotkalib/exceptions/api/__init__.py

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

sotkalib-0.0.6.post1.dist-info/RECORD

@@ -1,25 +0,0 @@
-sotkalib/__init__.py,sha256=TDJPQ_pOk73TTDkjgNpvn4nvn3siktb1sTogogLCwa0,139
-sotkalib/config/__init__.py,sha256=_F7rSYgBsSxnNL1JtxrJYlw3lBXyVg0JdsOrxbWtcDA,96
-sotkalib/config/field.py,sha256=vbKGAEevEmdvyw4eaZprfR2g7ZVAB-5AbYPx0f4uusc,317
-sotkalib/config/struct.py,sha256=gv1jFrSRytMC6bZTUDOUQf00Zo1iKxQvuTxGv9qnyHI,5679
-sotkalib/enum/__init__.py,sha256=pKpLPm8fqHO4Et21TWIybIPRiehN1KrmxcBh6hPRsxM,127
-sotkalib/enum/mixins.py,sha256=CQrgKftnmZSWkNb-56Z9PZ3um0_lHGEsnEYy9GwCmhM,1611
-sotkalib/exceptions/__init__.py,sha256=r-DwSwJIkuQ2UGAorKvkIVv87n4Yt8H0mk_uxKcBGTw,59
-sotkalib/exceptions/api/__init__.py,sha256=yTbg2p5mB0-8ZHtzlLL6e0ZkC3LRUZmjmWMxU9Uh8-Q,39
-sotkalib/exceptions/api/exc.py,sha256=gqx4GrHXUvKcR7tEmJpRqPbDWOT2AgKoyck8-FovQCc,1329
-sotkalib/exceptions/handlers/__init__.py,sha256=Pz1akT2x3SaRsPezNPYnCoTcejxy4n4_cO4cXRJUBIk,179
-sotkalib/exceptions/handlers/args_incl_error.py,sha256=rYiBximsXVw1YDUBbdsqeqsfTWxshyX4EdISXWYkPDE,533
-sotkalib/exceptions/handlers/core.py,sha256=5fhusoxBhUz59TaVWobplBvD-sbkZKBnmmu-fcSyRk4,836
-sotkalib/http/__init__.py,sha256=xi4qStyHRgLufX_3ziSL5_-hDlbVLzA1Eg8JtjfHMz8,421
-sotkalib/http/client_session.py,sha256=TOi_BwyYVgrvo4dmWzp6bcLwYyITV9C5ODx18uYTG_8,12757
-sotkalib/log/__init__.py,sha256=xrBx--c8QU5xkb3_n61LuqF8ySUaxlQkHCxHyH_D8aE,58
-sotkalib/log/factory.py,sha256=BM8gTHoITCsS4b9JNGST4czpDql5mVTIPsESutO2OGQ,214
-sotkalib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sotkalib/redis/__init__.py,sha256=-0ZXD-cC-Xi6RmAvnrAgU-8Z6g4l88XmXf3kvIgBD9k,154
-sotkalib/redis/client.py,sha256=W13VOlPtEb9HuDomQ9Uz7Fh3iq94mBWX6EXOeRRYtiQ,1137
-sotkalib/redis/lock.py,sha256=nEZjIyXmgq3vH-Urs8qXC_N8lmXNho00SaTZ7wJIEIo,2528
-sotkalib/sqla/__init__.py,sha256=n-I_hoRS-N7XN02yYCTtw6Dh4BBSQRmolS19tEB2KMM,87
-sotkalib/sqla/db.py,sha256=6ZckKQ8kmRlYrwCAzKidc_JNPwqp38tSGEy3XMGnv08,3376
-sotkalib-0.0.6.post1.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
-sotkalib-0.0.6.post1.dist-info/METADATA,sha256=2_4eonP0GVU1z9EAdmrzG_YM-lSeWuc6n41bcKYUd9U,392
-sotkalib-0.0.6.post1.dist-info/RECORD,,