Source code for simvx.graphics.renderer.resource_registry

"""ResourceRegistry — string-keyed bag of offscreen resources shared between passes.

Accessed only at setup/resize time. Passes resolve inputs once during setup() and
cache handles as direct instance attributes — no per-frame registry lookups.
"""

from __future__ import annotations

from typing import Any

__all__ = ["ResourceRegistry"]




class ResourceRegistry:
    """String-keyed resource namespace shared between render passes."""

    __slots__ = ("_entries",)

    def __init__(self) -> None:
        self._entries: dict[str, Any] = {}



    def register(self, name: str, handle: Any) -> None:
        """Register a named resource (image view, buffer, sampler, etc.)."""
        self._entries[name] = handle




    def get(self, name: str) -> Any:
        """Retrieve a resource by name. Raises KeyError if not registered."""
        return self._entries[name]




    def try_get(self, name: str) -> Any | None:
        """Retrieve a resource by name, or None if not registered."""
        return self._entries.get(name)




    def has(self, name: str) -> bool:
        """Check whether a resource is registered."""
        return name in self._entries




    def remove(self, name: str) -> None:
        """Remove a resource entry (e.g. before re-registering on resize)."""
        self._entries.pop(name, None)




    def clear(self) -> None:
        """Remove all entries."""
        self._entries.clear()




    def names(self) -> frozenset[str]:
        """Return all registered resource names."""
        return frozenset(self._entries)