File size: 2,962 Bytes
985c397 | 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 | // SPDX-License-Identifier: LGPL-2.1-or-later
/***************************************************************************
* Copyright (c) 2012 Werner Mayer <wmayer[at]users.sourceforge.net> *
* *
* This file is part of the FreeCAD CAx development system. *
* *
* This library is free software; you can redistribute it and/or *
* modify it under the terms of the GNU Library General Public *
* License as published by the Free Software Foundation; either *
* version 2 of the License, or (at your option) any later version. *
* *
* This library 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 Library General Public License for more details. *
* *
* You should have received a copy of the GNU Library General Public *
* License along with this library; see the file COPYING.LIB. If not, *
* write to the Free Software Foundation, Inc., 51 Franklin Street, *
* Fifth Floor, Boston, MA 02110-1301, USA *
* *
***************************************************************************/
#ifndef BASE_DEBUGGER_H
#define BASE_DEBUGGER_H
#include <QEventLoop>
#include <QObject>
#ifndef FC_GLOBAL_H
# include <FCGlobal.h>
#endif
namespace Base
{
/**
This is a utility class to break the application at a point to inspect e.g. the result of
an algorithm.
You usually use it like this
\code
...
Base::Debugger dbg;
dbg.attach();
dbg.exec();
...
\endcode
Or you can connect it with a button and let the user click it in order to continue.
\code
QPushButton* btn = new QPushButton();
btn->setText("Continue");
btn->show();
Base::Debugger dbg;
connect(btn, &QPushButton::clicked, &dbg, &Debugger::quit);
dbg.exec();
\endcode
\author Werner Mayer
*/
class BaseExport Debugger: public QObject
{
Q_OBJECT
public:
explicit Debugger(QObject* parent = nullptr);
~Debugger() override;
Debugger(const Debugger&) = delete;
Debugger(Debugger&&) = delete;
Debugger& operator=(const Debugger&) = delete;
Debugger& operator=(Debugger&&) = delete;
void attach();
void detach();
bool eventFilter(QObject* obj, QEvent* event) override;
int exec();
public Q_SLOTS:
void quit();
private:
bool isAttached {false};
QEventLoop loop;
};
} // namespace Base
#endif // BASE_DEBUGGER_H
|