aboutsummaryrefslogtreecommitdiff
path: root/libbuild2/bin/rule.hxx
blob: 74f43015cf3031bc2bb64bbda263a8891efb0240 (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
// file      : libbuild2/bin/rule.hxx -*- C++ -*-
// license   : MIT; see accompanying LICENSE file

#ifndef LIBBUILD2_BIN_RULE_HXX
#define LIBBUILD2_BIN_RULE_HXX

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

#include <libbuild2/rule.hxx>

#include <libbuild2/dist/rule.hxx>
#include <libbuild2/install/rule.hxx>

#include <libbuild2/bin/export.hxx>

namespace build2
{
  namespace bin
  {
    // "Fail rule" for obj{} and [h]bmi{} that issues diagnostics if someone
    // tries to build these groups directly.
    //
    // Note that for dist it acts as a pass-through to all existing (declared)
    // members.
    //
    class obj_rule: public dist::rule
    {
    public:
      obj_rule () {}

      virtual bool
      match (action, target&) const override;

      virtual recipe
      apply (action, target&) const override;
    };

    // This rule picks, matches, and unmatches (if possible) a member for the
    // purpose of making its metadata (for example, library's poptions, if
    // it's one of the cc libraries) available.
    //
    // The underlying idea here is that someone else (e.g., cc::link_rule)
    // makes a more informed choice and we piggy back on that decision,
    // falling back to making our own based on bin.lib and bin.exe.lib. Note
    // that for update this rule always returns target_state::unchanged.
    //
    // Note also that for dist it acts as a pass-through to all existing
    // (declared) members.
    //
    class libul_rule: public dist::rule
    {
    public:
      explicit
      libul_rule () {}

      virtual bool
      match (action, target&) const override;

      virtual recipe
      apply (action, target&) const override;
    };

    // Pass-through to group members rule, similar to alias.
    //
    // Note that for dist it always passes to both members.
    //
    class LIBBUILD2_BIN_SYMEXPORT lib_rule: public simple_rule
    {
    public:
      lib_rule () {}

      virtual bool
      match (action, target&) const override;

      virtual recipe
      apply (action, target&) const override;

      static target_state
      perform (action, const target&);
    };

    // Install rule for lib{} group.
    //
    // The only difference compared to the standard install::group_rule is
    // that it ignores the lib{} prerequisites, instead expecting the correct
    // things to be installed via the liba{}/libs{} members. This is important
    // due to the presence of match options (see lib{} target for details).
    //
    class LIBBUILD2_BIN_SYMEXPORT install_lib_rule: public install::group_rule
    {
    public:
      install_lib_rule () {}

      virtual pair<const target*, uint64_t>
      filter (const scope*,
              action, const target&, const prerequisite&,
              match_extra&) const override;

      using install::group_rule::filter; // "Unhide" to make Clang happy.
    };
  }
}

#endif // LIBBUILD2_BIN_RULE_HXX