stlib-ext 0.1.0__py3-none-any.whl

morefunctools/__init__.py

@@ -0,0 +1,17 @@
+from typing import Any
+import warnings
+
+def importDefaults(module) -> dict[str, Any]:
+    if not hasattr(module, "__defaults__"):
+        return {}
+    vals = {}
+    for obj in module.__defaults__:
+        if obj.__name__ in globals().keys():
+            warnings.warn(f"Warning: importDefaults may overwrite globals()[{repr(obj.__name__)}]")
+        vals[obj.__name__] = obj
+    return vals
+
+from . import cache
+from . import pyexperimental as exp
+
+globals().update(importDefaults(exp))

morefunctools/cache.py

@@ -0,0 +1,59 @@
+import math
+from functools import lru_cache
+from functools import wraps
+from typing import Optional, Any
+from collections.abc import Callable
+from moretyping.visualise import VisLink
+from .pyexperimental import experimental
+
+type MaxSize = int | bool
+
+class CacheInfo:
+    def __init__(self, hits: int, misses: int, maxsize: MaxSize, currsize: int) -> None:
+        self.hits = hits
+        self.misses = misses
+        self.maxsize = maxsize
+        self.currsize = currsize
+        self.locked = False
+
+    def lock(self) -> None:
+        self.locked = True
+
+    def __setattr__(self, name, value):
+        if self.locked == False:
+            self.__dict__[name] = value
+        else:
+            raise RuntimeError("Attempted to modify immutable object: CacheInfo")
+
+# TODO: Implement cache_clear()
+# TODO: Implement cache_info()
+# TODO: Implement cache_entries()
+@experimental
+def fifo_cache(maxsize: Optional[MaxSize]) -> Callable[[Callable], Callable]:
+    if isinstance(maxsize, bool):
+        maxsize = math.inf if maxsize else 0
+
+    def decorator(function: Callable):
+        cache = {}
+        cacheList = []  # TODO: Switch to deque
+
+        @wraps(function)
+        def wrapper(*args, **kwargs) -> Any:
+            key = VisLink((tuple(args), tuple(kwargs.items()))).string
+            if key in set(cache.keys()):  # TODO: Remove set()
+                return cache.get(key)
+            
+            value = function(*args, **kwargs)
+            cacheList.append(key)
+            cache[key] = value
+
+            if len(cacheList) > maxsize:
+                removalKey = cacheList.pop(0)
+                cache.pop(removalKey)
+                print(f"Removing key: {removalKey}")  # TODO: Remove debug print statements
+
+            return value
+
+        return wrapper
+    
+    return decorator

morefunctools/pyexperimental.py

@@ -0,0 +1,48 @@
+from functools import wraps
+from collections.abc import Callable
+from typing import Any, Optional, overload
+import warnings
+
+class ExperimentalWarning(Warning):
+    def __init__(self, message: str) -> None:
+        self.msg = message
+        super().__init__(message)
+
+@overload
+def experimental(message: Optional[str] = None, category: type[Warning] = ExperimentalWarning, stacklevel: int = 2) -> Callable[[Callable], Callable]:
+    ...
+
+@overload
+def experimental(fn: Callable) -> Callable:
+    ...
+
+# TODO: Clean up a little
+def experimental(message: Optional[str] | Callable = None, category: type[Warning] = ExperimentalWarning, stacklevel: int = 2) -> Callable:
+    newMessage = None if callable(message) else message
+    if callable(message):
+        fn = message
+        message = None
+        
+        @wraps(fn)
+        def wrapper(*args, **kwargs) -> Any:
+            warnings.warn(newMessage or f"Function {'{'}{fn.__name__}{'}'} is experimental. Expect bugs or incomplete behaviour.", category = category, stacklevel = stacklevel)
+            return fn(*args, **kwargs)
+        
+        return wrapper
+
+    def decorator(fn: Callable) -> Callable:
+        @wraps(fn)
+        def wrapper(*args, **kwargs) -> Any:
+            warnings.warn(newMessage or f"Function {'{'}{fn.__name__}{'}'} is experimental. Expect bugs or incomplete behaviour.", category = category, stacklevel = stacklevel)
+            return fn(*args, **kwargs)
+        return wrapper
+
+    return decorator
+
+@experimental
+def test():
+    ...
+
+__defaults__ = (
+    experimental,
+)

