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
|
// 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/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;
};
// 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;
};
}
#endif // LIBBUILD2_RULE_HXX
|