[library / gdsii] more cleanup

masque/library/capabilities.py

@@ -47,5 +47,9 @@ class IBorrowing(ABC):
 
         The source may use a different name, which is returned alongside it.
         Port metadata may differ because ports are not layout-file content.
+        The result is not recursively resolved: consumers must follow further
+        borrowing views themselves and enforce format-specific constraints such
+        as whether the visible and source names must match. `None` means the
+        source cannot be reused safely or no source provenance is available.
         """
         return None

masque/library/mapping.py

@@ -70,6 +70,7 @@ class _SubtreeLibraryView(ILibraryView, IMaterializable, IBorrowing):
             name: set(child_graph.get(name, set()))
             for name in self._order
             }
+
     def __getitem__(self, key: str) -> Pattern:
         if key not in self._names:
             raise KeyError(key)
@@ -136,6 +137,7 @@ class _SubtreeLibraryView(ILibraryView, IMaterializable, IBorrowing):
         refs = self._source.find_refs_local(name, parent_graph=parent_graph, dangling=dangling)
         return {parent: transforms for parent, transforms in refs.items() if parent in self._names}
 
+
 class Library(ILibrary):
     """
     Default implementation for a writeable library.

masque/library/overlay.py

@@ -79,6 +79,7 @@ class PortsLibraryView(ILibraryView, IMaterializable, IBorrowing):
         self._replace = replace
         self._cache: dict[str, Pattern] = {}
         self._lookups_in_progress: list[str] = []
+
     def __getitem__(self, key: str) -> Pattern:
         return self.materialize(key, persist=True)
 
@@ -160,6 +161,7 @@ class PortsLibraryView(ILibraryView, IMaterializable, IBorrowing):
             return cast('dict[str, list[NDArray[numpy.float64]]]', finder(name, parent_graph=parent_graph, dangling=dangling))
         return super().find_refs_local(name, parent_graph=parent_graph, dangling=dangling)
 
+
 class OverlayLibrary(ILibrary, IMaterializable, IBorrowing):
     """
     Mutable overlay over one or more source libraries.