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
122
123
124
125
126
127
128
129
130
131
|
// file : libbuild2/rule.hxx -*- C++ -*-
// license : MIT; see accompanying LICENSE file
#ifndef LIBBUILD2_RULE_HXX
#define LIBBUILD2_RULE_HXX
#include <libbuild2/types.hxx>
#include <libbuild2/forward.hxx>
#include <libbuild2/utility.hxx>
#include <libbuild2/action.hxx>
#include <libbuild2/target.hxx>
#include <libbuild2/recipe.hxx>
#include <libbuild2/export.hxx>
namespace build2
{
// Once a rule is registered (for a scope), it is treated as immutable. If
// you need to modify some state (e.g., counters or some such), then make
// sure it is MT-safe.
//
// Note: match() is only called once but may not be followed by apply().
//
class rule
{
public:
virtual bool
match (action, target&, const string& hint) const = 0;
virtual recipe
apply (action, target&) const = 0;
rule () = default;
rule (const rule&) = delete;
rule& operator= (const rule&) = delete;
};
// Fallback rule that only matches if the file exists. It will also match
// an mtime_target provided it has a set timestamp.
//
class LIBBUILD2_SYMEXPORT file_rule: public rule
{
public:
virtual bool
match (action, target&, const string&) const override;
virtual recipe
apply (action, target&) const override;
file_rule () {}
static const file_rule instance;
};
class LIBBUILD2_SYMEXPORT alias_rule: public rule
{
public:
virtual bool
match (action, target&, const string&) const override;
virtual recipe
apply (action, target&) const override;
alias_rule () {}
static const alias_rule instance;
};
// Note that this rule ignores the dry_run flag; see mkdir() in filesystem
// for the rationale.
//
class LIBBUILD2_SYMEXPORT fsdir_rule: public rule
{
public:
virtual bool
match (action, target&, const string&) const override;
virtual recipe
apply (action, target&) const override;
static target_state
perform_update (action, const target&);
static target_state
perform_clean (action, const target&);
// Sometimes, as an optimization, we want to emulate execute_direct()
// of fsdir{} without the overhead of switching to the execute phase.
//
static void
perform_update_direct (action, const target&);
fsdir_rule () {}
static const fsdir_rule instance;
};
// Fallback rule that always matches and does nothing.
//
class LIBBUILD2_SYMEXPORT noop_rule: public rule
{
public:
virtual bool
match (action, target&, const string&) const override;
virtual recipe
apply (action, target&) const override;
noop_rule () {}
static const noop_rule instance;
};
// Ad hoc recipe rule.
//
// Note: should not be used directly (e.g., registered, etc).
//
class LIBBUILD2_SYMEXPORT adhoc_rule: public rule
{
public:
virtual bool
match (action, target&, const string&) const override;
virtual recipe
apply (action, target&) const override;
adhoc_rule () {}
static const adhoc_rule instance;
static const rule_match match_instance;
};
}
#endif // LIBBUILD2_RULE_HXX
|
