aboutsummaryrefslogtreecommitdiff
path: root/build/scope
blob: 057fbc1ddeaf6a8914b845d56376983cf62bba6c (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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
// file      : build/scope -*- C++ -*-
// copyright : Copyright (c) 2014-2015 Code Synthesis Tools CC
// license   : MIT; see accompanying LICENSE file

#ifndef BUILD_SCOPE
#define BUILD_SCOPE

#include <functional>    // function
#include <unordered_set>
#include <unordered_map>

#include <build/path>
#include <build/path-map>
#include <build/variable>
#include <build/prerequisite>
#include <build/operation>

namespace build
{
  class scope
  {
  public:
    typedef build::path path_type;

    const path_type&
    path () const {return i_->first;} // Absolute and normalized.

    const path_type&
    src_path () const {return *src_path_;} // Corresponding src path.

    scope*
    parent_scope () const {return parent_;}

    // Root scope of this scope or NULL if this scope is not (yet)
    // in any (known) project. Note that if the scope itself is
    // root, then this function return this. To get to the outer
    // root, query the root scope of the parent.
    //
    scope*
    root_scope () const {return root_;}

    bool
    root () const {return root_ == this;}

    // Variable lookup. Note that this find, not find or insert like
    // in the variable_map, because we also search in outer scopes.
    // For the latter use the variables map directly.
    //
  public:
    value_proxy
    operator[] (const std::string&);

    value_proxy
    operator[] (const variable&);

    const path_type* src_path_ {nullptr}; // Cached src_{root,base} var value.

  public:
    variable_map variables;
    prerequisite_set prerequisites;

    // Meta/operations supported by this project (set on the root
    // scope only).
    //
    meta_operation_table meta_operations;
    operation_table operations;

    // Set of buildfiles already loaded for this scope. The included
    // buildfiles are checked against the project's root scope while
    // imported -- against the global scope (global_scope).
    //
    std::unordered_set<path_type> buildfiles;

    // A map of buildfiles to trigger functions that are executed when
    // such files are sourced. The path must be absolute and normalized.
    //
    // The passed path is the buildfile. If the returned value is true,
    // then the file is sourced. If false -- the file is ignored. Note
    // that currently triggers can only be registered on the project's
    // root scope.
    //
    using trigger_type = std::function<bool (scope&, const path_type&)>;
    std::unordered_map<path_type, trigger_type> triggers;

  private:
    friend class scope_map;
    typedef path_map<scope>::const_iterator iterator;

    scope (): variables (*this) {}

    iterator i_;
    scope* parent_;
    scope* root_;
  };

  class scope_map: public path_map<scope>
  {
  public:
    // Note that we assume the first insertion into the map is that
    // of the global scope.
    //
    std::pair<scope&, bool>
    insert (const path&, bool root);

    scope&
    operator[] (const path& p) {return insert (p, false).first;}

    // Find the most qualified scope that encompasses this path.
    //
    scope&
    find (const path&);

  private:
    typedef path_map<scope> base;
  };

  extern scope_map scopes;
  extern scope* global_scope;
}

#endif // BUILD_SCOPE