blob: 9f68d61b529eaa76b553d2beb32cf789f9738aa8 (
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
/*
This file is part of libdjinterop.
libdjinterop is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
libdjinterop is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with libdjinterop. If not, see <http://www.gnu.org/licenses/>.
*/
#pragma once
#ifndef DJINTEROP_DATABASE_HPP
#define DJINTEROP_DATABASE_HPP
#if __cplusplus < 201703L
#error This library needs at least a C++17 compliant compiler
#endif
#include <cstdint>
#include <memory>
#include <optional>
#include <stdexcept>
#include <string>
#include <vector>
#include <djinterop/config.hpp>
namespace sqlite
{
class database;
}
namespace djinterop
{
class crate;
class database_impl;
struct semantic_version;
class track;
class transaction_guard;
class database_not_found : public std::runtime_error
{
public:
explicit database_not_found(const std::string& what_arg) noexcept
: runtime_error{what_arg}
{
}
};
class DJINTEROP_PUBLIC database
{
public:
/// Copy constructor
database(const database& db);
/// Destructor
~database();
/// Copy assignment operator
database& operator=(const database& db);
transaction_guard begin_transaction() const;
/// Returns the crate with the given ID
///
/// If no such crate exists in the database, then `djinterop::std::nullopt`
/// is returned.
std::optional<crate> crate_by_id(int64_t id) const;
/// Returns all crates contained in the database
std::vector<crate> crates() const;
/// Returns all crates with the given name
std::vector<crate> crates_by_name(const std::string& name) const;
/// Creates a new root crate with the given name.
///
/// The created crate has no parent.
crate create_root_crate(std::string name) const;
/// Creates a new track associated to a given music file
///
/// The music file is given by its relative path from the directory passed
/// to the `database` constructor. The created track is not contained in any
/// crates.
track create_track(std::string relative_path) const;
/// Returns the path directory of the database
///
/// This is the same as the directory passed to the `database` constructor.
std::string directory() const;
/// Returns true iff the database version is supported by this version of
/// `libdjinterop` or not
bool is_supported() const;
/// Returns the UUID of the database
std::string uuid() const;
/// Verifies the consistency of the internal storage of the database.
///
/// A `database_inconsistency` (or some exception derived from it) is thrown
/// if any kind of inconsistency is found.
void verify() const;
/// Returns the schema version of the database
semantic_version version() const;
/// Removes a crate from the database
///
/// All handles to that crate become invalid.
void remove_crate(crate cr) const;
/// Removes a track from the database
///
/// All handles to that track become invalid.
void remove_track(track tr) const;
/// Returns the root-level crate with the given name.
///
/// If no such crate exists, then `djinterop::std::nullopt` is returned.
std::optional<crate> root_crate_by_name(const std::string& name) const;
/// Returns all root crates contained in the database
///
/// A root crate is a crate that has no parent.
std::vector<crate> root_crates() const;
/// Returns the track with the given id
///
/// If no such track exists in the database, then `djinterop::std::nullopt`
/// is returned.
std::optional<track> track_by_id(int64_t id) const;
/// Returns all tracks whose `relative_path` attribute in the database
/// matches the given string
std::vector<track> tracks_by_relative_path(
const std::string& relative_path) const;
/// Returns all tracks contained in the database
std::vector<track> tracks() const;
// TODO (haslersn): non public?
database(std::shared_ptr<database_impl> pimpl);
private:
std::shared_ptr<database_impl> pimpl_;
};
} // namespace djinterop
#endif // DJINTEROP_DATABASE_HPP
|
