Create TemplateUrlData to base::Dictionary utility functions

components/search_engines/template_url_data_util.h

+// Copyright 2016 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 COMPONENTS_SEARCH_ENGINES_TEMPLATE_URL_DATA_UTIL_H_
+#define COMPONENTS_SEARCH_ENGINES_TEMPLATE_URL_DATA_UTIL_H_
+
+#include <memory>
+
+namespace base {
+class DictionaryValue;
+}
+
+namespace TemplateURLPrepopulateData {
+struct PrepopulatedEngine;
+}
+
+struct TemplateURLData;
+
+// Restore TemplateURLData structure from base::DictionaryValue as stored by

[Peter Kasting, 2016/11/20 07:57:50]

Nit: Function overview comments should be descriptive ("restores") rather than
imperative ("restore"); see
http://google.github.io/styleguide/cppguide.html#Function_Comments .

Also, prefer to keep comments brief by not repeating information (e.g. type
names, or the word "structure") that's clear from the function declaration; for
example, here we could just say "Deserializes a TemplateURLData from |dict|. 
The serialization is assumed to be the one used by
TemplateURLDataToDictionary()."

Note that I wouldn't say "DefaultSearchManager format" because that's a class
that calls these functions, it's not really a documented format.  By definition,
its format is whatever these do.  Hence the phrasing above.

(Several places)

[Alexander Yashkin, 2016/11/20 20:24:05]

Fixed, thanks.

+// DefaultSearchManager.
+std::unique_ptr<TemplateURLData> TemplateURLDataFromDictionary(
+    const base::DictionaryValue& dict);
+
+// Store TemplateURLData structure to base::DictionaryValue, in
+// DefaultSearchManager format.
+std::unique_ptr<base::DictionaryValue> TemplateURLDataToDictionary(
+    const TemplateURLData& turl_data);
+
+// Create TemplateURLData structure from PrepopulatedEngine structure.
+std::unique_ptr<TemplateURLData> TemplateURLDataFromPrepopulatedEngine(
+    const TemplateURLPrepopulateData::PrepopulatedEngine& engine);
+
+// Restore TemplateURLData structure from base::DictionaryValue as stored in
+// kSearchProviderOverrides pref.

[Peter Kasting, 2016/11/20 07:57:50]

Nit: Here you might clarify that this differs from the format above for
historical reasons, and possibly add a TODO to eliminate this via migration.

[Alexander Yashkin, 2016/11/20 20:24:05]

Comment fixed.

+std::unique_ptr<TemplateURLData> TemplateURLDataFromOverrideDictionary(
+    const base::DictionaryValue& engine);
+
+#endif  // COMPONENTS_SEARCH_ENGINES_TEMPLATE_URL_DATA_UTIL_H_