components/bookmarks/test/bookmark_test_helpers.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef COMPONENTS_BOOKMARKS_TEST_BOOKMARK_TEST_HELPERS_H_
   6 #define COMPONENTS_BOOKMARKS_TEST_BOOKMARK_TEST_HELPERS_H_
   7
   8 #include <string>
   9
  10 namespace bookmarks {
  11
  12 class BookmarkModel;
  13 class BookmarkNode;
  14
  15 namespace test {
  16
  17 // Blocks until |model| finishes loading.
  18 void WaitForBookmarkModelToLoad(BookmarkModel* model);
  19
  20 // Return the descendants of |node| as a string useful for verifying node
  21 // modifications. The format of the resulting string is:
  22 //
  23 //           result = node " " , { node " " }
  24 //             node = bookmark title | folder
  25 //           folder = folder title ":[ " { node " " } "]"
  26 //   bookmark title = (* string with no spaces *)
  27 //     folder title = (* string with no spaces *)
  28 //
  29 // Example: "a f1:[ b d c ] d f2:[ e f g ] h "
  30 //
  31 // (Logically, we should use |string16|s, but it's more convenient for test
  32 // purposes to use (UTF-8) |std::string|s.)
  33 std::string ModelStringFromNode(const BookmarkNode* node);
  34
  35 // Create and add the node hierarchy specified by |model_string| to the
  36 // bookmark node given by |node|. The string has the same format as
  37 // specified for ModelStringFromNode(). The new nodes added to |node|
  38 // are appended to the end of node's existing subnodes, if any.
  39 // |model| must be the model of which |node| is a member.
  40 // NOTE: The string format is very rigid and easily broken if not followed
  41 //       exactly (since we're using a very simple parser).
  42 void AddNodesFromModelString(BookmarkModel* model,
  43                              const BookmarkNode* node,
  44                              const std::string& model_string);
  45
  46 }  // namespace test
  47 }  // namespace bookmarks
  48
  49 #endif  // COMPONENTS_BOOKMARKS_TEST_BOOKMARK_TEST_HELPERS_H_