tools/gn/test_with_scope.h

   1 // Copyright (c) 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 TOOLS_GN_TEST_WITH_SCOPE_H_
   6 #define TOOLS_GN_TEST_WITH_SCOPE_H_
   7
   8 #include <vector>
   9
  10 #include "base/basictypes.h"
  11 #include "tools/gn/build_settings.h"
  12 #include "tools/gn/err.h"
  13 #include "tools/gn/input_file.h"
  14 #include "tools/gn/parse_tree.h"
  15 #include "tools/gn/scope.h"
  16 #include "tools/gn/settings.h"
  17 #include "tools/gn/target.h"
  18 #include "tools/gn/token.h"
  19 #include "tools/gn/toolchain.h"
  20 #include "tools/gn/value.h"
  21
  22 // A helper class for setting up a Scope that a test can use. It makes a
  23 // toolchain and sets up all the build state.
  24 class TestWithScope {
  25  public:
  26   TestWithScope();
  27   ~TestWithScope();
  28
  29   BuildSettings* build_settings() { return &build_settings_; }
  30   Settings* settings() { return &settings_; }
  31   Toolchain* toolchain() { return &toolchain_; }
  32   Scope* scope() { return &scope_; }
  33
  34   // This buffer accumulates output from any print() commands executed in the
  35   // context of this test. Note that the implementation of this is not
  36   // threadsafe so don't write tests that call print from multiple threads.
  37   std::string& print_output() { return print_output_; }
  38
  39   // Parse the given string into a label in the default toolchain. This will
  40   // assert if the label isn't valid (this is intended for hardcoded labels).
  41   Label ParseLabel(const std::string& str) const;
  42
  43   // Fills in the tools for the given toolchain with reasonable default values.
  44   // The toolchain in this object will be automatically set up with this
  45   // function, it is exposed to allow tests to get the same functionality for
  46   // other toolchains they make
  47   static void SetupToolchain(Toolchain* toolchain);
  48
  49  private:
  50   void AppendPrintOutput(const std::string& str);
  51
  52   BuildSettings build_settings_;
  53   Settings settings_;
  54   Toolchain toolchain_;
  55   Scope scope_;
  56
  57   std::string print_output_;
  58
  59   DISALLOW_COPY_AND_ASSIGN(TestWithScope);
  60 };
  61
  62 // Helper class to treat some string input as a file.
  63 //
  64 // Instantiate it with the contents you want, be sure to check for error, and
  65 // then you can execute the ParseNode or whatever.
  66 class TestParseInput {
  67  public:
  68   explicit TestParseInput(const std::string& input);
  69   ~TestParseInput();
  70
  71   // Indicates whether and what error occurred during tokenizing and parsing.
  72   bool has_error() const { return parse_err_.has_error(); }
  73   const Err& parse_err() const { return parse_err_; }
  74
  75   const InputFile& input_file() const { return input_file_; }
  76   const std::vector<Token>& tokens() const { return tokens_; }
  77   const ParseNode* parsed() const { return parsed_.get(); }
  78
  79  private:
  80   InputFile input_file_;
  81
  82   std::vector<Token> tokens_;
  83   scoped_ptr<ParseNode> parsed_;
  84
  85   Err parse_err_;
  86
  87   DISALLOW_COPY_AND_ASSIGN(TestParseInput);
  88 };
  89
  90 // Shortcut for creating targets for tests that take the test setup, a pretty-
  91 // style label, and a target type and sets everything up. The target will
  92 // default to public visibility.
  93 class TestTarget : public Target {
  94  public:
  95   TestTarget(TestWithScope& setup,
  96              const std::string& label_string,
  97              Target::OutputType type);
  98   ~TestTarget() override;
  99 };
 100
 101 #endif  // TOOLS_GN_TEST_WITH_SCOPE_H_