moretyping/__init__.py

@@ -0,0 +1,4 @@
+from . import data
+
+from . import visualise
+vis = visualise

moretyping/data/__init__.py

@@ -0,0 +1 @@
+from .number import Number

moretyping/data/_meta_process.py

@@ -0,0 +1,35 @@
+from typing import Any
+
+class ProcessMeta(type):
+    __output_classes__: tuple[type, ...]
+
+    def __new__(mcls, name: str, bases: tuple[type, ...], namespace: dict[str, Any], *, output_classes: tuple[type, ...], **kwargs: Any) -> type:
+        oldnew = namespace["__new__"]
+
+        def __new__(cls: type, *args: Any, **kwargs: Any) -> Any:
+            value = oldnew(cls, *args, **kwargs)
+        
+            for t in output_classes:
+                if isinstance(value, t):
+                    break
+            else:
+                raise TypeError(f"Data processor `{name}` returned a value of type {type(value)} -- not one of {output_classes}")
+            
+            return value
+        
+        def __init__(self: Any, *_: Any, **__: Any) -> None:
+            raise RuntimeError(f"Attempted to initialise instance of {type(self)} (data processor). Invalid operation.")
+        
+        namespace["__init__"] = __init__
+        namespace["__new__"] = __new__
+        namespace["__output_classes__"] = output_classes
+
+        cls = super().__new__(mcls, name, bases, namespace, **kwargs)
+        return cls
+    
+    def __instancecheck__(cls: "ProcessMeta", instance: object) -> bool:
+        for t in cls.__output_classes__:
+            if isinstance(instance, t):
+                return True
+                
+        return False

moretyping/data/number.py

@@ -0,0 +1,27 @@
+from typing import Any
+from ._meta_process import ProcessMeta
+
+type Numeric = int | float
+
+class Number(metaclass=ProcessMeta, output_classes=(int, float)):
+    """
+    Convert an object of unknown type to a Numeric (`int|float`) value.
+
+    Args:
+        value: Numeric | Any — The value to cast to a Numeric type.
+
+    Returns:
+        Numeric — The value cast to a Numeric type.
+
+    Raises:
+        ValueError: If the value can't be cast to a numeric type.
+
+    Details:
+        If the value is an integer, return it unchanged.
+
+        Otherwise, return `float(value)`
+    """
+    def __new__(cls, value: Numeric | Any) -> int | float:  # type: ignore[misc]
+        if isinstance(value, int):
+            return value
+        return float(value)

moretyping/visualise/__init__.py

@@ -0,0 +1,2 @@
+from .lists import *
+from .other import *

moretyping/visualise/lists/__init__.py

@@ -0,0 +1 @@
+from .link import VisLink

moretyping/visualise/lists/link.py

@@ -0,0 +1,16 @@
+from ..shared import VisualiseMeta
+from typing import Any
+from functools import cached_property
+from collections.abc import Iterable
+
+class VisLink(metaclass=VisualiseMeta):
+    def __init__(self, data: list[Any]) -> None:
+        self.data = tuple(data)
+
+    @cached_property
+    def strdata(self) -> Iterable[str]:
+        return map(lambda x: str(x), self.data)
+
+    @cached_property
+    def string(self) -> str:
+        return f"[ {" > ".join(self.strdata)} ]"

moretyping/visualise/other/__init__.py

@@ -0,0 +1 @@
+from .showjson import ViewJSON

moretyping/visualise/other/showjson.py

