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
132
133
134
135
136
137
138
139
140
141
|
// file : bdep/sync.hxx -*- C++ -*-
// license : MIT; see accompanying LICENSE file
#ifndef BDEP_SYNC_HXX
#define BDEP_SYNC_HXX
#include <bdep/types.hxx>
#include <bdep/utility.hxx>
#include <bdep/project.hxx>
#include <bdep/sync-options.hxx>
namespace bdep
{
// A RAII class that restores the original value of the BDEP_SYNCED_CONFIGS
// environment variable on destruction.
//
class synced_configs_guard
{
public:
optional<optional<string>> original; // Set to absent to disarm.
synced_configs_guard () = default;
synced_configs_guard (optional<string> o): original (move (o)) {}
~synced_configs_guard ();
synced_configs_guard (synced_configs_guard&& r) noexcept
: original (move (r.original))
{
r.original = nullopt;
}
synced_configs_guard (const synced_configs_guard&) = delete;
synced_configs_guard& operator= (synced_configs_guard&&) = delete;
synced_configs_guard& operator= (const synced_configs_guard&) = delete;
};
// The optional pkg_args are the additional dependency packages and/or
// configuration variables to pass to bpkg-pkg-build (see bdep-init).
//
// If fetch is false, don't perform a (shallow) fetch of the project
// repository. If yes is false, then don't suppress bpkg prompts. If
// name_cfg is true then include the configuration name/directory into
// progress.
//
// Before automatically creating a configuration for a build-time dependency
// and associating it with the project(s), the user is prompted unless the
// respective create_*_config argument is true.
//
// If the transaction is already started on the project's database, then it
// must also be passed to the function along with a pointer to the
// configuration paths/types list. If the function will be associating
// build-time dependency configurations with the project, it will do it as
// part of this transaction and will also save the created dependency
// configurations into this list. If this transaction is rolled back for any
// reason (for example, because the failed exception is thrown by cmd_sync()
// call), then the caller must start the new transaction and re-associate
// the created configurations with the project using the configuration types
// also as their names.
//
synced_configs_guard
cmd_sync (const common_options&,
const dir_path& prj,
const shared_ptr<configuration>&,
bool implicit,
const strings& pkg_args = strings (),
bool fetch = true,
bool yes = true,
bool name_cfg = false,
bool create_host_config = false,
bool create_build2_config = false,
transaction* = nullptr,
vector<pair<dir_path, string>>* created_cfgs = nullptr);
// As above but sync multiple configurations. If some configurations belong
// to the same cluster, then they are synced at once.
//
void
cmd_sync (const common_options&,
const dir_path& prj,
const configurations&,
bool implicit,
const strings& pkg_args = strings (),
bool fetch = true,
bool yes = true,
bool name_cfg = false,
bool create_host_config = false,
bool create_build2_config = false);
// As above but perform an implicit sync without a configuration object
// (i.e., as if from the hook).
//
synced_configs_guard
cmd_sync_implicit (const common_options&,
const dir_path& cfg,
bool fetch = true,
bool yes = true,
bool name_cfg = true,
bool create_host_config = false,
bool create_build2_config = false);
// As above but sync multiple configurations. If some configurations belong
// to the same cluster, then they are synced at once.
//
void
cmd_sync_implicit (const common_options&,
const dir_paths& cfgs,
bool fetch = true,
bool yes = true,
bool name_cfg = true,
bool create_host_config = false,
bool create_build2_config = false);
int
cmd_sync (cmd_sync_options&&, cli::group_scanner& args);
// Return the list of additional (to prj, if not empty) projects that are
// using this configuration.
//
dir_paths
configuration_projects (const common_options& co,
const dir_path& cfg,
const dir_path& prj = dir_path ());
default_options_files
options_files (const char* cmd,
const cmd_sync_options&,
const strings& args);
cmd_sync_options
merge_options (const default_options<cmd_sync_options>&,
const cmd_sync_options&);
// Note that the hook is installed into the bpkg-created configuration which
// always uses the standard build file/directory naming scheme.
//
extern const path hook_file; // build/bootstrap/pre-bdep-sync.build
}
#endif // BDEP_SYNC_HXX
|
