From fdcf282949326d75ddea34bf4879bd09159b14df Mon Sep 17 00:00:00 2001 From: Loren Eteval Date: Tue, 18 Aug 2026 23:36:41 +0800 Subject: [PATCH] Clarify live storage collection semantics Signed-off-by: Loren Eteval --- Furious/Interface/Storage.py | 2 +- Furious/Repository/Routings.py | 3 +-- Furious/Repository/Servers.py | 3 +-- Furious/Repository/Subscriptions.py | 3 +-- Furious/Repository/TunSettings.py | 3 +-- 5 files changed, 5 insertions(+), 9 deletions(-) diff --git a/Furious/Interface/Storage.py b/Furious/Interface/Storage.py index bfa22b3..93488cf 100644 --- a/Furious/Interface/Storage.py +++ b/Furious/Interface/Storage.py @@ -35,5 +35,5 @@ class StorageBackend(ABC): @abstractmethod def data(self) -> Any: - """Return the data managed by the storage factory.""" + """Return the live mutable data managed by the storage factory.""" raise NotImplementedError diff --git a/Furious/Repository/Routings.py b/Furious/Repository/Routings.py index 09b4557..796b80d 100644 --- a/Furious/Repository/Routings.py +++ b/Furious/Repository/Routings.py @@ -61,8 +61,7 @@ class UserRoutings(Mixins.CleanupOnExit, StorageBackend): ) def data(self) -> dict[str, dict]: - # Shallow copy - """Return the data managed by the user routings.""" + """Return the live mutable collection managed by this repository.""" return self._data def cleanup(self): diff --git a/Furious/Repository/Servers.py b/Furious/Repository/Servers.py index f5738c3..4fe605c 100644 --- a/Furious/Repository/Servers.py +++ b/Furious/Repository/Servers.py @@ -166,8 +166,7 @@ class UserServers(Mixins.CleanupOnExit, StorageBackend): ) def data(self) -> list[ServerProfile]: - # Shallow copy - """Return the data managed by the user servers.""" + """Return the live mutable collection managed by this repository.""" return self._list def cleanup(self): diff --git a/Furious/Repository/Subscriptions.py b/Furious/Repository/Subscriptions.py index a818977..3587aa6 100644 --- a/Furious/Repository/Subscriptions.py +++ b/Furious/Repository/Subscriptions.py @@ -178,8 +178,7 @@ class UserSubs(Mixins.CleanupOnExit, StorageBackend): ) def data(self) -> dict[str, dict]: - # Shallow copy - """Return the data managed by the user subs.""" + """Return the live mutable collection managed by this repository.""" return self._data def groups(self) -> tuple[SubscriptionGroup, ...]: diff --git a/Furious/Repository/TunSettings.py b/Furious/Repository/TunSettings.py index 690e684..bb96cc6 100644 --- a/Furious/Repository/TunSettings.py +++ b/Furious/Repository/TunSettings.py @@ -58,8 +58,7 @@ class UserTUNSettings(Mixins.CleanupOnExit, StorageBackend): ) def data(self) -> dict[str, str]: - # Shallow copy - """Return the data managed by the user TUN settings.""" + """Return the live mutable collection managed by this repository.""" return self._data def cleanup(self):