LocalPreferences Namespace nesting

[lukaskollmer]

♻️ Current situation & Problem

the LocalPreferences API in GroveFoundation currently does not support nested key namespaces.
we consider this a desirable feature, as it will allow fine-grained control over bulk deletion of specific groups of items within a larger parent group.
for example, an app will typically wish to place all of its entries into an app-wide namespace. but if, within that, it has a collection of entries that belong to the same "thing", and it wishes to be able to delete them all at once, that currently is not possible. it'd have to delete all of the entries in its app-wide namespace, which would end up affecting random other things.

⚙️ Release Notes

• added the ability to define nested namespaces for LocalPreferenceKeys. note that bulk-clearing a namespace will also remove any entries belonging to namespaces nested w/in the namespace being bulk-cleared

📚 Documentation

yes

✅ Testing

yes

Code of Conduct & Contributing Guidelines

By creating and submitting this pull request, you agree to follow our Code of Conduct and Contributing Guidelines:

• I agree to follow the Code of Conduct and Contributing Guidelines.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: d004ad1a-153c-4b97-90a9-b5dab8ed4688

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[PSchmiedmayer]

Thanks @lukaskollmer 🚀

[PSchmiedmayer]

To be a bit clearer?

Suggested change

	/// - Note: Bulk-removing a namespace (via ``LocalPreferencesStore/removeAllEntries(in:)``
	/// will also remove all entries belonging to nested namespaces within the outer one.
	/// - Note: Bulk-removing a outer namespace (via ``LocalPreferencesStore/removeAllEntries(in:)``
	/// will also remove all entries belonging to nested namespaces within the parent namespace.