Issues #1163, #1173 - refactor CPluginUserSettings

test/plugin/UserSettingsTest.cpp

 /*
- * This file is part of Adblock Plus <http://adblockplus.org/>,
- * Copyright (C) 2014 Eyeo GmbH
+ * This file is part of Adblock Plus <https://adblockplus.org/>,
+ * Copyright (C) 2006-2015 Eyeo GmbH
  *
  * Adblock Plus is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 3 as
  * published by the Free Software Foundation.
  *
  * Adblock Plus is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
  * along with Adblock Plus.  If not, see <http://www.gnu.org/licenses/>.
  */
-
 #include <gtest/gtest.h>
 
+#include <OAIdl.h>
 #include "../../src/plugin/PluginUserSettings.h"
 
 //----------------------------------
 // GetIDsOfNames
 //----------------------------------
 
 namespace
 {
-  void single_method_name_found(std::wstring name, DISPID expected_id)
+  void SingleMethodNameFound(std::wstring name, DISPID expected_id)
   {
     CPluginUserSettings x;
-    wchar_t *names[1];
-    names[0] = const_cast<wchar_t *>(name.c_str());
+    wchar_t* names[] = {const_cast<wchar_t*>(name.c_str())};
     DISPID ids[1];
     HRESULT h = x.GetIDsOfNames(IID_NULL, names, 1, 0, ids);
     ASSERT_EQ(S_OK, h);
-    DISPID id=ids[0];
+    DISPID id = ids[0];
     ASSERT_EQ(expected_id, id);
   }
 
-  void single_method_name_notfound(std::wstring name)
+  void SingleMethodNameNotFound(std::wstring name)
   {
     CPluginUserSettings x;
-    wchar_t *names[1];
-    names[0] = const_cast<wchar_t *>(name.c_str());
+    wchar_t* names[] = {const_cast<wchar_t*>(name.c_str())};
     DISPID ids[1];
     HRESULT h = x.GetIDsOfNames(IID_NULL, names, 1, 0, ids);
     ASSERT_NE(S_OK, h);
     EXPECT_EQ(DISP_E_UNKNOWNNAME, h);
   }
 }
 
-TEST(CPluginUserSettings_GetIDsOfNames_Test, all_defined_found)
+TEST(CPluginUserSettingsGetIDsOfNames, AllDefinedMethodsMustBeFound)
 {
   CPluginUserSettings x;
-  single_method_name_found(L"GetMessage", 0);
-  single_method_name_found(L"GetLanguageCount", 1);
-  single_method_name_found(L"GetLanguageByIndex", 2);
-  single_method_name_found(L"GetLanguageTitleByIndex", 3);
-  single_method_name_found(L"SetLanguage", 4);
-  single_method_name_found(L"GetLanguage", 5);
-  single_method_name_found(L"GetWhitelistDomains", 6);
-  single_method_name_found(L"AddWhitelistDomain", 7);
-  single_method_name_found(L"RemoveWhitelistDomain", 8);
-  single_method_name_found(L"GetAppLocale", 9);
-  single_method_name_found(L"GetDocumentationLink", 10);
-  single_method_name_found(L"IsAcceptableAdsEnabled", 11);
-  single_method_name_found(L"SetAcceptableAdsEnabled", 12);
+  SingleMethodNameFound(L"GetMessage", 0);
+  SingleMethodNameFound(L"GetLanguageCount", 1);
+  SingleMethodNameFound(L"GetLanguageByIndex", 2);
+  SingleMethodNameFound(L"GetLanguageTitleByIndex", 3);
+  SingleMethodNameFound(L"SetLanguage", 4);
+  SingleMethodNameFound(L"GetLanguage", 5);
+  SingleMethodNameFound(L"GetWhitelistDomains", 6);
+  SingleMethodNameFound(L"AddWhitelistDomain", 7);
+  SingleMethodNameFound(L"RemoveWhitelistDomain", 8);
+  SingleMethodNameFound(L"GetAppLocale", 9);
+  SingleMethodNameFound(L"GetDocumentationLink", 10);
+  SingleMethodNameFound(L"IsAcceptableAdsEnabled", 11);
+  SingleMethodNameFound(L"SetAcceptableAdsEnabled", 12);
+  SingleMethodNameFound(L"IsUpdate", 13);
 }
 
-TEST(CPluginUserSettings_GetIDsOfNames_Test, undefined_not_found)
+TEST(CPluginUserSettingsGetIDsOfNames, UndefinedMethodsMustNotBeFound)
 {
-  single_method_name_notfound(L"");
-  single_method_name_notfound(L"clearly unknown");
-  single_method_name_notfound(L"GETMESSAGE");
+  SingleMethodNameNotFound(L"");
+  SingleMethodNameNotFound(L"clearly unknown");
+  SingleMethodNameNotFound(L"GETMESSAGE");
 }
 
 //----------------------------------
 // Invoke
 //----------------------------------
 
 namespace
 {
-  void invoke_invalid_dispatch_id(DISPID id)
+  void InvokeInvalidDispatchId(DISPID id)
   {
     CPluginUserSettings x;
     DISPPARAMS params;
     params.rgvarg = nullptr;
     params.rgdispidNamedArgs = nullptr;
     params.cArgs = 0;
     params.cNamedArgs = 0;
     EXCEPINFO ex;
-    HRESULT h = x.Invoke(-1, IID_NULL, 0, 0, &params, nullptr, &ex, nullptr);
+    HRESULT h = x.Invoke(id, IID_NULL, 0, DISPATCH_METHOD, &params, nullptr, &ex, nullptr);
     ASSERT_NE(S_OK, h);
     EXPECT_EQ(DISP_E_MEMBERNOTFOUND, h);
   }
 }
 
-TEST(CPluginUserSettings_Invoke_Test, invalid_dispatch_id_underflow)
+/**
+ * Verify that a negative Dispatch ID returns the proper error code.
+ */
+TEST(CPluginUserSettingsInvoke, InvalidDispatchIdShouldUnderflow)
 {
-  invoke_invalid_dispatch_id(-1);
+  InvokeInvalidDispatchId(-1);
 }
 
-TEST(CPluginUserSettings_Invoke_Test, invalid_dispatch_id_overflow)
+/**
+ * Verify that a positive Dispatch ID that's too large returns the proper error code.
+ */
+TEST(CPluginUserSettingsInvoke, InvalidDispatchIdShouldOverflow)
 {
-  invoke_invalid_dispatch_id(13);
-}
+  InvokeInvalidDispatchId(14);
+}