reslot 0.1__tar.gz

reslot-0.1/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.1/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: reslot
+Version: 0.1
+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.12
+License-File: LICENSE
+Dynamic: license-file

reslot-0.1/README.md

@@ -0,0 +1,9 @@
+# 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.
+

reslot-0.1/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "reslot"
+version = "0.1"
+authors = [
+    {name="Zachary Spector",email="public@zacharyspector.com"},
+]
+description="Class decorator to enable @cached_property on classes with __slots__"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = "~=3.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+	"Topic :: Software Development :: Libraries",
+	"Development Status :: 2 - Pre-Alpha"
+]
+
+[project.urls]
+"Homepage" = "https://codeberg.org/clayote/reslot"
+"Bug tracker" = "https://codeberg.org/clayote/reslot/issues"

reslot-0.1/reslot.egg-info/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: reslot
+Version: 0.1
+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.12
+License-File: LICENSE
+Dynamic: license-file

reslot-0.1/reslot.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+reslot.py
+reslot.egg-info/PKG-INFO
+reslot.egg-info/SOURCES.txt
+reslot.egg-info/dependency_links.txt
+reslot.egg-info/top_level.txt

reslot-0.1/reslot.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

reslot-0.1/reslot.egg-info/top_level.txt

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

reslot-0.1/reslot.py

@@ -0,0 +1,133 @@
+from collections.abc import MutableMapping
+from functools import wraps, cached_property
+from inspect import getclasstree
+from typing import TypeVar
+
+_UNSET = object()
+
+_T = TypeVar("_T")
+
+
+def collect_all_slots(cls) -> set[str]:
+	def recurse(l: list[type | tuple[type, type] | list]):
+		if isinstance(l, type):
+			yield l
+		elif isinstance(l, tuple):
+			yield l[0]
+		else:
+			for ll in l:
+				yield from recurse(ll)
+
+	slots = set()
+	if hasattr(cls, "__slots__"):
+		slots.update(cls.__slots__)
+	for clls in recurse(getclasstree([cls])):
+		if hasattr(clls, "__slots__"):
+			slots.update(clls.__slots__)
+	return slots
+
+
+def surround_name(prefix: str | None, name: str, suffix: str | None) -> str:
+	if prefix is None:
+		if name.startswith("_"):
+			prefix = ""
+		else:
+			prefix = "_"
+	if suffix is None:
+		if prefix:
+			suffix = ""
+		else:
+			suffix = "_"
+	return prefix + name + suffix
+
+
+def reslot(
+	cls: type[_T] | None = None,
+	prefix: str | None = None,
+	suffix: str | None = 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.
+
+	:param cls: The class to enable ``@cached_property`` on. If left ``None``,
+	    a partial function will be returned, which may then be used as a
+	    decorator.
+	:param prefix: String to put at the beginning of the slot name. Defaults
+	    to ``None``, in which case we'll prefix the slot name with an underscore
+	    unless it already starts with one. We won't default to a prefix then,
+	    because that would invoke name mangling.
+	:param suffix: String to put at the end of the slot name. Defaults to
+	    ``None``, in which case we won't use a suffix, unless ``prefix`` is
+	    also ``None`` or the empty string, in which case the default suffix is
+	    ``"_"``.
+
+	"""
+
+	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")
+		slots.remove("__dict__")
+
+		class SlotRedirector(MutableMapping):
+			__slots__ = slots
+
+			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__)
+
+		if hasattr(cls, "__getattr__"):
+			core_getattr = cls.__getattr__
+
+			@wraps(core_getattr)
+			def __getattr__(self: _T, attr: str):
+				if attr == "__dict__":
+					val = getattr(super(cls, self), "__dict__", _UNSET)
+					if val is _UNSET:
+						val = SlotRedirector()
+						setattr(self, "__dict__", val)
+					return val
+				return core_getattr(self, attr)
+
+			cls.__getattr__ = __getattr__
+		else:
+
+			def __getattr__(self: _T, attr: str):
+				if attr == "__dict__":
+					val = getattr(super(cls, self), "__dict__", _UNSET)
+					if val is _UNSET:
+						val = SlotRedirector()
+						setattr(self, "__dict__", val)
+					return val
+				return getattr(super(type(self), self), attr)
+
+			cls.__getattr__ = __getattr__
+		return cls
+
+	if cls is None:
+		return really_reslot
+	return really_reslot(cls)

reslot-0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+