aboutsummaryrefslogtreecommitdiff
path: root/bpkg/archive.hxx
blob: cfc4cdbbf17ef3835769c37678addc52a6321233 (plain)
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