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
|
/*
* This file is part of Poedit (https://poedit.net)
*
* Copyright (C) 2000-2026 Vaclav Slavik
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*
*/
#ifndef Poedit_cat_operations_h
#define Poedit_cat_operations_h
#include "catalog.h"
#include "gexecute.h"
/// Summary data about the result of merging two catalogs.
struct MergeStats
{
struct Key
{
wxString str, str_plural, context, sym_id;
Key(const wxString& sym_id_) : sym_id(sym_id_) {}
Key(const wxString& str_, const wxString& str_plural_, const wxString& context_)
: str(str_), str_plural(str_plural_), context(context_) {}
Key(const wxString& str_, const wxString& str_plural_, const wxString& context_, const wxString& sym_id_)
: str(str_), str_plural(str_plural_), context(context_), sym_id(sym_id_) {}
auto operator<(const Key& other) const
{
return std::tie(str, str_plural, context, sym_id) < std::tie(other.str, other.str_plural, other.context, other.sym_id);
}
wxString to_string() const
{
wxString s = str;
if (!str_plural.empty())
s += " | " + str_plural;
if (s.empty())
s = sym_id;
if (!context.empty())
s += wxString::Format(" [%s]", context);
return s;
}
};
// Added and removed strings (as their summary representation, not the full items)
std::vector<Key> added;
std::vector<Key> removed;
int changes_count() const { return int(added.size() + removed.size()); }
// Any errors/warnings that occurred during the merge
ParsedGettextErrors errors;
};
/// Resulting data from a merge operation.
struct MergeResult
{
CatalogPtr updated_catalog;
ParsedGettextErrors errors;
explicit operator bool() const { return updated_catalog != nullptr; }
};
/**
Calculates difference between a catalog and a reference ("upstream") one
w.r.t. merging operation, i.e. different in source strings.
*/
extern void ComputeMergeStats(MergeStats& r, CatalogPtr catalog, CatalogPtr reference);
/**
Merges catalog with a reference catalog, updating catalog with new strings
present in @a reference and removing strings that are no longer present there.
@note The returned updated_catalog may be the same as @a catalog, but it may also be
a new object, possibly also @a reference. Don't make assumptions about it and
always treat it as an entirely new object.
@warning The @a reference object cannot be used after being passed to this function!
*/
extern MergeResult MergeCatalogWithReference(CatalogPtr catalog, CatalogPtr reference);
#endif // Poedit_cat_operations_h
|
