mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-10-17 19:34:13 +02:00
ispyisail
2bd19e04be
A .qetz that does not open as it is -- a picture's file missing (as the title-change fault wrote them), a folio file missing, a row deleted from project.sqlite by hand (issue #1458), a damaged database -- was refused whole, and nothing in QElectroTech could get anything back. QetContainer::recover() reads what it can and says what it left out: an entry that cannot be unpacked, a missing folio file or picture, a symbol or wire that does not match the database, and, when the database cannot be read at all, the information it held (the wires go too, as it holds their ends). join(), restore() and QetZip::fromBytes() take an optional list for this; given none they refuse as before. `qelectrotech --recover damaged.qetz out.qet` writes what was read to a .qet and lists what was left out. Measured on industrial (50 folios, 618 symbols, 671 wires): a wire row deleted -> 670 wires, the rest whole; a folio file missing -> 49 folios; a database page overwritten -> every folio and symbol drawn, no wires and no symbol information. A zip cut short (no central directory) still cannot be read. Tests: recoverLeavesOutOnlyTheDamage (nothing, folio file, wire row, database page), recoverMissingPicture, recoverNotAZipRefused; they fail with the database side kept strict. The strict cases pass unchanged. ctest 106/106. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
57 lines
2.3 KiB
C++
57 lines
2.3 KiB
C++
/*
|
|
Copyright 2006-2026 The QElectroTech Team
|
|
This file is part of QElectroTech.
|
|
|
|
QElectroTech 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, either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
QElectroTech 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 QElectroTech. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
#ifndef QETCONTAINERDB_H
|
|
#define QETCONTAINERDB_H
|
|
|
|
#include <QByteArray>
|
|
#include <QDomElement>
|
|
#include <QStringList>
|
|
|
|
/**
|
|
@brief The QetContainerDb namespace
|
|
The engineering data of a project, moved between its document and the
|
|
project.sqlite of a .qetz: what a folio's title block says, a symbol's
|
|
information, a coil's contacts, a wire's ends and number. In a .qetz
|
|
these live only in the database; the folio files keep where things are
|
|
drawn. extract() takes them out of the document into a database,
|
|
restore() puts them back, so that restore(extract(d)) is d.
|
|
|
|
A row's key is its item's uuid, which stays in the folio file. An item
|
|
without a uuid of its own -- none, or one another item shares -- gets a
|
|
uuid made from what it holds, left in the document as qetz-key or
|
|
qetz-folio. A block of a shape
|
|
this does not model -- a value holding elements, say -- stays in the
|
|
document, so nothing can be lost by moving.
|
|
*/
|
|
namespace QetContainerDb
|
|
{
|
|
QByteArray extract(QDomElement project, QString *error = nullptr,
|
|
const QByteArray &kept_from = QByteArray());
|
|
/// With @p lost, a damaged project being recovered: what does not
|
|
/// match is noted there and left out, instead of refusing it all
|
|
bool restore(QDomElement project, const QByteArray &database, QString *error = nullptr,
|
|
QStringList *lost = nullptr);
|
|
/// What only the database could fill, left in @p project after a
|
|
/// restore() with lost, taken out; said in @p lost
|
|
void dropLeftovers(QDomElement project, QStringList *lost);
|
|
/// true if @p database is of the format this writes
|
|
bool currentFormat(const QByteArray &database);
|
|
}
|
|
|
|
#endif // QETCONTAINERDB_H
|