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
|
// file : bpkg/archive.hxx -*- C++ -*-
// license : MIT; see accompanying LICENSE file
#ifndef BPKG_ARCHIVE_HXX
#define BPKG_ARCHIVE_HXX
#include <bpkg/types.hxx>
#include <bpkg/utility.hxx>
#include <bpkg/common-options.hxx>
namespace bpkg
{
// Return the package directory based on the package archive.
//
dir_path
package_dir (const path& archive);
// Start the process of extracting the archive to the specified directory.
//
pair<process, process>
start_extract (const common_options&,
const path& archive,
const dir_path&);
// Start the process of extracting the specified file from the archive to
// the process' stdout. If diag is false, then redirect stderr to /dev/null
// (this can be used, for example, to suppress diagnostics). Note that in
// this case process errors (like unable to start) are still reported.
//
// Return a pair of processes that form a pipe. Wait on the second first.
//
pair<process, process>
start_extract (const common_options&,
const path& archive,
const path& file,
bool diag = true);
// Start as above and then extract the file content as a string. If diag is
// false, then don't issue diagnostics about the reason why the file can't
// be extracted (not present, the archive is broken, etc).
//
string
extract (const common_options&,
const path& archive,
const path& file,
bool diag = true);
}
#endif // BPKG_ARCHIVE_HXX
|