Files
qelectrotech-source-mirror/sources/import/edz/edzarchive.h
T
Shane Ringrose 207c0c9544 Fix copyright years and deduplicate terminal names
Two issues raised in PR review:

1. Copyright year: new files carried "2006" (the project's founding year).
   Updated to "2006-2026" to reflect the actual authorship period.

2. Duplicate terminal names: EPLAN parts can have multiple connection
   templates sharing the same connectionDesignation (e.g. a drive where
   both wire entries of terminal "1" are labelled "1").  QET requires
   unique terminal names for wiring and terminal-diagram generation.

   Resolution order in EdzElementBuilder::build():
   - Unique designation → used as-is.
   - Duplicated designation with distinct sanitised description →
     "designation_description" (e.g. "1_L_P").
   - Otherwise → numeric suffix: "1", "1_2", "1_3", …

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-20 22:39:11 +12:00

57 lines
1.6 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 EDZARCHIVE_H
#define EDZARCHIVE_H
#include <QString>
#include <QScopedPointer>
class QTemporaryDir;
/**
@brief Extracts an EPLAN Data Portal package (.edz) to a temporary folder.
A .edz is a 7-Zip archive holding a part definition (part.xml), an EPLAN
macro, a product image and metadata. EdzArchive unpacks it so the rest of the
import pipeline can read the (portable) part.xml.
Extraction uses the bundled (public-domain) LZMA SDK 7-Zip reader, so no
external 7-Zip is required at runtime (see edzsevenzip).
The extracted tree lives in a QTemporaryDir owned by this object and is
removed when the EdzArchive is destroyed.
*/
class EdzArchive
{
public:
EdzArchive();
~EdzArchive();
bool extract(const QString &edz_path);
QString extractedDir() const;
QString partXmlPath() const;
QString errorString() const;
private:
QScopedPointer<QTemporaryDir> m_dir;
QString m_error;
};
#endif // EDZARCHIVE_H