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
|
// file : libbuild2/script/run.hxx -*- C++ -*-
// license : MIT; see accompanying LICENSE file
#ifndef LIBBUILD2_SCRIPT_RUN_HXX
#define LIBBUILD2_SCRIPT_RUN_HXX
#include <libbuild2/types.hxx>
#include <libbuild2/utility.hxx>
#include <libbuild2/script/script.hxx>
namespace build2
{
namespace script
{
// An exception that can be thrown by an expression running function to
// exit the script (for example, as a result of executing the exit builtin
// by the below run*() functions). The status indicates whether the
// execution should be considered to have succeeded or failed.
//
struct exit
{
bool status;
explicit
exit (bool s): status (s) {}
};
// Helpers.
//
// Command expression running functions.
//
// Index is the 1-base index of this command line in the command list.
// If it is 0 then it means there is only one command. This information
// can be used, for example, to derive file names.
//
// Location is the start position of this command line in the script. It
// can be used in diagnostics.
//
// Optionally, save the command output into the referenced variable. In
// this case assume that the expression contains a single pipline.
//
void
run (environment&,
const command_expr&,
size_t index,
const location&,
string* output = nullptr);
bool
run_if (environment&,
const command_expr&,
size_t index,
const location&,
string* output = nullptr);
// Perform the registered special file cleanups in the direct order and
// then the regular cleanups in the reverse order.
//
void
clean (environment&, const location&);
// Print first 10 directory sub-entries to the diag record. The directory
// must exist. Is normally used while issuing diagnostics on non-empty
// directory removal failure.
//
void
print_dir (diag_record&, const dir_path&, const location&);
// Return the quoted path representation with the preserved trailing
// directory separator. The path is relative if the verbosity level is
// less than 3.
//
string
diag_path (const path&);
// Same as above, but prepends the path with a name, if present. The path
// must be not NULL.
//
string
diag_path (const dir_name_view&);
}
}
#endif // LIBBUILD2_SCRIPT_RUN_HXX
|
