blob: 984786dc13f74e28f6ed3e09c52f8f56d9f740ca (
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
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
|
// file : bpkg/manifest-utility.hxx -*- C++ -*-
// copyright : Copyright (c) 2014-2018 Code Synthesis Ltd
// license : MIT; see accompanying LICENSE file
#ifndef BPKG_MANIFEST_UTILITY_HXX
#define BPKG_MANIFEST_UTILITY_HXX
#include <libbpkg/manifest.hxx>
#include <libbpkg/package-name.hxx>
#include <bpkg/types.hxx>
#include <bpkg/utility.hxx>
namespace bpkg
{
extern const path repositories_file; // repositories.manifest
extern const path packages_file; // packages.manifest
extern const path signature_file; // signature.manifest
extern const path manifest_file; // manifest
// Package naming schemes.
//
enum class package_scheme
{
none,
sys
};
// Extract scheme from [<scheme>:]<package>. Position the pointer right after
// the scheme end if present, otherwise leave unchanged.
//
package_scheme
parse_package_scheme (const char*&);
// Extract the package name and version components from <name>[/<version>].
// Diagnose invalid components and throw failed.
//
package_name
parse_package_name (const char*, bool allow_version = true);
inline package_name
parse_package_name (const string& s, bool allow_version = true)
{
return parse_package_name (s.c_str (), allow_version);
}
// Return empty version if none is specified.
//
version
parse_package_version (const char*);
inline version
parse_package_version (const string& s)
{
return parse_package_version (s.c_str ());
}
// If the passed location is a relative local path, then assume this is a
// relative path to the repository directory and complete it based on the
// current working directory. Diagnose invalid locations and throw failed.
//
repository_location
parse_location (const string&, optional<repository_type>);
// Return the repository state subdirectory for the specified location as it
// appears under .bpkg/repos/ in the bpkg configuration. Return empty
// directory if the repository type doesn't have any state.
//
// Note that the semantics used to produce this name is repository type-
// specific and can base on the repository canonical name or (potentially a
// subset of) the location URL. In particular, a state directory could be
// shared by multiple repository locations of the same type.
//
dir_path
repository_state (const repository_location&);
// Return true if the argument is a valid repository canonical name.
//
bool
repository_name (const string&);
// Return the version of a package as provided by the build2 version module.
// Return nullopt if the version module is disabled for the package (or the
// build2 project directory doesn't contain the manifest file). Fail if the
// directory is not a build2 project.
//
// Note that if the package directory is under the version control, then the
// resulting version may be populated with the snapshot information (see
// libbutl/standard-version.mxx for more details). Thus, this function can
// be used for fixing up the package manifest version.
//
class common_options;
optional<version>
package_version (const common_options&, const dir_path&);
}
#endif // BPKG_MANIFEST_UTILITY_HXX
|