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
|
// file : bpkg/pkg-configure.hxx -*- C++ -*-
// license : MIT; see accompanying LICENSE file
#ifndef BPKG_PKG_CONFIGURE_HXX
#define BPKG_PKG_CONFIGURE_HXX
#include <libbpkg/manifest.hxx> // version
#include <libbpkg/package-name.hxx>
#include <bpkg/types.hxx>
#include <bpkg/forward.hxx> // transaction, selected_package
#include <bpkg/utility.hxx>
#include <bpkg/package.hxx> // package_prerequisites,
// dependencies.
#include <bpkg/package-skeleton.hxx>
#include <bpkg/pkg-configure-options.hxx>
namespace bpkg
{
int
pkg_configure (const pkg_configure_options&, cli::scanner& args);
// Configure a system package and commit the transaction.
//
shared_ptr<selected_package>
pkg_configure_system (const package_name&,
const version&,
database&,
transaction&);
// The custom search function. If specified, it is called by pkg_configure()
// to obtain the database to search for the prerequisite in, instead of
// searching for it in the linked databases, recursively. If the function
// returns NULL, then fallback to the recursive search through the linked
// databases.
//
using find_database_function = database* (database&,
const package_name&,
bool buildtime);
// Given dependencies of a package, return its prerequisite packages,
// configuration variables that resulted from selection of these
// prerequisites (import, reflection, etc), and sources of the configuration
// variables resulted from evaluating the reflect clauses. See
// pkg_configure() for the semantics of the dependency list. Fail if for
// some of the dependency alternative lists there is no satisfactory
// alternative (all its dependencies are configured, satisfy the respective
// constraints, etc).
//
// The package dependency constraints are expected to be complete.
//
// The dependencies argument may contain pre-selected dependency
// alternatives (with the potential empty entries for the toolchain
// build-time dependencies or for dependencies with all the alternatives
// disabled; see pkg-build for the use-case). In this case the number of
// dependency alternatives for each dependency must be 1 (or 0) and the
// alternatives argument must be specified. The alternatives argument must
// be parallel to the dependencies argument and specify indexes of the
// selected alternatives.
//
// If prerequisites corresponding to the previous configured state of the
// package are specified, then for each depends value try to select an
// alternative where dependencies all belong to this list (the "recreate
// dependency decisions" mode). Failed that, select an alternative as if no
// prerequisites are specified (the "make dependency decisions" mode).
//
struct configure_prerequisites_result
{
package_prerequisites prerequisites;
strings config_variables; // Note: name and value.
// Only contains sources of configuration variables collected using the
// package skeleton, excluding those user-specified variables which are
// not the project variables for the specified package (module
// configuration variables, etc). Thus, it is not parallel to the
// config_variables member.
//
vector<config_variable> config_sources; // Note: name and source.
};
// Return the "would be" state for packages that would be configured
// by this stage.
//
using find_package_state_function =
optional<pair<package_state, package_substate>> (
const shared_ptr<selected_package>&);
// Note: loads selected packages.
//
configure_prerequisites_result
pkg_configure_prerequisites (const common_options&,
database&,
transaction&,
const dependencies&,
const vector<size_t>* alternatives,
package_skeleton&&,
const vector<package_name>* prev_prerequisites,
bool simulate,
const function<find_database_function>&,
const function<find_package_state_function>&);
// Configure the package, update its state, and commit the transaction.
//
void
pkg_configure (const common_options&,
database&,
transaction&,
const shared_ptr<selected_package>&,
configure_prerequisites_result&&,
bool disfigured,
bool simulate);
// Note: loads selected packages.
//
void
pkg_configure (const common_options&,
database&,
transaction&,
const shared_ptr<selected_package>&,
const dependencies&,
const vector<size_t>* alternatives,
package_skeleton&&,
const vector<package_name>* prev_prerequisites,
bool disfigured,
bool simulate,
const function<find_database_function>& = {});
}
#endif // BPKG_PKG_CONFIGURE_HXX
|
