Feature switch support for applications.
This module contains convenience imports for:
A feature in a product that can dynamically be turned on/off.
Feature subclasses are used to provide dynamic access to a given feature in a product. The feature may appear off for most users but on for a select few, or only on in a development server, for instance.
Whether a feature is enabled is controlled by the
stability levelof the feature and by the
feature checker. It will be enabled if
STABLEor if the feature checker returns that the feature is enabled.
Consuming applications are expected to subclass this and define the information on the feature, and choose a feature checker to use.
Initialize the feature.
Subclasses that wish to provide special initialization should instead override
Parameters: register (bool, optional) – Whether to register this feature instance. This should generally be
Truefor all callers, except in special cases (like unit tests).
djblets.features.errors.FeatureConflictError– The feature ID on this class conflicts with another feature.
Initialize the feature.
Subclasses that wish to initialize feature logic within the class (such as connecting to signals) should do so by overriding this method.
This will always be called when instantiating the subclass, or when re-registering an unregistered feature class using the
Shut down the feature.
Subclasses that wish to provide special shutdown logic within the class (such as disconnecting from signals) should do so by overriding this method.
This is called when unregistering the feature through the
Return whether the feature is enabled for the given requirements.
This will return a boolean indicating if the feature is enabled.
STABLE, it will always be enabled. Otherwise, if
UNAVAILABLE, the configured feature checker will be used instead.
Callers can pass additional keyword arguments to this method, which the feature checker can use when determining if the feature is enabled. For example, a
HttpRequestinstance, or a
Parameters: **kwargs (dict) – Additional keyword arguments to pass to the feature checker. Returns: A boolean value indicating if the feature is enabled for the given conditions. Return type: bool
Possible stability levels for features.
The feature is completely unavailable.
Feature checkers will not be consulted in this case.
Return the global features registry.
The first time this is called, a
FeaturesRegistrywill be instantiated and cached for future calls.
Returns: The features registry. Return type: FeaturesRegistry