@@ -0,0 +1,12 @@
+from ..shared import VisualiseMeta
+from functools import cached_property
+from typing import Any, Optional
+import json
+
+class ViewJSON(metaclass=VisualiseMeta):
+    def __init__(self, data: Optional[Any] = {}) -> None:
+        self.data = data
+
+    @cached_property
+    def string(self) -> str:
+        return json.dumps(self.data, indent = 4)

moretyping/visualise/shared.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from typing import Any
+
+class VisualiseMeta(type):
+    def __new__(mcls: type[VisualiseMeta], name: str, bases: tuple[type, ...], namespace: dict[str, Any]) -> "VisualiseMeta":
+        def __repr__(self: Any) -> str:
+            return f"<{type(self).__name__} object> {self.__str__()}"
+        
+        def __str__(self: Any) -> str:
+            return str(self.string)
+
+        namespace["__repr__"] = namespace.get("__repr__") or __repr__
+        namespace["__str__"] = namespace.get("__str__") or __str__
+        cls = super().__new__(mcls, name, bases, namespace)
+        return cls
+    

stlib_ext/__init__.py

@@ -0,0 +1,2 @@
+import moretyping
+import morefunctools

stlib_ext-0.1.0.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.3
+Name: stlib-ext
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# stlib-ext

stlib_ext-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+morefunctools/__init__.py,sha256=pntkIUGrDS0GLSo6gpSOis5yHzyN5RR45yPpNjVuplY,488
+morefunctools/cache.py,sha256=tB7wLl0JQE1vU-v5cSiIyb7xQ5J8R8YeXVVNjUD_INc,1807
+morefunctools/pyexperimental.py,sha256=kBO3J1wml4gaWyiMXhUyqfdUOBdidb0C3zHGfBN3PiY,1559
+moretyping/__init__.py,sha256=y4oDRCAX70hi5l4AlHajG1NLLx9wYnAGKuLM2jMMvVc,60
+moretyping/data/__init__.py,sha256=1VwgRodn7CEgyix_yyTEPLEsFSNw1HahvZPTnEU5aJw,27
+moretyping/data/_meta_process.py,sha256=8Zq-50OZtXEfiYQMPXG-3WSfEI0T5nI9MUHQO785X4g,1342
+moretyping/data/number.py,sha256=q94wYTPNyqP1-0jnVvamDBY9dpAXjfMyeXlm9CRcQeM,763
+moretyping/meta/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+moretyping/visualise/__init__.py,sha256=D0d0F9kfpxuuBD2tTINmdXCFtsOa9oCzAeZX1lb2X8I,41
+moretyping/visualise/lists/__init__.py,sha256=hEfBxoBKPOV3oaPiE-Td2tGkxAuSNiwiWP8GhFBp__E,25
+moretyping/visualise/lists/link.py,sha256=Cdu_2gLc-Su3SsLv3foqnVq9bpWCw0d_lmjdUslIhpg,465
+moretyping/visualise/other/__init__.py,sha256=Jq9DZTNQGhLfnjste45_ekTIn7w26iBUxGXFXNVeadA,30
+moretyping/visualise/other/showjson.py,sha256=C_LRFqE0_Nw7EpDZkKvDUgaqR5evf2na4qTldoRUnHM,343
+moretyping/visualise/shared.py,sha256=SkLR53iY1lqXBoMq4jY_LXPBhoNWMltZ2J04ptfB_v4,627
+stlib_ext/__init__.py,sha256=ndgh7JT2wTwGdkUdTwUJPc1-WOGy_qfDzTqikmKStUg,39
+stlib_ext-0.1.0.dist-info/WHEEL,sha256=CoDSoyhtC_eO_tlxRYzsTraPv1fPJRXFx91k6ISeAvA,81
+stlib_ext-0.1.0.dist-info/METADATA,sha256=jgXS9mgg6UeH2Z5X9g32WYPmZn0S24t54Fju-_gDqAo,164
+stlib_ext-0.1.0.dist-info/RECORD,,

stlib_ext-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.28
+Root-Is-Purelib: true
+Tag: py3-none-any