1/*
2 knewstuff3/errorcode.h.
3 SPDX-FileCopyrightText: 2018 Dan Leinir Turthra Jensen <admin@leinir.dk>
4
5 SPDX-License-Identifier: LGPL-2.1-or-later
6*/
7
8#ifndef KNSCORE_ERRORCODE_H
9#define KNSCORE_ERRORCODE_H
10
11#include "knewstuffcore_export.h"
12#include <qobjectdefs.h>
13
14/*!
15 * \namespace KNSCore::ErrorCode
16 * \inmodule KNewStuffCore
17 */
18namespace KNSCore::ErrorCode
19{
20Q_NAMESPACE_EXPORT(KNEWSTUFFCORE_EXPORT)
21/**
22 * \enum KNSCore::ErrorCode::ErrorCode
23 *
24 * \brief An enumeration of specific error conditions which might occur and which
25 * users of KNewStuff would want to react to. It is used by both the Engine and
26 * Provider classes.
27 *
28 * \since 5.53
29 * TODO: KF6 do not repeat entry properties in the QVariantList
30
31 * \value UnknownError
32 * An unknown error (this should not be used, an error report of this nature should be considered a bug)
33 *
34 * \value NetworkError
35 * A network error. In signalErrorCode, this will be accompanied by the
36 * QtNetwork error code in the metadata
37 *
38 * \value OcsError
39 * An error reported by the OCS API server. In signalErrorCode, this will be
40 * accompanied by the OCS error code in the metadata
41 *
42 * \value ConfigFileError
43 * The configuration file is missing or somehow incorrect. The configuration
44 * file filename will be held in the metadata
45 *
46 * \value ProviderError
47 * A provider has failed to load or initialize. The provider file URL or
48 * provider URL will be held in the metadata
49 *
50 * \value InstallationError
51 * Installation of a content item has failed. If known, the entry's unique ID
52 * will be the metadata
53 *
54 * \value ImageError
55 * Loading an image has failed. The entry name and preview type which failed
56 * will be held in the metadata as a QVariantList
57 *
58 * \value AdoptionError
59 * Adopting one entry has failed. The adoption command will be in the metadata
60 * as a QVariantList.
61 *
62 * \value TryAgainLaterError
63 * Specific error condition for failed network calls which explicitly request
64 * an amount of time to wait before retrying (generally interpreted as
65 * maintenance). The retry will be scheduled automatically, and this code can
66 * be used to show the user how long they have to wait. The time after which
67 * the user can try again can be read as a QDateTime in the metadata. \since 5.84
68 */
69enum ErrorCode {
70 UnknownError,
71 NetworkError,
72 OcsError,
73 ConfigFileError,
74 ProviderError,
75 InstallationError,
76 ImageError,
77 AdoptionError,
78 TryAgainLaterError,
79};
80Q_ENUM_NS(ErrorCode)
81}
82#endif // KNSCORE_ERRORCODE_H
83

source code of knewstuff/src/core/errorcode.h