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
142
143
144
145
146
147
148
|
// file : bdep/git.hxx -*- C++ -*-
// license : MIT; see accompanying LICENSE file
#ifndef BDEP_GIT_HXX
#define BDEP_GIT_HXX
#include <libbutl/git.mxx>
#include <bdep/types.hxx>
#include <bdep/utility.hxx>
#include <bdep/common-options.hxx>
namespace bdep
{
using butl::git_repository;
// All functions that start git process take the minimum supported git
// version as an argument.
//
// Start git process.
//
template <typename I, typename O, typename E, typename... A>
process
start_git (const semantic_version&, I&& in, O&& out, E&& err, A&&... args);
template <typename I, typename O, typename E, typename... A>
process
start_git (const semantic_version&,
const dir_path& repo,
I&& in, O&& out, E&& err,
A&&... args);
template <typename I, typename O, typename E, typename... A>
inline process
start_git (const semantic_version& min_ver,
dir_path& repo,
I&& in, O&& out, E&& err,
A&&... args)
{
return start_git (min_ver,
const_cast<const dir_path&> (repo),
forward<I> (in), forward<O> (out), forward<E> (err),
forward<A> (args)...);
}
// Wait for git process to terminate.
//
void
finish_git (process& pr, bool io_read = false);
// Run git process.
//
template <typename... A>
void
run_git (const semantic_version&,
bool progress,
const dir_path& repo,
A&&... args);
template <typename... A>
inline void
run_git (const semantic_version& min_ver, const dir_path& repo, A&&... args)
{
run_git (min_ver, true /* progress */, repo, forward<A> (args)...);
}
// Return the first line of the git output. If ignore_error is true, then
// suppress stderr, ignore (normal) error exit status, and return nullopt.
//
template <typename... A>
optional<string>
git_line (const semantic_version&, bool ignore_error, A&&... args);
template <typename... A>
optional<string>
git_line (const semantic_version&,
const dir_path& repo,
bool ignore_error,
A&&... args);
// Similar to the above but takes the already started git process with a
// redirected output pipe.
//
optional<string>
git_line (process&&, fdpipe&&, bool ignore_error, char delim = '\n');
// Similar to git_line() functions but return the complete git output.
//
template <typename... A>
optional<string>
git_string (const semantic_version&, bool ignore_error, A&&... args);
template <typename... A>
optional<string>
git_string (const semantic_version&,
const dir_path& repo,
bool ignore_error,
A&&... args);
optional<string>
git_string (process&&, fdpipe&&, bool ignore_error);
// Try to derive a remote HTTPS repository URL from the optionally specified
// custom git config value falling back to remote.origin.build2Url and then
// remote.origin.url. Issue diagnostics (including a suggestion to use
// option opt, if specified) and fail if unable to.
//
url
git_remote_url (const dir_path& repo,
const char* opt = nullptr,
const char* what = "remote repository URL",
const char* cfg = nullptr);
// Repository status.
//
struct git_repository_status
{
string commit; // Current commit or empty if initial.
string branch; // Local branch or empty if detached.
string upstream; // Upstream in <remote>/<branch> form or empty if not set.
// Note that unmerged and untracked entries are considered as unstaged.
//
bool staged = false; // Repository has staged changes.
bool unstaged = false; // Repository has unstaged changes.
// Note that we can be both ahead and behind.
//
bool ahead = false; // Local branch is ahead of upstream.
bool behind = false; // Local branch is behind of upstream.
};
// Note: requires git 2.11.0 or higher.
//
git_repository_status
git_status (const dir_path& repo);
// Run the git push command.
//
template <typename... A>
void
git_push (const common_options&, const dir_path& repo, A&&... args);
}
#include <bdep/git.ixx>
#include <bdep/git.txx>
#endif // BDEP_GIT_HXX
|
