Add stage to provider manifest

Author: marcelveldt

music_assistant_models/enums.py

@@ -628,3 +628,33 @@ class HidePlayerOption(StrEnum):
     def _missing_(cls, value: object) -> HidePlayerOption:  # noqa: ARG003
         """Set default enum member if an unknown value is provided."""
         return cls.NEVER
+
+
+class ProviderStage(StrEnum):
+    """Enum with possible Provider (development/stability) stages."""
+
+    # alpha: early development stage, not ready for production use
+    ALPHA = "alpha"
+
+    # beta: feature complete, but not fully tested, may contain bugs
+    BETA = "beta"
+
+    # stable: fully tested and ready for production use
+    STABLE = "stable"
+
+    # experimental: not stable, may change at any time, not recommended for production use
+    # often indicates a provider that is in heavy development or is based on reverse engineering
+    # or breaks often due to upstream changes
+    EXPERIMENTAL = "experimental"
+
+    # unmaintained: no longer maintained, no longer receiving updates or support
+    # looking for a community maintainer - the provider may not work in the future
+    UNMAINTAINED = "unmaintained"
+
+    # deprecated: no longer supported, will be removed in the future
+    DEPRECATED = "deprecated"
+
+    @classmethod
+    def _missing_(cls, value: object) -> ProviderStage:  # noqa: ARG003
+        """Set default enum member if an unknown value is provided."""
+        return cls.STABLE

music_assistant_models/provider.py

@@ -9,7 +9,7 @@
 
 from mashumaro.mixins.orjson import DataClassORJSONMixin
 
-from .enums import MediaType, ProviderFeature, ProviderType
+from .enums import MediaType, ProviderFeature, ProviderStage, ProviderType
 
 
 @dataclass
@@ -24,6 +24,8 @@ class ProviderManifest(DataClassORJSONMixin):
 
     # optional params
 
+    # stage: the stage of the provider, used to determine if it is stable or experimental
+    stage: ProviderStage = ProviderStage.STABLE
     # requirements: list of (pip style) python packages required for this provider
     requirements: list[str] = field(default_factory=list)
     # documentation: link/url to documentation.