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
|
/*
* Copyright 2014 Canonical Ltd.
*
* This file is part of webbrowser-app.
*
* webbrowser-app is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; version 3.
*
* webbrowser-app 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#include <QDir>
#include <QHash>
#include <QString>
#include <QStringList>
#include <exception>
namespace HookUtils {
/**
* @brief The WebappHookParser class
*/
class WebappHookParser {
public:
/*
* Warning: The values exposed by the Data POD
* should have default values set to no-ops
* in case of any parsing failure so that the associated
* actions are not triggered.
*/
struct Data
{
Data ()
: shouldDeleteCacheOnUninstall(false)
, shouldDeleteCookiesOnUninstall(false) {}
bool shouldDeleteCacheOnUninstall;
bool shouldDeleteCookiesOnUninstall;
};
public:
Data parseContent(const QString& filename);
private:
Data parseDocument(const QJsonArray& array);
};
/**
* @brief Simple POD for click hook files & their parent folders.
*/
struct WebappClickHookInstallDescription
{
WebappClickHookInstallDescription(
const QString& folder,
const QHash<QString, QString>& files)
: parentFolder(folder), hookFiles(files) {}
QString parentFolder;
QHash<QString, QString> hookFiles;
};
/**
* @brief listWebappProcessedClickHookFilesIn
* @param dir
* @return
*/
WebappClickHookInstallDescription
listWebappProcessedClickHookFilesIn(const QDir& dir);
/**
* @brief listWebappInstalledClickHookFilesIn
* @param dir
* @return
*/
WebappClickHookInstallDescription
listWebappInstalledClickHookFilesIn(const QDir& dir);
/**
* @brief getProcessedClickHooksFolder
* @return
*/
QString getProcessedClickHooksFolder();
/**
* @brief getClickHooksInstallFolder
* @return
*/
QString getClickHooksInstallFolder();
/**
* @brief removeVersionFrom
* @param appId
* @return
*/
QString removeVersionFrom(const QString& appId);
/**
* @brief handleInstalls Detects click package uninstalls and handled what's needed
* @param alreadyProcessedClickHooks
* @param currentClickHooks
*/
void handleInstalls(const WebappClickHookInstallDescription& alreadyProcessedClickHooks
, const WebappClickHookInstallDescription& currentClickHooks);
/**
* @brief handleUninstall Detects click package uninstalls and handled what's needed
* @param alreadyProcessedClickHooks
* @param currentClickHooks
*/
void handleUninstall(const WebappClickHookInstallDescription& alreadyProcessedClickHooks
, const WebappClickHookInstallDescription& currentClickHooks);
/**
* @brief handleUpdates
* @param alreadyProcessedClickHooks
* @param currentClickHooks
*/
void handleUpdates(const WebappClickHookInstallDescription& alreadyProcessedClickHooks
, const WebappClickHookInstallDescription& installedClickHooks);
} // namespace HookUtils
|