| OLD | NEW |
| (Empty) |
| 1 // Copyright 2013 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 CHROME_TOOLS_PROFILE_RESET_JTL_PARSER_H_ | |
| 6 #define CHROME_TOOLS_PROFILE_RESET_JTL_PARSER_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 #include <vector> | |
| 10 | |
| 11 #include "base/basictypes.h" | |
| 12 #include "base/memory/scoped_ptr.h" | |
| 13 #include "base/values.h" | |
| 14 | |
| 15 // Parses text-based JTL source code into a stream of operation names, arguments | |
| 16 // and separator kinds. | |
| 17 class JtlParser { | |
| 18 public: | |
| 19 // Creates a new parser to parse |compacted_source_code|, which should already | |
| 20 // be stripped of all comments and whitespace (except inside string literals). | |
| 21 // Use RemoveCommentsAndAllWhitespace() to manufacture these arguments, also | |
| 22 // see its comments for a description of |newline_indices|. | |
| 23 JtlParser(const std::string& compacted_source_code, | |
| 24 const std::vector<size_t>& newline_indices); | |
| 25 ~JtlParser(); | |
| 26 | |
| 27 // Removes comments from |verbose_text| and compacts it into whitespace-free | |
| 28 // format (except inside string literals). Elements in |newline_indices| will | |
| 29 // be monotonically increasing and will refer to positions in |compacted_text| | |
| 30 // such that a new line has been removed before that position. | |
| 31 // Example: | |
| 32 // verbose_text = "H e l l o // my\n" | |
| 33 // " dear \n" | |
| 34 // "\n" | |
| 35 // "world\" ! \"" | |
| 36 // compacted_text = "Hellodearworld\" ! \"" | |
| 37 // 01234567890123... | |
| 38 // newline_indices = {5, 9, 9} | |
| 39 // Returns true on success, false if there were unmatched quotes in a line, in | |
| 40 // which case |error_line_number| will be set accordingly if it is non-NULL. | |
| 41 static bool RemoveCommentsAndAllWhitespace( | |
| 42 const std::string& verbose_text, | |
| 43 std::string* compacted_text, | |
| 44 std::vector<size_t>* newline_indices, | |
| 45 size_t* error_line_number); | |
| 46 | |
| 47 // Returns true if the entire input has been successfully consumed. Note that | |
| 48 // even when this returns false, a subsequent call to ParseNextOperation() | |
| 49 // might still fail if the next operation cannot be parsed. | |
| 50 bool HasFinished(); | |
| 51 | |
| 52 // Fetches the |name| and the |argument_list| of the next operation, and also | |
| 53 // whether or not it |ends_the_sentence|, i.e. it is followed by the | |
| 54 // end-of-sentence separator. | |
| 55 // Returns false if there is a parsing error, in which case the values for the | |
| 56 // output parameters are undefined, and |this| parser shall no longer be used. | |
| 57 bool ParseNextOperation(std::string* name, | |
| 58 base::ListValue* argument_list, | |
| 59 bool* ends_the_sentence); | |
| 60 | |
| 61 // Returns the compacted source code that was passed in to the constructor. | |
| 62 const std::string& compacted_source() const { return compacted_source_; } | |
| 63 | |
| 64 // Returns at which line the character at position |compacted_index| in the | |
| 65 // |compacted_source()| was originally located. | |
| 66 size_t GetOriginalLineNumber(size_t compacted_index) const; | |
| 67 | |
| 68 size_t GetLastLineNumber() const; | |
| 69 std::string GetLastContext() const; | |
| 70 | |
| 71 private: | |
| 72 // Contains pre-compiled regular expressions and related state. Factored out | |
| 73 // to avoid this header depending on RE2 headers. | |
| 74 struct ParsingState; | |
| 75 | |
| 76 std::string compacted_source_; | |
| 77 std::vector<size_t> newline_indices_; | |
| 78 scoped_ptr<ParsingState> state_; | |
| 79 | |
| 80 DISALLOW_COPY_AND_ASSIGN(JtlParser); | |
| 81 }; | |
| 82 | |
| 83 #endif // CHROME_TOOLS_PROFILE_RESET_JTL_PARSER_H_ | |
| OLD | NEW |