mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-10-14 17:44:13 +02:00
ispyisail
8d118faf36
Answers the points arummler raised in discussion #1440 about the
project.sqlite that .qetz files carry (format 2, PR #1462):
- Folio rows were keyed "f1", "f2"... by position, and every symbol and
wire carried a separate key beside its uuid. A row's key is now the
item's own uuid, which stays in the folio file; no key attribute is
added to the folio files of a project as QElectroTech saves it. An item
without a usable uuid (none, or one another item shares, F100) gets a
uuid made from its own content, the same on every save, never from
where it is.
- freezeLabel is stored as 0/1 (INTEGER) and an element information's
"show" in its own column; a value QElectroTech would not write stays in
the folio file verbatim. The tag is kept in the JSON only when it is
not the usual one.
- The database's PRAGMA user_version holds the format.
Format 3. Format 2 files, written by development builds since #1462,
still open: tst_qetcontainer reads one (fixtures/qetz_format2.qetz,
grafcet.qet saved by master aa503aec8) and saves it again.
Checked: tst_qetcontainer 38/38, and 343/343 readable projects of the
legacy corpus round-trip exactly. Every example saved as .qetz then .qet
equals its plain resave, and every format 2 file read by this build
equals what master writes from it. Each new test goes red with the
behaviour it checks broken.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
47 lines
1.8 KiB
C++
47 lines
1.8 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>
|
|
|
|
/**
|
|
@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);
|
|
bool restore(QDomElement project, const QByteArray &database, QString *error = nullptr);
|
|
}
|
|
|
|
#endif // QETCONTAINERDB_H
|