aboutsummaryrefslogtreecommitdiff
path: root/bpkg/archive.hxx
blob: c6461850050ef4f2ff910bd7afe2ad4c6006af26 (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
// file      : bpkg/archive.hxx -*- C++ -*-
// copyright : Copyright (c) 2014-2019 Code Synthesis Ltd
// license   : MIT; see accompanying LICENSE file

#ifndef BPKG_ARCHIVE_HXX
#define BPKG_ARCHIVE_HXX

#include <libbutl/process.mxx>

#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 specified file from the archive. 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 printed.
  //
  // Return a pair of processes that form a pipe. Wait on the second first.
  //
  pair<butl::process, butl::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