aboutsummaryrefslogtreecommitdiff
path: root/build2/test/script/runner.hxx
blob: 17b4de11e0171492b4fcb4c19c96b8da77c30894 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
// file      : build2/test/script/runner.hxx -*- C++ -*-
// copyright : Copyright (c) 2014-2018 Code Synthesis Ltd
// license   : MIT; see accompanying LICENSE file

#ifndef BUILD2_TEST_SCRIPT_RUNNER_HXX
#define BUILD2_TEST_SCRIPT_RUNNER_HXX

#include <build2/types.hxx>
#include <build2/utility.hxx>

#include <build2/diagnostics.hxx> // location

#include <build2/test/script/script.hxx>

namespace build2
{
  namespace test
  {
    struct common;

    namespace script
    {
      // An exception that can be thrown by a runner to exit the scope (for
      // example, as a result of executing the exit builtin). The status
      // indicates whether the scope should be considered to have succeeded
      // or failed.
      //
      struct exit_scope
      {
        bool status;

        explicit
        exit_scope (bool s): status (s) {}
      };

      class runner
      {
      public:
        // Return false if this test/group should be skipped.
        //
        virtual bool
        test (scope&) const = 0;

        // Location is the scope start location (for diagnostics, etc).
        //
        virtual void
        enter (scope&, const location&) = 0;

        // Index is the 1-base index of this command line in the command list
        // (e.g., in a compound test). If it is 0 then it means there is only
        // one command (e.g., a simple test). This information can be used,
        // for example, to derive file names.
        //
        // Location is the start position of this command line in the
        // testscript. It can be used in diagnostics.
        //
        virtual void
        run (scope&,
             const command_expr&, command_type,
             size_t index,
             const location&) = 0;

        virtual bool
        run_if (scope&, const command_expr&, size_t, const location&) = 0;

        // Location is the scope end location (for diagnostics, etc).
        //
        virtual void
        leave (scope&, const location&) = 0;
      };

      class default_runner: public runner
      {
      public:
        explicit
        default_runner (const common& c): common_ (c) {}

        virtual bool
        test (scope& s) const override;

        virtual void
        enter (scope&, const location&) override;

        virtual void
        run (scope&,
             const command_expr&, command_type,
             size_t,
             const location&) override;

        virtual bool
        run_if (scope&, const command_expr&, size_t, const location&) override;

        virtual void
        leave (scope&, const location&) override;

      private:
        const common& common_;
      };
    }
  }
}

#endif // BUILD2_TEST_SCRIPT_RUNNER_HXX