summaryrefslogtreecommitdiff
path: root/chromium/extensions/common/permissions/permission_message_provider.h
diff options
context:
space:
mode:
Diffstat (limited to 'chromium/extensions/common/permissions/permission_message_provider.h')
-rw-r--r--chromium/extensions/common/permissions/permission_message_provider.h58
1 files changed, 58 insertions, 0 deletions
diff --git a/chromium/extensions/common/permissions/permission_message_provider.h b/chromium/extensions/common/permissions/permission_message_provider.h
new file mode 100644
index 00000000000..a75b46eed4a
--- /dev/null
+++ b/chromium/extensions/common/permissions/permission_message_provider.h
@@ -0,0 +1,58 @@
+// Copyright 2013 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef EXTENSIONS_COMMON_PERMISSIONS_PERMISSION_MESSAGE_PROVIDER_H_
+#define EXTENSIONS_COMMON_PERMISSIONS_PERMISSION_MESSAGE_PROVIDER_H_
+
+#include <vector>
+
+#include "extensions/common/manifest.h"
+#include "extensions/common/permissions/permission_message.h"
+
+namespace extensions {
+
+class PermissionIDSet;
+class PermissionSet;
+
+// The PermissionMessageProvider interprets permissions, translating them
+// into warning messages to show to the user. It also determines whether
+// a new set of permissions entails showing new warning messages.
+class PermissionMessageProvider {
+ public:
+ PermissionMessageProvider() {}
+ virtual ~PermissionMessageProvider() {}
+
+ // Return the global permission message provider.
+ static const PermissionMessageProvider* Get();
+
+ // Calculates and returns the full list of permission messages for the given
+ // |permissions|. This involves converting the given PermissionIDs into
+ // localized messages, as well as coalescing and parameterizing any messages
+ // that require the permission ID's argument in their message.
+ virtual PermissionMessages GetPermissionMessages(
+ const PermissionIDSet& permissions) const = 0;
+
+ // Returns true if |new_permissions| has a greater privilege level than
+ // |old_permissions|.
+ // Whether certain permissions are considered varies by extension type.
+ // TODO(sashab): Add an implementation of this method that uses
+ // PermissionIDSet instead, then deprecate this one.
+ virtual bool IsPrivilegeIncrease(const PermissionSet& old_permissions,
+ const PermissionSet& new_permissions,
+ Manifest::Type extension_type) const = 0;
+
+ // Given the permissions for an extension, finds the IDs of all the
+ // permissions for that extension (including API, manifest and host
+ // permissions).
+ // TODO(sashab): This uses the legacy PermissionSet type. Deprecate or rename
+ // this type, and make this take as little as is needed to work out the
+ // PermissionIDSet.
+ virtual PermissionIDSet GetAllPermissionIDs(
+ const PermissionSet& permissions,
+ Manifest::Type extension_type) const = 0;
+};
+
+} // namespace extensions
+
+#endif // EXTENSIONS_COMMON_PERMISSIONS_PERMISSION_MESSAGE_PROVIDER_H_