reslot 0.8__py3-none-any.whl

reslot-0.8.dist-info/METADATA

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: reslot
+Version: 0.8
+Summary: Class decorator to enable @cached_property on classes with __slots__
+Author-email: Zachary Spector <public@zacharyspector.com>
+License-Expression: MIT
+Project-URL: Homepage, https://codeberg.org/clayote/reslot
+Project-URL: Bug tracker, https://codeberg.org/clayote/reslot/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Development Status :: 2 - Pre-Alpha
+Requires-Python: ~=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# reslot
+
+
+A class decorator that lets you use `@cached_property` on classes with `__slots__`.
+
+The decorated class needs a `__dict__` slot, but there won't exactly be a
+dictionary in it. Instead, `@reslot` will give it a custom `MutableMapping`
+with *its own* slots. `@cached_property` will keep its cache there.
+
+The custom `MutableMapping`'s slots will be exactly the slots needed to store
+the results of every `@cached_property` that was on the class at the time it
+was declared. This minimizes the memory footprint and makes lookup speedy.
+
+
+## Usage
+
+```python
+from functools import cached_property
+
+from reslot import reslot
+
+BEANED = False
+
+@reslot
+class Spam:
+    __slots__ = ("__dict__",)
+
+    @cached_property
+    def eggs(self):
+        return {"delicious": False}
+
+    @cached_property
+    def beans(self):
+        global BEANED
+        BEANED = True
+        return {"spam": 111000, "delicious": True}
+
+spam = Spam()
+print(spam.eggs)   # {"delicious": False}
+print(BEANED)      # False
+print(spam.beans)  # {"spam": 111000, "delicious": True}
+print(BEANED)      # True
+```

reslot-0.8.dist-info/RECORD

@@ -0,0 +1,6 @@
+reslot.py,sha256=ADYharQLBJp0LxXeT8weTJHnmRKT6BSbns6dCMLHrdk,3276
+reslot-0.8.dist-info/licenses/LICENSE,sha256=VE4HyKmDTdoGsJpu9htwTVPwjgiQG6nI3yVBQxx9J9Y,1069
+reslot-0.8.dist-info/METADATA,sha256=M4frA34YMWS_J-L5qJcyXCNrp5Q5zqek7DF7qc4XHog,1728
+reslot-0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+reslot-0.8.dist-info/top_level.txt,sha256=DxypSdTiydR9REd7AKh05-3uZVg44mK04CPNGLf9SrA,7
+reslot-0.8.dist-info/RECORD,,

reslot-0.8.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

reslot-0.8.dist-info/licenses/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Zachary Avram Spector
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

reslot-0.8.dist-info/top_level.txt

@@ -0,0 +1 @@
+reslot

reslot.py

@@ -0,0 +1,115 @@
+from collections.abc import MutableMapping
+from functools import wraps, cached_property, partial, update_wrapper
+from inspect import getclasstree, getdoc
+from typing import TypeVar, Iterator, Type, Optional, Set, Tuple, Union, List
+
+_UNSET = object()
+
+_T = TypeVar("_T")
+
+walk_class_tree_hint = List[Union[Type, Tuple[Type, Type], "recurse_class_tree_hint"]]
+
+def walk_class_tree(l: walk_class_tree_hint) -> Iterator[Type]:
+	if isinstance(l, type):
+		yield l
+	elif isinstance(l, tuple):
+		yield l[0]
+		if len(l) > 1:
+			yield from walk_class_tree(l[1])
+	else:
+		for ll in l:
+			yield from walk_class_tree(ll)
+
+def collect_all_slots(cls) -> Set[str]:
+	slots = set()
+	if hasattr(cls, "__slots__"):
+		slots.update(cls.__slots__)
+	for clls in walk_class_tree(getclasstree([cls])):
+		if hasattr(clls, "__slots__"):
+			slots.update(clls.__slots__)
+	return slots
+
+
+def iter_needed_slots(cls: Type) -> Iterator[Tuple[str, Optional[str]]]:
+	for clls in walk_class_tree([cls]):
+		for attr in dir(clls):
+			try:
+				val = getattr(clls, attr)
+			except AttributeError:
+				continue
+			if not isinstance(val, cached_property):
+				continue
+			if val.attrname is None:
+				raise TypeError("cached_property without name")
+			yield val.attrname, getdoc(val.func)
+
+
+def init(slot_dict, core_init, self, *args, **kwargs):
+	class SlotRedirector(MutableMapping, dict):
+		# I think inheriting from dict means we still have an empty
+		# dictionary floating in memory for each SlotRedirector instantiated.
+		# That's eighty bytes we don't need...but at least it doesn't grow.
+		__slots__ = slot_dict
+
+		def __setitem__(self, key, value, /):
+			try:
+				setattr(self, key, value)
+			except AttributeError:
+				raise KeyError("No such slot", key) from None
+
+		def __delitem__(self, key, /):
+			try:
+				delattr(self, key)
+			except AttributeError:
+				raise KeyError("Slot not set", key)
+
+		def __getitem__(self, key, /):
+			try:
+				return getattr(self, key)
+			except AttributeError:
+				raise KeyError("Slot not set", key)
+
+		def __len__(self):
+			return len(self.__slots__)
+
+		def __iter__(self):
+			return iter(self.__slots__)
+	self.__dict__ = SlotRedirector()
+	if callable(core_init):
+		core_init(self, *args, **kwargs)
+	else:
+		super(type(self), self).__init__(*args, **kwargs)
+
+def reslot(
+	cls: Optional[Type[_T]] = None,
+) -> Type[_T]:
+	"""Class decorator to enable ``@cached_property`` with ``__slots__``
+
+	The decorated class needs a ``__dict__`` slot, but we won't put an actual
+	dictionary in it. Instead, we'll put a mapping with the needed slots in it.
+	"""
+
+	def really_reslot(cls: Type[_T]) -> Type[_T]:
+		if not hasattr(cls, "__slots__"):
+			raise TypeError("Class doesn't have __slots__")
+		slots = collect_all_slots(cls)
+		if "__dict__" not in slots:
+			raise TypeError("Need __dict__ slot")
+		slot_dict = dict(iter_needed_slots(cls))
+		if hasattr(cls, "__slots__"):
+			if isinstance(cls.__slots__, dict):
+				slot_dict.update(cls.__slots__)
+			else:
+				for slot in cls.__slots__:
+					slot_dict[slot] = None
+		if hasattr(cls, "__init__"):
+			part = partial(init, slot_dict, cls.__init__)
+			update_wrapper(part, cls.__init__)
+		else:
+			part = partial(init, slot_dict, None)
+		cls.__init__ = part
+		return cls
+
+	if cls is None:
+		return really_reslot
+	return really_reslot(cls)