tuttifrutti 0.1.0__tar.gz

tuttifrutti-0.1.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.3
+Name: tuttifrutti
+Version: 0.1.0
+Summary: A collection of tiny, reusable Python utilities.
+Author: Kunal Goel
+Author-email: Kunal Goel <hexcodex101@gmail.com>
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Maintainer: Kunal Goel
+Maintainer-email: Kunal Goel <hexcodex101@gmail.com>
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/kgcodex/tuttifrutti
+Project-URL: Documentation, https://github.com/kgcodex/tuttifrutti#readme
+Project-URL: Repository, https://github.com/kgcodex/tuttifrutti
+Project-URL: Issues, https://github.com/kgcodex/tuttifrutti/issues
+Description-Content-Type: text/markdown
+

tuttifrutti-0.1.0/pyproject.toml

@@ -0,0 +1,86 @@
+[project]
+name = "tuttifrutti"
+version = "0.1.0"
+description = "A collection of tiny, reusable Python utilities."
+readme = "README.md"
+authors = [
+    { name = "Kunal Goel", email = "hexcodex101@gmail.com" }
+]
+maintainers = [
+    { name = "Kunal Goel", email = "hexcodex101@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = []
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/kgcodex/tuttifrutti"
+Documentation = "https://github.com/kgcodex/tuttifrutti#readme"
+Repository = "https://github.com/kgcodex/tuttifrutti"
+Issues = "https://github.com/kgcodex/tuttifrutti/issues"
+
+[build-system]
+requires = ["uv_build>=0.11.8,<0.12.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.1.0",
+    "pre-commit>=4.6.0",
+    "pytest>=9.1.1",
+    "ruff>=0.15.20",
+]
+
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_any_generics = true
+check_untyped_defs = true
+
+mypy_path = "src"
+explicit_package_bases = true
+
+
+[[tool.mypy.overrides]]
+module = "pytest.*"
+ignore_missing_imports = true
+
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+    "N",
+    "ASYNC",
+    "PTH",
+]
+# ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
+force-single-line = false
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"

tuttifrutti-0.1.0/src/tuttifrutti/__init__.py

@@ -0,0 +1,17 @@
+from importlib import import_module
+from importlib.metadata import version
+from typing import TYPE_CHECKING, Any
+
+__version__ = version("tuttifrutti")
+
+if TYPE_CHECKING:
+    from ._optional_chain import OptionalChain
+
+__all__ = ["OptionalChain"]
+
+
+def __getattr__(name: str) -> Any:
+    if name == "OptionalChain":
+        return import_module("._optional_chain", __name__).OptionalChain
+
+    raise AttributeError(f"module '{__name__}' has not attribute {name}")

tuttifrutti-0.1.0/src/tuttifrutti/_optional_chain.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+from collections.abc import Callable
+from typing import Any
+
+
+class OptionalChain[T]:
+    def __init__(self, obj: T | None) -> None:
+        self._obj = obj
+
+    def __repr__(self) -> str:
+        return (
+            f"OptionalChain("
+            f"{self._obj.__class__.__name__ if self._obj is not None else None}"
+            f")"
+        )
+
+    def __getattr__(self, attr: str) -> OptionalChain[Any]:
+        if self._obj is None:
+            return OptionalChain(None)
+
+        if isinstance(self._obj, dict):
+            return OptionalChain(self._obj.get(attr, None))
+
+        return OptionalChain(getattr(self._obj, attr, None))
+
+    def get(self) -> T | None:
+        return self._obj
+
+    def __getitem__(self, key: Any) -> OptionalChain[Any]:
+        if self._obj is None:
+            return OptionalChain(None)
+        try:
+            return OptionalChain(self._obj[key])  # type:ignore[index]
+        except (KeyError, IndexError, TypeError):
+            return OptionalChain(None)
+
+    def or_else[K](self, default: K) -> T | K:
+        return self._obj if self._obj is not None else default
+
+    def map[R](self, func: Callable[[T], R]) -> OptionalChain[R]:
+        if self._obj is None:
+            return OptionalChain(None)
+        return OptionalChain(func(self._obj))