libsegmentation/feature_management.h

// Copyright 2023 The ChromiumOS Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef LIBSEGMENTATION_FEATURE_MANAGEMENT_H_
#define LIBSEGMENTATION_FEATURE_MANAGEMENT_H_

#include <memory>
#include <set>
#include <string>
#include <utility>

#include <brillo/brillo_export.h>
#include <libsegmentation/feature_management_interface.h>

namespace segmentation {

// C++ class to access feature_management system properties.
class BRILLO_EXPORT FeatureManagement {
 public:
  // Default implementation uses the real feature_management
  // (FeatureManagementImpl).
  FeatureManagement();

  // Can be used to instantiate a fake implementation for testing by passing
  // FeatureManagementFake.
  explicit FeatureManagement(std::unique_ptr<FeatureManagementInterface> impl);

  // Return true when a named feature can be used on the device.
  bool IsFeatureEnabled(const std::string& name);

  // Return the maximal feature level available on the device.
  int GetFeatureLevel() const;

  // Returns the highest possible feature level for *any* device.
  int GetMaxFeatureLevel() const;

  // Return the maximal scope level available on the device.
  int GetScopeLevel() const;

  // List features supported on the device.
  // |usage| narrows down the list to a specific subsystem (ChromeOS, Chrome
  // or Android).
  const std::set<std::string> ListFeatures(const FeatureUsage usage);

  // Prefix for naming features.
  static constexpr char kPrefix[] = "FeatureManagement";

 private:
  std::unique_ptr<FeatureManagementInterface> impl_;
};

}  // namespace segmentation

#endif  // LIBSEGMENTATION_FEATURE_MANAGEMENT_H_