add the concept of a namespace for the config injector.

Author: carl-adams-planet

src/planet_auth_config_injection/builtins_provider.py

@@ -51,6 +51,16 @@ class BuiltinConfigurationProviderInterface(ABC):
     Built-in trust environments are expected to be all uppercase.
     """
 
+    def namespace(self) -> str:
+        """
+        Application namespace. This will be used as a prefix in various contexts
+        so that multiple applications may use the Planet auth libraries in the same
+        environment without collisions.  Presently, this includes being
+        used as a prefix for environment variables, and as a prefix for config
+        settings store to the user's `~/.planet.json` file.
+        """
+        return ""
+
     @abstractmethod
     def builtin_client_authclient_config_dicts(self) -> Dict[str, dict]:
         """

src/planet_auth_utils/builtins.py

@@ -92,6 +92,11 @@ def _load_builtin_jit():
             Builtins._builtin = _load_builtins()
             auth_logger.debug(msg=f"Successfully loaded built-in provider: {Builtins._builtin.__class__.__name__}")
 
+    @staticmethod
+    def namespace() -> str:
+        Builtins._load_builtin_jit()
+        return Builtins._builtin.namespace()
+
     @staticmethod
     def is_builtin_profile(profile: str) -> bool:
         Builtins._load_builtin_jit()