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
|
// file : bdep/git.hxx -*- C++ -*-
// copyright : Copyright (c) 2014-2019 Code Synthesis Ltd
// 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);
// 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&& pr, fdpipe&& pipe, 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
|